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 декабря.

Поддержка EMULATED была прекращена 10 декабря 2015 года . Все скрипты, пытающиеся использовать EMULATED вместо него используют IFRAME .

IFRAME Enum Режим песочницы, использующий песочницу iframe вместо технологии песочницы Caja, применяемой в режимах EMULATED и NATIVE . Этот режим является режимом по умолчанию для новых скриптов, начиная с 12 ноября 2015 года, и для всех скриптов, начиная с 6 июля 2016 года.

Этот режим накладывает гораздо меньше ограничений, чем другие режимы песочницы, и работает быстрее всего, но вообще не работает в некоторых старых браузерах, включая Internet Explorer 9.

NATIVE Enum Режим песочницы, основанный на строгом режиме ECMAScript 5. Этот режим был прекращен 6 июля 2016 года . Теперь все скрипты используют режим IFRAME .