Enum SandboxMode

Korumalı alanmodu

İstemci tarafı HtmlService komut dosyaları için kullanılabilecek test ortamı modlarını temsil eden bir enum. Bu değerlere HtmlService.SandboxMode üzerinden erişilebilir ve HtmlOutput.setSandboxMode(mode) çağrılarak ayarlanabilir.

Bir enum'ı çağırmak için üst sınıfını, adını ve özelliğini çağırmanız gerekir. Örneğin, HtmlService.SandboxMode.IFRAME.

NATIVE ve EMULATED modlarının desteği 13 Ekim 2015'te sonlandırılmıştı ve her ikisi de artık kullanımdan kaldırıldı. Şu anda yalnızca IFRAME modu desteklenmektedir.

Kullanıcıların kötü amaçlı HTML veya JavaScript yayınlanmasından korunması için HTML hizmetinden yayınlanan istemci tarafı kodu, koda kısıtlamalar getiren bir güvenlik korumalı alanında yürütülür. Bu yöntem, daha önce komut dosyası yazarlarının korumalı alanın farklı sürümleri arasında seçim yapmasına olanak tanıyordu ancak artık bir etkisi yok.HtmlOutput.setSandboxMode(mode) Daha fazla bilgi için HTML hizmetindeki kısıtlamalarla ilgili kılavuza bakın.

IFRAME modu, diğer sandbox modlarına kıyasla çok daha az kısıtlama uygular ve en hızlı şekilde çalışır ancak Internet Explorer 9 da dahil olmak üzere belirli eski tarayıcılarda hiç çalışmaz. Sandbox modu, google.script.sandbox.mode incelenerek istemci tarafı komut dosyasında da okunabilir. Bu özelliğin, istemcideki gerçek modu döndürdüğünü unutmayın. İstenen mod kullanıcının tarayıcısında desteklenmiyorsa bu mod, sunucuda istenen moddan farklı olabilir. 

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>

Özellikler

MülkTürAçıklama
EMULATEDEnumYalnızca ECMAScript 3'te bulunan özellikler kullanılarak ECMAScript 5 yüksek düzey modu taklit eden eski bir sanal alan modu. Bu mod, Şubat 2014'ten önce varsayılan moddu.

EMULATED, 10 Aralık itibarıyla kullanımdan kaldırıldı.

EMULATED, 10 Aralık 2015 itibarıyla kullanımdan kaldırıldı. EMULATED kullanmaya çalışan tüm komut dosyaları bunun yerine IFRAME kullanır.
IFRAMEEnumEMULATED ve NATIVE modlarında kullanılan Caja korumalı alan teknolojisi yerine iframe korumalı alanını kullanan bir korumalı alan modu. Bu mod, 12 Kasım 2015'ten itibaren yeni komut dosyaları için, 6 Temmuz 2016'dan itibaren ise tüm komut dosyaları için varsayılan moddur.

Bu mod, diğer korumalı alan modlarına kıyasla çok daha az kısıtlama uygular ve en hızlı şekilde çalışır ancak Internet Explorer 9 dahil olmak üzere belirli eski tarayıcılarda hiç çalışmaz.
NATIVEEnumECMAScript 5 yüksek düzey modu üzerine kurulu bir korumalı alan modu. ECMAScript 5'in yüksek düzey modu üzerine kurulu bir korumalı alan modu. Bu modun desteği 6 Temmuz 2016'da sonlandırıldı. Tüm komut dosyaları artık IFRAME modunu kullanıyor.