Enum SandboxMode

Ein Enum, das die Sandbox-Modi darstellt, die für clientseitige HtmlService-Scripts verwendet werden können. Auf diese Werte kann über HtmlService.SandboxMode zugegriffen und sie können durch Aufrufen von HtmlOutput.setSandboxMode(mode) festgelegt werden.

Wenn Sie ein Enum aufrufen möchten, rufen Sie die übergeordnete Klasse, den Namen und die Eigenschaft auf. Beispiel: HtmlService.SandboxMode.IFRAME.

Die Modi NATIVE und EMULATED wurden am 13. Oktober 2015 eingestellt und sind jetzt nicht mehr verfügbar. Derzeit wird nur der IFRAME-Modus unterstützt.

Um Nutzer vor schädlichem HTML- oder JavaScript-Code zu schützen, wird clientseitiger Code, der über den HTML-Dienst bereitgestellt wird, in einer Sicherheits-Sandbox ausgeführt, die Einschränkungen für den Code vorschreibt. Mit der Methode HtmlOutput.setSandboxMode(mode) konnten Scriptautoren bisher zwischen verschiedenen Versionen der Sandbox wählen. Diese Option ist jetzt nicht mehr verfügbar. Weitere Informationen finden Sie im Leitfaden zu Einschränkungen im HTML-Dienst.

Der IFRAME-Modus ist weniger eingeschränkt als die anderen Sandbox-Modi und läuft am schnellsten. Er funktioniert jedoch in bestimmten älteren Browsern, z. B. Internet Explorer 9, überhaupt nicht. Der Sandbox-Modus kann auch in einem clientseitigen Script gelesen werden, indem google.script.sandbox.mode geprüft wird. Hinweis: Diese Eigenschaft gibt den tatsächlichen Modus auf dem Client zurück. Dieser kann sich vom auf dem Server angeforderten Modus unterscheiden, wenn der angeforderte Modus im Browser des Nutzers nicht unterstützt wird.

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