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

Browser-Kompatibilität