Cette page a été traduite par l'API Cloud Translation.

Enum SandboxMode

Enumé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 à partir de HtmlService.SandboxMode et les définir en appelant HtmlOutput.setSandboxMode(mode).

Pour appeler un énumération, vous devez appeler sa classe parente, son nom et sa propriété. Par exemple, HtmlService.SandboxMode.IFRAME.

Les modes NATIVE et EMULATED ont été abandonnés le 13 octobre 2015 et sont désormais obsolètes. Seul le mode IFRAME est désormais pris en charge.

Pour protéger les utilisateurs contre le 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 au 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 désormais aucun effet. Pour en savoir plus, consultez le guide des restrictions du service HTML.

Le mode IFRAME impose beaucoup moins de restrictions que les autres modes de bac à sable et s'exécute plus rapidement, mais ne fonctionne pas du tout dans certains anciens navigateurs, y compris Internet Explorer 9. Le mode bac à sable 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 différer 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>

Propriétés

Propriété	Type	Description
`EMULATED`	`Enum`	Ancien mode bac à sable qui émule le mode strict ECMAScript 5 en n'utilisant que les fonctionnalités disponibles dans ECMAScript 3. Il s'agissait du mode par défaut avant février 2014. `EMULATED` a été abandonné le 10 décembre 2015. Tous les scripts qui tentent d'utiliser `EMULATED` utiliseront désormais `IFRAME` à la place.
`IFRAME`	`Enum`	Mode bac à sable qui utilise le bac à sable iFrame au lieu de la technologie de bac à sable Caja utilisée par les modes `EMULATED` et `NATIVE`. Ce mode est utilisé par défaut pour les nouveaux scripts à partir du 12 novembre 2015 et pour tous les scripts à partir du 6 juillet 2016. Ce mode impose beaucoup moins de restrictions que les autres modes de bac à sable et s'exécute plus rapidement, mais ne fonctionne pas du tout dans certains anciens navigateurs, y compris Internet Explorer 9.
`NATIVE`	`Enum`	Mode bac à sable basé sur le mode strict ECMAScript 5. Mode bac à sable basé sur le mode strict ECMAScript 5. Ce mode a été abandonné le 6 juillet 2016. Tous les scripts utilisent désormais le mode `IFRAME`.