Перечисление, представляющее режимы песочницы, которые можно использовать для клиентских сценариев 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 года. |
IFRAME | Enum | Режим песочницы, который использует песочницу iframe вместо технологии песочницы Caja, используемой в EMULATED и NATIVE . Этот режим используется по умолчанию для новых сценариев с 12 ноября 2015 г. и для всех сценариев с 6 июля 2016 г.Этот режим накладывает гораздо меньше ограничений, чем другие режимы песочницы, и работает быстрее, но вообще не работает в некоторых старых браузерах, включая Internet Explorer 9. |
NATIVE | Enum | Режим песочницы, созданный поверх строгого режима ECMAScript 5. Режим песочницы, созданный поверх строгого режима ECMAScript 5. Этот режим был закрыт по состоянию на 6 июля 2016 года . Все скрипты теперь используют режим IFRAME . |