İ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ğırırsınız. Ö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ılamıyor. Şu anda yalnızca IFRAME modu desteklenmektedir.
Kullanıcıların kötü amaçlı HTML veya JavaScript'in sunulmasından korunması için HTML hizmetinden sunulan 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 herhangi 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 sanal 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. Korumalı alan modu ayrıca 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. Bu mod, istenen mod kullanıcının tarayıcısında desteklenmiyorsa sunucuda istenen moddan farklı olabilir.
<!-- Read the sandbox mode (in a client-side script). --> <script> alert(google.script.sandbox.mode); </script>
Özellikler
| Mülk | Tür | Açıklama |
|---|---|---|
EMULATED | Enum | Yalnızca ECMAScript 3'te bulunan özellikler kullanılarak ECMAScript 5 yüksek düzey modu taklit eden eski bir korumalı alan modu. Bu mod, Şubat 2014'ten önce varsayılan moddu.
|
IFRAME | Enum | EMULATED 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 sanal 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. |
NATIVE | Enum | ECMAScript 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 mod, 6 Temmuz 2016 itibarıyla kullanımdan kaldırıldı. Tüm komut dosyaları artık IFRAME modunu kullanıyor. |