Permissions-Policy : directive fullscreen

Disponibilit limite

Cette fonctionnalit n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utiliss.

Vous voulez une meilleure prise en charge pour cette fonctionnalit ? Dites-nous pourquoi.

En savoir plus
Voir la compatibilit complte

Exprimental: Il s'agit d'une technologie exprimentale.
Vrifiez attentivement le tableau de compatibilit des navigateurs avant de l'utiliser en production.

L'en-tte HTTP Permissions-Policy avec la directive fullscreen contrle si le document actuel est autoris utiliser Element.requestFullscreen().

Plus prcisment, lorsqu'une politique dfinie bloque l'utilisation de cette fonctionnalit, les appels requestFullscreen() retournent une promesse (Promise) qui sera rejete avec une TypeError.

Note : Si cette directive (c'est--dire avec l'attribut allow) et l'attribut allowfullscreen sont prsents sur un lment <iframe>, cette directive prend le pas.

Syntaxe

http

Permissions-Policy: fullscreen=<allowlist>;

<allowlist>: Une liste d'origines pour lesquelles l'autorisation est accorde pour utiliser la fonctionnalit. Voir Permissions-Policy > Syntaxe pour plus de dtails.

La liste d'autorisation par dfaut pour fullscreen est self. Le contexte de navigation de niveau suprieur et les cadres intgrs de mme origine sont autoriss accder la fonctionnalit fullscreen par dfaut.

Exemples

Utilisation simple

SecureCorp Inc. souhaite interdire fullscreen dans tous les cadres intgrs inter-origines, sauf ceux dont l'origine est https://example.com. Elle peut le faire en envoyant l'en-tte de rponse HTTP suivant pour dfinir une politique de permissions :

http

Permissions-Policy: fullscreen=(self "https://example.com")

SecureCorp Inc. doit galement inclure un attribut allow sur chaque lment <iframe> o fullscreen doit tre autoris :

html

<iframe src="https://example.com/presentation" allow="fullscreen"></iframe>

Note : Dfinir l'en-tte Permissions-Policy de cette manire interdit fullscreen pour d'autres origines, mme si elles sont autorises par l'attribut allow de l'lment <iframe>.

Utiliser la rgle par dfaut

Si une liste d'autorisation pour fullscreen n'est pas dfinie par un en-tte de rponse Permissions-Policy, les agents utilisateurs appliqueront la liste d'autorisation par dfaut self. Dans ce mode, fullscreen est automatiquement autoris dans le contexte de navigation de niveau suprieur et les cadres intgrs de mme origine, mais pas dans les cadres inter-origines.

Pour autoriser fullscreen dans un cadre inter-origines, incluez un attribut allow sur l'lment <iframe> :

html

<iframe src="https://autre.com/videoplayer" allow="fullscreen"></iframe>

Spcifications

Spcification
Fullscreen API # permissions-policy-integration

Compatibilit des navigateurs

Voir aussi

L'en-tte Permissions-Policy
Politique de permissions

Aider amliorer MDN

Cette page vous a-t-elle t utile ?

Oui Non

Apprendre contribuer

Cette page a t modifie le 8 juil. 2026 par les contributeurices du MDN.

Voir cette page sur GitHub Signaler un problme avec ce contenu