Enum SandboxMode
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Режим песочницы Перечисление, представляющее режимы песочницы, которые можно использовать для клиентских скриптов Html Service . Эти значения доступны из Html Service.SandboxMode и устанавливаются вызовом Html Output.setSandboxMode(mode) .
Чтобы вызвать перечисление, нужно указать его родительский класс, имя и свойство. Например, HtmlService.SandboxMode.IFRAME .
Режимы NATIVE и EMULATED были объявлены устаревшими 13 октября 2015 года и теперь не поддерживаются. Теперь поддерживается только режим IFRAME .
Чтобы защитить пользователей от вредоносного HTML- или JavaScript-кода, клиентский код, предоставляемый HTML-сервисом, выполняется в изолированной среде безопасности, которая накладывает ограничения на код. Метод Html Output.setSandboxMode(mode) ранее позволял авторам скриптов выбирать между различными версиями изолированной среды, но теперь не имеет никакого эффекта. Подробнее см. в руководстве по ограничениям в HTML-сервисе .
Режим IFRAME накладывает гораздо меньше ограничений, чем другие режимы «песочницы», и работает быстрее всего, но не работает совсем в некоторых старых браузерах, включая Internet Explorer 9. Режим «песочницы» также можно прочитать в клиентском скрипте, проверив google.script.sandbox.mode . Обратите внимание, что это свойство возвращает фактический режим на клиенте, который может отличаться от режима, запрошенного на сервере, если запрошенный режим не поддерживается браузером пользователя.
<!-- Read the sandbox mode (in a client-side script). -->
<script>
alert(google.script.sandbox.mode);
</script>
Характеристики
| Свойство | Тип | Описание |
|---|
EMULATED | Enum | Устаревший режим «песочницы», эмулирующий строгий режим ECMAScript 5, используя только функции, доступные в ECMAScript 3. Этот режим использовался по умолчанию до февраля 2014 года. Поддержка EMULATED прекращена 10 декабря 2015 г. Все скрипты, пытающиеся использовать EMULATED , теперь будут использовать IFRAME . |
IFRAME | Enum | Режим песочницы, использующий песочницу iframe вместо технологии песочницы Caja, применяемой в режимах EMULATED и NATIVE . Этот режим используется по умолчанию для новых скриптов с 12 ноября 2015 года и для всех скриптов с 6 июля 2016 года. Этот режим накладывает гораздо меньше ограничений, чем другие режимы «песочницы», и работает быстрее всего, но совсем не работает в некоторых старых браузерах, включая Internet Explorer 9. |
NATIVE | Enum | Режим песочницы, построенный на основе строгого режима ECMAScript 5. Режим песочницы, построенный на основе строгого режима ECMAScript 5. Этот режим был упразднён 6 июля 2016 года . Все скрипты теперь используют режим IFRAME . |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-04 UTC.
[null,null,["Последнее обновление: 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. |"]]
