Enum SandboxMode

Режим песочницы

Перечисление, представляющее режимы песочницы, которые можно использовать для сценариев HtmlService на стороне клиента. Доступ к этим значениям можно получить из HtmlService.SandboxMode и установить, вызвав HtmlOutput.setSandboxMode(mode) .

Чтобы вызвать перечисление, вы вызываете его родительский класс, имя и свойство. Например, HtmlService.SandboxMode.IFRAME .

Режимы NATIVE и EMULATED устарели 13 октября 2015 г., и оба режима больше не поддерживаются. Теперь поддерживается только режим IFRAME .

Чтобы защитить пользователей от вредоносного HTML или JavaScript, клиентский код, передаваемый из службы HTML, выполняется в изолированной программной среде безопасности, которая накладывает ограничения на код. Метод HtmlOutput.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 .