Ein Enum-Wert, der die Sandbox-Modi darstellt, die für clientseitige HtmlService-Skripts verwendet werden können. Sie können über HtmlService.SandboxMode auf diese Werte zugreifen und sie durch Aufrufen von HtmlOutput.setSandboxMode(mode) festlegen.
Die Modi NATIVE und EMULATED wurden am 13. Oktober 2015 eingestellt und sind beide eingestellt. Es wird nur der Modus IFRAME unterstützt.
Damit Nutzer kein schädliches HTML oder JavaScript erhalten, wird clientseitiger Code, der vom HTML-Dienst bereitgestellt wird, in einer Sicherheits-Sandbox ausgeführt, die Einschränkungen für den Code auferlegt. Bisher konnten Skriptautoren zwischen verschiedenen Versionen der Sandbox-Bibliothek (HtmlOutput.setSandboxMode(mode)) wählen. Dies hat jedoch keine Auswirkungen. Weitere Informationen finden Sie im Leitfaden zu Einschränkungen im HTML-Dienst.
Der Modus IFRAME gibt viel weniger Einschränkungen als die anderen Sandbox-Modi vor und wird am schnellsten ausgeführt, funktioniert jedoch in bestimmten älteren Browsern, einschließlich Internet Explorer 9, überhaupt nicht. Sie können den Sandbox-Modus auch in einem clientseitigen Skript lesen. Dazu prüfen Sie google.script.sandbox.mode. Dieses Attribut gibt den tatsächlichen Modus auf dem Client zurück. Dieser kann sich vom Modus unterscheiden, der auf dem Server angefordert wird, wenn der angeforderte Modus vom Browser des Nutzers nicht unterstützt wird.
<!-- Read the sandbox mode (in a client-side script). --> <script> alert(google.script.sandbox.mode); </script>
Attribute
| Property | Typ | Beschreibung |
|---|---|---|
EMULATED | Enum | Ein älterer Sandbox-Modus, der den strengen Modus von ECMAScript 5 mithilfe der Funktionen emuliert, die in ECMAScript 3 verfügbar sind. Dieser Modus war vor Februar 2014 die Standardeinstellung.
|
IFRAME | Enum | Ein Sandbox-Modus, der iFrame-Sandboxing anstelle der Caja-Sandbox-Technologie verwendet, die von den Modi EMULATED und NATIVE verwendet wird. Dieser Modus ist die Standardeinstellung für neue Skripts ab dem 12. November 2015 und für alle Skripts ab dem 6. Juli 2016.
Dieser Modus bringt viel weniger Einschränkungen als die anderen Sandbox-Modi und wird am schnellsten ausgeführt, funktioniert jedoch in bestimmten älteren Browsern, einschließlich Internet Explorer 9, überhaupt nicht. |
NATIVE | Enum | Ein Sandbox-Modus, der auf dem strengen Modus von ECMAScript 5 aufbaut Ein Sandbox-Modus, der auf dem strengen Modus von ECMAScript 5 basiert. Dieser Modus wurde am 6. Juli 2016 eingestellt. Alle Skripts verwenden jetzt den Modus IFRAME. |