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>