HTMLIFrameElement: sandbox-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die schreibgeschützte sandbox-Eigenschaft des HTMLIFrameElement gibt ein dynamisches DOMTokenList-Objekt zurück, das zusätzliche Einschränkungen für das Verhalten des eingebetteten Inhalts anzeigt. Sie spiegelt das sandbox-Inhaltsattribut des <iframe>-Elements wider.
Wert
Ein dynamisches DOMTokenList-Objekt.
Obwohl die sandbox-Eigenschaft selbst im Sinne einer nicht austauschbaren DOMTokenList-Objekt schreibgeschützt ist, kann man der sandbox-Eigenschaft direkt einen Wert zuweisen, was dem Zuweisen zu ihrer value-Eigenschaft entspricht. Sie können das DOMTokenList-Objekt auch mit den Methoden add(), remove(), replace() und toggle() verändern.
Beispiele
<iframe
id="el"
title="example"
src="https://example.com"
sandbox="allow-same-origin allow-scripts"></iframe>
const el = document.getElementById("el");
console.log(Array.from(el.sandbox)); // Output: ["allow-same-origin", "allow-scripts"]
el.sandbox = "";
console.log(Array.from(el.sandbox)); // Output: []
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-iframe-sandbox |