From 3cf9bd8b9901006085d4e0f353b0d3b6b8f69d93 Mon Sep 17 00:00:00 2001 From: julieng Date: Mon, 15 Nov 2021 21:45:15 +0100 Subject: convert content to md --- .../webextensions/api/runtime/onconnect/index.md | 114 ++++++++++----------- 1 file changed, 52 insertions(+), 62 deletions(-) (limited to 'files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect') diff --git a/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.md index d77c14c446..30b40610aa 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.md @@ -13,59 +13,52 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onConnect --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

Lancé quand une connexion est établie avec un processus d'extension ou un script de contenu.

+Lancé quand une connexion est établie avec un processus d'extension ou un script de contenu. -

Syntaxe

+## Syntaxe -
browser.runtime.onConnect.addListener(listener)
+```js
+browser.runtime.onConnect.addListener(listener)
 browser.runtime.onConnect.removeListener(listener)
 browser.runtime.onConnect.hasListener(listener)
-
+``` -

Les événements ont trois fonctions :

+Les événements ont trois fonctions : -
-
addListener(callback)
-
Ajoute un écouteur à cet événement.
-
removeListener(listener)
-
Arrêtez d'écouter cet événement. L'argument de l'écouteur est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifie si un écouteur est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.
-
+- `addListener(callback)` + - : Ajoute un écouteur à cet événement. +- `removeListener(listener)` + - : Arrêtez d'écouter cet événement. L'argument de l'`écouteur` est l'écouteur à supprimer. +- `hasListener(listener)` + - : Vérifie si un `écouteur` est enregistré pour cet événement. Renvoie `true` s'il écoute, sinon `false`. -

Syntaxe addListener

+## Syntaxe addListener -

Paramètres

+### Paramètres -
-
fonction
-
-

Une fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction recevra les arguments suivants:

+- `fonction` -
-
port
-
Un objet {{WebExtAPIRef('runtime.Port')}} connectant le script courant à l'autre contexte auquel il se connecte.
-
-
-
+ - : Une fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction recevra les arguments suivants: -

Compatibilité du navigateur

+ - `port` + - : Un objet {{WebExtAPIRef('runtime.Port')}} connectant le script courant à l'autre contexte auquel il se connecte. -

{{Compat("webextensions.api.runtime.onConnect")}}

+## Compatibilité du navigateur -

Exemples

+{{Compat("webextensions.api.runtime.onConnect")}} -

Ce script de contenu :

+## Exemples - +Ce script de contenu : -
// content-script.js
+- Se connecte au script d'arrière-plan et stocke le `Port` dans une variable `myPort`
+- Ecoute les messages sur `myPort`, et les enregistre
+- Envoie des messages au script d'arrière-plan, en utilisant `myPort`, lorsque l'utilisateur clique sur le document
+
+```js
+// content-script.js
 
 var myPort = browser.runtime.connect({name:"port-from-cs"});
 myPort.postMessage({greeting: "hello from content script"});
@@ -77,23 +70,22 @@ myPort.onMessage.addListener(function(m) {
 
 document.body.addEventListener("click", function() {
   myPort.postMessage({greeting: "they clicked the page!"});
-});
+}); +``` + +Le script d'arrière-plan correspondant : + +- Ecoute les tentatives de connexion de script de contenu +- Quand il reçoit une tentative de connexion : -

Le script d'arrière-plan correspondant :

+ - Stocke le port dans une variable nommée `portFromCS` + - Envoie un message au script de contenu en utilisant le port + - Commence à écouter les messages reçus sur le port et les enregistre - +- Envoie des messages au script de contenu, en utilisant `portFromCS`, quand l'utilisateur clique sur l'action du navigateur de l'extension -
// background-script.js
+```js
+// background-script.js
 
 var portFromCS;
 
@@ -110,19 +102,18 @@ browser.runtime.onConnect.addListener(connected);
 
 browser.browserAction.onClicked.addListener(function() {
   portFromCS.postMessage({greeting: "they clicked the button!"});
-});
- -

{{WebExtExamples}}

- -

Note :

+}); +``` -

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

+{{WebExtExamples}} -

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.

-
+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dérivée de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> 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