diff options
Diffstat (limited to 'files/fr/web/api/featurepolicy')
5 files changed, 341 insertions, 0 deletions
diff --git a/files/fr/web/api/featurepolicy/allowedfeatures/index.html b/files/fr/web/api/featurepolicy/allowedfeatures/index.html new file mode 100644 index 0000000000..d4f42561b8 --- /dev/null +++ b/files/fr/web/api/featurepolicy/allowedfeatures/index.html @@ -0,0 +1,64 @@ +--- +title: FeaturePolicy.allowedFeatures() +slug: Web/API/FeaturePolicy/allowedFeatures +tags: + - API + - Directive + - Feature Policy + - Feature-Policy + - Reference +translation_of: Web/API/FeaturePolicy/allowedFeatures +--- +<p>{{APIRef("Feature Policy API")}}{{SeeCompatTable}}</p> + +<p><span class="seoSummary">La méthode <strong><code>allowedFeatures()</code></strong> de l'interface {{DOMxRef("FeaturePolicy")}} retourne la liste des noms des directives de fonctionnalités permises par ce Feature Policy. Elle permet l'introspection de directives spécifiques du Feature Policy sur lequel la méthode est appelée. Ainsi, la méthode <code>allowedFeatures()</code> retourne un sous-ensemble de la liste des noms de directives retournée par {{DOMxRef("FeaturePolicy.features", "features()")}}.</span></p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox notranslate">const permissions = <em>FeaturePolicy</em>.allowedFeatures() +</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<p id="Feature_name">Aucun.</p> + +<h3 id="Valeur_de_retour">Valeur de retour</h3> + +<p>Un tableau de chaines de caractères représentant les noms des directives Feature Policy dont l'utilisation de la fonctionnalité associée est permise par le Feature Policy sur laquel est appelée cette méthode.</p> + +<h2 id="Exemple">Exemple</h2> + +<p>L'exemple suivant affiche toutes les directives permises pour le présent document. Notez que ces fonctionnalités pourraient être restreintes par l'API Permissions, si l'utilisateur n'a pas encore accordé les droits correspondants.</p> + +<pre class="brush: js notranslate">// D'abord, récupère l'objet Feature Policy +const featurePolicy = document.featurePolicy + +// Puis demande la liste des foncitonnalités permises +const permissions = featurePolicy.allowedFeatures() + +for (const directive of permissions) + console.log(directive) +</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>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.FeaturePolicy.allowedFeatures")}}</p> diff --git a/files/fr/web/api/featurepolicy/allowsfeature/index.html b/files/fr/web/api/featurepolicy/allowsfeature/index.html new file mode 100644 index 0000000000..508e15dbb8 --- /dev/null +++ b/files/fr/web/api/featurepolicy/allowsfeature/index.html @@ -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><span class="seoSummary">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é).</span></p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox notranslate">const listePermissions = <em>FeaturePolicy</em>.allowsFeature(<nomDirective>) +</pre> + +<p>ou</p> + +<pre class="syntaxbox notranslate">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 notranslate">// 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> diff --git a/files/fr/web/api/featurepolicy/features/index.html b/files/fr/web/api/featurepolicy/features/index.html new file mode 100644 index 0000000000..c4061ce3a5 --- /dev/null +++ b/files/fr/web/api/featurepolicy/features/index.html @@ -0,0 +1,64 @@ +--- +title: FeaturePolicy.features() +slug: Web/API/FeaturePolicy/features +tags: + - API + - Feature Policy + - Feature-Policy + - Reference +translation_of: Web/API/FeaturePolicy/features +--- +<div>{{APIRef("Feature Policy API")}}{{SeeCompatTable}}</div> + +<p><span class="seoSummary">La méthode <strong><code>features()</code></strong> de l'interface {{DOMxRef("FeaturePolicy")}} retourne la liste des noms de directives de fonctionnalités supportées par l'agent utilisateur. Une fonctionnalité dont le nom apparait dans la liste pourrait n'être pas autorisée par le Feature Policy du contexte courant d'exécution ou n'être pas accessible à cause des permissions de l'utilisateur.</span></p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox notranslate">const fonctionnalitésSupportées = <em>FeaturePolicy</em>.features() +</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<p>Aucun.</p> + +<h3 id="Valeur_de_retour">Valeur de retour</h3> + +<p>Un tableau de chaines de caractères représentant les noms des directives Feature Policy dont la fonctionnalité associée est supportée par l'agent utilisateur.</p> + +<h2 id="Exemple">Exemple</h2> + +<p>Cet exemple affiche dans la console toutes les directives supportées par votre agent utilisateur :</p> + +<pre class="brush: js notranslate">// Récupère l'objet Feature Policy +const featurePolicy = document.featurePolicy + +// Récupère la liste des noms de directives de Feature Policy dont les fonctionnalités sont supportées +const fonctionnalitésSupportées = featurePolicy.features() + +// Affiche chaque directive dans la console +for (const directive of fonctionnalitésSupportées) + console.log(directive) +</pre> + +<h2 id="Spécification">Spécification</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","","features")}}</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.features")}}</p> diff --git a/files/fr/web/api/featurepolicy/getallowlistforfeature/index.html b/files/fr/web/api/featurepolicy/getallowlistforfeature/index.html new file mode 100644 index 0000000000..2134dfc1ae --- /dev/null +++ b/files/fr/web/api/featurepolicy/getallowlistforfeature/index.html @@ -0,0 +1,69 @@ +--- +title: FeaturePolicy.getAllowlistForFeature() +slug: Web/API/FeaturePolicy/getAllowlistForFeature +tags: + - API + - Feature Policy + - Feature-Policy + - Reference +translation_of: Web/API/FeaturePolicy/getAllowlistForFeature +--- +<div>{{APIRef("Feature Policy API")}}{{SeeCompatTable}}</div> + +<p><span class="seoSummary">La méthode <strong><code>getAllowlistForFeature()</code></strong> de {{DOMxRef("FeaturePolicy")}} permet d'obtenir la liste des permissions associée à une fonctionnalité pour ce Feature Policy.</span></p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox notranslate">const listePermissions = <em>FeaturePolicy</em>.getAllowlistForFeature(<fonctionnalité>) +</pre> + +<h3 id="Parameter">Parameter</h3> + +<h4 id="Nom_de_fonctionnalité">Nom de fonctionnalité</h4> + +<p>Un nom de fonctionnalité doit être fourni.</p> + +<h3 id="Valeur_de_retour">Valeur de retour</h3> + +<p>Une <a href="fr/Web/HTTP/Feature_Policy/Using_Feature_Policy">liste de permissions</a> pour la fonctionnalité demandée est retournée.</p> + +<h2 id="Erreurs">Erreurs</h2> + +<p>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.</p> + +<h2 id="Exemple">Exemple</h2> + +<p>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.</p> + +<pre class="brush: js notranslate">// 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) +</pre> + +<h2 id="Spécification">Spécification</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","","getAllowlistForFeature")}}</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.getAllowlistForFeature")}}</p> diff --git a/files/fr/web/api/featurepolicy/index.html b/files/fr/web/api/featurepolicy/index.html new file mode 100644 index 0000000000..e63c2d60af --- /dev/null +++ b/files/fr/web/api/featurepolicy/index.html @@ -0,0 +1,68 @@ +--- +title: FeaturePolicy +slug: Web/API/FeaturePolicy +tags: + - API + - Feature Policy + - Feature-Policy + - FeaturePolicy + - Interface + - Permissions + - Privileges + - Reference + - access + - accès + - delegation +translation_of: Web/API/FeaturePolicy +--- +<p>{{APIRef("Feature Policy")}}</p> + +<p>L'interface <code>FeaturePolicy</code> de l'<a href="/en-US/docs/Web/HTTP/Feature_Policy">API Feature Policy</a> représente l'ensemble des règles appliquées au contexte d'exécution courant.</p> + +<h2 id="Méthodes_de_FeaturePolicy">Méthodes de FeaturePolicy</h2> + +<dl> + <dt>{{DOMxRef("FeaturePolicy.allowsFeature")}}</dt> + <dd>Retourne un Boolean indiquant si une fonctionnalité particulière est activée ou non dans le contexte spécifié.</dd> + <dt>{{DOMxRef("FeaturePolicy.features")}}</dt> + <dd>Retourne une liste des noms de toutes les fonctionnalités supportées par l'agent utilisateur. Une fonctionnalité dont le nom est dans la liste pourrait ne pas être autorisée par le Feature Policy du contexte courant d'exécution ou n'être pas accessible à cause des permissions de l'utilisateur.</dd> + <dt>{{DOMxRef("FeaturePolicy.allowedFeatures")}}</dt> + <dd>Retourne une liste des noms des fonctionnalités supportées par l'agent utilisateur et autorisées par le Feature Policy. Notee que les fonctionnaltiés dont le nom est dans la liste pourraient toujours être bloquées par l'absence de permission de l'utilisateur.</dd> +</dl> + +<dl> + <dt>{{DOMxRef("FeaturePolicy.getAllowlistForFeature")}}</dt> + <dd>Retourne la liste de permissions pour la fonctionnalité spécifiée.</dd> +</dl> + +<h2 id="Spécification">Spécification</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Statut</th> + <th scope="col">Commentaire</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName("Feature Policy")}}</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")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{HTTPHeader("Feature-Policy")}}</li> + <li><a href="/en-US/docs/Web/Privacy">Anonymat et vie privée, permissions et informations sur la sécurité</a></li> +</ul> |