HTMLIFrameElement : propriété sandbox
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La propriété en lecture seule sandbox de l'interface HTMLIFrameElement retourne un objet DOMTokenList dynamique indiquant des restrictions supplémentaires sur le comportement du contenu imbriqué. Elle reflète l'attribut de contenu sandbox de l'élément HTML <iframe>.
Valeur
Un objet DOMTokenList dynamique.
Bien que la propriété sandbox elle-même soit en lecture seule dans le sens où vous ne pouvez pas remplacer l'objet DOMTokenList, il est possible d'affecter directement à la propriété sandbox, ce qui équivaut à affecter sa propriété value. Vous pouvez également modifier l'objet DOMTokenList à l'aide des méthodes add(), remove(), replace() et toggle().
Exemples
<iframe
id="el"
title="exemple"
src="https://exemple.com"
sandbox="allow-same-origin allow-scripts"></iframe>
const el = document.getElementById("el");
console.log(Array.from(el.sandbox)); // Affiche : ["allow-same-origin", "allow-scripts"]
el.sandbox = "";
console.log(Array.from(el.sandbox)); // Affiche : []
Spécifications
| Specification |
|---|
| HTML # dom-iframe-sandbox |