Um ein Enum aufzurufen, 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. Nur der Modus IFRAME wird jetzt unterstützt.
Um Nutzer vor bösartigem 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 auferlegt. Mit der Methode HtmlOutput.setSandboxMode(mode) konnten Skriptautoren zuvor zwischen verschiedenen Versionen der Sandbox wählen. Das ist jetzt nicht mehr möglich. Weitere Informationen finden Sie in der Anleitung zu Einschränkungen im HTML-Dienst.
Im IFRAME-Modus gelten viel weniger Einschränkungen als in den anderen Sandbox-Modi. Er ist auch der schnellste, funktioniert aber in bestimmten älteren Browsern wie Internet Explorer 9 überhaupt nicht. Der Sandbox-Modus kann auch in einem clientseitigen Script durch Untersuchen von google.script.sandbox.mode gelesen werden. 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>
Attribute
Attribut
Typ
Beschreibung
EMULATED
Enum
Ein Legacy-Sandbox-Modus, der den ECMAScript 5-Strict-Modus emuliert und nur die in ECMAScript 3 verfügbaren Funktionen verwendet. Vor Februar 2014 war dieser Modus die Standardeinstellung.
EMULATED wurde am 10. Dezember 2015 eingestellt. In allen Scripts, in denen EMULATED verwendet wird, wird jetzt stattdessen IFRAME verwendet.
IFRAME
Enum
Ein Sandbox-Modus, der Iframe-Sandboxing anstelle der Caja-Sandbox-Technologie verwendet, die in den Modi EMULATED und NATIVE verwendet wird. Dieser Modus ist seit dem 12. November 2015 der Standard für neue Skripts und seit dem 6. Juli 2016 für alle Skripts.
Dieser Modus unterliegt viel weniger Einschränkungen als die anderen Sandbox-Modi und wird am schnellsten ausgeführt. Er funktioniert jedoch in bestimmten älteren Browsern, einschließlich Internet Explorer 9, überhaupt nicht.
NATIVE
Enum
Ein Sandbox-Modus, der auf dem Strict-Modus von ECMAScript 5 basiert. Ein Sandbox-Modus, der auf dem strikten Modus von ECMAScript 5 basiert. Dieser Modus wurde am 6. Juli 2016 eingestellt. Alle Scripts verwenden jetzt den IFRAME-Modus.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-04 (UTC)."],[[["\u003cp\u003eSandboxMode is used for setting the sandbox environment for client-side HtmlService scripts in Google Apps Script.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eIFRAME\u003c/code\u003e is the only supported SandboxMode; \u003ccode\u003eNATIVE\u003c/code\u003e and \u003ccode\u003eEMULATED\u003c/code\u003e are deprecated and sunset.\u003c/p\u003e\n"],["\u003cp\u003eClient-side code in HTML service runs in a security sandbox with restrictions to protect users.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eIFRAME\u003c/code\u003e mode has fewer restrictions and runs faster but might not work in older browsers like Internet Explorer 9.\u003c/p\u003e\n"],["\u003cp\u003eYou can read the actual sandbox mode on the client-side using \u003ccode\u003egoogle.script.sandbox.mode\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["SandboxMode\n\nAn enum representing the sandbox modes that can be used for client-side [HtmlService](/apps-script/reference/html/html-service)\nscripts. These values can be accessed from [HtmlService.SandboxMode](/apps-script/reference/html/html-service#SandboxMode), and set by calling\n[HtmlOutput.setSandboxMode(mode)](/apps-script/reference/html/html-output#setSandboxMode(SandboxMode)).\n\nTo call an enum, you call its parent class, name, and property. For example, `\nHtmlService.SandboxMode.IFRAME`.\n\nThe `NATIVE` and `EMULATED` modes were [deprecated on October 13, 2015](https://workspace.google.com/blog/product-announcements/google-apps-script-update-htmlservice) and both are now sunset. Only `IFRAME` mode is now\nsupported.\n\nTo protect users from being served malicious HTML or JavaScript, client-side code served from\nHTML service executes in a security sandbox that imposes restrictions on the code. The method\n[HtmlOutput.setSandboxMode(mode)](/apps-script/reference/html/html-output#setSandboxMode(SandboxMode)) previously allowed script authors to choose\nbetween different versions of the sandbox, but now has no effect. For more information, see the\n[guide to restrictions in HTML service](/apps-script/guides/html/restrictions).\n\nThe `IFRAME` mode imposes many fewer restrictions than the other sandbox modes and runs\nfastest, but does not work at all in certain older browsers, including Internet Explorer 9. The\nsandbox mode can also be read in a client-side script by inspecting `google.script.sandbox.mode`. Note that this property returns the actual mode on the client, which\nmay differ from the mode requested on the server if the requested mode is not supported in the\nuser's browser.\n\n```html\n\u003c!-- Read the sandbox mode (in a client-side script). --\u003e\n\u003cscript\u003e\n alert(google.script.sandbox.mode);\n\u003c/script\u003e\n``` \n\nProperties\n\n| Property | Type | Description |\n|------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `EMULATED` | `Enum` | A legacy sandbox mode that emulates ECMAScript 5 strict mode using only the features available in ECMAScript 3. This mode was the default prior to February 2014. `EMULATED` was [sunset as of December 10, 2015](/apps-script/guides/support/sunset). All scripts attempting use `EMULATED` will now use `IFRAME` instead. |\n| `IFRAME` | `Enum` | A sandbox mode that uses iframe sandboxing instead of the Caja sandbox technology used by the `EMULATED` and `NATIVE` modes. This mode is the default for new scripts as of November 12, 2015 and for all scripts as of July 6, 2016. This mode imposes many fewer restrictions than the other sandbox modes and runs fastest, but does not work at all in certain older browsers, including Internet Explorer 9. |\n| `NATIVE` | `Enum` | A sandbox mode that is built on top of ECMAScript 5 strict mode. A sandbox mode built on top of ECMAScript 5 strict mode. This mode was [sunset as of July 6, 2016](/apps-script/guides/support/sunset). All scripts now use `IFRAME` mode. |"]]
