From 34d315396ca29d7ef51ecc27eeeeeb275e9b0ba9 Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Mon, 15 Nov 2021 19:39:07 +0100 Subject: Prepare Mozilla section for Markdown conversion (#2980) * Remove summary * Remove hidden except for copyright notice * Remove spans * Remove font * Remove notranslate * Remove extra id, deleting an untranslated page doing so * Fix links, absolute links, rm internal, titles * Remove external classes * fix headings with name attr * fix some styles and classes * remove useless class reference-values * rm styles in links * Fix code blocks in pre * Remove ltr classes * remove fullwidth-table * Fix various conversion errors and some one offs * Remove nested code/pre/code * Fix notes * Fix warnings * fix dls * fix nested issues in dls * fix images --- .../webextensions/api/runtime/onmessage/index.html | 28 +++++++++++----------- 1 file changed, 14 insertions(+), 14 deletions(-) (limited to 'files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html') diff --git a/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html index 8c2b3bd020..f946a74336 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html @@ -13,7 +13,7 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onMessage --- - +
{{AddonSidebar()}}

Utilisez cet événement pour écouter les messages d’une autre partie de votre extension.

@@ -28,8 +28,8 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onMessage

Pour envoyer un message reçu par l'écouteur onMessage, utilisez {{WebExtAPIRef("runtime.sendMessage()")}} ou (pour envoyer un message à un script de contenu) {{WebExtAPIRef("tabs.sendMessage()")}}.

-
-

Évitez de créer plusieurs écouteurs onMessage pour le même type de message, car l'ordre de déclenchement des différents écouteurs ne sera pas garanti.

+
+

Note : Évitez de créer plusieurs écouteurs onMessage pour le même type de message, car l'ordre de déclenchement des différents écouteurs ne sera pas garanti.

Lorsque vous voulez garantir la livraison d'un message à une terminaison spécifique, utilisez l'approche basée sur la connexion pour échanger des messages.

@@ -51,13 +51,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onMessage
-

Retourner une promesse (Promise) est désormais la méthode à privilégier car sendResponse() sera retirée de la spécification W3C.

+

Attention : Retourner une promesse (Promise) est désormais la méthode à privilégier car sendResponse() sera retirée de la spécification W3C.

-

La bibliothèque populaire webextension-polyfill a déjà supprimé cette fonction de son implémentation.

+

La bibliothèque populaire webextension-polyfill a déjà supprimé cette fonction de son implémentation.

-
-

Vous pouvez également utiliser une approche basée sur la connexion pour échanger des messages.

+
+

Note : Vous pouvez également utiliser une approche basée sur la connexion pour échanger des messages.

Syntaxe

@@ -87,17 +87,17 @@ browser.runtime.onMessage.hasListener(listener)

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

-
+
message
Un objet qui est le message lui-même. C’est un objet sérialisable (voir l'algorithme de clonage de données).
-
+
sender
Un objet {{WebExtAPIRef("runtime.MessageSender")}} représentant l’expéditeur du message.
-
+
sendResponse

Une fonction à appeler, au plus une fois, pour envoyer une réponse au message. La fonction prend un seul argument, qui peut être n'importe quel objet sérialisable (voir l'algorithme de clonage de données). Cet argument est renvoyé à l'expéditeur du message.

@@ -117,8 +117,8 @@ browser.runtime.onMessage.hasListener(listener)

La fonction listener peut renvoyer un booléen ou une {{jsxref("Promise")}}.

-
-

Important: N'appelez pas addListener() en utilisant une fonction async :

+
+

Note : N'appelez pas addListener() en utilisant une fonction async :

// ne faites pas ça
 browser.runtime.onMessage.addListener(
@@ -165,7 +165,7 @@ function notifyExtension(e) {
   browser.runtime.sendMessage({"url": e.target.href});
 }
-

Le script d’arrière-plan écoute ces messages et affiche une notification à l’aide de l’API notifications.

+

Le script d’arrière-plan écoute ces messages et affiche une notification à l’aide de l’API notifications.

// background-script.js
 
@@ -287,7 +287,7 @@ browser.runtime.onMessage.addListener(handleMessage);

{{WebExtExamples}}

-
Remerciements  +

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.

-- cgit v1.2.3-54-g00ecf