Enum SandboxMode

Korumalı AlanModu

İstemci tarafı HtmlServicekodları için kullanılabilecek korumalı alan modlarını temsil eden bir enum. Bu değerlere HtmlService.SandboxMode adresinden 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 artık kullanılamıyor. Şu anda yalnızca IFRAME modu desteklenmektedir.

Kullanıcıların kötü amaçlı HTML veya JavaScript'e maruz kalmasını önlemek için HTML hizmetinden sunulan istemci tarafı kod, kod üzerinde 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 olanak tanımasına rağmen artık etkisi yoktur. Daha fazla bilgi için HTML hizmetindeki kısıtlamalar kılavuzuna göz atı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 da dahil olmak üzere belirli eski tarayıcılarda hiç çalışmaz. Korumalı alan modu, google.script.sandbox.mode incelenerek istemci taraflı bir komut dosyasında da okunabilir. Bu mülkün, istemcide gerçek modu döndürdüğünü unutmayın. İstenilen 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 özellikleri kullanarak ECMAScript 5 katı modunu taklit eden eski bir korumalı 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ı tarafından kullanılan Caja korumalı alan teknolojisi yerine iframe korumalı alanı kullanan bir korumalı alan modu. Bu mod, 12 Kasım 2015'ten itibaren yeni komut dosyaları ve 6 Temmuz 2016'dan 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ı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 temel alınarak oluşturulmuş bir korumalı alan modu. ECMAScript 5'in katı modu üzerine inşa edilmiş bir korumalı alan modu. Bu mod, 6 Temmuz 2016 itibarıyla kullanımdan kaldırılmıştır. Tüm komut dosyaları artık IFRAME modunu kullanıyor.