From f36cc6a7639a8f1adff02bc7a152bd7f54ceae6d Mon Sep 17 00:00:00 2001 From: julieng Date: Mon, 15 Nov 2021 21:45:09 +0100 Subject: move *.html to *.md --- .../webextensions/api/runtime/connect/index.html | 158 ---------- .../webextensions/api/runtime/connect/index.md | 158 ++++++++++ .../api/runtime/connectnative/index.html | 120 -------- .../api/runtime/connectnative/index.md | 120 ++++++++ .../api/runtime/getbackgroundpage/index.html | 110 ------- .../api/runtime/getbackgroundpage/index.md | 110 +++++++ .../api/runtime/getbrowserinfo/index.html | 63 ---- .../api/runtime/getbrowserinfo/index.md | 63 ++++ .../api/runtime/getmanifest/index.html | 84 ------ .../webextensions/api/runtime/getmanifest/index.md | 84 ++++++ .../runtime/getpackagedirectoryentry/index.html | 86 ------ .../api/runtime/getpackagedirectoryentry/index.md | 86 ++++++ .../api/runtime/getplatforminfo/index.html | 88 ------ .../api/runtime/getplatforminfo/index.md | 88 ++++++ .../webextensions/api/runtime/geturl/index.html | 95 ------ .../webextensions/api/runtime/geturl/index.md | 95 ++++++ .../webextensions/api/runtime/id/index.html | 68 ----- .../add-ons/webextensions/api/runtime/id/index.md | 68 +++++ .../add-ons/webextensions/api/runtime/index.html | 171 ----------- .../add-ons/webextensions/api/runtime/index.md | 171 +++++++++++ .../webextensions/api/runtime/lasterror/index.html | 122 -------- .../webextensions/api/runtime/lasterror/index.md | 122 ++++++++ .../api/runtime/messagesender/index.html | 81 ----- .../api/runtime/messagesender/index.md | 81 +++++ .../runtime/onbrowserupdateavailable/index.html | 101 ------- .../api/runtime/onbrowserupdateavailable/index.md | 101 +++++++ .../webextensions/api/runtime/onconnect/index.html | 153 ---------- .../webextensions/api/runtime/onconnect/index.md | 153 ++++++++++ .../api/runtime/onconnectexternal/index.html | 138 --------- .../api/runtime/onconnectexternal/index.md | 138 +++++++++ .../api/runtime/oninstalled/index.html | 122 -------- .../webextensions/api/runtime/oninstalled/index.md | 122 ++++++++ .../api/runtime/oninstalledreason/index.html | 77 ----- .../api/runtime/oninstalledreason/index.md | 77 +++++ .../webextensions/api/runtime/onmessage/index.html | 326 --------------------- .../webextensions/api/runtime/onmessage/index.md | 326 +++++++++++++++++++++ .../api/runtime/onmessageexternal/index.html | 155 ---------- .../api/runtime/onmessageexternal/index.md | 155 ++++++++++ .../api/runtime/onrestartrequired/index.html | 98 ------- .../api/runtime/onrestartrequired/index.md | 98 +++++++ .../api/runtime/onrestartrequiredreason/index.html | 72 ----- .../api/runtime/onrestartrequiredreason/index.md | 72 +++++ .../webextensions/api/runtime/onstartup/index.html | 98 ------- .../webextensions/api/runtime/onstartup/index.md | 98 +++++++ .../webextensions/api/runtime/onsuspend/index.html | 106 ------- .../webextensions/api/runtime/onsuspend/index.md | 106 +++++++ .../api/runtime/onsuspendcanceled/index.html | 101 ------- .../api/runtime/onsuspendcanceled/index.md | 101 +++++++ .../api/runtime/onupdateavailable/index.html | 114 ------- .../api/runtime/onupdateavailable/index.md | 114 +++++++ .../api/runtime/openoptionspage/index.html | 84 ------ .../api/runtime/openoptionspage/index.md | 84 ++++++ .../api/runtime/platformarch/index.html | 75 ----- .../api/runtime/platformarch/index.md | 75 +++++ .../api/runtime/platforminfo/index.html | 75 ----- .../api/runtime/platforminfo/index.md | 75 +++++ .../api/runtime/platformnaclarch/index.html | 66 ----- .../api/runtime/platformnaclarch/index.md | 66 +++++ .../api/runtime/platformos/index.html | 81 ----- .../webextensions/api/runtime/platformos/index.md | 81 +++++ .../webextensions/api/runtime/port/index.html | 246 ---------------- .../webextensions/api/runtime/port/index.md | 246 ++++++++++++++++ .../webextensions/api/runtime/reload/index.html | 81 ----- .../webextensions/api/runtime/reload/index.md | 81 +++++ .../api/runtime/requestupdatecheck/index.html | 107 ------- .../api/runtime/requestupdatecheck/index.md | 107 +++++++ .../runtime/requestupdatecheckstatus/index.html | 75 ----- .../api/runtime/requestupdatecheckstatus/index.md | 75 +++++ .../api/runtime/sendmessage/index.html | 165 ----------- .../webextensions/api/runtime/sendmessage/index.md | 165 +++++++++++ .../api/runtime/sendnativemessage/index.html | 112 ------- .../api/runtime/sendnativemessage/index.md | 112 +++++++ .../api/runtime/setuninstallurl/index.html | 95 ------ .../api/runtime/setuninstallurl/index.md | 95 ++++++ 74 files changed, 4169 insertions(+), 4169 deletions(-) delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/connect/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/connect/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/connectnative/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/connectnative/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/getbackgroundpage/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/getbackgroundpage/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/getbrowserinfo/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/getbrowserinfo/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/getpackagedirectoryentry/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/getpackagedirectoryentry/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/getplatforminfo/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/getplatforminfo/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/geturl/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/geturl/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/id/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/id/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/lasterror/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/lasterror/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/messagesender/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/messagesender/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onbrowserupdateavailable/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onbrowserupdateavailable/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onconnectexternal/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onconnectexternal/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalled/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalled/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalledreason/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalledreason/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onmessageexternal/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onmessageexternal/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequired/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequired/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequiredreason/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequiredreason/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onstartup/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onstartup/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspend/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspend/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspendcanceled/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspendcanceled/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onupdateavailable/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/onupdateavailable/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/platformarch/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/platformarch/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/platforminfo/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/platforminfo/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/platformnaclarch/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/platformnaclarch/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/platformos/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/platformos/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/port/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/port/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/reload/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/reload/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheck/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheck/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheckstatus/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheckstatus/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/sendnativemessage/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/sendnativemessage/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/setuninstallurl/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/runtime/setuninstallurl/index.md (limited to 'files/fr/mozilla/add-ons/webextensions/api/runtime') diff --git a/files/fr/mozilla/add-ons/webextensions/api/runtime/connect/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/connect/index.html deleted file mode 100644 index 0049b13556..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/connect/index.html +++ /dev/null @@ -1,158 +0,0 @@ ---- -title: runtime.connect() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/connect -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - connect - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/connect ---- -
{{AddonSidebar()}}
- -
- -

Créer une connexion pour plusieurs cas d'utilisation pout votre extension.

- -

Vous pouvez utiliser cette facilité dans les situations suivantes:

- - - -

Attention, vous ne pouvez pas utiliser cette fonctionnalité pour connecter une extension à son script de contenu. Pour réaliser cette opération, il vaut mieux utiliser {{WebExtAPIRef('tabs.connect()')}}.

- -

Syntaxe

- -
var port = browser.runtime.connect(
-  extensionId, // optional string
-  connectInfo  // optional object
-)
-
- -

Paramètres

- -
-
extensionId{{optional_inline}}
-
string. L'ID de l'extension à laquelle se connecter. Si la cible à défini un ID dans la clé applications du fichier manifest.json, alors extensionId doit avoir cette valeur. Autrement, il doit avoir l'ID qui a été généré pour la cible.
-
connectInfo{{optional_inline}}
-

object. Détails de la connexion:

-
-
name{{optional_inline}}
-
string. Sera passé dans {{WebExtAPIRef("runtime.onConnect")}} pour les processus qui écoutent un évènement de type connexion.
-
includeTlsChannelId{{optional_inline}}
-
boolean. indique si l'ID du canal TLS sera transmis à  {{WebExtAPIRef("runtime.onConnectExternal")}} pour le processus qui écoutent l'événement de connexion.
-
-
-
- -

Valeur retournée

- -

{{WebExtAPIRef('runtime.Port')}}. Port à travers lequel les messages peuvent être envoyés et reçus. L'événement onDisconnect du port est déclenché si l'extension n'existe pas.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Le script de contenu :

- - - -
// content-script.js
-
-var myPort = browser.runtime.connect({name:"port-from-cs"});
-myPort.postMessage({greeting: "hello from content script"});
-
-myPort.onMessage.addListener(function(m) {
-  console.log("In content script, received message from background script: ");
-  console.log(m.greeting);
-});
-
-document.body.addEventListener("click", function() {
-  myPort.postMessage({greeting: "they clicked the page!"});
-});
- -

Les scripts d'arrière plan correspondant :

- - - -
// background-script.js
-
-var portFromCS;
-
-function connected(p) {
-  portFromCS = p;
-  portFromCS.postMessage({greeting: "hi there content script!"});
-  portFromCS.onMessage.addListener(function(m) {
-    console.log("In background script, received message from content script")
-    console.log(m.greeting);
-  });
-}
-
-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.

- -

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/runtime/connect/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/connect/index.md new file mode 100644 index 0000000000..0049b13556 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/connect/index.md @@ -0,0 +1,158 @@ +--- +title: runtime.connect() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/connect +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - connect + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/connect +--- +
{{AddonSidebar()}}
+ +
+ +

Créer une connexion pour plusieurs cas d'utilisation pout votre extension.

+ +

Vous pouvez utiliser cette facilité dans les situations suivantes:

+ + + +

Attention, vous ne pouvez pas utiliser cette fonctionnalité pour connecter une extension à son script de contenu. Pour réaliser cette opération, il vaut mieux utiliser {{WebExtAPIRef('tabs.connect()')}}.

+ +

Syntaxe

+ +
var port = browser.runtime.connect(
+  extensionId, // optional string
+  connectInfo  // optional object
+)
+
+ +

Paramètres

+ +
+
extensionId{{optional_inline}}
+
string. L'ID de l'extension à laquelle se connecter. Si la cible à défini un ID dans la clé applications du fichier manifest.json, alors extensionId doit avoir cette valeur. Autrement, il doit avoir l'ID qui a été généré pour la cible.
+
connectInfo{{optional_inline}}
+

object. Détails de la connexion:

+
+
name{{optional_inline}}
+
string. Sera passé dans {{WebExtAPIRef("runtime.onConnect")}} pour les processus qui écoutent un évènement de type connexion.
+
includeTlsChannelId{{optional_inline}}
+
boolean. indique si l'ID du canal TLS sera transmis à  {{WebExtAPIRef("runtime.onConnectExternal")}} pour le processus qui écoutent l'événement de connexion.
+
+
+
+ +

Valeur retournée

+ +

{{WebExtAPIRef('runtime.Port')}}. Port à travers lequel les messages peuvent être envoyés et reçus. L'événement onDisconnect du port est déclenché si l'extension n'existe pas.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Le script de contenu :

+ + + +
// content-script.js
+
+var myPort = browser.runtime.connect({name:"port-from-cs"});
+myPort.postMessage({greeting: "hello from content script"});
+
+myPort.onMessage.addListener(function(m) {
+  console.log("In content script, received message from background script: ");
+  console.log(m.greeting);
+});
+
+document.body.addEventListener("click", function() {
+  myPort.postMessage({greeting: "they clicked the page!"});
+});
+ +

Les scripts d'arrière plan correspondant :

+ + + +
// background-script.js
+
+var portFromCS;
+
+function connected(p) {
+  portFromCS = p;
+  portFromCS.postMessage({greeting: "hi there content script!"});
+  portFromCS.onMessage.addListener(function(m) {
+    console.log("In background script, received message from content script")
+    console.log(m.greeting);
+  });
+}
+
+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.

+ +

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/runtime/connectnative/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/connectnative/index.html deleted file mode 100644 index e4a04221e2..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/connectnative/index.html +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: runtime.connectNative() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/connectNative -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - connectNative - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/connectNative ---- -
{{AddonSidebar()}}
- -
Connecte l'extension à une appplication native sur l'ordinateur de l'utilisateur.
- -
- -
Cela prend le nom d'une application native en tant que paramètre. Il démarre l'application native et retourne un objet  {{WebExtAPIRef("runtime.Port")}} à l'appelant.
- -
- -
L'appelant peut utiliser le Port pour échanger des messages avec l'application native utilisant Port.postMessage() et port.onMessage.
- -
- -
L'application native s'exécute jusqu'à ce qu'elle se termine, ou l'appelant appelle Port.disconnect(), ou la page qui a créé le Port est détruite. Une fois le Port est déconnecté, le navigateur mettra quelques secondes à se terminer pour quitter le processus, puis le désactiver s'il ne s'est pas arrêté.
- -
- -

Pour plus d'informations, voir messagerie native.

- -

Syntaxe

- -
var port = browser.runtime.connectNative(
-  application // string
-)
-
- -

Paramètres

- -
-
application
-
string. Le nom de l'application native à laquelle se connecter. Cela doit correspondre à la propriété "name" dans le fichier manifest de l'application native.
-
- -

Valeur retournée

- -

Un objet {{WebExtAPIRef('runtime.Port')}}. Le port que l'appelant peut utiliser pour échanger des messages avec l'application native.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Cet exemple se connecte à l'appplication native "ping_pong" et commence à en écouter les messages. Il envoie également un message à l'application native lorsque l'utilisateur clique sur l'icône d'une action du navigateur :

- -
/*
-On startup, connect to the "ping_pong" app.
-*/
-var port = browser.runtime.connectNative("ping_pong");
-
-/*
-Listen for messages from the app.
-*/
-port.onMessage.addListener((response) => {
-  console.log("Received: " + response);
-});
-
-/*
-On a click on the browser action, send the app a message.
-*/
-browser.browserAction.onClicked.addListener(() => {
-  console.log("Sending:  ping");
-  port.postMessage("ping");
-});
- -

{{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.

- -

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/runtime/connectnative/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/connectnative/index.md new file mode 100644 index 0000000000..e4a04221e2 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/connectnative/index.md @@ -0,0 +1,120 @@ +--- +title: runtime.connectNative() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/connectNative +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - connectNative + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/connectNative +--- +
{{AddonSidebar()}}
+ +
Connecte l'extension à une appplication native sur l'ordinateur de l'utilisateur.
+ +
+ +
Cela prend le nom d'une application native en tant que paramètre. Il démarre l'application native et retourne un objet  {{WebExtAPIRef("runtime.Port")}} à l'appelant.
+ +
+ +
L'appelant peut utiliser le Port pour échanger des messages avec l'application native utilisant Port.postMessage() et port.onMessage.
+ +
+ +
L'application native s'exécute jusqu'à ce qu'elle se termine, ou l'appelant appelle Port.disconnect(), ou la page qui a créé le Port est détruite. Une fois le Port est déconnecté, le navigateur mettra quelques secondes à se terminer pour quitter le processus, puis le désactiver s'il ne s'est pas arrêté.
+ +
+ +

Pour plus d'informations, voir messagerie native.

+ +

Syntaxe

+ +
var port = browser.runtime.connectNative(
+  application // string
+)
+
+ +

Paramètres

+ +
+
application
+
string. Le nom de l'application native à laquelle se connecter. Cela doit correspondre à la propriété "name" dans le fichier manifest de l'application native.
+
+ +

Valeur retournée

+ +

Un objet {{WebExtAPIRef('runtime.Port')}}. Le port que l'appelant peut utiliser pour échanger des messages avec l'application native.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Cet exemple se connecte à l'appplication native "ping_pong" et commence à en écouter les messages. Il envoie également un message à l'application native lorsque l'utilisateur clique sur l'icône d'une action du navigateur :

+ +
/*
+On startup, connect to the "ping_pong" app.
+*/
+var port = browser.runtime.connectNative("ping_pong");
+
+/*
+Listen for messages from the app.
+*/
+port.onMessage.addListener((response) => {
+  console.log("Received: " + response);
+});
+
+/*
+On a click on the browser action, send the app a message.
+*/
+browser.browserAction.onClicked.addListener(() => {
+  console.log("Sending:  ping");
+  port.postMessage("ping");
+});
+ +

{{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.

+ +

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/runtime/getbackgroundpage/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/getbackgroundpage/index.html deleted file mode 100644 index 1c3fb7e932..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/getbackgroundpage/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: runtime.getBackgroundPage() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/getBackgroundPage -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - getBackgroundPage - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getBackgroundPage ---- -
{{AddonSidebar()}}
- -

Récupère l'objet Window pour la page d'arrière-plan qui s'exécute dans l'extension en cours.

- -

Cela consiste un moyen pratique pour d'autres scripts d'extension privilégiés d'accéder directement à la portée du script d'arrière plan. Cela leur permet d'accéder aux variables ou aux fonctions d'appel définies dans cette portée. Le "script privilégié" inclut ici les scripts s'exécutant dans les  pages d'options, ou les scripts s'exécutant dans les fenêtres d'action du navigateur ou d'action page, mais n'inclut pas les scripts de contenu.

- -

Notez que les variables déclarées à l'aide de const ou let n'apparaissaient pas dans l'objet window retourné par cette fonction.

- -

Notez également que cette méthode ne peut pas être utilisée dans une fenêtre privée dans Firefox—Elle renvoie toujours null. Pour plus d'informations voir le bug lié à bugzilla.

- -

Si la page d'arrière plan est une page événement, le système s'assuera qu'il est chargé avant de résoudre la promise.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var gettingPage = browser.runtime.getBackgroundPage()
-
- -

Paramètres

- -

None.

- -

Valeur retournée

- -

Une Promise qui sera remplie avec l'objet Window pour la page d'arrière plan, s'il y en a une. Si l'extension n'inclut pas de page d'arrière-plan, la promise est rejetée avec un message d'erreur.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Supposons un script d'arrière-plan définisse une fonction foo():

- -
// background.js
-
-function foo() {
-  console.log("I'm defined in background.js");
-}
- -

Un script exécuté dans un popup peut appeler cette fonction directement comme ceci :

- -
// popup.js
-
-function onGot(page) {
-  page.foo();
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var getting = browser.runtime.getBackgroundPage();
-getting.then(onGot, onError);
- -

{{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.

- -

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/runtime/getbackgroundpage/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/getbackgroundpage/index.md new file mode 100644 index 0000000000..1c3fb7e932 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/getbackgroundpage/index.md @@ -0,0 +1,110 @@ +--- +title: runtime.getBackgroundPage() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/getBackgroundPage +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getBackgroundPage + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getBackgroundPage +--- +
{{AddonSidebar()}}
+ +

Récupère l'objet Window pour la page d'arrière-plan qui s'exécute dans l'extension en cours.

+ +

Cela consiste un moyen pratique pour d'autres scripts d'extension privilégiés d'accéder directement à la portée du script d'arrière plan. Cela leur permet d'accéder aux variables ou aux fonctions d'appel définies dans cette portée. Le "script privilégié" inclut ici les scripts s'exécutant dans les  pages d'options, ou les scripts s'exécutant dans les fenêtres d'action du navigateur ou d'action page, mais n'inclut pas les scripts de contenu.

+ +

Notez que les variables déclarées à l'aide de const ou let n'apparaissaient pas dans l'objet window retourné par cette fonction.

+ +

Notez également que cette méthode ne peut pas être utilisée dans une fenêtre privée dans Firefox—Elle renvoie toujours null. Pour plus d'informations voir le bug lié à bugzilla.

+ +

Si la page d'arrière plan est une page événement, le système s'assuera qu'il est chargé avant de résoudre la promise.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var gettingPage = browser.runtime.getBackgroundPage()
+
+ +

Paramètres

+ +

None.

+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec l'objet Window pour la page d'arrière plan, s'il y en a une. Si l'extension n'inclut pas de page d'arrière-plan, la promise est rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Supposons un script d'arrière-plan définisse une fonction foo():

+ +
// background.js
+
+function foo() {
+  console.log("I'm defined in background.js");
+}
+ +

Un script exécuté dans un popup peut appeler cette fonction directement comme ceci :

+ +
// popup.js
+
+function onGot(page) {
+  page.foo();
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var getting = browser.runtime.getBackgroundPage();
+getting.then(onGot, onError);
+ +

{{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.

+ +

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/runtime/getbrowserinfo/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/getbrowserinfo/index.html deleted file mode 100644 index 72b7ebc953..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/getbrowserinfo/index.html +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: runtime.getBrowserInfo() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/getBrowserInfo -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - getBrowserInfo - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getBrowserInfo ---- -
{{AddonSidebar}}
- -

Renvoie les informations sur le navigateur dans lequel l'extension est installée.

- -

Il s'agit d'une fonction asynchrone qui renvoie une {{JSxRef("Promise")}}.

- -

Syntaxe

- -
var gettingInfo = browser.runtime.getBrowserInfo()
-
- -

Paramètres

- -

None.

- -

valeur retournée

- -

Une Promise qui sera remplie avec un objet qui a les propriétés suivantes :

- - - -

Compatibilité du navigateur

- - - -

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

- -

Exemples

- -

Obtenir et enregistrer le nom du navigateur :

- -
function gotBrowserInfo(info) {
-  console.log(info.name);
-}
-
-var gettingInfo = browser.runtime.getBrowserInfo();
-gettingInfo.then(gotBrowserInfo);
- -

{{WebExtExamples}}

- -

Note :

- -

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/runtime/getbrowserinfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/getbrowserinfo/index.md new file mode 100644 index 0000000000..72b7ebc953 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/getbrowserinfo/index.md @@ -0,0 +1,63 @@ +--- +title: runtime.getBrowserInfo() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/getBrowserInfo +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - getBrowserInfo + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getBrowserInfo +--- +
{{AddonSidebar}}
+ +

Renvoie les informations sur le navigateur dans lequel l'extension est installée.

+ +

Il s'agit d'une fonction asynchrone qui renvoie une {{JSxRef("Promise")}}.

+ +

Syntaxe

+ +
var gettingInfo = browser.runtime.getBrowserInfo()
+
+ +

Paramètres

+ +

None.

+ +

valeur retournée

+ +

Une Promise qui sera remplie avec un objet qui a les propriétés suivantes :

+ + + +

Compatibilité du navigateur

+ + + +

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

+ +

Exemples

+ +

Obtenir et enregistrer le nom du navigateur :

+ +
function gotBrowserInfo(info) {
+  console.log(info.name);
+}
+
+var gettingInfo = browser.runtime.getBrowserInfo();
+gettingInfo.then(gotBrowserInfo);
+ +

{{WebExtExamples}}

+ +

Note :

+ +

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/runtime/getmanifest/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.html deleted file mode 100644 index 6182f11708..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: runtime.getManifest() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/getManifest -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - getManifest - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getManifest ---- -
{{AddonSidebar()}}
- -
Obtenez le fichier manifest.json complet, sérialisé à un objet JSON.
- -
- -

Syntaxe

- -
browser.runtime.getManifest()
-
- -

Paramètres

- -

None.

- -

Valeur retournée

- -

Un object JSON représentant le manifest.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Récupère le manifest et consignez la propriété "name" :

- -
var manifest = browser.runtime.getManifest();
-console.log(manifest.name);
- -

{{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.

- -

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/runtime/getmanifest/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.md new file mode 100644 index 0000000000..6182f11708 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.md @@ -0,0 +1,84 @@ +--- +title: runtime.getManifest() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/getManifest +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getManifest + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getManifest +--- +
{{AddonSidebar()}}
+ +
Obtenez le fichier manifest.json complet, sérialisé à un objet JSON.
+ +
+ +

Syntaxe

+ +
browser.runtime.getManifest()
+
+ +

Paramètres

+ +

None.

+ +

Valeur retournée

+ +

Un object JSON représentant le manifest.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Récupère le manifest et consignez la propriété "name" :

+ +
var manifest = browser.runtime.getManifest();
+console.log(manifest.name);
+ +

{{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.

+ +

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/runtime/getpackagedirectoryentry/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/getpackagedirectoryentry/index.html deleted file mode 100644 index 6468c165c2..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/getpackagedirectoryentry/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: runtime.getPackageDirectoryEntry() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/getPackageDirectoryEntry -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - getPackageDirectoryEntry - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getPackageDirectoryEntry ---- -
{{AddonSidebar()}}
- -

Renvoie un objet DirectoryEntry représentant le répertoire du package.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var gettingEntry = browser.runtime.getPackageDirectoryEntry()
-
- -

Paramètres

- -

None.

- -

Valeur retournée

- -

Une Promise qui sera remplie avec un objet DirectoryEntry représentant le répertoire du package.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -
function gotDirectoryEntry(directoryEntry) {
-  console.log(directoryEntry);
-}
-
-var gettingEntry = browser.runtime.getPackageDirectoryEntry();
-gettingEntry.then(gotDirectoryEntry);
- -

{{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.

- -

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/runtime/getpackagedirectoryentry/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/getpackagedirectoryentry/index.md new file mode 100644 index 0000000000..6468c165c2 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/getpackagedirectoryentry/index.md @@ -0,0 +1,86 @@ +--- +title: runtime.getPackageDirectoryEntry() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/getPackageDirectoryEntry +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - getPackageDirectoryEntry + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getPackageDirectoryEntry +--- +
{{AddonSidebar()}}
+ +

Renvoie un objet DirectoryEntry représentant le répertoire du package.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var gettingEntry = browser.runtime.getPackageDirectoryEntry()
+
+ +

Paramètres

+ +

None.

+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un objet DirectoryEntry représentant le répertoire du package.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +
function gotDirectoryEntry(directoryEntry) {
+  console.log(directoryEntry);
+}
+
+var gettingEntry = browser.runtime.getPackageDirectoryEntry();
+gettingEntry.then(gotDirectoryEntry);
+ +

{{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.

+ +

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/runtime/getplatforminfo/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/getplatforminfo/index.html deleted file mode 100644 index 1af9d51e7e..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/getplatforminfo/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: runtime.getPlatformInfo() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/getPlatformInfo -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - getPlatformInfo - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getPlatformInfo ---- -
{{AddonSidebar()}}
- -

Renvoies des informations sur la plate-forme actuelle. Ceci ne peut être appelé que dans le contexte du script d'arrière-plan.

- -

Il s'agit d'une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var getting = browser.runtime.getPlatformInfo()
-
- -

Paramètres

- -

None.

- -

Valeur rentournée

- -

Une Promise qui sera remplie avec une valeur {{WebExtAPIRef('runtime.PlatformInfo')}} représentant la plate-forme actuelle.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Obtenez et consignez le système d'exploitation de la plateforme :

- -
function gotPlatformInfo(info) {
-  console.log(info.os);
-}
-
-var gettingInfo = browser.runtime.getPlatformInfo();
-gettingInfo.then(gotPlatformInfo);
- -

{{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.

- -

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/runtime/getplatforminfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/getplatforminfo/index.md new file mode 100644 index 0000000000..1af9d51e7e --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/getplatforminfo/index.md @@ -0,0 +1,88 @@ +--- +title: runtime.getPlatformInfo() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/getPlatformInfo +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getPlatformInfo + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getPlatformInfo +--- +
{{AddonSidebar()}}
+ +

Renvoies des informations sur la plate-forme actuelle. Ceci ne peut être appelé que dans le contexte du script d'arrière-plan.

+ +

Il s'agit d'une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var getting = browser.runtime.getPlatformInfo()
+
+ +

Paramètres

+ +

None.

+ +

Valeur rentournée

+ +

Une Promise qui sera remplie avec une valeur {{WebExtAPIRef('runtime.PlatformInfo')}} représentant la plate-forme actuelle.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Obtenez et consignez le système d'exploitation de la plateforme :

+ +
function gotPlatformInfo(info) {
+  console.log(info.os);
+}
+
+var gettingInfo = browser.runtime.getPlatformInfo();
+gettingInfo.then(gotPlatformInfo);
+ +

{{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.

+ +

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/runtime/geturl/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/geturl/index.html deleted file mode 100644 index 3b29aadb83..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/geturl/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: runtime.getURL() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/getURL -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - getURL - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getURL ---- -
{{AddonSidebar()}}
- -
Etant donné un chemin relatif de manifest.json à une ressource empaquetée avec l'extension, renvoyez une URL complète.
- -
- -
Cette fonction ne vérifie pas que la ressource existe réellement à cette URL.
- -
- -

Syntaxe

- -
browser.runtime.getURL(
-  path // string
-)
-
- -

Paramètres

- -
-
path
-
string. Un chemin relatif de manifest.json à une ressource empaquetée avec l'extension.
-
- -

Valeur retournée

- -

string. L'URL complète de la ressource.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Etant donné un fichier empaqueté avec l'extension "beasts/frog.html", obtenez l'URL complète comme ceci :

- -
var fullURL = browser.runtime.getURL("beasts/frog.html");
-console.log(fullURL);
-// Returns something like:
-// moz-extension://2c127fa4-62c7-7e4f-90e5-472b45eecfdc/beasts/frog.html
- -

{{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.

- -

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/runtime/geturl/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/geturl/index.md new file mode 100644 index 0000000000..3b29aadb83 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/geturl/index.md @@ -0,0 +1,95 @@ +--- +title: runtime.getURL() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/getURL +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - getURL + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getURL +--- +
{{AddonSidebar()}}
+ +
Etant donné un chemin relatif de manifest.json à une ressource empaquetée avec l'extension, renvoyez une URL complète.
+ +
+ +
Cette fonction ne vérifie pas que la ressource existe réellement à cette URL.
+ +
+ +

Syntaxe

+ +
browser.runtime.getURL(
+  path // string
+)
+
+ +

Paramètres

+ +
+
path
+
string. Un chemin relatif de manifest.json à une ressource empaquetée avec l'extension.
+
+ +

Valeur retournée

+ +

string. L'URL complète de la ressource.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Etant donné un fichier empaqueté avec l'extension "beasts/frog.html", obtenez l'URL complète comme ceci :

+ +
var fullURL = browser.runtime.getURL("beasts/frog.html");
+console.log(fullURL);
+// Returns something like:
+// moz-extension://2c127fa4-62c7-7e4f-90e5-472b45eecfdc/beasts/frog.html
+ +

{{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.

+ +

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/runtime/id/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/id/index.html deleted file mode 100644 index 1c76b09fe0..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/id/index.html +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: runtime.id -slug: Mozilla/Add-ons/WebExtensions/API/runtime/id -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Property - - Reference - - WebExtensions - - runtime - - §ID -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/id ---- -
{{AddonSidebar()}}
- -

L'ID de l'extension

- -

Syntaxe

- -
var myAddonId = browser.runtime.id;
- -

Value

- -

Une chaîne représentant l'ID du module complémentaire. Si l'extension a spécifié un ID dans la clé manifest.json de ses applications, runtime.id contiendra la valeur. SInon runtime.id contiendra l'ID généré pour l'extension.

- -

Compatibilité du navigateur

- -

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

- -

{{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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/runtime/id/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/id/index.md new file mode 100644 index 0000000000..1c76b09fe0 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/id/index.md @@ -0,0 +1,68 @@ +--- +title: runtime.id +slug: Mozilla/Add-ons/WebExtensions/API/runtime/id +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Property + - Reference + - WebExtensions + - runtime + - §ID +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/id +--- +
{{AddonSidebar()}}
+ +

L'ID de l'extension

+ +

Syntaxe

+ +
var myAddonId = browser.runtime.id;
+ +

Value

+ +

Une chaîne représentant l'ID du module complémentaire. Si l'extension a spécifié un ID dans la clé manifest.json de ses applications, runtime.id contiendra la valeur. SInon runtime.id contiendra l'ID généré pour l'extension.

+ +

Compatibilité du navigateur

+ +

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

+ +

{{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.

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

Ce module fournit des informations sur votre extension et l'environnement dans lequel elle fonctionne.

- -

Il fournit également des API de messagerie vous permettant de:

- - - -

Types

- -
-
{{WebExtAPIRef("runtime.Port")}}
-
Représente une extrémité d'une connexion entre deux contextes spécifiques, qui peut être utilisée pour échanger des messages.
-
{{WebExtAPIRef("runtime.MessageSender")}}
-
-

Contient des informations sur l'expéditeur d'un message ou d'une demande de connexion.

-
-
{{WebExtAPIRef("runtime.PlatformOs")}}
-
Identifie le système d'exploitation du navigateur.
-
{{WebExtAPIRef("runtime.PlatformArch")}}
-
Identifie l'architecture du processeur du navigateur.
-
{{WebExtAPIRef("runtime.PlatformInfo")}}
-
Contient des informations sur la plate-forme utilisée par le navigateur.
-
{{WebExtAPIRef("runtime.RequestUpdateCheckStatus")}}
-
Résultat d'un appel à {{WebExtAPIRef("runtime.requestUpdateCheck()")}}.
-
{{WebExtAPIRef("runtime.OnInstalledReason")}}
-
La raison pour laquelle l'événement {{WebExtAPIRef("runtime.onInstalled")}} est en cours d'envoi.
-
{{WebExtAPIRef("runtime.OnRestartRequiredReason")}}
-
La raison pour laquelle l'événement {{WebExtAPIRef("runtime.onRestartRequired")}} est en cours d'expédition.
-
- -

Propriétés

- -
-
{{WebExtAPIRef("runtime.lastError")}}
-
Cette valeur est définie lorsqu'une fonction asynchrone a une condition d'erreur qu'elle doit signaler à son appelant
-
{{WebExtAPIRef("runtime.id")}}
-
L'ID de l'extension
-
- -

Fonctions

- -
-
{{WebExtAPIRef("runtime.getBackgroundPage()")}}
-
Récupère l'objet Window pour la page d'arrière-plan qui s'exécute dans l'extension en cours.
-
{{WebExtAPIRef("runtime.openOptionsPage()")}}
-
-

Ouvre une page d'options de votre extension.

-
-
{{WebExtAPIRef("runtime.getManifest()")}}
-
Obtient le fichier manifest.json complet,  sérialisé en tant qu'objet.
-
{{WebExtAPIRef("runtime.getURL()")}}
-
Etant donné un chemin relatif de manifest.json à une ressource empaquetée avec l'extension, renvoie une URL entièrement qualifiée.
-
{{WebExtAPIRef("runtime.setUninstallURL()")}}
-
Définit une URL à visiter lorsque l'extension est désinstallée.
-
{{WebExtAPIRef("runtime.reload()")}}
-
Recharge l'extension.
-
{{WebExtAPIRef("runtime.requestUpdateCheck()")}}
-
Vérifie les mises à jour de cette extension.
-
{{WebExtAPIRef("runtime.connect()")}}
-
Établit une connexion d'un script de contenu au processus d'extension principal ou d'une extension à une extension différente.
-
{{WebExtAPIRef("runtime.connectNative()")}}
-
-
Connecte l'extension à une application native sur l'ordinateur de l'utilisateur.
-
-
{{WebExtAPIRef("runtime.sendMessage()")}}
-
Envoie un seul message aux écouteurs d'événement dans votre extension ou une extension différente. Similaire à  {{WebExtAPIRef('runtime.connect')}} mais n'envoie qu'un seul message, avec une réponse facultative.
-
{{WebExtAPIRef("runtime.sendNativeMessage()")}}
-
Envoie un seul message d'une extension à une application native.
-
{{WebExtAPIRef("runtime.getPlatformInfo()")}}
-
Renvoie des informations sur la plate-forme actuelle.
-
{{WebExtAPIRef("runtime.getBrowserInfo()")}}
-
Renvoie des informations sur le navigateur dans lequel cette extension est installée.
-
{{WebExtAPIRef("runtime.getPackageDirectoryEntry()")}}
-
Renvoie un DirectoryEntry pour le répertoire du package.
-
- -

Evénements

- -
-
{{WebExtAPIRef("runtime.onStartup")}}
-
Lancé lorsqu'un premier profil a cette extension installée. Cet événement n'est pas déclenché lorsqu'un profil de navigation privée est démarré.
-
{{WebExtAPIRef("runtime.onInstalled")}}
-
Lancé lorsque l'extension est installée pour la première fois, lorsque l'extension est mise à jour vers une nouvelle version et lorsque le navigateur est mis à jour vers une nouvelle version.
-
{{WebExtAPIRef("runtime.onSuspend")}}
-
Envoyé sur la page de l'événement juste avant le déchargement de l'extension. Cela donne à l'extension l'opportunité de faire un peu de nettoyage.
-
{{WebExtAPIRef("runtime.onSuspendCanceled")}}
-
Envoyé après {{WebExtAPIRef("runtime.onSuspend")}} pour indiquer que l'extension ne sera pas déchargée après tout.
-
{{WebExtAPIRef("runtime.onUpdateAvailable")}}
-
Lancé lorsqu'une mise à jour est disponible, mais n'est pas installé immédiatement car l'extension est en cours d'exécution.
-
{{WebExtAPIRef("runtime.onBrowserUpdateAvailable")}} {{deprecated_inline}}
-
Lancé lorsqu'une mise à jour pour le navigateur est disponible, mais n'est pas installée immédiatement car un redémarrage du navigateur est requis.
-
{{WebExtAPIRef("runtime.onConnect")}}
-
Lancé lorsqu'une connexion est établie avec un processus d'extension ou un script de contenu.
-
{{WebExtAPIRef("runtime.onConnectExternal")}}
-
Lancé lorsqu'une connexion est établie avec une autre extension.
-
{{WebExtAPIRef("runtime.onMessage")}}
-
Lancé lorsqu'un message est envoyé par un processus d'extension ou un script de contenu.
-
{{WebExtAPIRef("runtime.onMessageExternal")}}
-
Lancé lorsqu'un message est envoyé depuis un autre poste. Ne peut pas être utilisé dans un script de contenu.
-
{{WebExtAPIRef("runtime.onRestartRequired")}}
-
Lancé lorsque le périphérique doit être redémarré.
-
- -

Compatibilité du navigateur

- -
- - -

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

- -
{{WebExtExamples("h2")}}
- -
-
- -

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.

- -

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/runtime/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/index.md new file mode 100644 index 0000000000..0d69ad6128 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/index.md @@ -0,0 +1,171 @@ +--- +title: runtime +slug: Mozilla/Add-ons/WebExtensions/API/runtime +tags: + - API + - Add-ons + - Extensions + - Interface + - Non-standard + - Reference + - WebExtensions + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime +--- +
{{AddonSidebar}}
+ +

Ce module fournit des informations sur votre extension et l'environnement dans lequel elle fonctionne.

+ +

Il fournit également des API de messagerie vous permettant de:

+ + + +

Types

+ +
+
{{WebExtAPIRef("runtime.Port")}}
+
Représente une extrémité d'une connexion entre deux contextes spécifiques, qui peut être utilisée pour échanger des messages.
+
{{WebExtAPIRef("runtime.MessageSender")}}
+
+

Contient des informations sur l'expéditeur d'un message ou d'une demande de connexion.

+
+
{{WebExtAPIRef("runtime.PlatformOs")}}
+
Identifie le système d'exploitation du navigateur.
+
{{WebExtAPIRef("runtime.PlatformArch")}}
+
Identifie l'architecture du processeur du navigateur.
+
{{WebExtAPIRef("runtime.PlatformInfo")}}
+
Contient des informations sur la plate-forme utilisée par le navigateur.
+
{{WebExtAPIRef("runtime.RequestUpdateCheckStatus")}}
+
Résultat d'un appel à {{WebExtAPIRef("runtime.requestUpdateCheck()")}}.
+
{{WebExtAPIRef("runtime.OnInstalledReason")}}
+
La raison pour laquelle l'événement {{WebExtAPIRef("runtime.onInstalled")}} est en cours d'envoi.
+
{{WebExtAPIRef("runtime.OnRestartRequiredReason")}}
+
La raison pour laquelle l'événement {{WebExtAPIRef("runtime.onRestartRequired")}} est en cours d'expédition.
+
+ +

Propriétés

+ +
+
{{WebExtAPIRef("runtime.lastError")}}
+
Cette valeur est définie lorsqu'une fonction asynchrone a une condition d'erreur qu'elle doit signaler à son appelant
+
{{WebExtAPIRef("runtime.id")}}
+
L'ID de l'extension
+
+ +

Fonctions

+ +
+
{{WebExtAPIRef("runtime.getBackgroundPage()")}}
+
Récupère l'objet Window pour la page d'arrière-plan qui s'exécute dans l'extension en cours.
+
{{WebExtAPIRef("runtime.openOptionsPage()")}}
+
+

Ouvre une page d'options de votre extension.

+
+
{{WebExtAPIRef("runtime.getManifest()")}}
+
Obtient le fichier manifest.json complet,  sérialisé en tant qu'objet.
+
{{WebExtAPIRef("runtime.getURL()")}}
+
Etant donné un chemin relatif de manifest.json à une ressource empaquetée avec l'extension, renvoie une URL entièrement qualifiée.
+
{{WebExtAPIRef("runtime.setUninstallURL()")}}
+
Définit une URL à visiter lorsque l'extension est désinstallée.
+
{{WebExtAPIRef("runtime.reload()")}}
+
Recharge l'extension.
+
{{WebExtAPIRef("runtime.requestUpdateCheck()")}}
+
Vérifie les mises à jour de cette extension.
+
{{WebExtAPIRef("runtime.connect()")}}
+
Établit une connexion d'un script de contenu au processus d'extension principal ou d'une extension à une extension différente.
+
{{WebExtAPIRef("runtime.connectNative()")}}
+
+
Connecte l'extension à une application native sur l'ordinateur de l'utilisateur.
+
+
{{WebExtAPIRef("runtime.sendMessage()")}}
+
Envoie un seul message aux écouteurs d'événement dans votre extension ou une extension différente. Similaire à  {{WebExtAPIRef('runtime.connect')}} mais n'envoie qu'un seul message, avec une réponse facultative.
+
{{WebExtAPIRef("runtime.sendNativeMessage()")}}
+
Envoie un seul message d'une extension à une application native.
+
{{WebExtAPIRef("runtime.getPlatformInfo()")}}
+
Renvoie des informations sur la plate-forme actuelle.
+
{{WebExtAPIRef("runtime.getBrowserInfo()")}}
+
Renvoie des informations sur le navigateur dans lequel cette extension est installée.
+
{{WebExtAPIRef("runtime.getPackageDirectoryEntry()")}}
+
Renvoie un DirectoryEntry pour le répertoire du package.
+
+ +

Evénements

+ +
+
{{WebExtAPIRef("runtime.onStartup")}}
+
Lancé lorsqu'un premier profil a cette extension installée. Cet événement n'est pas déclenché lorsqu'un profil de navigation privée est démarré.
+
{{WebExtAPIRef("runtime.onInstalled")}}
+
Lancé lorsque l'extension est installée pour la première fois, lorsque l'extension est mise à jour vers une nouvelle version et lorsque le navigateur est mis à jour vers une nouvelle version.
+
{{WebExtAPIRef("runtime.onSuspend")}}
+
Envoyé sur la page de l'événement juste avant le déchargement de l'extension. Cela donne à l'extension l'opportunité de faire un peu de nettoyage.
+
{{WebExtAPIRef("runtime.onSuspendCanceled")}}
+
Envoyé après {{WebExtAPIRef("runtime.onSuspend")}} pour indiquer que l'extension ne sera pas déchargée après tout.
+
{{WebExtAPIRef("runtime.onUpdateAvailable")}}
+
Lancé lorsqu'une mise à jour est disponible, mais n'est pas installé immédiatement car l'extension est en cours d'exécution.
+
{{WebExtAPIRef("runtime.onBrowserUpdateAvailable")}} {{deprecated_inline}}
+
Lancé lorsqu'une mise à jour pour le navigateur est disponible, mais n'est pas installée immédiatement car un redémarrage du navigateur est requis.
+
{{WebExtAPIRef("runtime.onConnect")}}
+
Lancé lorsqu'une connexion est établie avec un processus d'extension ou un script de contenu.
+
{{WebExtAPIRef("runtime.onConnectExternal")}}
+
Lancé lorsqu'une connexion est établie avec une autre extension.
+
{{WebExtAPIRef("runtime.onMessage")}}
+
Lancé lorsqu'un message est envoyé par un processus d'extension ou un script de contenu.
+
{{WebExtAPIRef("runtime.onMessageExternal")}}
+
Lancé lorsqu'un message est envoyé depuis un autre poste. Ne peut pas être utilisé dans un script de contenu.
+
{{WebExtAPIRef("runtime.onRestartRequired")}}
+
Lancé lorsque le périphérique doit être redémarré.
+
+ +

Compatibilité du navigateur

+ +
+ + +

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

+ +
{{WebExtExamples("h2")}}
+ +
+
+ +

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.

+ +

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/runtime/lasterror/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/lasterror/index.html deleted file mode 100644 index 0384ff364d..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/lasterror/index.html +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: runtime.lastError -slug: Mozilla/Add-ons/WebExtensions/API/runtime/lastError -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Property - - Reference - - WebExtensions - - lastError - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/lastError ---- -
{{AddonSidebar()}}
- -
Cette valeur est utilisée pour signaler un message d'erreur provenant d'une API asynchrone, lorsque l'API asynchrone reçoit un rappel. Cela est utile pour les extensions qui utilisent la valeur basée sur le rappel des API WebExtension.
- -
- -
Vpous n'avez pas besoin de vérifier cette propriété si vous utilisez la version basée sur la promesse des API : à la place, passez un gestionnaire d'erreurs à la promesse :
- -
- -
var gettingCookies = browser.cookies.getAll();
-gettingCookies.then(onGot, onError);
- -

La propriété runtime.lastError est définie lorsqu'une fonction asynchrone a une condition  d'erreur qu'elle doit signaler à son appelant.

- -
Si vous applez une fonction asynchrone qui veut définir lastError, vous devez vérifier l'erreur lorsque vous gérez le résultat de la fonction. Si  lastError a été défini et que vous ne cochez pas dans la fonction de rappel, une erreur sera générée.
- -
- -

Syntaxe

- -
var myError = browser.runtime.lastError;  // null or Error object
- -

Valeur

- -

Un objet Error représentant une erreur. La propriété message est un string avec une description lisible par l'utilisateur de l'erreur. Si  lastError n'a pas été défini, la valeur est null.

- -

Examples

- -

Définir un cookie, utiliser pour enregistrer le nouveau cookie ou signaler une erreur :

- -
function logCookie(c) {
-  if (browser.runtime.lastError) {
-    console.error(browser.runtime.lastError);
-  } else {
-    console.log(c);
-  }
-}
-
-browser.cookies.set(
-  {url: "https://developer.mozilla.org/"},
-  logCookie
-);
- -

La même chose, mais en utilisant une promesse de gérer le résultat de setCookie():

- -
function logCookie(c) {
-  console.log(c);
-}
-
-function logError(e) {
-  console.error(e);
-}
-
-var setCookie = browser.cookies.set(
-  {url: "https://developer.mozilla.org/"}
-);
-
-setCookie.then(logCookie, logError);
- -
-

Note : runtime.lastError est un alias pour  {{WebExtAPIRef("extension.lastError")}}: Ils sont ensemble, et la vérification de l'un fonctionnera.

-
- -

Compatibilité du navigateur

- -

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

- -

{{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.

- -

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/runtime/lasterror/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/lasterror/index.md new file mode 100644 index 0000000000..0384ff364d --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/lasterror/index.md @@ -0,0 +1,122 @@ +--- +title: runtime.lastError +slug: Mozilla/Add-ons/WebExtensions/API/runtime/lastError +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Property + - Reference + - WebExtensions + - lastError + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/lastError +--- +
{{AddonSidebar()}}
+ +
Cette valeur est utilisée pour signaler un message d'erreur provenant d'une API asynchrone, lorsque l'API asynchrone reçoit un rappel. Cela est utile pour les extensions qui utilisent la valeur basée sur le rappel des API WebExtension.
+ +
+ +
Vpous n'avez pas besoin de vérifier cette propriété si vous utilisez la version basée sur la promesse des API : à la place, passez un gestionnaire d'erreurs à la promesse :
+ +
+ +
var gettingCookies = browser.cookies.getAll();
+gettingCookies.then(onGot, onError);
+ +

La propriété runtime.lastError est définie lorsqu'une fonction asynchrone a une condition  d'erreur qu'elle doit signaler à son appelant.

+ +
Si vous applez une fonction asynchrone qui veut définir lastError, vous devez vérifier l'erreur lorsque vous gérez le résultat de la fonction. Si  lastError a été défini et que vous ne cochez pas dans la fonction de rappel, une erreur sera générée.
+ +
+ +

Syntaxe

+ +
var myError = browser.runtime.lastError;  // null or Error object
+ +

Valeur

+ +

Un objet Error représentant une erreur. La propriété message est un string avec une description lisible par l'utilisateur de l'erreur. Si  lastError n'a pas été défini, la valeur est null.

+ +

Examples

+ +

Définir un cookie, utiliser pour enregistrer le nouveau cookie ou signaler une erreur :

+ +
function logCookie(c) {
+  if (browser.runtime.lastError) {
+    console.error(browser.runtime.lastError);
+  } else {
+    console.log(c);
+  }
+}
+
+browser.cookies.set(
+  {url: "https://developer.mozilla.org/"},
+  logCookie
+);
+ +

La même chose, mais en utilisant une promesse de gérer le résultat de setCookie():

+ +
function logCookie(c) {
+  console.log(c);
+}
+
+function logError(e) {
+  console.error(e);
+}
+
+var setCookie = browser.cookies.set(
+  {url: "https://developer.mozilla.org/"}
+);
+
+setCookie.then(logCookie, logError);
+ +
+

Note : runtime.lastError est un alias pour  {{WebExtAPIRef("extension.lastError")}}: Ils sont ensemble, et la vérification de l'un fonctionnera.

+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{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.

+ +

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/runtime/messagesender/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/messagesender/index.html deleted file mode 100644 index f9fdd35544..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/messagesender/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: runtime.MessageSender -slug: Mozilla/Add-ons/WebExtensions/API/runtime/MessageSender -tags: - - API - - Add-ons - - Extensions - - MessageSender - - Non-standard - - Reference - - Type - - WebExtensions - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/MessageSender ---- -
{{AddonSidebar()}}
- -

Un objet contenant des informations sur l'expéditeur d'un message ou d'une demande de connexion ; ceci est passé à l'écouteur {{WebExtAPIRef("runtime.onMessage()")}}.

- -

C'est aussi une propriété de {{WebExtAPIRef("runtime.Port")}}, mais seulement dans l'instance de Port passée dans les écouteurs {{WebExtAPIRef("runtime.onConnect()")}} ou {{WebExtAPIRef("runtime.onConnectExternal()")}}.

- -

Type

- -

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

- -
-
tab{{optional_inline}}
-
{{WebExtAPIRef('tabs.Tab')}}. Le {{WebExtAPIRef('tabs.Tab')}} qui a ouvert la connexion. Cette propriété ne sera présente que lorsque la connexion a été ouverte à partir d'un onglet (y compris les scripts de contenu).
-
frameId{{optional_inline}}
-
integer. Le cadre qui a ouvert la connexion. Zéro pour les cadres de haut niveau, positif pour les cadres enfants.  Cela ne sera défini que lorsque l'onglet est défini.
-
id{{optional_inline}}
-
string. L'ID de l'extension qui a envoyé le message, si le message a été envoyé par une extension. Si l'expéditeur définit explicitement un ID à l'aide de la clé des applications dans manifest.json, then id  aura cette valeur. Sinon, il aura l'ID qui a été généré pour l'expéditeur. Notez que dans Firefox, avant la version 54, cette valeur était l'ID interne de l'extension (c'est-à-dire l'UUID qui apparaît dans l'URL de l'extension).
-
url{{optional_inline}}
-
string. L'URL de la page ou du cadre hébergeant le script qui a envoyé le message. Si l'expéditeur est un script s'exécutant dans une page d'extension (telle qu'une  page d'arrière-plan, une page d'options, ou une action de navigateur ou une action contextuelle), l'URL sera au format "moz-extension://<extension-internal-id>/path/to/page.html". Si l'expéditeur est un script d'arrière-plan et que vous n'avez pas inclus une page d'arrière-plan, ce sera "moz-extension://<extension-internal-id>/_generated_background_page.html". Si l'expéditeur est un script s'exécutant sur une page Web (y compris les scripts de contenu et les scripts de page normaux), alors l'url sera l'URL de la page web. Si le script s'exécute dans un iframe, url sera l'URL de l'iframe.
-
tlsChannelId{{optional_inline}}
-
string. L'ID de canal TLS de la page ou du cadre qui a ouvert la connexion, si demandé par l'extension, et si disponible.
-
- -

Compatibilité du navigateur

- -

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

- -

{{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.

- -

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/runtime/messagesender/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/messagesender/index.md new file mode 100644 index 0000000000..f9fdd35544 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/messagesender/index.md @@ -0,0 +1,81 @@ +--- +title: runtime.MessageSender +slug: Mozilla/Add-ons/WebExtensions/API/runtime/MessageSender +tags: + - API + - Add-ons + - Extensions + - MessageSender + - Non-standard + - Reference + - Type + - WebExtensions + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/MessageSender +--- +
{{AddonSidebar()}}
+ +

Un objet contenant des informations sur l'expéditeur d'un message ou d'une demande de connexion ; ceci est passé à l'écouteur {{WebExtAPIRef("runtime.onMessage()")}}.

+ +

C'est aussi une propriété de {{WebExtAPIRef("runtime.Port")}}, mais seulement dans l'instance de Port passée dans les écouteurs {{WebExtAPIRef("runtime.onConnect()")}} ou {{WebExtAPIRef("runtime.onConnectExternal()")}}.

+ +

Type

+ +

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

+ +
+
tab{{optional_inline}}
+
{{WebExtAPIRef('tabs.Tab')}}. Le {{WebExtAPIRef('tabs.Tab')}} qui a ouvert la connexion. Cette propriété ne sera présente que lorsque la connexion a été ouverte à partir d'un onglet (y compris les scripts de contenu).
+
frameId{{optional_inline}}
+
integer. Le cadre qui a ouvert la connexion. Zéro pour les cadres de haut niveau, positif pour les cadres enfants.  Cela ne sera défini que lorsque l'onglet est défini.
+
id{{optional_inline}}
+
string. L'ID de l'extension qui a envoyé le message, si le message a été envoyé par une extension. Si l'expéditeur définit explicitement un ID à l'aide de la clé des applications dans manifest.json, then id  aura cette valeur. Sinon, il aura l'ID qui a été généré pour l'expéditeur. Notez que dans Firefox, avant la version 54, cette valeur était l'ID interne de l'extension (c'est-à-dire l'UUID qui apparaît dans l'URL de l'extension).
+
url{{optional_inline}}
+
string. L'URL de la page ou du cadre hébergeant le script qui a envoyé le message. Si l'expéditeur est un script s'exécutant dans une page d'extension (telle qu'une  page d'arrière-plan, une page d'options, ou une action de navigateur ou une action contextuelle), l'URL sera au format "moz-extension://<extension-internal-id>/path/to/page.html". Si l'expéditeur est un script d'arrière-plan et que vous n'avez pas inclus une page d'arrière-plan, ce sera "moz-extension://<extension-internal-id>/_generated_background_page.html". Si l'expéditeur est un script s'exécutant sur une page Web (y compris les scripts de contenu et les scripts de page normaux), alors l'url sera l'URL de la page web. Si le script s'exécute dans un iframe, url sera l'URL de l'iframe.
+
tlsChannelId{{optional_inline}}
+
string. L'ID de canal TLS de la page ou du cadre qui a ouvert la connexion, si demandé par l'extension, et si disponible.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{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.

+ +

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/runtime/onbrowserupdateavailable/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onbrowserupdateavailable/index.html deleted file mode 100644 index 3319ee6867..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onbrowserupdateavailable/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: runtime.onBrowserUpdateAvailable -slug: Mozilla/Add-ons/WebExtensions/API/runtime/onBrowserUpdateAvailable -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onBrowserUpdateAvailable - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onBrowserUpdateAvailable ---- -

{{AddonSidebar}}{{Deprecated_header}}

- -

Lancé lorsqu'une mise à jour pour le navigateur est disponible, mais qu'elle n'est pas installée immédiatement car un redémarrage du navigateur est requi.

- -

Syntaxe

- -
browser.runtime.onBrowserUpdateAvailable.addListener(listener)
-browser.runtime.onBrowserUpdateAvailable.removeListener(listener)
-browser.runtime.onBrowserUpdateAvailable.hasListener(listener)
-
- -

Les événements ont trois fonctions :

- -
-
addListener(callback)
-
Ajoute un écouteur à cet événement.
-
removeListener(listener)
-
Arrestez d'écouter un événement. L'argument listener est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifie si un écouteur est enregistré pour cet événement. Retourne true s'il écoute, sinon false.
-
- -

Syntaxe addListener

- -

Paramètres

- -
-
function
-
-

Une fonction de rappel qui sera appelée lorsque cet événement se produira.

-
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Ecoutez cet événement :

- -
function handleBrowserUpdateAvailable() {
-  // handle event
-}
-
-browser.runtime.onBrowserUpdateAvailable.addListener(handleBrowserUpdateAvailable);
- -

{{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.

- -

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/runtime/onbrowserupdateavailable/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onbrowserupdateavailable/index.md new file mode 100644 index 0000000000..3319ee6867 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onbrowserupdateavailable/index.md @@ -0,0 +1,101 @@ +--- +title: runtime.onBrowserUpdateAvailable +slug: Mozilla/Add-ons/WebExtensions/API/runtime/onBrowserUpdateAvailable +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onBrowserUpdateAvailable + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onBrowserUpdateAvailable +--- +

{{AddonSidebar}}{{Deprecated_header}}

+ +

Lancé lorsqu'une mise à jour pour le navigateur est disponible, mais qu'elle n'est pas installée immédiatement car un redémarrage du navigateur est requi.

+ +

Syntaxe

+ +
browser.runtime.onBrowserUpdateAvailable.addListener(listener)
+browser.runtime.onBrowserUpdateAvailable.removeListener(listener)
+browser.runtime.onBrowserUpdateAvailable.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
addListener(callback)
+
Ajoute un écouteur à cet événement.
+
removeListener(listener)
+
Arrestez d'écouter un événement. L'argument listener est l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifie si un écouteur est enregistré pour cet événement. Retourne true s'il écoute, sinon false.
+
+ +

Syntaxe addListener

+ +

Paramètres

+ +
+
function
+
+

Une fonction de rappel qui sera appelée lorsque cet événement se produira.

+
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Ecoutez cet événement :

+ +
function handleBrowserUpdateAvailable() {
+  // handle event
+}
+
+browser.runtime.onBrowserUpdateAvailable.addListener(handleBrowserUpdateAvailable);
+ +

{{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.

+ +

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/runtime/onconnect/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.html deleted file mode 100644 index d77c14c446..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.html +++ /dev/null @@ -1,153 +0,0 @@ ---- -title: runtime.onConnect -slug: Mozilla/Add-ons/WebExtensions/API/runtime/onConnect -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onconnect - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onConnect ---- -
{{AddonSidebar()}}
- -

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

- -

Syntaxe

- -
browser.runtime.onConnect.addListener(listener)
-browser.runtime.onConnect.removeListener(listener)
-browser.runtime.onConnect.hasListener(listener)
-
- -

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

Syntaxe addListener

- -

Paramètres

- -
-
fonction
-
-

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

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

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Ce script de contenu :

- - - -
// content-script.js
-
-var myPort = browser.runtime.connect({name:"port-from-cs"});
-myPort.postMessage({greeting: "hello from content script"});
-
-myPort.onMessage.addListener(function(m) {
-  console.log("In content script, received message from background script: ");
-  console.log(m.greeting);
-});
-
-document.body.addEventListener("click", function() {
-  myPort.postMessage({greeting: "they clicked the page!"});
-});
- -

Le script d'arrière-plan correspondant :

- - - -
// background-script.js
-
-var portFromCS;
-
-function connected(p) {
-  portFromCS = p;
-  portFromCS.postMessage({greeting: "hi there content script!"});
-  portFromCS.onMessage.addListener(function(m) {
-    console.log("In background script, received message from content script")
-    console.log(m.greeting);
-  });
-}
-
-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.

- -

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/runtime/onconnect/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.md new file mode 100644 index 0000000000..d77c14c446 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.md @@ -0,0 +1,153 @@ +--- +title: runtime.onConnect +slug: Mozilla/Add-ons/WebExtensions/API/runtime/onConnect +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onconnect + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onConnect +--- +
{{AddonSidebar()}}
+ +

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

+ +

Syntaxe

+ +
browser.runtime.onConnect.addListener(listener)
+browser.runtime.onConnect.removeListener(listener)
+browser.runtime.onConnect.hasListener(listener)
+
+ +

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

Syntaxe addListener

+ +

Paramètres

+ +
+
fonction
+
+

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

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

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Ce script de contenu :

+ + + +
// content-script.js
+
+var myPort = browser.runtime.connect({name:"port-from-cs"});
+myPort.postMessage({greeting: "hello from content script"});
+
+myPort.onMessage.addListener(function(m) {
+  console.log("In content script, received message from background script: ");
+  console.log(m.greeting);
+});
+
+document.body.addEventListener("click", function() {
+  myPort.postMessage({greeting: "they clicked the page!"});
+});
+ +

Le script d'arrière-plan correspondant :

+ + + +
// background-script.js
+
+var portFromCS;
+
+function connected(p) {
+  portFromCS = p;
+  portFromCS.postMessage({greeting: "hi there content script!"});
+  portFromCS.onMessage.addListener(function(m) {
+    console.log("In background script, received message from content script")
+    console.log(m.greeting);
+  });
+}
+
+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.

+ +

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/runtime/onconnectexternal/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnectexternal/index.html deleted file mode 100644 index 82de77f179..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnectexternal/index.html +++ /dev/null @@ -1,138 +0,0 @@ ---- -title: runtime.onConnectExternal -slug: Mozilla/Add-ons/WebExtensions/API/runtime/onConnectExternal -tags: - - API - - Add-ons - - Evènement - - Extensions - - Non-standard - - Reference - - WebExtensions - - onConnectExternal - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onConnectExternal ---- -
{{AddonSidebar()}}
- -

Lancé lorsqu'une extension reçoit une demande de connexion d'une extension différente.

- -

Pour envoyer un message qui sera reçu par le programme d'écoute onConnectExternal, utilisez {{WebExtAPIRef("runtime.connect()")}}, en transmettant l'ID du destinataire dans le paramètre extensionId.

- -

L'écouteur reçoit un objet {{WebExtAPIRef('runtime.Port')}} qu'il peut ensuite utiliser pour envoyer et recevoir des messages. L'objet Port contient également une propriétésender, qui est un objet {{WebExtAPIRef("runtime.MessageSender")}},  et que le destinataire peut utiliser pour vérifier l'ID de l'expéditeur.

- -

Syntaxe

- -
browser.runtime.onConnectExternal.addListener(listener)
-browser.runtime.onConnectExternal.removeListener(listener)
-browser.runtime.onConnectExternal.hasListener(listener)
-
- -

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 listener est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifie si un  listener est enregistré pour cet événement. Retourne true s'il écoute,  false sinon.
-
- -

Syntaxe addListener

- -

Paramètres

- -
-
fonction
-
-

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

- -
-
port
-
Un objet {{WebExtAPIRef('runtime.Port')}} connectant le script en cours à l'autre extension à laquelle il se connecte.
-
-
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Dans cet exemple, l'extension Hansel se connecte à l'extension Gretel :

- -
console.log("connecting to Gretel");
-var myPort = browser.runtime.connect(
-  "gretel@mozilla.org"
-);
-
-myPort.onMessage.addListener((message) => {
-  console.log(`From Gretel: ${message.content}`);
-});
-
-browser.browserAction.onClicked.addListener(() => {
-  myPort.postMessage({content: "Hello from Hansel"});
-});
- -

Gretel écoute la connexion  et vérifie que l'expéditeur est vraiment Hansel:

- -
var portFromHansel;
-
-browser.runtime.onConnectExternal.addListener((port) => {
-  console.log(port);
-  if (port.sender.id === "hansel@mozilla.org") {
-    console.log("connection attempt from Hansel");
-    portFromHansel = port;
-    portFromHansel.onMessage.addListener((message) => {
-      console.log(`From Hansel: ${message.content}`);
-    });
-  }
-});
-
-browser.browserAction.onClicked.addListener(() => {
-   portFromHansel.postMessage({content: "Message from Gretel"});
-});
-
-
- -

{{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.

- -

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/runtime/onconnectexternal/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnectexternal/index.md new file mode 100644 index 0000000000..82de77f179 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnectexternal/index.md @@ -0,0 +1,138 @@ +--- +title: runtime.onConnectExternal +slug: Mozilla/Add-ons/WebExtensions/API/runtime/onConnectExternal +tags: + - API + - Add-ons + - Evènement + - Extensions + - Non-standard + - Reference + - WebExtensions + - onConnectExternal + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onConnectExternal +--- +
{{AddonSidebar()}}
+ +

Lancé lorsqu'une extension reçoit une demande de connexion d'une extension différente.

+ +

Pour envoyer un message qui sera reçu par le programme d'écoute onConnectExternal, utilisez {{WebExtAPIRef("runtime.connect()")}}, en transmettant l'ID du destinataire dans le paramètre extensionId.

+ +

L'écouteur reçoit un objet {{WebExtAPIRef('runtime.Port')}} qu'il peut ensuite utiliser pour envoyer et recevoir des messages. L'objet Port contient également une propriétésender, qui est un objet {{WebExtAPIRef("runtime.MessageSender")}},  et que le destinataire peut utiliser pour vérifier l'ID de l'expéditeur.

+ +

Syntaxe

+ +
browser.runtime.onConnectExternal.addListener(listener)
+browser.runtime.onConnectExternal.removeListener(listener)
+browser.runtime.onConnectExternal.hasListener(listener)
+
+ +

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 listener est l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifie si un  listener est enregistré pour cet événement. Retourne true s'il écoute,  false sinon.
+
+ +

Syntaxe addListener

+ +

Paramètres

+ +
+
fonction
+
+

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

+ +
+
port
+
Un objet {{WebExtAPIRef('runtime.Port')}} connectant le script en cours à l'autre extension à laquelle il se connecte.
+
+
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Dans cet exemple, l'extension Hansel se connecte à l'extension Gretel :

+ +
console.log("connecting to Gretel");
+var myPort = browser.runtime.connect(
+  "gretel@mozilla.org"
+);
+
+myPort.onMessage.addListener((message) => {
+  console.log(`From Gretel: ${message.content}`);
+});
+
+browser.browserAction.onClicked.addListener(() => {
+  myPort.postMessage({content: "Hello from Hansel"});
+});
+ +

Gretel écoute la connexion  et vérifie que l'expéditeur est vraiment Hansel:

+ +
var portFromHansel;
+
+browser.runtime.onConnectExternal.addListener((port) => {
+  console.log(port);
+  if (port.sender.id === "hansel@mozilla.org") {
+    console.log("connection attempt from Hansel");
+    portFromHansel = port;
+    portFromHansel.onMessage.addListener((message) => {
+      console.log(`From Hansel: ${message.content}`);
+    });
+  }
+});
+
+browser.browserAction.onClicked.addListener(() => {
+   portFromHansel.postMessage({content: "Message from Gretel"});
+});
+
+
+ +

{{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.

+ +

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/runtime/oninstalled/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalled/index.html deleted file mode 100644 index 72b6f011f6..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalled/index.html +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: runtime.onInstalled -slug: Mozilla/Add-ons/WebExtensions/API/runtime/onInstalled -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onInstalled - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onInstalled ---- -
{{AddonSidebar()}}
- -

Lancé lorsque l'extension est installée pour la première fois, lorsque l'extension est mise à jour vers une nouvelle version et lorsque le navigateur est mis à jour vers une nouvelle version.

- -

Notez que runtime.onInstalled n'est pas la même chose  {{WebExtAPIRef("management.onInstalled")}}. L'événement  runtime.onInstalled est déclenché uniquement pour votre extension. L'événement browser.management.onInstalled est déclenché pour toutes les extensions.

- -

Syntaxe

- -
browser.runtime.onInstalled.addListener(listener)
-browser.runtime.onInstalled.removeListener(listener)
-browser.runtime.onInstalled.hasListener(listener)
-
- -

Les événements ont trois fonctions :

- -
-
addListener(callback)
-
Ajouterun écouteur à cet événement.
-
removeListener(listener)
-
Arrêtez d'écoutercet événement. L'argument listener est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifie si un écouteur est enregistré pour cet événement. Renvoie true s'il écoute, false sinon.
-
- -

Syntaxe addListener

- -

Paramètres

- -
-
function
-
-

La fonction de rappel appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :

- -
-
details
-

Un objet avec les propriétés suivantes :

-
-
id{{optional_inline}}
-
string. L'ID de l'extension  de module partagé importé mise à jour. Ceci n'est présent que si la valeur de raison est  shared_module_update.
-
previousVersion{{optional_inline}}
-
string. La version précédente de l'extension vient d'être mise à jour. Ceci n'est pas présent si la valeur de raison est mise à jour.
-
reason
-
Une valeur {{WebExtAPIRef('runtime.OnInstalledReason')}}, indiquant la raison pour laquelle cet événement est distribué.
-
temporary
-
boolean. Vrai si le module complémentaire a été installé temporairement. Par exemple, en utilisant la page "about:debugging" dans Firefox ou en utilisant  web-ext run. Sinon faux.
-
-
-
-
-
- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.runtime.onInstalled", 10)}}

- -

Exemples

- -

Lorsque l'extensin est installé, connectez-vous à la raison de l'installon et ouvrez https://www.reddit.com/r/CatGifs/:

- -
function handleInstalled(details) {
-  console.log(details.reason);
-  browser.tabs.create({
-    url: "http://chilloutandwatchsomecatgifs.com/"
-  });
-}
-
-browser.runtime.onInstalled.addListener(handleInstalled);
- -

{{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.

- -

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/runtime/oninstalled/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalled/index.md new file mode 100644 index 0000000000..72b6f011f6 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalled/index.md @@ -0,0 +1,122 @@ +--- +title: runtime.onInstalled +slug: Mozilla/Add-ons/WebExtensions/API/runtime/onInstalled +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onInstalled + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onInstalled +--- +
{{AddonSidebar()}}
+ +

Lancé lorsque l'extension est installée pour la première fois, lorsque l'extension est mise à jour vers une nouvelle version et lorsque le navigateur est mis à jour vers une nouvelle version.

+ +

Notez que runtime.onInstalled n'est pas la même chose  {{WebExtAPIRef("management.onInstalled")}}. L'événement  runtime.onInstalled est déclenché uniquement pour votre extension. L'événement browser.management.onInstalled est déclenché pour toutes les extensions.

+ +

Syntaxe

+ +
browser.runtime.onInstalled.addListener(listener)
+browser.runtime.onInstalled.removeListener(listener)
+browser.runtime.onInstalled.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
addListener(callback)
+
Ajouterun écouteur à cet événement.
+
removeListener(listener)
+
Arrêtez d'écoutercet événement. L'argument listener est l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifie si un écouteur est enregistré pour cet événement. Renvoie true s'il écoute, false sinon.
+
+ +

Syntaxe addListener

+ +

Paramètres

+ +
+
function
+
+

La fonction de rappel appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :

+ +
+
details
+

Un objet avec les propriétés suivantes :

+
+
id{{optional_inline}}
+
string. L'ID de l'extension  de module partagé importé mise à jour. Ceci n'est présent que si la valeur de raison est  shared_module_update.
+
previousVersion{{optional_inline}}
+
string. La version précédente de l'extension vient d'être mise à jour. Ceci n'est pas présent si la valeur de raison est mise à jour.
+
reason
+
Une valeur {{WebExtAPIRef('runtime.OnInstalledReason')}}, indiquant la raison pour laquelle cet événement est distribué.
+
temporary
+
boolean. Vrai si le module complémentaire a été installé temporairement. Par exemple, en utilisant la page "about:debugging" dans Firefox ou en utilisant  web-ext run. Sinon faux.
+
+
+
+
+
+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.runtime.onInstalled", 10)}}

+ +

Exemples

+ +

Lorsque l'extensin est installé, connectez-vous à la raison de l'installon et ouvrez https://www.reddit.com/r/CatGifs/:

+ +
function handleInstalled(details) {
+  console.log(details.reason);
+  browser.tabs.create({
+    url: "http://chilloutandwatchsomecatgifs.com/"
+  });
+}
+
+browser.runtime.onInstalled.addListener(handleInstalled);
+ +

{{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.

+ +

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/runtime/oninstalledreason/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalledreason/index.html deleted file mode 100644 index 1e02e04511..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalledreason/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: runtime.OnInstalledReason -slug: Mozilla/Add-ons/WebExtensions/API/runtime/OnInstalledReason -tags: - - API - - Add-ons - - Extensions - - Non-standard - - OnInstalledReason - - Reference - - Type - - WebExtensions - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/OnInstalledReason ---- -
{{AddonSidebar()}}
- -

Les valeurs pour laquelle l'événement {{WebExtAPIRef("runtime.onInstalled")}} est en cours d'envoi.

- -

Type

- -

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

- -
-
"install"
-
L'extension a été installée.
-
"update"
-
L'extension a été mise à jour vers une nouvelle version.
-
"browser_update"
-
Le navigateur a été mise à jour vers une nouvelle version.
-
"shared_module_update"
-
Une autre extension, qui contient un module utilisé par cette extension, a été mise à jour.
-
- -

Compatibilité du navigateur

- -

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

- -

{{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.

- -

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/runtime/oninstalledreason/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalledreason/index.md new file mode 100644 index 0000000000..1e02e04511 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalledreason/index.md @@ -0,0 +1,77 @@ +--- +title: runtime.OnInstalledReason +slug: Mozilla/Add-ons/WebExtensions/API/runtime/OnInstalledReason +tags: + - API + - Add-ons + - Extensions + - Non-standard + - OnInstalledReason + - Reference + - Type + - WebExtensions + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/OnInstalledReason +--- +
{{AddonSidebar()}}
+ +

Les valeurs pour laquelle l'événement {{WebExtAPIRef("runtime.onInstalled")}} est en cours d'envoi.

+ +

Type

+ +

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

+ +
+
"install"
+
L'extension a été installée.
+
"update"
+
L'extension a été mise à jour vers une nouvelle version.
+
"browser_update"
+
Le navigateur a été mise à jour vers une nouvelle version.
+
"shared_module_update"
+
Une autre extension, qui contient un module utilisé par cette extension, a été mise à jour.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{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.

+ +

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/runtime/onmessage/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html deleted file mode 100644 index f946a74336..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.html +++ /dev/null @@ -1,326 +0,0 @@ ---- -title: runtime.onMessage -slug: Mozilla/Add-ons/WebExtensions/API/runtime/onMessage -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onmessage - - 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.

- -

Voici quelques exemples de cas d'utilisation :

- - - -

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()")}}.

- -
-

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.

-
- -

En plus du message, l’écouteur reçoit en paramètres :

- - - -

Vous pouvez envoyer une réponse synchrone au message en appelant la fonction sendResponse() dans votre écouteur. Voir un exemple.

- -

Pour envoyer une réponse asynchrone, il existe deux options :

- - - -
-

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.

-
- -
-

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

-
- -

Syntaxe

- -
browser.runtime.onMessage.addListener(listener)
-browser.runtime.onMessage.removeListener(listener)
-browser.runtime.onMessage.hasListener(listener)
-
- -

Les événements ont trois fonctions :

- -
-
addListener(listener)
-
Ajoute un écouteur à cet événement.
-
removeListener(listener)
-
Cesse d’écouter cet événement. L’argument listener est l’écouteur à supprimer.
-
hasListener(listener)
-
Vérifie si un listener est enregistré pour cet événement. Retourne true s’il écoute, false sinon.
-
- -

Syntaxe de addListener

- -

Paramètres

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

- -

Si vous avez plus d'un écouteur onMessage() dans le même document, alors un seul peut envoyer une réponse.

- -

Pour envoyer une réponse de manière synchrone, appelez sendResponse() avant le retour de la fonction d'écoute.

- -

Pour envoyer une réponse de manière asynchrone :

- -
    -
  • soit on gardera une référence à l'argument sendResponse() et on retournera true depuis la fonction listenener. sendResponse() pourra être appelée après le retour de la fonction d'écoute.
    • -
  • ou on retournera {{jsxref("Promise")}} à partir de la fonction d'écoute et on résoudra la promesse lorsque la réponse sera prête. C'est la méthode à privilégier.
    • -
-
-
- -

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

- -
-

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

- - 
// ne faites pas ça
-browser.runtime.onMessage.addListener(
-  async (data, sender) => {
-    if (data.type === 'handle_me') { return 'done'; }
-  }
-);
-
- -

L'écouteur consommera ainsi chaque message qu'il reçoit, ce qui empêchera effectivement tous les autres écouteurs de recevoir et de traiter des messages.

- -

Si vous souhaitez adopter une approche asynchrone, utilisez plutôt une Promise, comme ceci :

- - 
browser.runtime.onMessage.addListener(
-  (data, sender) => {
-    if (data.type === 'handle_me') {
-      return Promise.resolve('done');
-    }
-  }
-);
-
-
-
-
- -

Compatibilité des navigateurs

- -

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

- -

Exemples

- -

Exemple simple

- -

Ce script de contenu écoute les événements clic dans la page web. Si le clic a eu lieu sur un lien, il envoie un message à la page d’arrière-plan avec l’URL cible :

- -
// content-script.js
-
-window.addEventListener("click", notifyExtension);
-
-function notifyExtension(e) {
-  if (e.target.tagName != "A") {
-    return;
-  }
-  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.

- -
// background-script.js
-
-browser.runtime.onMessage.addListener(notify);
-
-function notify(message) {
-  browser.notifications.create({
-    "type": "basic",
-    "iconUrl": browser.extension.getURL("link.png"),
-    "title": "Vous avez cliqué sur un lien !",
-    "message": message.url
-  });
-}
- -

Envoyer une réponse synchrone

- -

Le script de contenu suivant envoie un message au script d’arrière-plan lorsque l’utilisateur ou l’utilisatrice clique sur la page. Il enregistre également toute réponse envoyée par le script d’arrière-plan :

- -
// content-script.js
-
-function handleResponse(message) {
-  console.log(`le script d’arrière-plan a répondu : ${message.response}`);
-}
-
-function handleError(error) {
-  console.log(`Erreur : ${error}`);
-}
-
-function sendMessage(e) {
-  var sending = browser.runtime.sendMessage({content: "message du script de contenu"});
-  sending.then(handleResponse, handleError);
-}
-
-window.addEventListener("click", sendMessage);
- -

Voici une version du script d’arrière-plan correspondant, qui envoie une réponse de manière synchrone depuis l’intérieur de l’écouteur :

- -
// background-script.js
-
-function handleMessage(request, sender, sendResponse) {
-  console.log(`le script de contenu a envoyé un message : ${request.content}`);
-  sendResponse({response: "réponse du script d’arrière-plan"});
-}
-
-browser.runtime.onMessage.addListener(handleMessage);
- -

Et voici une autre version, qui utilise {{jsxref("Promise.resolve()")}} :

- -
// background-script.js
-
-function handleMessage(request, sender, sendResponse) {
-  console.log(`le script de contenu a envoyé un message : ${request.content}`);
-  return Promise.resolve({response: "réponse du script d’arrière-plan"});
-}
-
-browser.runtime.onMessage.addListener(handleMessage);
- -

Envoi d’une réponse asynchrone à l’aide de sendResponse

- -

Voici une autre version du script d’arrière-plan de l’exemple précédent. Il envoie une réponse de manière asynchrone, après le retour de l’écouteur. Remarquez le return true; dans l’écouteur : cela indique au navigateur que vous avez l’intention d’utiliser l’argument sendResponse() après le retour de l’écouteur.

- -
// background-script.js
-
-function handleMessage(request, sender, sendResponse) {
-  console.log(`le script de contenu a envoyé un message : ${request.content}`);
-  setTimeout(() => {
-    sendResponse({response: "réponse asynchrone du script d’arrière-plan"});
-  }, 1000);
-  return true;
-}
-
-browser.runtime.onMessage.addListener(handleMessage);
- -

Envoi d’une réponse asynchrone à l’aide d’une promesse

- -

Ce script de contenu reçoit le premier lien <a> dans la page, et envoie un message demandant si l’emplacement du lien fait partie des marque-pages. Il attend comme réponse un {{jsxref("Boolean", "booléen")}} : true si l’emplacement est dans les marque-pages, false sinon.

- -
// content-script.js
-
-const firstLink = document.querySelector("a");
-
-function handleResponse(isBookmarked) {
-  if (isBookmarked) {
-    firstLink.classList.add("bookmarked");
-  }
-}
-
-browser.runtime.sendMessage({
-  url: firstLink.href
-}).then(handleResponse);
- -

Voici le script d’arrière-plan. Il utilise {{WebExtAPIRef("bookmarks.search()")}} pour voir si le lien est dans les marque-pages, ce qui renvoie une {{jsxref("Promise", "promesse")}} :

- -
// background-script.js
-
-function isBookmarked(message, sender, response) {
-  return browser.bookmarks.search({
-    url: message.url
-  }).then(function(results) {
-    return results.length > 0;
-  });
-}
-
-browser.runtime.onMessage.addListener(isBookmarked);
- -

Si le gestionnaire asynchrone ne renvoie pas de promesse, vous pouvez explicitement construire une promesse. Cet exemple plutôt artificiel envoie une réponse après un délai d’une seconde, en utilisant Window.setTimeout() :

- -
// background-script.js
-
-function handleMessage(request, sender, sendResponse) {
-  return new Promise(resolve => {
-    setTimeout(() => {
-      resolve({response: "réponse asynchrone du script d’arrière-plan"});
-    }, 1000);
-  });
-}
-
-browser.runtime.onMessage.addListener(handleMessage);
- -

{{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.

- -

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/runtime/onmessage/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.md new file mode 100644 index 0000000000..f946a74336 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.md @@ -0,0 +1,326 @@ +--- +title: runtime.onMessage +slug: Mozilla/Add-ons/WebExtensions/API/runtime/onMessage +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onmessage + - 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.

+ +

Voici quelques exemples de cas d'utilisation :

+ + + +

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()")}}.

+ +
+

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.

+
+ +

En plus du message, l’écouteur reçoit en paramètres :

+ + + +

Vous pouvez envoyer une réponse synchrone au message en appelant la fonction sendResponse() dans votre écouteur. Voir un exemple.

+ +

Pour envoyer une réponse asynchrone, il existe deux options :

+ + + +
+

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.

+
+ +
+

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

+
+ +

Syntaxe

+ +
browser.runtime.onMessage.addListener(listener)
+browser.runtime.onMessage.removeListener(listener)
+browser.runtime.onMessage.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
addListener(listener)
+
Ajoute un écouteur à cet événement.
+
removeListener(listener)
+
Cesse d’écouter cet événement. L’argument listener est l’écouteur à supprimer.
+
hasListener(listener)
+
Vérifie si un listener est enregistré pour cet événement. Retourne true s’il écoute, false sinon.
+
+ +

Syntaxe de addListener

+ +

Paramètres

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

+ +

Si vous avez plus d'un écouteur onMessage() dans le même document, alors un seul peut envoyer une réponse.

+ +

Pour envoyer une réponse de manière synchrone, appelez sendResponse() avant le retour de la fonction d'écoute.

+ +

Pour envoyer une réponse de manière asynchrone :

+ +
    +
  • soit on gardera une référence à l'argument sendResponse() et on retournera true depuis la fonction listenener. sendResponse() pourra être appelée après le retour de la fonction d'écoute.
    • +
  • ou on retournera {{jsxref("Promise")}} à partir de la fonction d'écoute et on résoudra la promesse lorsque la réponse sera prête. C'est la méthode à privilégier.
    • +
+
+
+ +

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

+ +
+

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

+ + 
// ne faites pas ça
+browser.runtime.onMessage.addListener(
+  async (data, sender) => {
+    if (data.type === 'handle_me') { return 'done'; }
+  }
+);
+
+ +

L'écouteur consommera ainsi chaque message qu'il reçoit, ce qui empêchera effectivement tous les autres écouteurs de recevoir et de traiter des messages.

+ +

Si vous souhaitez adopter une approche asynchrone, utilisez plutôt une Promise, comme ceci :

+ + 
browser.runtime.onMessage.addListener(
+  (data, sender) => {
+    if (data.type === 'handle_me') {
+      return Promise.resolve('done');
+    }
+  }
+);
+
+
+
+
+ +

Compatibilité des navigateurs

+ +

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

+ +

Exemples

+ +

Exemple simple

+ +

Ce script de contenu écoute les événements clic dans la page web. Si le clic a eu lieu sur un lien, il envoie un message à la page d’arrière-plan avec l’URL cible :

+ +
// content-script.js
+
+window.addEventListener("click", notifyExtension);
+
+function notifyExtension(e) {
+  if (e.target.tagName != "A") {
+    return;
+  }
+  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.

+ +
// background-script.js
+
+browser.runtime.onMessage.addListener(notify);
+
+function notify(message) {
+  browser.notifications.create({
+    "type": "basic",
+    "iconUrl": browser.extension.getURL("link.png"),
+    "title": "Vous avez cliqué sur un lien !",
+    "message": message.url
+  });
+}
+ +

Envoyer une réponse synchrone

+ +

Le script de contenu suivant envoie un message au script d’arrière-plan lorsque l’utilisateur ou l’utilisatrice clique sur la page. Il enregistre également toute réponse envoyée par le script d’arrière-plan :

+ +
// content-script.js
+
+function handleResponse(message) {
+  console.log(`le script d’arrière-plan a répondu : ${message.response}`);
+}
+
+function handleError(error) {
+  console.log(`Erreur : ${error}`);
+}
+
+function sendMessage(e) {
+  var sending = browser.runtime.sendMessage({content: "message du script de contenu"});
+  sending.then(handleResponse, handleError);
+}
+
+window.addEventListener("click", sendMessage);
+ +

Voici une version du script d’arrière-plan correspondant, qui envoie une réponse de manière synchrone depuis l’intérieur de l’écouteur :

+ +
// background-script.js
+
+function handleMessage(request, sender, sendResponse) {
+  console.log(`le script de contenu a envoyé un message : ${request.content}`);
+  sendResponse({response: "réponse du script d’arrière-plan"});
+}
+
+browser.runtime.onMessage.addListener(handleMessage);
+ +

Et voici une autre version, qui utilise {{jsxref("Promise.resolve()")}} :

+ +
// background-script.js
+
+function handleMessage(request, sender, sendResponse) {
+  console.log(`le script de contenu a envoyé un message : ${request.content}`);
+  return Promise.resolve({response: "réponse du script d’arrière-plan"});
+}
+
+browser.runtime.onMessage.addListener(handleMessage);
+ +

Envoi d’une réponse asynchrone à l’aide de sendResponse

+ +

Voici une autre version du script d’arrière-plan de l’exemple précédent. Il envoie une réponse de manière asynchrone, après le retour de l’écouteur. Remarquez le return true; dans l’écouteur : cela indique au navigateur que vous avez l’intention d’utiliser l’argument sendResponse() après le retour de l’écouteur.

+ +
// background-script.js
+
+function handleMessage(request, sender, sendResponse) {
+  console.log(`le script de contenu a envoyé un message : ${request.content}`);
+  setTimeout(() => {
+    sendResponse({response: "réponse asynchrone du script d’arrière-plan"});
+  }, 1000);
+  return true;
+}
+
+browser.runtime.onMessage.addListener(handleMessage);
+ +

Envoi d’une réponse asynchrone à l’aide d’une promesse

+ +

Ce script de contenu reçoit le premier lien <a> dans la page, et envoie un message demandant si l’emplacement du lien fait partie des marque-pages. Il attend comme réponse un {{jsxref("Boolean", "booléen")}} : true si l’emplacement est dans les marque-pages, false sinon.

+ +
// content-script.js
+
+const firstLink = document.querySelector("a");
+
+function handleResponse(isBookmarked) {
+  if (isBookmarked) {
+    firstLink.classList.add("bookmarked");
+  }
+}
+
+browser.runtime.sendMessage({
+  url: firstLink.href
+}).then(handleResponse);
+ +

Voici le script d’arrière-plan. Il utilise {{WebExtAPIRef("bookmarks.search()")}} pour voir si le lien est dans les marque-pages, ce qui renvoie une {{jsxref("Promise", "promesse")}} :

+ +
// background-script.js
+
+function isBookmarked(message, sender, response) {
+  return browser.bookmarks.search({
+    url: message.url
+  }).then(function(results) {
+    return results.length > 0;
+  });
+}
+
+browser.runtime.onMessage.addListener(isBookmarked);
+ +

Si le gestionnaire asynchrone ne renvoie pas de promesse, vous pouvez explicitement construire une promesse. Cet exemple plutôt artificiel envoie une réponse après un délai d’une seconde, en utilisant Window.setTimeout() :

+ +
// background-script.js
+
+function handleMessage(request, sender, sendResponse) {
+  return new Promise(resolve => {
+    setTimeout(() => {
+      resolve({response: "réponse asynchrone du script d’arrière-plan"});
+    }, 1000);
+  });
+}
+
+browser.runtime.onMessage.addListener(handleMessage);
+ +

{{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.

+ +

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/runtime/onmessageexternal/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessageexternal/index.html deleted file mode 100644 index 497fcab12a..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessageexternal/index.html +++ /dev/null @@ -1,155 +0,0 @@ ---- -title: runtime.onMessageExternal -slug: Mozilla/Add-ons/WebExtensions/API/runtime/onMessageExternal -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onMessageExternal - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onMessageExternal ---- -
{{AddonSidebar()}}
- -
-
Utilisez cet événement pour écouter les messages d'une autre extension.
- -
- -

Pour envoyer un message qui sera reçu par le module d'écoute onMessageExternal, utilisez {{WebExtAPIRef("runtime.sendMessage()")}}, en transmettant l'ID du destinataire dans le paramètre extensionId.

- -

Avec le message lui-même, l'écouteur est transmis :

- - -
- -

Cette API ne peut pas être utilisée dans un script de contenu.

- -

Syntax

- -
browser.runtime.onMessageExternal.addListener()
-browser.runtime.onMessageExternal.removeListener(listener)
-browser.runtime.onMessageExternal.hasListener(listener)
-
- -

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 listener est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifie si un listener est enregistré pour cet événement. Renvoie true s'il écoute, false sinon.
-
- -

Syntaxe addListener

- -

Paramètres

- -
-
function
-
-

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

- -
-
message
-
object. Le message lui-même. C'est un objet JSON-ifiable.
-
- -
-
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 JSON-ifiable. Cet argument est renvoyé à l'expéditeur du message.

- -

Si vous avez plus d'un écouteur onMessageExternal dans le même document, un seul peut envoyer une réponse.

- -

To send a response synchronously, call sendResponse before the listener function returns. To send a response asynchronously:

- -
    -
  • Soit garder une référence à l'argumen sendResponse et retourne true à partir de la fonction d'écouteur. Vous pourrez ensuite appeler sendResponse après le retour de la fonction d'écouteur..
    • -
  • ou retourne une Promise de la fonction d'écouteur et résoudre la promesse lorsque la réponse est prête.
    • -
-
-
-
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Dans cet exemple, l'extension "blue@mozilla.org" envoie un message  à l'extension "red@mozilla.org":

- -
// sender: browser.runtime.id == "blue@mozilla.org"
-
-// Send a message to the extension whose ID is "red@mozilla.org"
-browser.runtime.sendMessage(
-    "red@mozilla.org",
-    "my message"
-  );
- -
// recipient: browser.runtime.id == "red@mozilla.org"
-
-function handleMessage(message, sender) {
-  // check that the message is from "blue@mozilla.org"
-  if (sender.id === "blue@mozilla.org") {
-    // process message
-  }
-}
-
-browser.runtime.onMessageExternal.addListener(handleMessage);
- -

{{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.

- -

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/runtime/onmessageexternal/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessageexternal/index.md new file mode 100644 index 0000000000..497fcab12a --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessageexternal/index.md @@ -0,0 +1,155 @@ +--- +title: runtime.onMessageExternal +slug: Mozilla/Add-ons/WebExtensions/API/runtime/onMessageExternal +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onMessageExternal + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onMessageExternal +--- +
{{AddonSidebar()}}
+ +
+
Utilisez cet événement pour écouter les messages d'une autre extension.
+ +
+ +

Pour envoyer un message qui sera reçu par le module d'écoute onMessageExternal, utilisez {{WebExtAPIRef("runtime.sendMessage()")}}, en transmettant l'ID du destinataire dans le paramètre extensionId.

+ +

Avec le message lui-même, l'écouteur est transmis :

+ + +
+ +

Cette API ne peut pas être utilisée dans un script de contenu.

+ +

Syntax

+ +
browser.runtime.onMessageExternal.addListener()
+browser.runtime.onMessageExternal.removeListener(listener)
+browser.runtime.onMessageExternal.hasListener(listener)
+
+ +

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 listener est l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifie si un listener est enregistré pour cet événement. Renvoie true s'il écoute, false sinon.
+
+ +

Syntaxe addListener

+ +

Paramètres

+ +
+
function
+
+

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

+ +
+
message
+
object. Le message lui-même. C'est un objet JSON-ifiable.
+
+ +
+
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 JSON-ifiable. Cet argument est renvoyé à l'expéditeur du message.

+ +

Si vous avez plus d'un écouteur onMessageExternal dans le même document, un seul peut envoyer une réponse.

+ +

To send a response synchronously, call sendResponse before the listener function returns. To send a response asynchronously:

+ +
    +
  • Soit garder une référence à l'argumen sendResponse et retourne true à partir de la fonction d'écouteur. Vous pourrez ensuite appeler sendResponse après le retour de la fonction d'écouteur..
    • +
  • ou retourne une Promise de la fonction d'écouteur et résoudre la promesse lorsque la réponse est prête.
    • +
+
+
+
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Dans cet exemple, l'extension "blue@mozilla.org" envoie un message  à l'extension "red@mozilla.org":

+ +
// sender: browser.runtime.id == "blue@mozilla.org"
+
+// Send a message to the extension whose ID is "red@mozilla.org"
+browser.runtime.sendMessage(
+    "red@mozilla.org",
+    "my message"
+  );
+ +
// recipient: browser.runtime.id == "red@mozilla.org"
+
+function handleMessage(message, sender) {
+  // check that the message is from "blue@mozilla.org"
+  if (sender.id === "blue@mozilla.org") {
+    // process message
+  }
+}
+
+browser.runtime.onMessageExternal.addListener(handleMessage);
+ +

{{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.

+ +

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/runtime/onrestartrequired/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequired/index.html deleted file mode 100644 index 117554432e..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequired/index.html +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: runtime.onRestartRequired -slug: Mozilla/Add-ons/WebExtensions/API/runtime/onRestartRequired -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onRestartRequired - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onRestartRequired ---- -
{{AddonSidebar()}}
- -

Lancé lorsqu'une application ou le périphérique sur lequel elle s'exécute doit être redémarré. L'application devrait fermer toutes ses fenêtres dans les meilleurs délais pour permettre le redémarrage. Si l'application ne fait rien, un redémarrage sera appliqué après une période de grâce de 24 heures. Actuellement, cet événement est uniquement déclenché pour les applications de kiosque Chrome OS.

- -

Syntaxe

- -
browser.runtime.onRestartRequired.addListener(listener)
-browser.runtime.onRestartRequired.removeListener(listener)
-browser.runtime.onRestartRequired.hasListener(listener)
-
- -

Les événements ont trois fonctions :

- -
-
addListener(callback)
-
Ajouter un écouteur à cet événement.
-
removeListener(listener)
-
Arrêtez d'écouter cet événement. L'argument listener est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifie si un listener est enregistré pour cet événement. Renvoie true s'il écoute, false sinon.
-
- -

Syntaxe addListener

- -

Paramètres

- -
-
fonction
-
-

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

- -
-
raison
-
Une valeur {{WebExtAPIRef('runtime.OnRestartRequiredReason')}} — La raison pour laquelle l'événemtn est envoyé.
-
-
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

{{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.

- -

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/runtime/onrestartrequired/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequired/index.md new file mode 100644 index 0000000000..117554432e --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequired/index.md @@ -0,0 +1,98 @@ +--- +title: runtime.onRestartRequired +slug: Mozilla/Add-ons/WebExtensions/API/runtime/onRestartRequired +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onRestartRequired + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onRestartRequired +--- +
{{AddonSidebar()}}
+ +

Lancé lorsqu'une application ou le périphérique sur lequel elle s'exécute doit être redémarré. L'application devrait fermer toutes ses fenêtres dans les meilleurs délais pour permettre le redémarrage. Si l'application ne fait rien, un redémarrage sera appliqué après une période de grâce de 24 heures. Actuellement, cet événement est uniquement déclenché pour les applications de kiosque Chrome OS.

+ +

Syntaxe

+ +
browser.runtime.onRestartRequired.addListener(listener)
+browser.runtime.onRestartRequired.removeListener(listener)
+browser.runtime.onRestartRequired.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
addListener(callback)
+
Ajouter un écouteur à cet événement.
+
removeListener(listener)
+
Arrêtez d'écouter cet événement. L'argument listener est l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifie si un listener est enregistré pour cet événement. Renvoie true s'il écoute, false sinon.
+
+ +

Syntaxe addListener

+ +

Paramètres

+ +
+
fonction
+
+

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

+ +
+
raison
+
Une valeur {{WebExtAPIRef('runtime.OnRestartRequiredReason')}} — La raison pour laquelle l'événemtn est envoyé.
+
+
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

{{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.

+ +

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/runtime/onrestartrequiredreason/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequiredreason/index.html deleted file mode 100644 index 4f7806847c..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequiredreason/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: runtime.OnRestartRequiredReason -slug: Mozilla/Add-ons/WebExtensions/API/runtime/OnRestartRequiredReason -tags: - - API - - Add-ons - - Extensions - - Non-standard - - OnRestartsRequiredReason - - Reference - - Type - - WebExtensions - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/OnRestartRequiredReason ---- -
{{AddonSidebar()}}
- -

La raison pour laquelle l'événement  {{WebExtAPIRef("runtime.onRestartRequired", "onRestartRequired")}} est en cours d'exécution.

- -

Type

- -

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

- - - -

Compatibilité du navigateur

- -

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

- -

{{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.

- -

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/runtime/onrestartrequiredreason/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequiredreason/index.md new file mode 100644 index 0000000000..4f7806847c --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequiredreason/index.md @@ -0,0 +1,72 @@ +--- +title: runtime.OnRestartRequiredReason +slug: Mozilla/Add-ons/WebExtensions/API/runtime/OnRestartRequiredReason +tags: + - API + - Add-ons + - Extensions + - Non-standard + - OnRestartsRequiredReason + - Reference + - Type + - WebExtensions + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/OnRestartRequiredReason +--- +
{{AddonSidebar()}}
+ +

La raison pour laquelle l'événement  {{WebExtAPIRef("runtime.onRestartRequired", "onRestartRequired")}} est en cours d'exécution.

+ +

Type

+ +

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

+ + + +

Compatibilité du navigateur

+ +

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

+ +

{{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.

+ +

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/runtime/onstartup/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onstartup/index.html deleted file mode 100644 index 039bb149a4..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onstartup/index.html +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: runtime.onStartup -slug: Mozilla/Add-ons/WebExtensions/API/runtime/onStartup -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onStartup - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onStartup ---- -
{{AddonSidebar()}}
- -

Lancé quand un profil ayant cette extension installée démarre une session. Cet événement n'est pas déclenché lorsqu'une navigation privée / profil privé est démarré, même si cette extension fonctionne en mode de navigation privée 'split'.

- -

Syntaxe

- -
browser.runtime.onStartup.addListener(listener)
-browser.runtime.onStartup.removeListener(listener)
-browser.runtime.onStartup.hasListener(listener)
-
- -

Fonctions des événements

- -

Les événements ont trois fonctions :

- -
-
addListener(callback)
-
Ajoute un écouteur à écouteur.
-
removeListener(listener)
-
Arrête d'écouter cet événement. L'argument listener est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifie si un écouteur est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.
-
- -

Parameters

- -
-
callback
-
Une fonction qui sera appelée lorsque cet événement se produit.
-
- -

Exemples

- -

Ouvre http://chilloutandwatchsomecatgifs.com/ quand le navigateur démarre :

- -
function handleStartup() {
-  browser.tabs.create({
-    url: "http://chilloutandwatchsomecatgifs.com/"
-  });
-}
-
-browser.runtime.onStartup.addListener(handleStartup);
- -
-

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.

-

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.

-
- - - -

Compatibilité du navigateur

- -

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/runtime/onstartup/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onstartup/index.md new file mode 100644 index 0000000000..039bb149a4 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onstartup/index.md @@ -0,0 +1,98 @@ +--- +title: runtime.onStartup +slug: Mozilla/Add-ons/WebExtensions/API/runtime/onStartup +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onStartup + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onStartup +--- +
{{AddonSidebar()}}
+ +

Lancé quand un profil ayant cette extension installée démarre une session. Cet événement n'est pas déclenché lorsqu'une navigation privée / profil privé est démarré, même si cette extension fonctionne en mode de navigation privée 'split'.

+ +

Syntaxe

+ +
browser.runtime.onStartup.addListener(listener)
+browser.runtime.onStartup.removeListener(listener)
+browser.runtime.onStartup.hasListener(listener)
+
+ +

Fonctions des événements

+ +

Les événements ont trois fonctions :

+ +
+
addListener(callback)
+
Ajoute un écouteur à écouteur.
+
removeListener(listener)
+
Arrête d'écouter cet événement. L'argument listener est l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifie si un écouteur est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.
+
+ +

Parameters

+ +
+
callback
+
Une fonction qui sera appelée lorsque cet événement se produit.
+
+ +

Exemples

+ +

Ouvre http://chilloutandwatchsomecatgifs.com/ quand le navigateur démarre :

+ +
function handleStartup() {
+  browser.tabs.create({
+    url: "http://chilloutandwatchsomecatgifs.com/"
+  });
+}
+
+browser.runtime.onStartup.addListener(handleStartup);
+ +
+

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.

+

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.

+
+ + + +

Compatibilité du navigateur

+ +

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspend/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspend/index.html deleted file mode 100644 index 28d601ead7..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspend/index.html +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: runtime.onSuspend -slug: Mozilla/Add-ons/WebExtensions/API/runtime/onSuspend -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onSuspend - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onSuspend ---- -
{{AddonSidebar()}}
- -

Envoyé sur la page de l'événement juste avant son déchargement. Cela donne à l'extension l'opportunité de faire un peu de nettoyage. Notez que, comme la page est en cours de déchargement, les opérations asynchrones démarrées lors de la gestion de cet événement ne sont pas garanties.

- -
-

Note : Si quelque chose empêche le déchargement de la page d'événement, l'événement {{WebExtAPIRef("runtime.onSuspendCanceled")}} sera envoyé et la page ne sera pas déchargée.

-
- -

Syntaxe

- -
browser.runtime.onSuspend.addListener(listener)
-browser.runtime.onSuspend.removeListener(listener)
-browser.runtime.onSuspend.hasListener(listener)
-
- -

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 listener est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifie si un écouteur est enregistré pour cet événement. Retourne true s'il est écouté, sinon false.
-
- -

Syntaxe addListener

- -

Paramètres

- -
-
callback
-
-

Fonction dui sera appelée lorsque cet événement se produit

-
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Ecoutez les événements suspendus :

- -
function handleSuspend() {
-  console.log("Suspending event page");
-  // handle cleanup
-}
-
-browser.runtime.onSuspend.addListener(handleSuspend);
- -

{{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.

- -

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/runtime/onsuspend/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspend/index.md new file mode 100644 index 0000000000..28d601ead7 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspend/index.md @@ -0,0 +1,106 @@ +--- +title: runtime.onSuspend +slug: Mozilla/Add-ons/WebExtensions/API/runtime/onSuspend +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onSuspend + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onSuspend +--- +
{{AddonSidebar()}}
+ +

Envoyé sur la page de l'événement juste avant son déchargement. Cela donne à l'extension l'opportunité de faire un peu de nettoyage. Notez que, comme la page est en cours de déchargement, les opérations asynchrones démarrées lors de la gestion de cet événement ne sont pas garanties.

+ +
+

Note : Si quelque chose empêche le déchargement de la page d'événement, l'événement {{WebExtAPIRef("runtime.onSuspendCanceled")}} sera envoyé et la page ne sera pas déchargée.

+
+ +

Syntaxe

+ +
browser.runtime.onSuspend.addListener(listener)
+browser.runtime.onSuspend.removeListener(listener)
+browser.runtime.onSuspend.hasListener(listener)
+
+ +

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 listener est l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifie si un écouteur est enregistré pour cet événement. Retourne true s'il est écouté, sinon false.
+
+ +

Syntaxe addListener

+ +

Paramètres

+ +
+
callback
+
+

Fonction dui sera appelée lorsque cet événement se produit

+
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Ecoutez les événements suspendus :

+ +
function handleSuspend() {
+  console.log("Suspending event page");
+  // handle cleanup
+}
+
+browser.runtime.onSuspend.addListener(handleSuspend);
+ +

{{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.

+ +

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/runtime/onsuspendcanceled/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspendcanceled/index.html deleted file mode 100644 index 1e38dbd73f..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspendcanceled/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: runtime.onSuspendCanceled -slug: Mozilla/Add-ons/WebExtensions/API/runtime/onSuspendCanceled -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onSuspendCanceled - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onSuspendCanceled ---- -
{{AddonSidebar()}}
- -

Envoyé après {{WebExtAPIRef("runtime.onSuspend")}} pour indiquer que l'application  ne sera pas déchargée après tout.

- -

Syntaxe

- -
browser.runtime.onSuspendCanceled.addListener(listener)
-browser.runtime.onSuspendCanceled.removeListener(listener)
-browser.runtime.onSuspendCanceled.hasListener(listener)
-
- -

Les événements ont trois fonctions :

- -
-
addListener(callback)
-
Ajouter un écouteur à cet événement.
-
removeListener(listener)
-
Arrêtez d'écouter cet événement. L'argument listener est un écouteur à suppriimer.
-
hasListener(listener)
-
Vérifie si un écouteur est enregistré pour cet événement. Retourne true s'il écoute, sinon false.
-
- -

Syntaxe addListener

- -

Paramètres

- -
-
callback
-
-

Fonction qui sera appelée lorsque cet événement se produit.

-
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Ecoutez les événements SuspendCanceled :

- -
function handleSuspendCanceled() {
-  console.log("Suspend canceled");
-}
-
-browser.runtime.onSuspendCanceled.addListener(handleSuspendCanceled);
- -

{{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.

- -

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/runtime/onsuspendcanceled/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspendcanceled/index.md new file mode 100644 index 0000000000..1e38dbd73f --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspendcanceled/index.md @@ -0,0 +1,101 @@ +--- +title: runtime.onSuspendCanceled +slug: Mozilla/Add-ons/WebExtensions/API/runtime/onSuspendCanceled +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onSuspendCanceled + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onSuspendCanceled +--- +
{{AddonSidebar()}}
+ +

Envoyé après {{WebExtAPIRef("runtime.onSuspend")}} pour indiquer que l'application  ne sera pas déchargée après tout.

+ +

Syntaxe

+ +
browser.runtime.onSuspendCanceled.addListener(listener)
+browser.runtime.onSuspendCanceled.removeListener(listener)
+browser.runtime.onSuspendCanceled.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
addListener(callback)
+
Ajouter un écouteur à cet événement.
+
removeListener(listener)
+
Arrêtez d'écouter cet événement. L'argument listener est un écouteur à suppriimer.
+
hasListener(listener)
+
Vérifie si un écouteur est enregistré pour cet événement. Retourne true s'il écoute, sinon false.
+
+ +

Syntaxe addListener

+ +

Paramètres

+ +
+
callback
+
+

Fonction qui sera appelée lorsque cet événement se produit.

+
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Ecoutez les événements SuspendCanceled :

+ +
function handleSuspendCanceled() {
+  console.log("Suspend canceled");
+}
+
+browser.runtime.onSuspendCanceled.addListener(handleSuspendCanceled);
+ +

{{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.

+ +

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/runtime/onupdateavailable/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/onupdateavailable/index.html deleted file mode 100644 index c30803e06f..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onupdateavailable/index.html +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: runtime.onUpdateAvailable -slug: Mozilla/Add-ons/WebExtensions/API/runtime/onUpdateAvailable -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onUpdateAvailable - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onUpdateAvailable ---- -
{{AddonSidebar()}}
- -

Déclenché quand une mise à jour de l'extension est disponible. Cet événement permet à une extension de retarder une mise à jour : par exemple, car elle est au milieu d'une opération qui ne doit pas être interrompue.

- -

Si l'extension n'écoute pas cet événement lorsqu'une mise à jour est disponible, l'extension est rechargée immédiatement et la mise à jour est appliquée. Si l'extension est à l'écoute, la mise à jour sera appliquée la prochaine fois que l'extension sera rechargée. Cela arrive si :

- - - -

Syntaxe

- -
browser.runtime.onUpdateAvailable.addListener()
-browser.runtime.onUpdateAvailable.removeListener(listener)
-browser.runtime.onUpdateAvailable.hasListener(listener)
-
- -

Les événements ont trois fonctions :

- -
-
addListener(callback)
-
Ajouter un écouteur à cet événement.
-
removeListener(listener)
-
Arrêtez d'écouter cet événement. L'argumentlistener est un écouteur à supprimer.
-
hasListener(listener)
-
Vérifie que l'écouteur est enregistré pour cet événement. Retourne true s'il écoute, sinon false.
-
- -

Syntaxe addListener

- -

Paramètres

- -
-
callback
-
-

Fonction qui sera appelée quand cet événement se produit. La fonction recevra les arguments suivants :

- -
-
details
-
object. Contient une seule propriété, une chaîne nommée version, qui représente le numéro de version de la mise à jour.
-
-
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Ecoutez les événements UpdateAvailable:

- -
function handleUpdateAvailable(details) {
-  console.log(details.version);
-}
-
-browser.runtime.onUpdateAvailable.addListener(handleUpdateAvailable);
- -

{{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.

- -

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/runtime/onupdateavailable/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onupdateavailable/index.md new file mode 100644 index 0000000000..c30803e06f --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onupdateavailable/index.md @@ -0,0 +1,114 @@ +--- +title: runtime.onUpdateAvailable +slug: Mozilla/Add-ons/WebExtensions/API/runtime/onUpdateAvailable +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onUpdateAvailable + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onUpdateAvailable +--- +
{{AddonSidebar()}}
+ +

Déclenché quand une mise à jour de l'extension est disponible. Cet événement permet à une extension de retarder une mise à jour : par exemple, car elle est au milieu d'une opération qui ne doit pas être interrompue.

+ +

Si l'extension n'écoute pas cet événement lorsqu'une mise à jour est disponible, l'extension est rechargée immédiatement et la mise à jour est appliquée. Si l'extension est à l'écoute, la mise à jour sera appliquée la prochaine fois que l'extension sera rechargée. Cela arrive si :

+ + + +

Syntaxe

+ +
browser.runtime.onUpdateAvailable.addListener()
+browser.runtime.onUpdateAvailable.removeListener(listener)
+browser.runtime.onUpdateAvailable.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
addListener(callback)
+
Ajouter un écouteur à cet événement.
+
removeListener(listener)
+
Arrêtez d'écouter cet événement. L'argumentlistener est un écouteur à supprimer.
+
hasListener(listener)
+
Vérifie que l'écouteur est enregistré pour cet événement. Retourne true s'il écoute, sinon false.
+
+ +

Syntaxe addListener

+ +

Paramètres

+ +
+
callback
+
+

Fonction qui sera appelée quand cet événement se produit. La fonction recevra les arguments suivants :

+ +
+
details
+
object. Contient une seule propriété, une chaîne nommée version, qui représente le numéro de version de la mise à jour.
+
+
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Ecoutez les événements UpdateAvailable:

+ +
function handleUpdateAvailable(details) {
+  console.log(details.version);
+}
+
+browser.runtime.onUpdateAvailable.addListener(handleUpdateAvailable);
+ +

{{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.

+ +

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/runtime/openoptionspage/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.html deleted file mode 100644 index 1c83d24be8..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: runtime.openOptionsPage() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/openOptionsPage -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/openOptionsPage ---- -
{{AddonSidebar()}}
- -
Si votre extension a défini une page d'options, cette méthode l'ouvre.
- -
- -

C'est une fonction asynchrone  qui renvoie une Promise.

- -

Syntaxe

- -
var openingPage = browser.runtime.openOptionsPage()
-
- -

Paramètres

- -

None.

- -

valeur retournée

- -

Une Promise qui sera remplie sans argument lorsque la page d'options a été créée avec succés, ou rejetée avec un message d'erreur si l'opération a échoué.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Ouvrez une page d'options lorsque l'utilisateur clique sur l'icône d'une action du navigateur :

- -
function onOpened() {
-  console.log(`Options page opened`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var opening = browser.runtime.openOptionsPage();
-opening.then(onOpened, onError);
- -

{{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.

- -

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/runtime/openoptionspage/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.md new file mode 100644 index 0000000000..1c83d24be8 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.md @@ -0,0 +1,84 @@ +--- +title: runtime.openOptionsPage() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/openOptionsPage +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/openOptionsPage +--- +
{{AddonSidebar()}}
+ +
Si votre extension a défini une page d'options, cette méthode l'ouvre.
+ +
+ +

C'est une fonction asynchrone  qui renvoie une Promise.

+ +

Syntaxe

+ +
var openingPage = browser.runtime.openOptionsPage()
+
+ +

Paramètres

+ +

None.

+ +

valeur retournée

+ +

Une Promise qui sera remplie sans argument lorsque la page d'options a été créée avec succés, ou rejetée avec un message d'erreur si l'opération a échoué.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Ouvrez une page d'options lorsque l'utilisateur clique sur l'icône d'une action du navigateur :

+ +
function onOpened() {
+  console.log(`Options page opened`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var opening = browser.runtime.openOptionsPage();
+opening.then(onOpened, onError);
+ +

{{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.

+ +

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/runtime/platformarch/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformarch/index.html deleted file mode 100644 index 8ae2611d5d..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/platformarch/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: runtime.PlatformArch -slug: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformArch -tags: - - API - - Add-ons - - Extensions - - Non-standard - - PlatformArch - - Reference - - Type - - WebExtensions - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformArch ---- -
{{AddonSidebar()}}
- -

L'architecture du processeur de la machine.

- -

Type

- -

Les valeurs de ce type sont des chaînes. Les valeurs possible sont  :

- -
-
"arm"
-
La plateforme est basée sur l'architecture des bras.
-
"x86-32"
-
La plateforme est basé sur l'architecture x86 32-bits.
-
"x86-64"
-
La plateforme est basé sur l'architecture x86 64-bits.
-
- -

Compatibilité du navigateur

- -

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

- -

{{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.

- -

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/runtime/platformarch/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformarch/index.md new file mode 100644 index 0000000000..8ae2611d5d --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformarch/index.md @@ -0,0 +1,75 @@ +--- +title: runtime.PlatformArch +slug: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformArch +tags: + - API + - Add-ons + - Extensions + - Non-standard + - PlatformArch + - Reference + - Type + - WebExtensions + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformArch +--- +
{{AddonSidebar()}}
+ +

L'architecture du processeur de la machine.

+ +

Type

+ +

Les valeurs de ce type sont des chaînes. Les valeurs possible sont  :

+ +
+
"arm"
+
La plateforme est basée sur l'architecture des bras.
+
"x86-32"
+
La plateforme est basé sur l'architecture x86 32-bits.
+
"x86-64"
+
La plateforme est basé sur l'architecture x86 64-bits.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{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.

+ +

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/runtime/platforminfo/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/platforminfo/index.html deleted file mode 100644 index 0955150051..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/platforminfo/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: runtime.PlatformInfo -slug: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformInfo -tags: - - API - - Add-ons - - Extensions - - Non-standard - - PlatformInfo - - Reference - - Type - - WebExtensions - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformInfo ---- -
{{AddonSidebar()}}
- -

Un objet contenant des informations sur la plate-forme actuelle.

- -

Type

- -

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

- -
-
os
-
{{WebExtAPIRef('runtime.PlatformOs')}}. Le système d'exploitation de la plateforme.
-
arch
-
{{WebExtAPIRef('runtime.PlatformArch')}}. L'architecture du processeur de la plateforme.
-
nacl_arch
-
{{WebExtAPIRef('runtime.PlatformNaclArch')}}. L'architecture du client natif Cela peut être différent de arch sur certaines plates-formes.
-
- -

Compatibilité du navigateur

- -

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

- -

{{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.

- -

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/runtime/platforminfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/platforminfo/index.md new file mode 100644 index 0000000000..0955150051 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/platforminfo/index.md @@ -0,0 +1,75 @@ +--- +title: runtime.PlatformInfo +slug: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformInfo +tags: + - API + - Add-ons + - Extensions + - Non-standard + - PlatformInfo + - Reference + - Type + - WebExtensions + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformInfo +--- +
{{AddonSidebar()}}
+ +

Un objet contenant des informations sur la plate-forme actuelle.

+ +

Type

+ +

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

+ +
+
os
+
{{WebExtAPIRef('runtime.PlatformOs')}}. Le système d'exploitation de la plateforme.
+
arch
+
{{WebExtAPIRef('runtime.PlatformArch')}}. L'architecture du processeur de la plateforme.
+
nacl_arch
+
{{WebExtAPIRef('runtime.PlatformNaclArch')}}. L'architecture du client natif Cela peut être différent de arch sur certaines plates-formes.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{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.

+ +

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/runtime/platformnaclarch/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformnaclarch/index.html deleted file mode 100644 index 6ea89d7dca..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/platformnaclarch/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: runtime.PlatformNaclArch -slug: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformNaclArch -tags: - - API - - Add-ons - - Extensions - - Non-standard - - PlatformNaclArch - - Reference - - Type - - WebExtensions - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformNaclArch ---- -

{{AddonSidebar()}}

- -

L'architecture du client natif. Cela peut-etre différent de arch sur certaines plate-formes.

- -

Type

- -

Les valeurs de type sont des chaînes. Les valeurs possible sont : "arm", "x86-32", "x86-64".

- -

Compatibilité du navigateur

- -

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

- -

{{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.

- -

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/runtime/platformnaclarch/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformnaclarch/index.md new file mode 100644 index 0000000000..6ea89d7dca --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformnaclarch/index.md @@ -0,0 +1,66 @@ +--- +title: runtime.PlatformNaclArch +slug: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformNaclArch +tags: + - API + - Add-ons + - Extensions + - Non-standard + - PlatformNaclArch + - Reference + - Type + - WebExtensions + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformNaclArch +--- +

{{AddonSidebar()}}

+ +

L'architecture du client natif. Cela peut-etre différent de arch sur certaines plate-formes.

+ +

Type

+ +

Les valeurs de type sont des chaînes. Les valeurs possible sont : "arm", "x86-32", "x86-64".

+ +

Compatibilité du navigateur

+ +

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

+ +

{{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.

+ +

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/runtime/platformos/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformos/index.html deleted file mode 100644 index d193759c72..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/platformos/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: runtime.PlatformOs -slug: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformOs -tags: - - API - - Add-ons - - Extensions - - Non-standard - - PlatformOs - - Reference - - Type - - WebExtensions - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformOs ---- -
{{AddonSidebar()}}
- -

Le système d'exploitation sur lequel le navigateur fonctionne.

- -

Type

- -

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont:

- -
-
"mac"
-
Le système d'exploitation est sous Mac OS X.
-
"win"
-
Le système d'exploitation est sous Windows.
-
"android"
-
Le système d'exploitation est sous Android.
-
"cros"
-
Le système d'exploitation est sous Chrome OS.
-
"linux"
-
Le système d'exploitation est sous Linux.
-
"openbsd"
-
Le système d'exploitation est sous Open/FreeBSD.
-
- -

Compatibilité du navigateur

- -

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

- -

{{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.

- -

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/runtime/platformos/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformos/index.md new file mode 100644 index 0000000000..d193759c72 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformos/index.md @@ -0,0 +1,81 @@ +--- +title: runtime.PlatformOs +slug: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformOs +tags: + - API + - Add-ons + - Extensions + - Non-standard + - PlatformOs + - Reference + - Type + - WebExtensions + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformOs +--- +
{{AddonSidebar()}}
+ +

Le système d'exploitation sur lequel le navigateur fonctionne.

+ +

Type

+ +

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont:

+ +
+
"mac"
+
Le système d'exploitation est sous Mac OS X.
+
"win"
+
Le système d'exploitation est sous Windows.
+
"android"
+
Le système d'exploitation est sous Android.
+
"cros"
+
Le système d'exploitation est sous Chrome OS.
+
"linux"
+
Le système d'exploitation est sous Linux.
+
"openbsd"
+
Le système d'exploitation est sous Open/FreeBSD.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{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.

+ +

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/runtime/port/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/port/index.html deleted file mode 100644 index 0d5f60172d..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/port/index.html +++ /dev/null @@ -1,246 +0,0 @@ ---- -title: runtime.Port -slug: Mozilla/Add-ons/WebExtensions/API/runtime/Port -tags: - - API - - Add-ons - - Extensionns - - Non-standard - - Reference - - Type - - WebExtensions - - port - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/Port ---- -
{{AddonSidebar()}}
- -

Un objet Port represente une extrémité d'une connexion entre deux contextes spécifiques, qui peut-être utilisée pour échanger des messages.

- -

Un côté initie la connexion à l'aide d'une API connect(). Cela retourne un objet Port. L'autre camp écoute les tentatives de connexion à l'aide d'un écouteur onConnect. Ceci est passé un objet Port correspondant.

- -

Une fois que les deux côtés ont des objets Port, ils peuvent échanger des messages JSON en utilisant Port.postMessage() et Port.onMessage. Quand ils sont terminés, chaque extrémité peut se déconnecter en utilisant Port.disconnect(), ce qui générera un événement Port.onDisconnect à l'autre extrémité, permettant à l'autre extrémité de faire le nettoyage requis.

- -

Vous pouvez utiliser ce modèle pour communiquer entre:

- - - -

Vous devez utiliser différentes API de connexion pour différents types de connexions, comme indiqué dans le tableau ci-dessous.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
type de connectionLancer une tentative de connexionGérer la tentative de connexion
Script d'arrière-plan au script de contenu{{WebExtAPIRef("tabs.connect()")}}{{WebExtAPIRef("runtime.onConnect")}}
Script de contenu au script d'arrière-plan{{WebExtAPIRef("runtime.connect()")}}{{WebExtAPIRef("runtime.onConnect")}}
Extension à l'application native{{WebExtAPIRef("runtime.connectNative()")}}N'est pas applicable (voir Native messaging).
Extension à l'extension{{WebExtAPIRef("runtime.connect()")}}{{WebExtAPIRef("runtime.onConnectExternal")}}
- -

Type

- -

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

- -
-
name
-
string. Le nom du port, défini dans {{WebExtAPIRef("runtime.connect()")}} ou {{WebExtAPIRef("tabs.connect()")}} appel qui l'a créé. Si ce port est connecté à une application native, son nom est le nom de l'application native.
-
disconnect
-
function. Déconnecte un port. Chaque extrémité peut appeler cela quand ils ont fini avec le port. Cela provoquera le déclenchement de onDisconnect à l'autre extrémité. Ceci est utile si l'autre extrémité maintient un état relatif à ce port, qui peut être nettoyé lors de la déconnexion. Si ce port est connecté à une application native, cette fonction ferme l'application native.
-
error
-
object. Si le port a été déconnecté en raison d'une erreur, il sera défini sur un objet avec un message, de propriété de chaîne, vous donnant plus d'informations sur l'erreur. Voir onDisconnect.
-
onDisconnect
-
-

object. Cela contient les fonctions addListener() et removeListener() communes à tous les événements pour les extensions créées à l'aide des API. WebExtension. Les fonctions de l'écouteur seront appelées lorsque l'autre extrémité aura appelé Port.disconnect(). Cet événement ne sera déclenché qu'une fois pour chaque port. La fonction d'écouteur recevra l'objet Port. Si le port a été déconnecté en raison d'une erreur, l'argument Port contiendra une propriété  error donnant plus d'informations sur l'erreur :

- - 
port.onDisconnect.addListener((p) => {
-  if (p.error) {
-    console.log(`Disconnected due to an error: ${p.error.message}`);
-  }
-});
- -

Notez que dans Google Chrome port.error n'est pas supporté: utilisez plutôt  {{WebExtAPIRef("runtime.lastError")}} pour obtenir le message d'erreur.

-
-
onMessage
-
object. Cela contient les fonctions addListener() et removeListener() communes à tous les événements pour les extensions créées à l'aide des API WebExtension. Les fonctions de l'écouteur seront appelées lorsque l'autre extrémité aura envoyé un message à ce port. L'écouteur recevra l'objet JSON envoyé par l'autre extrémité.
-
postMessage
-
function. Envoyer un message à l'autre extrémité. Cela prend un argument, qui est un objet JSON représentant le message à envoyer. Il sera fourni à tout script écoutant l'événement onMessage du port, ou à l'application native si ce port est connecté à une application native.
-
sender{{optional_inline}}
-
{{WebExtAPIRef('runtime.MessageSender')}}. Contient des informations sur l'expéditeur du message. ette propriété ne sera présente que sur les ports transmis aux écouteurs onConnect/onConnectExternal.
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Connecting from content scripts

- -

This content script:

- - - -
// content-script.js
-
-var myPort = browser.runtime.connect({name:"port-from-cs"});
-myPort.postMessage({greeting: "hello from content script"});
-
-myPort.onMessage.addListener(function(m) {
-  console.log("In content script, received message from background script: ");
-  console.log(m.greeting);
-});
-
-document.body.addEventListener("click", function() {
-  myPort.postMessage({greeting: "they clicked the page!"});
-});
- -

The corresponding background script:

- - - -
// background-script.js
-
-var portFromCS;
-
-function connected(p) {
-  portFromCS = p;
-  portFromCS.postMessage({greeting: "hi there content script!"});
-  portFromCS.onMessage.addListener(function(m) {
-    console.log("In background script, received message from content script")
-    console.log(m.greeting);
-  });
-}
-
-browser.runtime.onConnect.addListener(connected);
-
-browser.browserAction.onClicked.addListener(function() {
-  portFromCS.postMessage({greeting: "they clicked the button!"});
-});
- -

Script à contenu multiple

- -

Si plusieurs scripts de contenu communiquent en même temps, vous voudrez peut-être stocker chaque connexion dans un tableau.

- - - -
// background-script.js
-
-var ports = []
-
-function connected(p) {
-  ports[p.sender.tab.id]    = p
-  //...
-}
-
-browser.runtime.onConnect.addListener(connected)
-
-browser.browserAction.onClicked.addListener(function() {
-  ports.forEach(p => {
-        p.postMessage({greeting: "they clicked the button!"})
-    })
-});
- -

Connecting to native applications

- -

This example connects to the native application "ping_pong" and starts listening for messages from it. It also sends the native application a message when the user clicks a browser action icon:

- -
/*
-On startup, connect to the "ping_pong" app.
-*/
-var port = browser.runtime.connectNative("ping_pong");
-
-/*
-Listen for messages from the app.
-*/
-port.onMessage.addListener((response) => {
-  console.log("Received: " + response);
-});
-
-/*
-On a click on the browser action, send the app a message.
-*/
-browser.browserAction.onClicked.addListener(() => {
-  console.log("Sending:  ping");
-  port.postMessage("ping");
-});
- -

{{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.

- -

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/runtime/port/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/port/index.md new file mode 100644 index 0000000000..0d5f60172d --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/port/index.md @@ -0,0 +1,246 @@ +--- +title: runtime.Port +slug: Mozilla/Add-ons/WebExtensions/API/runtime/Port +tags: + - API + - Add-ons + - Extensionns + - Non-standard + - Reference + - Type + - WebExtensions + - port + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/Port +--- +
{{AddonSidebar()}}
+ +

Un objet Port represente une extrémité d'une connexion entre deux contextes spécifiques, qui peut-être utilisée pour échanger des messages.

+ +

Un côté initie la connexion à l'aide d'une API connect(). Cela retourne un objet Port. L'autre camp écoute les tentatives de connexion à l'aide d'un écouteur onConnect. Ceci est passé un objet Port correspondant.

+ +

Une fois que les deux côtés ont des objets Port, ils peuvent échanger des messages JSON en utilisant Port.postMessage() et Port.onMessage. Quand ils sont terminés, chaque extrémité peut se déconnecter en utilisant Port.disconnect(), ce qui générera un événement Port.onDisconnect à l'autre extrémité, permettant à l'autre extrémité de faire le nettoyage requis.

+ +

Vous pouvez utiliser ce modèle pour communiquer entre:

+ + + +

Vous devez utiliser différentes API de connexion pour différents types de connexions, comme indiqué dans le tableau ci-dessous.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
type de connectionLancer une tentative de connexionGérer la tentative de connexion
Script d'arrière-plan au script de contenu{{WebExtAPIRef("tabs.connect()")}}{{WebExtAPIRef("runtime.onConnect")}}
Script de contenu au script d'arrière-plan{{WebExtAPIRef("runtime.connect()")}}{{WebExtAPIRef("runtime.onConnect")}}
Extension à l'application native{{WebExtAPIRef("runtime.connectNative()")}}N'est pas applicable (voir Native messaging).
Extension à l'extension{{WebExtAPIRef("runtime.connect()")}}{{WebExtAPIRef("runtime.onConnectExternal")}}
+ +

Type

+ +

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

+ +
+
name
+
string. Le nom du port, défini dans {{WebExtAPIRef("runtime.connect()")}} ou {{WebExtAPIRef("tabs.connect()")}} appel qui l'a créé. Si ce port est connecté à une application native, son nom est le nom de l'application native.
+
disconnect
+
function. Déconnecte un port. Chaque extrémité peut appeler cela quand ils ont fini avec le port. Cela provoquera le déclenchement de onDisconnect à l'autre extrémité. Ceci est utile si l'autre extrémité maintient un état relatif à ce port, qui peut être nettoyé lors de la déconnexion. Si ce port est connecté à une application native, cette fonction ferme l'application native.
+
error
+
object. Si le port a été déconnecté en raison d'une erreur, il sera défini sur un objet avec un message, de propriété de chaîne, vous donnant plus d'informations sur l'erreur. Voir onDisconnect.
+
onDisconnect
+
+

object. Cela contient les fonctions addListener() et removeListener() communes à tous les événements pour les extensions créées à l'aide des API. WebExtension. Les fonctions de l'écouteur seront appelées lorsque l'autre extrémité aura appelé Port.disconnect(). Cet événement ne sera déclenché qu'une fois pour chaque port. La fonction d'écouteur recevra l'objet Port. Si le port a été déconnecté en raison d'une erreur, l'argument Port contiendra une propriété  error donnant plus d'informations sur l'erreur :

+ + 
port.onDisconnect.addListener((p) => {
+  if (p.error) {
+    console.log(`Disconnected due to an error: ${p.error.message}`);
+  }
+});
+ +

Notez que dans Google Chrome port.error n'est pas supporté: utilisez plutôt  {{WebExtAPIRef("runtime.lastError")}} pour obtenir le message d'erreur.

+
+
onMessage
+
object. Cela contient les fonctions addListener() et removeListener() communes à tous les événements pour les extensions créées à l'aide des API WebExtension. Les fonctions de l'écouteur seront appelées lorsque l'autre extrémité aura envoyé un message à ce port. L'écouteur recevra l'objet JSON envoyé par l'autre extrémité.
+
postMessage
+
function. Envoyer un message à l'autre extrémité. Cela prend un argument, qui est un objet JSON représentant le message à envoyer. Il sera fourni à tout script écoutant l'événement onMessage du port, ou à l'application native si ce port est connecté à une application native.
+
sender{{optional_inline}}
+
{{WebExtAPIRef('runtime.MessageSender')}}. Contient des informations sur l'expéditeur du message. ette propriété ne sera présente que sur les ports transmis aux écouteurs onConnect/onConnectExternal.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Connecting from content scripts

+ +

This content script:

+ + + +
// content-script.js
+
+var myPort = browser.runtime.connect({name:"port-from-cs"});
+myPort.postMessage({greeting: "hello from content script"});
+
+myPort.onMessage.addListener(function(m) {
+  console.log("In content script, received message from background script: ");
+  console.log(m.greeting);
+});
+
+document.body.addEventListener("click", function() {
+  myPort.postMessage({greeting: "they clicked the page!"});
+});
+ +

The corresponding background script:

+ + + +
// background-script.js
+
+var portFromCS;
+
+function connected(p) {
+  portFromCS = p;
+  portFromCS.postMessage({greeting: "hi there content script!"});
+  portFromCS.onMessage.addListener(function(m) {
+    console.log("In background script, received message from content script")
+    console.log(m.greeting);
+  });
+}
+
+browser.runtime.onConnect.addListener(connected);
+
+browser.browserAction.onClicked.addListener(function() {
+  portFromCS.postMessage({greeting: "they clicked the button!"});
+});
+ +

Script à contenu multiple

+ +

Si plusieurs scripts de contenu communiquent en même temps, vous voudrez peut-être stocker chaque connexion dans un tableau.

+ + + +
// background-script.js
+
+var ports = []
+
+function connected(p) {
+  ports[p.sender.tab.id]    = p
+  //...
+}
+
+browser.runtime.onConnect.addListener(connected)
+
+browser.browserAction.onClicked.addListener(function() {
+  ports.forEach(p => {
+        p.postMessage({greeting: "they clicked the button!"})
+    })
+});
+ +

Connecting to native applications

+ +

This example connects to the native application "ping_pong" and starts listening for messages from it. It also sends the native application a message when the user clicks a browser action icon:

+ +
/*
+On startup, connect to the "ping_pong" app.
+*/
+var port = browser.runtime.connectNative("ping_pong");
+
+/*
+Listen for messages from the app.
+*/
+port.onMessage.addListener((response) => {
+  console.log("Received: " + response);
+});
+
+/*
+On a click on the browser action, send the app a message.
+*/
+browser.browserAction.onClicked.addListener(() => {
+  console.log("Sending:  ping");
+  port.postMessage("ping");
+});
+ +

{{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.

+ +

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/runtime/reload/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/reload/index.html deleted file mode 100644 index 44e83fcfda..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/reload/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: runtime.reload() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/reload -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - reload - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/reload ---- -
{{AddonSidebar()}}
- -

Recharge une extension.

- -

S'il y a des mises à jour en attente pour l'extension, qu'elles ont été différées en écoutant {{WebExtAPIRef("runtime.onUpdateAvailable")}}, elles seront appliquées en reload.

- -

Syntaxe

- -
browser.runtime.reload()
-
- -

Paramètres

- -

Aucun.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Rechargez l'extension lorsque l'utilisateur clique sur l'icône d'une action du navigateur :

- -
browser.browserAction.onClicked.addListener((tab) => {
-  browser.runtime.reload();
-});
- -

{{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.

- -

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/runtime/reload/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/reload/index.md new file mode 100644 index 0000000000..44e83fcfda --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/reload/index.md @@ -0,0 +1,81 @@ +--- +title: runtime.reload() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/reload +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - reload + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/reload +--- +
{{AddonSidebar()}}
+ +

Recharge une extension.

+ +

S'il y a des mises à jour en attente pour l'extension, qu'elles ont été différées en écoutant {{WebExtAPIRef("runtime.onUpdateAvailable")}}, elles seront appliquées en reload.

+ +

Syntaxe

+ +
browser.runtime.reload()
+
+ +

Paramètres

+ +

Aucun.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Rechargez l'extension lorsque l'utilisateur clique sur l'icône d'une action du navigateur :

+ +
browser.browserAction.onClicked.addListener((tab) => {
+  browser.runtime.reload();
+});
+ +

{{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.

+ +

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/runtime/requestupdatecheck/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheck/index.html deleted file mode 100644 index d3918536f3..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheck/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: runtime.requestUpdateCheck() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/requestUpdateCheck -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - requestUpdateCheck - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/requestUpdateCheck ---- -
{{AddonSidebar()}}
- -

Vérifie de voir si un mise à jour de l'extension est disponible.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var requestingCheck = browser.runtime.requestUpdateCheck()
-
- -

Paramètres

- -

None.

- -

Valeur retournée

- -

Une Promise qui sera remplie avec deux arguments :

- -
-
status
-
Une valeur {{WebExtAPIRef('runtime.RequestUpdateCheckStatus')}}  — Le résultat de la vérification de mise à jour.
-
details{{optional_inline}}
-

object. Si le status est update_available, cela contient plus d'informations sur la mise à jour. C'est un objet contenant une simple propriété :

-
-
version
-
string. La version de la mise à jour.
-
-
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Demander une mise à jour, etenregistrer la nouvelle version si elle est disponible :

- -
function onRequested(status, details) {
-  console.log(status);
-  if (status === "update_available") {
-    console.log(details.version);
-  }
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var requestingCheck = browser.runtime.requestUpdateCheck(onRequested);
-requestingCheck.then(onRequested, onError);
- -

{{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.

- -

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/runtime/requestupdatecheck/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheck/index.md new file mode 100644 index 0000000000..d3918536f3 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheck/index.md @@ -0,0 +1,107 @@ +--- +title: runtime.requestUpdateCheck() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/requestUpdateCheck +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - requestUpdateCheck + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/requestUpdateCheck +--- +
{{AddonSidebar()}}
+ +

Vérifie de voir si un mise à jour de l'extension est disponible.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var requestingCheck = browser.runtime.requestUpdateCheck()
+
+ +

Paramètres

+ +

None.

+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec deux arguments :

+ +
+
status
+
Une valeur {{WebExtAPIRef('runtime.RequestUpdateCheckStatus')}}  — Le résultat de la vérification de mise à jour.
+
details{{optional_inline}}
+

object. Si le status est update_available, cela contient plus d'informations sur la mise à jour. C'est un objet contenant une simple propriété :

+
+
version
+
string. La version de la mise à jour.
+
+
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Demander une mise à jour, etenregistrer la nouvelle version si elle est disponible :

+ +
function onRequested(status, details) {
+  console.log(status);
+  if (status === "update_available") {
+    console.log(details.version);
+  }
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var requestingCheck = browser.runtime.requestUpdateCheck(onRequested);
+requestingCheck.then(onRequested, onError);
+ +

{{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.

+ +

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/runtime/requestupdatecheckstatus/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheckstatus/index.html deleted file mode 100644 index d6ae317192..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheckstatus/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: runtime.RequestUpdateCheckStatus -slug: Mozilla/Add-ons/WebExtensions/API/runtime/RequestUpdateCheckStatus -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Reference - - RequestUpdateCheckStatus - - Type - - WebExtensions - - runtime -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/RequestUpdateCheckStatus ---- -
{{AddonSidebar()}}
- -

Résultat d'un appel à {{WebExtAPIRef("runtime.requestUpdateCheck()")}}.

- -

Type

- -

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

- -
-
"throttled"
-
La mise à jour est limitée.
-
"no_update"
-
Aucune mise à jour n'est disponible.
-
"update_available"
-
Une mise à jour de l'extension est disponible.
-
- -

Compatibilité du navigateur

- -

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

- -

{{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.

- -

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/runtime/requestupdatecheckstatus/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheckstatus/index.md new file mode 100644 index 0000000000..d6ae317192 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheckstatus/index.md @@ -0,0 +1,75 @@ +--- +title: runtime.RequestUpdateCheckStatus +slug: Mozilla/Add-ons/WebExtensions/API/runtime/RequestUpdateCheckStatus +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - RequestUpdateCheckStatus + - Type + - WebExtensions + - runtime +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/RequestUpdateCheckStatus +--- +
{{AddonSidebar()}}
+ +

Résultat d'un appel à {{WebExtAPIRef("runtime.requestUpdateCheck()")}}.

+ +

Type

+ +

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

+ +
+
"throttled"
+
La mise à jour est limitée.
+
"no_update"
+
Aucune mise à jour n'est disponible.
+
"update_available"
+
Une mise à jour de l'extension est disponible.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{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.

+ +

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/runtime/sendmessage/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.html deleted file mode 100644 index 77f451869b..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.html +++ /dev/null @@ -1,165 +0,0 @@ ---- -title: runtime.sendMessage() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - runtime - - sendMessage -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage ---- -
{{AddonSidebar()}}
- -

Envoie un simple message aux écouteurs d'événement dans votre extension ou une extension différente.

- -

Si vous envoyez à votre extension, omettez l'argument extensionId. L'événement {{WebExtAPIRef('runtime.onMessage')}} sera déclenché dans chaque page de votre extension, à l'exception du cadre appelé runtime.sendMessage.

- -

Si vous envoyez une extension différente, ajouter l'argument extensionId à l'ID de l'autre extension. {{WebExtAPIRef('runtime.onMessageExternal')}} sera déclenché dans l'autre extension.

- -

Les extensions ne peuvent pas envoyer de messages aux scripts de contenu en utilisant cette méthode. Pour envoyer des messages aux scripts de contenu, utilisez {{WebExtAPIRef('tabs.sendMessage')}}.

- - - -

C'est une fonction asynchrone qui renvoie une Promise.

- -
-

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

-
- -

Syntaxe

- -
var sending = browser.runtime.sendMessage(
-  extensionId,             // optional string
-  message,                 // any
-  options                  // optional object
-)
-
- -

Paramètres

- -
-
extensionId{{optional_inline}}
-

string. L'ID de l'extension à envoyer le message. Incluez ceci pour envoyer le message à une extension différente..Si le destinataire prévu a défini un ID explicitement en utilisant la clé d' applications dans  manifest.json, extensionId doit avoir une valeur. Sinon, il devrait avoir l'ID qui a été généré pour le destinataire prévu.

-

Si extensionId est omis, le message sera envoyé à votre propre extension.

-
message
-
any. Un objet qui peut être structuré clone sérialisé.
-
options{{optional_inline}}
-

object.

-
-
includeTlsChannelId{{optional_inline}}
-
boolean. Indique si l'ID de canal TLS sera transmis à {{WebExtAPIRef('runtime.onMessageExternal')}} pour les processus qui écoutent l'événement de connexion.
-
toProxyScript{{optional_inline}}
-
boolean. Doit être True si le message est destiné à un fichier PAC chargé à l'aide de l'API {{WebExtAPIRef("proxy")}}.
-
-
-
- -

En fonction des arguments qui lui sont donnés, cette API est parfois ambiguë. Les règles suivantes sont utilisées :

- - - -

Notez qu'avant Firefox 55, le règles étaient différentes dans le cas des 2 arguments. Sous les anciennes règles, si le premier argument était une chaîne, il était traité comme extensionId, avec le message comme deuxième argument. Cel signifiait que si vous appelez sendMessage() avec des arguments comme ("my-message", {}), il enverrait un message vide à l'extension identifiée par "my-message". Sous les nouvelles règles, avec ces arguments, vous enverriez le message "my-message" en interne, avec un objet options vide.

- -

Valeur retournée

- -

Une Promise. Si le destinataire a envoyé une réponse, celle-ci sera remplie avec la réponse en tant qu'objet JSON. Sinon, il sera rempli sans arguments. si une erreur survient lors de la connexion à l'extension, la promessage sera rejetée avec un message d'erreur.

- -

Compatibilité du navitageur

- -

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

- -

Exemples

- -

Voici un script de contenu qui envoie un message au script d'arrière-plan lorsque l'utilisateur clique sur la fenêtre de contenu. La charge utile du message est {greeting: "Greeting from the content script"}, et l'expéditeur s'attend également à recevoir une réponse, qui est gérée dans la fonction handleResponse :

- -
// content-script.js
-
-function handleResponse(message) {
-  console.log(`Message from the background script:  ${message.response}`);
-}
-
-function handleError(error) {
-  console.log(`Error: ${error}`);
-}
-
-function notifyBackgroundPage(e) {
-  var sending = browser.runtime.sendMessage({
-    greeting: "Greeting from the content script"
-  });
-  sending.then(handleResponse, handleError);
-}
-
-window.addEventListener("click", notifyBackgroundPage);
- -

Le script d'arrière-plan correspondant ressemble à ceci :

- -
// background-script.js
-
-function handleMessage(request, sender, sendResponse) {
-  console.log("Message from the content script: " +
-    request.greeting);
-  sendResponse({response: "Response from background script"});
-}
-
-browser.runtime.onMessage.addListener(handleMessage);
- -

{{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.

- -

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/runtime/sendmessage/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.md new file mode 100644 index 0000000000..77f451869b --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.md @@ -0,0 +1,165 @@ +--- +title: runtime.sendMessage() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - runtime + - sendMessage +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage +--- +
{{AddonSidebar()}}
+ +

Envoie un simple message aux écouteurs d'événement dans votre extension ou une extension différente.

+ +

Si vous envoyez à votre extension, omettez l'argument extensionId. L'événement {{WebExtAPIRef('runtime.onMessage')}} sera déclenché dans chaque page de votre extension, à l'exception du cadre appelé runtime.sendMessage.

+ +

Si vous envoyez une extension différente, ajouter l'argument extensionId à l'ID de l'autre extension. {{WebExtAPIRef('runtime.onMessageExternal')}} sera déclenché dans l'autre extension.

+ +

Les extensions ne peuvent pas envoyer de messages aux scripts de contenu en utilisant cette méthode. Pour envoyer des messages aux scripts de contenu, utilisez {{WebExtAPIRef('tabs.sendMessage')}}.

+ + + +

C'est une fonction asynchrone qui renvoie une Promise.

+ +
+

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

+
+ +

Syntaxe

+ +
var sending = browser.runtime.sendMessage(
+  extensionId,             // optional string
+  message,                 // any
+  options                  // optional object
+)
+
+ +

Paramètres

+ +
+
extensionId{{optional_inline}}
+

string. L'ID de l'extension à envoyer le message. Incluez ceci pour envoyer le message à une extension différente..Si le destinataire prévu a défini un ID explicitement en utilisant la clé d' applications dans  manifest.json, extensionId doit avoir une valeur. Sinon, il devrait avoir l'ID qui a été généré pour le destinataire prévu.

+

Si extensionId est omis, le message sera envoyé à votre propre extension.

+
message
+
any. Un objet qui peut être structuré clone sérialisé.
+
options{{optional_inline}}
+

object.

+
+
includeTlsChannelId{{optional_inline}}
+
boolean. Indique si l'ID de canal TLS sera transmis à {{WebExtAPIRef('runtime.onMessageExternal')}} pour les processus qui écoutent l'événement de connexion.
+
toProxyScript{{optional_inline}}
+
boolean. Doit être True si le message est destiné à un fichier PAC chargé à l'aide de l'API {{WebExtAPIRef("proxy")}}.
+
+
+
+ +

En fonction des arguments qui lui sont donnés, cette API est parfois ambiguë. Les règles suivantes sont utilisées :

+ + + +

Notez qu'avant Firefox 55, le règles étaient différentes dans le cas des 2 arguments. Sous les anciennes règles, si le premier argument était une chaîne, il était traité comme extensionId, avec le message comme deuxième argument. Cel signifiait que si vous appelez sendMessage() avec des arguments comme ("my-message", {}), il enverrait un message vide à l'extension identifiée par "my-message". Sous les nouvelles règles, avec ces arguments, vous enverriez le message "my-message" en interne, avec un objet options vide.

+ +

Valeur retournée

+ +

Une Promise. Si le destinataire a envoyé une réponse, celle-ci sera remplie avec la réponse en tant qu'objet JSON. Sinon, il sera rempli sans arguments. si une erreur survient lors de la connexion à l'extension, la promessage sera rejetée avec un message d'erreur.

+ +

Compatibilité du navitageur

+ +

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

+ +

Exemples

+ +

Voici un script de contenu qui envoie un message au script d'arrière-plan lorsque l'utilisateur clique sur la fenêtre de contenu. La charge utile du message est {greeting: "Greeting from the content script"}, et l'expéditeur s'attend également à recevoir une réponse, qui est gérée dans la fonction handleResponse :

+ +
// content-script.js
+
+function handleResponse(message) {
+  console.log(`Message from the background script:  ${message.response}`);
+}
+
+function handleError(error) {
+  console.log(`Error: ${error}`);
+}
+
+function notifyBackgroundPage(e) {
+  var sending = browser.runtime.sendMessage({
+    greeting: "Greeting from the content script"
+  });
+  sending.then(handleResponse, handleError);
+}
+
+window.addEventListener("click", notifyBackgroundPage);
+ +

Le script d'arrière-plan correspondant ressemble à ceci :

+ +
// background-script.js
+
+function handleMessage(request, sender, sendResponse) {
+  console.log("Message from the content script: " +
+    request.greeting);
+  sendResponse({response: "Response from background script"});
+}
+
+browser.runtime.onMessage.addListener(handleMessage);
+ +

{{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.

+ +

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/runtime/sendnativemessage/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/sendnativemessage/index.html deleted file mode 100644 index 1886bbad5e..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/sendnativemessage/index.html +++ /dev/null @@ -1,112 +0,0 @@ ---- -title: runtime.sendNativeMessage() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/sendNativeMessage -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - runtime - - sendNativeMessage -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/sendNativeMessage ---- -
{{AddonSidebar()}}
- -

Envoie un seul message d'une extension à une application native.

- -

Cela prend deux paramètres obligatoires : le nom de l'application native et un objet JSON qui est le message à envoyer. Le navigateur lancera l'application native et délivrera le message.

- -

C'est une fonction asynchrone qui renvoie une Promise. The first message sent by the native application is treated as a response to the sendNativeMessage() call, and the promise will be fulfilled with this message as a parameter. Note that you can't use {{WebExtAPIRef("runtime.onMessage")}} to get responses from the application: you must use the callback function instead.

- -

Une nouvelle instance de l'application est lancée pour appel à  runtime.sendNativeMessage(). Le navigateur terminera l'application native après avoir reçu une réponse. Pour mettre fin à une application native, le navigateur ferme le canal, donne au processus quelques secondes pour quitter normalement, puis le tue s'il ne s'est pas arrêté.

- -

Pour plus d'informations, voir Native messaging.

- -

Syntaxe

- -
var sending = browser.runtime.sendNativeMessage(
-  application,             // string
-  message                  // object
-)
-
- -

Paramètres

- -
-
application
-
string. Le nom de l'application native. Cela doit correspondre à la propriété "name" dans le fichier manifest de l'application native.
-
message
-
object. Un objet JSON qui sera envoyé à l'application native.
-
- -

Valeur retournée

- -

Une Promise. Si l'expéditeur a envoyé une réponse, celle-ci sera remplie avec la réponse en tant qu'objet JSON. Sinon, il sera rempli sans arguments. Si une erreur survient lors de la connexion à l'application native, la promesse sera rejetée avec un message d'erreur.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Voici un script d'arrière-plan qui envoie un message "ping" à l'application "ping_pong" et enregistre la réponse, chaque fois que l'utilisateur clique sur l'action du navigateur :

- -
function onResponse(response) {
-  console.log(`Received ${response}`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-/*
-On a click on the browser action, send the app a message.
-*/
-browser.browserAction.onClicked.addListener(() => {
-  console.log("Sending:  ping");
-  var sending = browser.runtime.sendNativeMessage("ping_pong", "ping");
-  sending.then(onResponse, onError);
-});
- -

{{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.

- -

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/runtime/sendnativemessage/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/sendnativemessage/index.md new file mode 100644 index 0000000000..1886bbad5e --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/sendnativemessage/index.md @@ -0,0 +1,112 @@ +--- +title: runtime.sendNativeMessage() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/sendNativeMessage +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - runtime + - sendNativeMessage +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/sendNativeMessage +--- +
{{AddonSidebar()}}
+ +

Envoie un seul message d'une extension à une application native.

+ +

Cela prend deux paramètres obligatoires : le nom de l'application native et un objet JSON qui est le message à envoyer. Le navigateur lancera l'application native et délivrera le message.

+ +

C'est une fonction asynchrone qui renvoie une Promise. The first message sent by the native application is treated as a response to the sendNativeMessage() call, and the promise will be fulfilled with this message as a parameter. Note that you can't use {{WebExtAPIRef("runtime.onMessage")}} to get responses from the application: you must use the callback function instead.

+ +

Une nouvelle instance de l'application est lancée pour appel à  runtime.sendNativeMessage(). Le navigateur terminera l'application native après avoir reçu une réponse. Pour mettre fin à une application native, le navigateur ferme le canal, donne au processus quelques secondes pour quitter normalement, puis le tue s'il ne s'est pas arrêté.

+ +

Pour plus d'informations, voir Native messaging.

+ +

Syntaxe

+ +
var sending = browser.runtime.sendNativeMessage(
+  application,             // string
+  message                  // object
+)
+
+ +

Paramètres

+ +
+
application
+
string. Le nom de l'application native. Cela doit correspondre à la propriété "name" dans le fichier manifest de l'application native.
+
message
+
object. Un objet JSON qui sera envoyé à l'application native.
+
+ +

Valeur retournée

+ +

Une Promise. Si l'expéditeur a envoyé une réponse, celle-ci sera remplie avec la réponse en tant qu'objet JSON. Sinon, il sera rempli sans arguments. Si une erreur survient lors de la connexion à l'application native, la promesse sera rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Voici un script d'arrière-plan qui envoie un message "ping" à l'application "ping_pong" et enregistre la réponse, chaque fois que l'utilisateur clique sur l'action du navigateur :

+ +
function onResponse(response) {
+  console.log(`Received ${response}`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+/*
+On a click on the browser action, send the app a message.
+*/
+browser.browserAction.onClicked.addListener(() => {
+  console.log("Sending:  ping");
+  var sending = browser.runtime.sendNativeMessage("ping_pong", "ping");
+  sending.then(onResponse, onError);
+});
+ +

{{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.

+ +

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/runtime/setuninstallurl/index.html b/files/fr/mozilla/add-ons/webextensions/api/runtime/setuninstallurl/index.html deleted file mode 100644 index 94befdc38d..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/setuninstallurl/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: runtime.setUninstallURL() -slug: Mozilla/Add-ons/WebExtensions/API/runtime/setUninstallURL -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - runtime - - setUninstallURL -translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/setUninstallURL ---- -
{{AddonSidebar()}}
- -

Définit l'URL à visiter lorsque l'extension est déinstallée. Cela peut être utilisé pour nettoyer les données côté serveur, effectuer des analyses ou implémenter des enquêtes. L'URL peut contenir au maximum 255 caractères.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var settingUrl = browser.runtime.setUninstallURL(
-  url             // string
-)
-
- -

Paramètres

- -
-
url
-
string. L'URL à ouvrir après la désinstallation de l'extension. Cette URL doit avoir un schéma http ou https.  Définissez-le sur une chaîne vide pour ne pas ouvrir un nouvel onglet lors de la désinstallation.
-
- -

Valeur retournée

- -

Une Promise qui sera remplie sans argument lorsque l'URL a été définie ou rejetée avec un message d'erreur si l'opération a échoué.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -
function onSetURL() {
-  console.log("set uninstall URL");
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var settingUrl = browser.runtime.setUninstallURL("https://example.org");
-settingUrl.then(onSetURL, onError);
- -

{{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.

- -

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/runtime/setuninstallurl/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/setuninstallurl/index.md new file mode 100644 index 0000000000..94befdc38d --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/setuninstallurl/index.md @@ -0,0 +1,95 @@ +--- +title: runtime.setUninstallURL() +slug: Mozilla/Add-ons/WebExtensions/API/runtime/setUninstallURL +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - runtime + - setUninstallURL +translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/setUninstallURL +--- +
{{AddonSidebar()}}
+ +

Définit l'URL à visiter lorsque l'extension est déinstallée. Cela peut être utilisé pour nettoyer les données côté serveur, effectuer des analyses ou implémenter des enquêtes. L'URL peut contenir au maximum 255 caractères.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var settingUrl = browser.runtime.setUninstallURL(
+  url             // string
+)
+
+ +

Paramètres

+ +
+
url
+
string. L'URL à ouvrir après la désinstallation de l'extension. Cette URL doit avoir un schéma http ou https.  Définissez-le sur une chaîne vide pour ne pas ouvrir un nouvel onglet lors de la désinstallation.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie sans argument lorsque l'URL a été définie ou rejetée avec un message d'erreur si l'opération a échoué.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +
function onSetURL() {
+  console.log("set uninstall URL");
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var settingUrl = browser.runtime.setUninstallURL("https://example.org");
+settingUrl.then(onSetURL, onError);
+ +

{{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.

+ +

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