Enum SandboxMode

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Режим песочницы

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

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

Чтобы защитить пользователей от предоставления вредоносного кода HTML или JavaScript, код на стороне клиента, обслуживаемый службой HTML, выполняется в изолированной программной среде безопасности, которая накладывает ограничения на код. Метод HtmlOutput.setSandboxMode(mode) ранее позволял авторам скриптов выбирать между различными версиями песочницы, но теперь не действует. Дополнительные сведения см. в руководстве по ограничениям в службе HTML .

Режим IFRAME накладывает гораздо меньше ограничений, чем другие режимы песочницы, и работает быстрее, но вообще не работает в некоторых старых браузерах, включая Internet Explorer 9. Режим песочницы также можно прочитать в сценарии на стороне клиента, google.script.sandbox.mode . 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 .