Um tipo enumerado que representa os modos de sandbox que podem ser usados para HtmlService do lado do cliente
scripts. Esses valores podem ser acessados de HtmlService.SandboxMode e definidos chamando
HtmlOutput.setSandboxMode(mode).
Para chamar um tipo enumerado, chame a classe mãe, o nome e a propriedade dele. Por exemplo,
HtmlService.SandboxMode.IFRAME.
Os modos NATIVE e EMULATED foram descontinuados em 13 de outubro de 2015 e foram desativados. Somente
O modo IFRAME agora é compatível.
Para proteger os usuários contra a disponibilização de HTML ou JavaScript malicioso, o código do lado do cliente fornecido por
O serviço HTML é executado em uma sandbox de segurança que impõe restrições ao código. Método
HtmlOutput.setSandboxMode(mode) autorizou anteriormente a escolha de autores de script
entre diferentes versões do sandbox, mas que agora não tem efeito. Para mais informações, consulte a
guia de restrições no serviço HTML.
O modo IFRAME impõe muito menos restrições do que os outros modos e execuções de sandbox.
mais rápido, mas não funciona em certos navegadores mais antigos, incluindo o Internet Explorer 9. A
O modo sandbox também pode ser lido em um script do lado do cliente inspecionando google.script.sandbox.mode. Essa propriedade retorna o modo real no cliente, que
poderá diferir do modo solicitado no servidor se o modo solicitado não for suportado no
navegador do usuário.
<!-- Read the sandbox mode (in a client-side script). --> <script> alert(google.script.sandbox.mode); </script>
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
EMULATED | Enum | Um modo sandbox legado que emula o modo estrito do ECMAScript 5 usando apenas os recursos disponíveis
no ECMAScript 3. Esse modo era o padrão antes de fevereiro de 2014.
|
IFRAME | Enum | Um modo de sandbox que usa sandbox iframe em vez da tecnologia Caja sandbox usada pelo
Modos EMULATED e NATIVE. Esse modo é o padrão para novos scripts a partir da
12 de novembro de 2015 e para todos os scripts a partir de 6 de julho de 2016.
Esse modo impõe muito menos restrições do que os outros modos de sandbox e é executado mais rapidamente, mas não funciona em alguns navegadores mais antigos, incluindo o Internet Explorer 9. |
NATIVE | Enum | Um modo sandbox criado sobre o modo estrito do ECMAScript 5. Um modo sandbox baseado em
Modo estrito do ECMAScript 5. Este modo foi desativado porque
de 6 de julho de 2016. Todos os scripts agora usam o modo IFRAME. |