From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../webextensions/api/events/event/index.html | 87 +++++++++++++ .../add-ons/webextensions/api/events/index.html | 72 +++++++++++ .../webextensions/api/events/rule/index.html | 81 ++++++++++++ .../webextensions/api/events/urlfilter/index.html | 142 +++++++++++++++++++++ 4 files changed, 382 insertions(+) create mode 100644 files/fr/mozilla/add-ons/webextensions/api/events/event/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/events/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/events/rule/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/events/urlfilter/index.html (limited to 'files/fr/mozilla/add-ons/webextensions/api/events') diff --git a/files/fr/mozilla/add-ons/webextensions/api/events/event/index.html b/files/fr/mozilla/add-ons/webextensions/api/events/event/index.html new file mode 100644 index 0000000000..7e535f112b --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/events/event/index.html @@ -0,0 +1,87 @@ +--- +title: events.Event +slug: Mozilla/Add-ons/WebExtensions/API/events/Event +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - events +translation_of: Mozilla/Add-ons/WebExtensions/API/events/Event +--- +
{{AddonSidebar()}}
+ +

Un objet qui permet l'ajout et la suppression d'écouteurs pour un événement de navigateur.

+ +

Type

+ +

Les valeurs de ce type sont des objets.

+ +

Méthodes

+ +
+
{{WebExtAPIRef("events.Event.addListener()")}}
+
Enregistre un rappel d'écouteur d'événement sur un événement.
+
{{WebExtAPIRef("events.Event.removeListener()")}}
+
Désinscrit un rappel d'écouteur d'événement d'un événement.
+
{{WebExtAPIRef("events.Event.hasListener()")}}
+
Teste l'état d'enregistrement d'un écouteur.
+
{{WebExtAPIRef("events.Event.hasListeners()")}}
+
Teste si des écouteurs sont enregistrés pour l'événement.
+
{{WebExtAPIRef("events.Event.addRules()")}}
+
Enregistre les règles pour gérer les événements.
+
{{WebExtAPIRef("events.Event.getRules()")}}
+
Renvoie les règles actuellement enregistrées.
+
{{WebExtAPIRef("events.Event.removeRules()")}}
+
Annule l'inscription des règles actuellement enregistrées.
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.events.Event")}}

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.events. Cette documentation est dérivée de events.json dans le code Chromium.

+ +

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/events/index.html b/files/fr/mozilla/add-ons/webextensions/api/events/index.html new file mode 100644 index 0000000000..0f5e711402 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/events/index.html @@ -0,0 +1,72 @@ +--- +title: events +slug: Mozilla/Add-ons/WebExtensions/API/events +tags: + - API + - Add-ons + - Extensions + - Interface + - Non-standard + - Reference + - WebExtensions + - events +translation_of: Mozilla/Add-ons/WebExtensions/API/events +--- +
{{AddonSidebar}}
+ +

Types communs utilisés par les API qui distribuent les événements.

+ +

Types

+ +
+
{{WebExtAPIRef("events.Rule")}}
+
Description d'une règle déclarative pour gérer les événements.
+
{{WebExtAPIRef("events.Event")}}
+
Un objet qui permet l'ajout et la suppression d'écouteurs pour un événement Chrome.
+
{{WebExtAPIRef("events.UrlFilter")}}
+
Filtre les URL pour différents critères. Si un critère donné correspond, alors tout le filtre correspond.
+
+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.events")}}

+ +

{{WebExtExamples("h2")}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.events. Cette documentation est dérivée de events.json dans le code Chromium.

+ +

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/events/rule/index.html b/files/fr/mozilla/add-ons/webextensions/api/events/rule/index.html new file mode 100644 index 0000000000..84e0066e51 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/events/rule/index.html @@ -0,0 +1,81 @@ +--- +title: events.Rule +slug: Mozilla/Add-ons/WebExtensions/API/events/Rule +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - Rule + - Type + - WebExtensions + - events +translation_of: Mozilla/Add-ons/WebExtensions/API/events/Rule +--- +

{{AddonSidebar()}}

+ +

Description d'une règle déclarative pour la gestion des événements.

+ +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

+ +
+
id{{optional_inline}}
+
string. Identifiant facultatif permettant de référencer cette règle.
+
tags{{optional_inline}}
+
array of string. Les balises peuvent être utilisées pour annoter des règles et effectuer des opérations sur des ensembles de règles.
+
conditions
+
array de any. Liste des conditions qui peuvent déclencher les actions.
+
actions
+
array de any. Liste des actions qui sont déclenchées si l'une des conditions est remplie.
+
priority{{optional_inline}}
+
integer. Priorité optionnelle de cette règle. Par défaut à 100.
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.events.Rule")}}

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.events. Cette documentation est dérivée de events.json dans le code Chromium.

+ +

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/events/urlfilter/index.html b/files/fr/mozilla/add-ons/webextensions/api/events/urlfilter/index.html new file mode 100644 index 0000000000..0f77415edc --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/events/urlfilter/index.html @@ -0,0 +1,142 @@ +--- +title: events.UrlFilter +slug: Mozilla/Add-ons/WebExtensions/API/events/UrlFilter +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - Type + - UrlFilter + - WebExtensions + - events +translation_of: Mozilla/Add-ons/WebExtensions/API/events/UrlFilter +--- +
{{AddonSidebar()}}
+ +

Décrit différents critères de filtrage des URL. Si tous les critères spécifiés dans les propriétés du filtre correspondent à l'URL, le filtre correspond. Les filtres sont souvent fournis aux méthodes API dans un Array d'UrlFilters. Par exemple, les écouteurs  webNavigation peuvent être ajoutés avec un filtre qui est un objet avec une seule propriété url qui est un Array de UrlFilters, par exemple {url:[UrlFilter,UrlFilter,...]}. Si un filtre dans le tableau de UrlFilters correspond, il est considéré comme une correspondance pour le tableau. En effet, les critères spécifiés dans un seul filtre sont associés ensemble, alors que tous les filtres individuels dans un tableau sont où.

+ +

Tous les critères sont sensibles à la casse.

+ +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes:

+ +

Toutefois, notez que ces deux derniers modèles ne correspondent pas au dernier composant du nom d'hôte, car aucun point implicite n'est ajouté à la fin du nom d'hôte. Ainsi, par exemple, "org." correspondra à "https://borg.com" mais pas "https://example.org". Pour faire correspondre ces modèles, utilisez hostSuffix.

+ +
+
hostContains{{optional_inline}}
+
string. Correspond si le hostname de l'URL contient la chaîne donnée. +
    +
  • Pour tester si un composant de nom d'hôte commence par "foo", utilisez  ".foo". Cela correspond à "www.foobar.com" et "foo.com", car un point implicite est ajouté au début du nom d'hôte.
    • +
  • Pour tester si un composant de nom d'hôte se termine par "foo", utilisez "foo.".
    • +
  • Pour tester si un composant de nom d'hôte correspond exactement à "foo", utilisez ".foo.".
    • +
+
+
hostEquals{{optional_inline}}
+
string. Correspond si le nom d'hôte de l'URL est égal à une chaîne spécifiée.
+
hostPrefix{{optional_inline}}
+
string. Correspond si le nom d'hôte de l'URL commence par une chaîne spécifiée.
+
hostSuffix{{optional_inline}}
+
string. Correspond si le nom d'hôte de l'URL se termine par une chaîne spécifiée. +
    +
  • Exemple: ".example.com" correspond à "http://www.example.com/", mais pas à "http://example.com/".
    • +
  • Exemple: "example.com" correspond à "http://www.example.com/", et  "http://fakeexample.com/".
    • +
+
+
pathContains{{optional_inline}}
+
string. Correspond si le segment de chemin de l'URL contient une chaîne spécifiée.
+
pathEquals{{optional_inline}}
+
string. Correspond si le segment de chemin de l'URL est égal à une chaîne spécifiée.
+
pathPrefix{{optional_inline}}
+
string. Correspond si le segment de chemin de l'URL commence par une chaîne spécifiée.
+
pathSuffix{{optional_inline}}
+
string. Correspond si le segment de chemin de l'URL se termine par une chaîne spécifiée.
+
queryContains{{optional_inline}}
+
string. Correspond si le segment de requête de l'URL contient une chaîne spécifiée.
+
queryEquals{{optional_inline}}
+
string. Correspond si le segment de requête de l'URL est égal à une chaîne spécifiée.
+
queryPrefix{{optional_inline}}
+
string. Correspond si le segment de requête de l'URL commence par une chaîne spécifiée.
+
querySuffix{{optional_inline}}
+
string. Correspond si le segment de requête de l'URL se termine par une chaîne spécifiée.
+
urlContains{{optional_inline}}
+
string. Correspond si l'URL (sans identificateur de fragment) contient une chaîne spécifiée. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut.
+
urlEquals{{optional_inline}}
+
string. Correspond si l'URL (sans l'identificateur de fragment) est égale à une chaîne spécifiée. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut.
+
urlMatches{{optional_inline}}
+
string. Correspond si l'URL (sans l'identificateur de fragment) correspond à une  expression régulière. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut. +
    +
  • Par exemple : urlMatches: "^[^:]*:(?://)?(?:[^/]*\\.)?mozilla\\.org/.*$" correspond "http://mozilla.org/", "https://developer.mozilla.org/", "ftp://foo.mozilla.org/", mais pas "https://developer.fakemozilla.org/".
    • +
+
+
originAndPathMatches{{optional_inline}}
+
string. Correspond si l'URL sans segment de requête et l'identificateur de fragment correspondent à une expression régulière spécifiée. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut.
+
urlPrefix{{optional_inline}}
+
string. Correspond si l'URL (sans l'identificateur de fragment) commence par une chaîne spécifiée. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut. +
    +
  • Exemple: "https://developer" correspond "https://developer.mozilla.org/" et  "https://developers.facebook.com/".
    • +
+
+
urlSuffix{{optional_inline}}
+
string. Correspond si l'URL (sans l'identificateur de fragment) se termine par une chaîne spécifiée. Les numéros de port sont supprimés de l'URL s'ils correspondent au numéro de port par défaut. Notez qu'un slash "/" implicite est ajoutée après l'hôte, donc "com/" correspond "https://example.com", mais pas "com".
+
schemas{{optional_inline}}
+
array of string. Correspond si le schéma de l'URL est identique à l'un des schémas spécifiés dans le tableau. Comme les schémas sont toujours convertis en minuscules, ils doivent toujours être en minuscules ou ne correspondent jamais. +
    +
  • Exemple: ["https"] correspond uniquement aux URL HTTPS.
    • +
+
+
ports{{optional_inline}}
+
array de (integer ou array of integer). Un tableau qui peut contenir des entiers et des tableaux d'entiers. Les entiers sont interprétés comme des numéros de port, tandis que les tableaux d'entiers sont interprétés comme des plages de ports. Correspond si le port de l'URL correspond à un numéro de port ou est contenu dans des plages. +
    +
  • Par exemple: [80, 443, [1000, 1200]] correspond à toutes les demandes sur les ports 80, 443, et dans la plage 1000-1200.
    • +
+
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.events.UrlFilter")}}

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.events. Cette documentation est dérivée de events.json dans le code Chromium.

+ +

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

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