Enum SandboxMode

SandboxMode

Ein Enum-Wert, der die Sandbox-Modi darstellt, die für das clientseitige HtmlService verwendet werden können Skripts erstellt. Auf diese Werte kann über HtmlService.SandboxMode zugegriffen werden. Sie legen sie fest, indem sie HtmlOutput.setSandboxMode(mode).

Um eine Enumeration aufzurufen, rufen Sie deren übergeordnete Klasse, ihren Namen und ihre Eigenschaft auf. Beispiel: HtmlService.SandboxMode.IFRAME.

Die Modi NATIVE und EMULATED wurden am 13. Oktober 2015 eingestellt und beide sind jetzt eingestellt. Nur Der IFRAME-Modus wird jetzt unterstützt.

Um Nutzer vor schädlichem HTML- oder JavaScript-Code zu schützen, wird clientseitiger Code von Der HTML-Dienst wird in einer Sicherheits-Sandbox ausgeführt, die Einschränkungen für den Code vorgibt. Die Methode HtmlOutput.setSandboxMode(mode) hat zuvor Skriptautoren die Auswahl getroffen Versionen der Sandbox zu wechseln, hat jetzt jedoch keine Auswirkungen. Weitere Informationen finden Sie in der Leitfaden zu Einschränkungen beim HTML-Dienst

Für den IFRAME-Modus gelten wesentlich weniger Einschränkungen als für die anderen Sandbox-Modi und die Ausführung aber bei bestimmten älteren Browsern, wie Internet Explorer 9, funktioniert es überhaupt nicht. Die Der Sandbox-Modus kann auch in einem clientseitigen Script gelesen werden, indem google.script.sandbox.mode geprüft wird. Beachten Sie, dass diese Eigenschaft den tatsächlichen Modus auf dem Client zurückgibt, der von dem auf dem Server angeforderten Modus abweichen kann, wenn er von der im Browser des Nutzers.

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

Attribute

AttributTypBeschreibung
EMULATEDEnumÄlterer Sandbox-Modus, der den strikten ECMAScript 5-Modus emuliert und nur die verfügbaren Funktionen verwendet in ECMAScript 3. Dies war vor Februar 2014 der Standardmodus.

EMULATED wurde am 10. Dezember eingestellt 2015. Alle Skripts, die versuchen, EMULATED zu verwenden, verwenden jetzt stattdessen IFRAME.

IFRAMEEnumSandbox-Modus, bei dem die iFrame-Sandbox anstelle der Caja-Sandbox-Technologie verwendet wird EMULATED- und NATIVE-Modi. Dieser Modus ist die Standardeinstellung für neue Skripts ab ab dem 12. November 2015 und für alle Skripts mit Stand vom 6. Juli 2016.

Dieser Modus unterliegt wesentlich weniger Einschränkungen als die anderen Sandbox-Modi und wird am schnellsten ausgeführt. funktioniert in bestimmten älteren Browsern, einschließlich Internet Explorer 9, nicht.

NATIVEEnumEin Sandbox-Modus, der auf dem strikten Modus von ECMAScript 5 basiert. Ein Sandbox-Modus basiert auf Strikter Modus in ECMAScript 5 Dieser Modus wurde eingestellt als vom 6. Juli 2016. Für alle Skripts wird jetzt der Modus IFRAME verwendet.