FeaturePolicy.getAllowlistForFeature()

Experimental

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

La méthode getAllowlistForFeature() de FeaturePolicy permet d'obtenir la liste des permissions associée à une fonctionnalité pour ce Feature Policy.

Syntaxe

const listePermissions = FeaturePolicy.getAllowlistForFeature(<fonctionnalité>)

Parameter

Nom de fonctionnalité

Un nom de fonctionnalité doit être fourni.

Valeur de retour

Une liste de permissions pour la fonctionnalité demandée est retournée.

Erreurs

La fonction jettera un avertissement si la directive de Feature Policy demandée est inconnue. Toutefois, elle retournera aussi un tableau vide, indiquant que l'utilisation de cette fonctionnalité n'est permise pour aucune origine.

Exemple

Cet exemple affiche toutes les origines à qui la directive Feature Policy permet d'utiliser l'API Camera (appareil photo). Notez que l'API Camera pourrait être restreinte par l'API Permissions si l'utilisateur n'a pas encore accordé la permission.

// D'abord, récupère l'objet Feature Policy
const featurePolicy = document.featurePolicy

// Puis demande la liste pour la fonctionnalité "camera"
const listePermissions = featurePolicy.getAllowlistForFeature("camera")

for (const origine of listePermissions)
  console.log(origine)

Spécification

Spécification Statut Commentaire
Permissions Policy
La définition de 'getAllowlistForFeature' dans cette spécification.
Brouillon de l'éditeur Définition initiale.

Compatibilité des navigateurs

BCD tables only load in the browser