İstemci tarafı HtmlService komut dosyaları için kullanılabilecek korumalı alan modlarını temsil eden bir enum. Bu değerlere HtmlService.SandboxMode üzerinden erişilebilir ve HtmlOutput.setSandboxMode(mode) çağrısı yapılarak ayarlanabilir.
Bir enum'u ç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ı 13 Ekim 2015'te kullanımdan kaldırıldı ve şu anda kullanımdan kaldırıldı. Artık yalnızca IFRAME modu desteklenmektedir.
Kullanıcılara kötü amaçlı HTML veya JavaScript'in sunulmasını önlemek için HTML hizmetinden sunulan istemci tarafı kod, koda kısıtlamalar uygulayan bir güvenlik korumalı alanında yürütülür. HtmlOutput.setSandboxMode(mode) yöntemi, daha önce komut dosyası yazarlarının korumalı alanın farklı sürümleri arasında seçim yapmasına izin veriyordu ancak artık böyle bir etkisi yoktur. Daha fazla bilgi için HTML hizmetindeki kısıtlamalarla ilgili kılavuza bakın.
IFRAME modu, 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. Korumalı alan modu, google.script.sandbox.mode incelenerek istemci taraflı komut dosyasında da okunabilir. Bu özelliğin istemcide gerçek modu döndürdüğünü unutmayın. Bu, kullanıcının tarayıcısında istenen mod desteklenmiyorsa sunucuda istenen moddan farklı olabilir.
<!-- Read the sandbox mode (in a client-side script). --> <script> alert(google.script.sandbox.mode); </script>
Özellikler
| Özellik | Tür | Açıklama |
|---|---|---|
EMULATED | Enum | Yalnızca ECMAScript 3'te kullanılabilen özellikleri kullanarak ECMAScript 5 yüksek düzey modunu emüle eden eski bir korumalı alan modu. Bu mod, Şubat 2014'ten önce varsayılan moddur.
|
IFRAME | Enum | EMULATED ve NATIVE modlarında kullanılan Caja korumalı alan teknolojisi yerine iframe korumalı alanı kullanan bir korumalı alan modu. Bu mod, 12 Kasım 2015 itibarıyla yeni komut dosyaları ve 6 Temmuz 2016 tarihinden itibaren tüm komut dosyaları için varsayılan ayardır.
Bu mod, diğer korumalı alan modlarına kıyasla çok daha az kısıtlamaya neden olur ve en hızlı şekilde çalışır ancak Internet Explorer 9 dahil olmak üzere bazı eski tarayıcılarda hiç çalışmaz. |
NATIVE | Enum | ECMAScript 5 yüksek düzey modu temel alınarak oluşturulmuş bir korumalı alan modu. ECMAScript 5 yüksek düzey modu
üzerine oluşturulmuş bir korumalı alan modu. Bu mod 6 Temmuz 2016 tarihinde kullanımdan kaldırıldı. Tüm komut dosyaları artık IFRAME modunu kullanıyor. |