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'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 her ikisi de artık kullanılamıyor. Artık 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 HtmlOutput.setSandboxMode(mode) 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. 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. 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 katı modu taklit eden eski bir sanal alan modu. Bu mod, Şubat 2014'ten önce varsayılan moddu.

EMULATED, 10 Aralık 2015 itibarıyla kullanımdan kaldırıldı. EMULATED kullanmaya çalışan tüm komut dosyaları artık bunun yerine IFRAME kullanacak.
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 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.
NATIVEEnumECMAScript 5 katı modu üzerine kurulu bir korumalı alan modu. ECMAScript 5 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.