Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

allow — fonctions accessibles dans une iframe

`allow` sur `iframe` limite ou délègue des fonctions du navigateur via Permissions Policy ; il ne donne pas le consentement de l’utilisateur.

Version : HTML Living Standard

Syntaxe

<iframe allow="geolocation 'none'; camera 'none'"></iframe>

La valeur contient des directives séparées par des points-virgules, telles que geolocation 'none'; camera 'none'. Chaque directive nomme une fonction et des origines autorisées ; 'none' la refuse. Cette syntaxe diffère de l’en-tête HTTP Permissions-Policy. Ce n’est pas une liste d’éléments HTML.

Une iframe ne peut obtenir une fonction interdite par la politique d’un document ancêtre. Son usage peut aussi exiger un contexte sécurisé, une activation ou une autorisation utilisateur. allow ne remplace pas sandbox et n’annule pas les restrictions entre origines.

L’exemple charge uniquement un srcdoc local et lit la politique effective avec featurePolicy, présent dans le Chromium testé. Géolocalisation et caméra sont interdites. Aucun capteur ni demande d’autorisation n’est lancé ; cette interface de diagnostic n’est pas portable sur tous les navigateurs.

Exemples

<!doctype html><meta charset="utf-8">
<iframe id="frame" title="Restricted content" allow="geolocation 'none'; camera 'none'"
  srcdoc="<p>Local content</p>"></iframe>
<output id="result"></output>
<script>
document.querySelector('#frame').addEventListener('load', event => {
  const policy = event.target.contentDocument.featurePolicy;
  document.querySelector('#result').textContent =
    'geolocation=' + policy.allowsFeature('geolocation') +
    '; camera=' + policy.allowsFeature('camera');
});
</script>

Résultat

geolocation=false; camera=false

Le résultat vient de la politique du document de l’iframe, et pas seulement de la lecture de son attribut.

Sources