From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../api/featurepolicy/allowedfeatures/index.html | 64 ++++++++++++++++++ .../web/api/featurepolicy/allowsfeature/index.html | 76 ++++++++++++++++++++++ files/fr/web/api/featurepolicy/features/index.html | 64 ++++++++++++++++++ .../getallowlistforfeature/index.html | 69 ++++++++++++++++++++ files/fr/web/api/featurepolicy/index.html | 68 +++++++++++++++++++ 5 files changed, 341 insertions(+) create mode 100644 files/fr/web/api/featurepolicy/allowedfeatures/index.html create mode 100644 files/fr/web/api/featurepolicy/allowsfeature/index.html create mode 100644 files/fr/web/api/featurepolicy/features/index.html create mode 100644 files/fr/web/api/featurepolicy/getallowlistforfeature/index.html create mode 100644 files/fr/web/api/featurepolicy/index.html (limited to 'files/fr/web/api/featurepolicy') 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 +--- +

{{APIRef("Feature Policy API")}}{{SeeCompatTable}}

+ +

La méthode allowedFeatures() 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 allowedFeatures() retourne un sous-ensemble de la liste des noms de directives retournée par {{DOMxRef("FeaturePolicy.features", "features()")}}.

+ +

Syntaxe

+ +
const permissions = FeaturePolicy.allowedFeatures()
+
+ +

Paramètres

+ +

Aucun.

+ +

Valeur de retour

+ +

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.

+ +

Exemple

+ +

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.

+ +
// 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)
+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("Feature Policy","","allowsFeature")}}{{Spec2("Feature Policy")}}Initial definition.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.FeaturePolicy.allowedFeatures")}}

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 +--- +
{{APIRef("Feature Policy API")}}{{SeeCompatTable}}
+ +

La méthode allowsFeature() 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 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 {{Optional_inline}}

+ +

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 {{JSxRef("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écificationStatutCommentaire
{{SpecName("Feature Policy","","allowsFeature")}}{{Spec2("Feature Policy")}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.FeaturePolicy.allowsFeature")}}

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 +--- +
{{APIRef("Feature Policy API")}}{{SeeCompatTable}}
+ +

La méthode features() 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.

+ +

Syntaxe

+ +
const fonctionnalitésSupportées = FeaturePolicy.features()
+
+ +

Paramètres

+ +

Aucun.

+ +

Valeur de retour

+ +

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.

+ +

Exemple

+ +

Cet exemple affiche dans la console toutes les directives supportées par votre agent utilisateur :

+ +
// 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)
+
+ +

Spécification

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("Feature Policy","","features")}}{{Spec2("Feature Policy")}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.FeaturePolicy.features")}}

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 +--- +
{{APIRef("Feature Policy API")}}{{SeeCompatTable}}
+ +

La méthode getAllowlistForFeature() de {{DOMxRef("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écificationStatutCommentaire
{{SpecName("Feature Policy","","getAllowlistForFeature")}}{{Spec2("Feature Policy")}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.FeaturePolicy.getAllowlistForFeature")}}

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 +--- +

{{APIRef("Feature Policy")}}

+ +

L'interface FeaturePolicy de l'API Feature Policy représente l'ensemble des règles appliquées au contexte d'exécution courant.

+ +

Méthodes de FeaturePolicy

+ +
+
{{DOMxRef("FeaturePolicy.allowsFeature")}}
+
Retourne un Boolean indiquant si une fonctionnalité particulière est activée ou non dans le contexte spécifié.
+
{{DOMxRef("FeaturePolicy.features")}}
+
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.
+
{{DOMxRef("FeaturePolicy.allowedFeatures")}}
+
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.
+
+ +
+
{{DOMxRef("FeaturePolicy.getAllowlistForFeature")}}
+
Retourne la liste de permissions pour la fonctionnalité spécifiée.
+
+ +

Spécification

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("Feature Policy")}}{{Spec2("Feature Policy")}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.FeaturePolicy")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf