Enum SandboxMode

Um tipo enumerado que representa os modos de sandbox que podem ser usados para scripts HtmlService do lado do cliente. Esses valores podem ser acessados em HtmlService.SandboxMode e definidos chamando HtmlOutput.setSandboxMode(mode).

Para chamar um tipo enumerado, chame a classe, o nome e a propriedade pai dele. Por exemplo, HtmlService.SandboxMode.IFRAME.

Os modos NATIVE e EMULATED foram descontinuados em 13 de outubro de 2015 e agora foram desativados. Somente o modo IFRAME agora é compatível.

Para proteger os usuários contra a veiculação de HTML ou JavaScript malicioso, o código do lado do cliente disponibilizado pelo serviço HTML é executado em um sandbox de segurança que impõe restrições ao código. Antes, o método HtmlOutput.setSandboxMode(mode) permitia que os autores de scripts escolhessem entre diferentes versões do sandbox, mas agora não tem efeito. Para ver mais informações, consulte o guia para restrições no serviço HTML.

O modo IFRAME 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. 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 pode ser diferente do modo solicitado no servidor se o modo solicitado não for compatível com o navegador do usuário.

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>