Enum SandboxMode
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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ülk | Tür | Açıklama |
EMULATED | Enum | Yalnı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.
|
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 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. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-04 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-04 UTC."],[[["\u003cp\u003eSandboxMode is used for setting the sandbox environment for client-side HtmlService scripts in Google Apps Script.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eIFRAME\u003c/code\u003e is the only supported SandboxMode; \u003ccode\u003eNATIVE\u003c/code\u003e and \u003ccode\u003eEMULATED\u003c/code\u003e are deprecated and sunset.\u003c/p\u003e\n"],["\u003cp\u003eClient-side code in HTML service runs in a security sandbox with restrictions to protect users.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eIFRAME\u003c/code\u003e mode has fewer restrictions and runs faster but might not work in older browsers like Internet Explorer 9.\u003c/p\u003e\n"],["\u003cp\u003eYou can read the actual sandbox mode on the client-side using \u003ccode\u003egoogle.script.sandbox.mode\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Enum SandboxMode\n\nSandboxMode\n\nAn enum representing the sandbox modes that can be used for client-side [HtmlService](/apps-script/reference/html/html-service)\nscripts. These values can be accessed from [HtmlService.SandboxMode](/apps-script/reference/html/html-service#SandboxMode), and set by calling\n[HtmlOutput.setSandboxMode(mode)](/apps-script/reference/html/html-output#setSandboxMode(SandboxMode)).\n\nTo call an enum, you call its parent class, name, and property. For example, `\nHtmlService.SandboxMode.IFRAME`.\n\nThe `NATIVE` and `EMULATED` modes were [deprecated on October 13, 2015](https://workspace.google.com/blog/product-announcements/google-apps-script-update-htmlservice) and both are now sunset. Only `IFRAME` mode is now\nsupported.\n\nTo protect users from being served malicious HTML or JavaScript, client-side code served from\nHTML service executes in a security sandbox that imposes restrictions on the code. The method\n[HtmlOutput.setSandboxMode(mode)](/apps-script/reference/html/html-output#setSandboxMode(SandboxMode)) previously allowed script authors to choose\nbetween different versions of the sandbox, but now has no effect. For more information, see the\n[guide to restrictions in HTML service](/apps-script/guides/html/restrictions).\n\nThe `IFRAME` mode imposes many fewer restrictions than the other sandbox modes and runs\nfastest, but does not work at all in certain older browsers, including Internet Explorer 9. The\nsandbox mode can also be read in a client-side script by inspecting `google.script.sandbox.mode`. Note that this property returns the actual mode on the client, which\nmay differ from the mode requested on the server if the requested mode is not supported in the\nuser's browser.\n\n```html\n\u003c!-- Read the sandbox mode (in a client-side script). --\u003e\n\u003cscript\u003e\n alert(google.script.sandbox.mode);\n\u003c/script\u003e\n``` \n\n### Properties\n\n| Property | Type | Description |\n|------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `EMULATED` | `Enum` | A legacy sandbox mode that emulates ECMAScript 5 strict mode using only the features available in ECMAScript 3. This mode was the default prior to February 2014. `EMULATED` was [sunset as of December 10, 2015](/apps-script/guides/support/sunset). All scripts attempting use `EMULATED` will now use `IFRAME` instead. |\n| `IFRAME` | `Enum` | A sandbox mode that uses iframe sandboxing instead of the Caja sandbox technology used by the `EMULATED` and `NATIVE` modes. This mode is the default for new scripts as of November 12, 2015 and for all scripts as of July 6, 2016. This mode imposes many fewer restrictions than the other sandbox modes and runs fastest, but does not work at all in certain older browsers, including Internet Explorer 9. |\n| `NATIVE` | `Enum` | A sandbox mode that is built on top of ECMAScript 5 strict mode. A sandbox mode built on top of ECMAScript 5 strict mode. This mode was [sunset as of July 6, 2016](/apps-script/guides/support/sunset). All scripts now use `IFRAME` mode. |"]]
