diff options
Diffstat (limited to 'files/fr/web/api/featurepolicy/allowsfeature/index.md')
-rw-r--r-- | files/fr/web/api/featurepolicy/allowsfeature/index.md | 76 |
1 files changed, 76 insertions, 0 deletions
diff --git a/files/fr/web/api/featurepolicy/allowsfeature/index.md b/files/fr/web/api/featurepolicy/allowsfeature/index.md new file mode 100644 index 0000000000..52eae7a58d --- /dev/null +++ b/files/fr/web/api/featurepolicy/allowsfeature/index.md @@ -0,0 +1,76 @@ +--- +title: FeaturePolicy.allowsFeature() +slug: Web/API/FeaturePolicy/allowsFeature +tags: + - API + - Feature Policy + - Feature-Policy + - Reference +translation_of: Web/API/FeaturePolicy/allowsFeature +--- +<div>{{APIRef("Feature Policy API")}}{{SeeCompatTable}}</div> + +<p>La méthode <strong><code>allowsFeature()</code></strong> de l'interface {{DOMxRef("FeaturePolicy")}} permet l'introspection de directives du Feature Policy sur lequel la méthode est appelée. Elle retourne un {{JSxRef("Boolean")}} valant <code>true</code> 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é).</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox">const listePermissions = <em>FeaturePolicy</em>.allowsFeature(<nomDirective>) +</pre> + +<p>ou</p> + +<pre class="syntaxbox">const listePermissions = <em>FeaturePolicy</em>.allowsFeature(<nomDirective>, <origine>)</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<h4 id="Nom_de_directive"><code>Nom de directive</code></h4> + +<p>Le nom de la directive associée à une fonctionnalité.</p> + +<h4 id="Origine_Optional_inline"><code>Origine</code> {{Optional_inline}}</h4> + +<p>Une URL d'origine sur lequel vérifier la disponibilité de la fonctionnalité. Si omise, sa valeur par défaut est utilisée.</p> + +<h3 id="Valeur_de_retour">Valeur de retour</h3> + +<p>Un {{JSxRef("Boolean")}} valant <code>true</code> si et seulement si la fonctionnalité est permise.</p> + +<h2 id="Exemple">Exemple</h2> + +<p>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.</p> + +<pre class="brush: js">// 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.") +</pre> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Statut</th> + <th scope="col">Commentaire</th> + </tr> + <tr> + <td>{{SpecName("Feature Policy","","allowsFeature")}}</td> + <td>{{Spec2("Feature Policy")}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.FeaturePolicy.allowsFeature")}}</p> |