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 .