FeaturePolicy.allowsFeature()

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 allowsFeature() de l'interface FeaturePolicy permet l'introspection de directives du Feature Policy sur lequel la méthode est appelée. Elle retourne un Boolean valant true si et seulement si la fonctionnalité dont le nom de directive est fourni est permise dans le contexte spécifié (ou le contexte par défaut si aucun contexte n'est spécifié).

Syntaxe

const listePermissions = FeaturePolicy.allowsFeature(<nomDirective>)

ou

const listePermissions = FeaturePolicy.allowsFeature(<nomDirective>, <origine>)

Paramètres

Nom de directive

Le nom de la directive associée à une fonctionnalité.

Origine Facultatif

Une URL d'origine sur lequel vérifier la disponibilité de la fonctionnalité. Si omise, sa valeur par défaut est utilisée.

Valeur de retour

Un Boolean valant true si et seulement si la fonctionnalité est permise.

Exemple

Cet exemple demande au document s'il lui est permis par Feature Policy 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 le Feature Policy
const featurePolicy = document.featurePolicy

// Demande si la fonctionnalité est disponible
const estPermise = featurePolicy.allowsFeature("camera")

if (estPermise)
  console.log("FP autorise l'appareil photo.")

else
  console.log("FP n'autorise pas l'appareil photo.")

Spécifications

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

Compatibilité des navigateurs

BCD tables only load in the browser