Enum SandboxMode

SandboxMode

Énumération représentant les modes bac à sable pouvant être utilisés pour HtmlService côté client les scripts. Ces valeurs sont accessibles depuis HtmlService.SandboxMode et définies en appelant HtmlOutput.setSandboxMode(mode)

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

Les modes NATIVE et EMULATED ont été obsolètes le 13 octobre 2015 et ont été abandonnés. Uniquement 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é depuis Le 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) utilisateurs précédemment autorisés à choisir les auteurs de scripts entre les différentes versions du bac à sable, mais n'a plus d'effet. Pour en savoir plus, consultez les guide des restrictions concernant le service HTML.

Le mode IFRAME impose beaucoup moins de restrictions que les autres modes et s'exécute plus rapide, mais ne fonctionne pas du tout avec certaines versions antérieures, y compris Internet Explorer 9. La 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, ce qui peut différer du mode demandé sur le serveur s'il n'est pas pris en charge dans le dans 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éTypeDescription
EMULATEDEnumUn ancien mode bac à sable qui émule le mode strict ECMAScript 5 en utilisant uniquement les fonctionnalités disponibles dans ECMAScript 3. Ce mode était le mode par défaut avant février 2014.

EMULATED a été arrêté le 10 décembre, 2015. Tous les scripts qui tentent d'utiliser EMULATED utiliseront désormais IFRAME à la place.

IFRAMEEnumUn mode Sandbox qui utilise le bac à sable iFrame au lieu de la technologie de bac à sable Caja utilisée par la classe Modes EMULATED et NATIVE. Il s'agit du mode par défaut pour les nouveaux scripts 12 novembre 2015 et pour tous les scripts à compter du 6 juillet 2016.

Ce mode impose beaucoup moins de restrictions que les autres modes bac à sable et s'exécute plus rapidement, mais ne fonctionne pas du tout dans certains navigateurs plus anciens, y compris Internet Explorer 9.

NATIVEEnumMode bac à sable basé sur le mode strict ECMAScript 5 Un mode bac à sable basé sur Mode strict ECMAScript 5 Ce mode était arrêté au soleil du 6 juillet 2016. Tous les scripts utilisent désormais le mode IFRAME.