Enum SandboxMode

Énumération représentant les modes de bac à sable pouvant être utilisés pour les scripts HtmlService côté client. Vous pouvez accéder à ces valeurs depuis HtmlService.SandboxMode et les définir en appelant HtmlOutput.setSandboxMode(mode).

Les modes NATIVE et EMULATED ont été obsolètes le 13 octobre 2015. Ils ont tous deux été abandonnés. Seul le mode IFRAME est désormais compatible.

Pour empêcher les utilisateurs d'être exposés à du code HTML ou JavaScript malveillant, le code côté client diffusé à partir du service HTML s'exécute dans un bac à sable de sécurité qui impose des restrictions sur le code. La méthode HtmlOutput.setSandboxMode(mode) permettait auparavant aux auteurs de scripts de choisir entre différentes versions du bac à sable, mais n'a plus d'effet. Pour en savoir plus, consultez le guide des restrictions dans le service HTML.

Le mode IFRAME impose beaucoup moins de restrictions que les autres modes du bac à sable et s'exécute le plus rapidement, mais ne fonctionne pas du tout dans certains navigateurs plus anciens, y compris Internet Explorer 9. Le mode sandbox peut également être lu dans un script côté client en inspectant google.script.sandbox.mode. Notez que cette propriété renvoie le mode réel sur le client, qui peut être différent du mode demandé sur le serveur si le mode demandé n'est pas compatible avec le navigateur de l'utilisateur.

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