From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../api/extension/getbackgroundpage/index.html | 100 ++++++++++++++++++ .../api/extension/getextensiontabs/index.html | 88 ++++++++++++++++ .../webextensions/api/extension/geturl/index.html | 94 +++++++++++++++++ .../api/extension/getviews/index.html | 117 +++++++++++++++++++++ .../add-ons/webextensions/api/extension/index.html | 109 +++++++++++++++++++ .../api/extension/inincognitocontext/index.html | 64 +++++++++++ .../extension/isallowedfileschemeaccess/index.html | 94 +++++++++++++++++ .../extension/isallowedincognitoaccess/index.html | 92 ++++++++++++++++ .../api/extension/lasterror/index.html | 64 +++++++++++ .../api/extension/onrequest/index.html | 117 +++++++++++++++++++++ .../api/extension/onrequestexternal/index.html | 116 ++++++++++++++++++++ .../api/extension/sendrequest/index.html | 97 +++++++++++++++++ .../api/extension/setupdateurldata/index.html | 80 ++++++++++++++ .../api/extension/viewtype/index.html | 68 ++++++++++++ 14 files changed, 1300 insertions(+) create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/getextensiontabs/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/geturl/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/getviews/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/inincognitocontext/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/isallowedfileschemeaccess/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/isallowedincognitoaccess/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/lasterror/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/onrequest/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/onrequestexternal/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/sendrequest/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/setupdateurldata/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/extension/viewtype/index.html (limited to 'files/fr/mozilla/add-ons/webextensions/api/extension') diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.html new file mode 100644 index 0000000000..81ba330d0d --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.html @@ -0,0 +1,100 @@ +--- +title: extension.getBackgroundPage() +slug: Mozilla/Add-ons/WebExtensions/API/extension/getBackgroundPage +tags: + - API + - Add-ons + - Extension + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - getBackgroundPage +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/getBackgroundPage +--- +
{{AddonSidebar()}}
+ +

Alias de {{WebExtAPIRef("runtime.getBackgroundPage()")}}.

+ +
+

Remarque : Cette méthode ne peut pas être utilisée en mode Navigation privée - elle renvoie toujours un tableau vide. Pour plus d'informations, voir {{bug(1329304)}}.

+
+ +

Syntaxe

+ +
var page = browser.extension.getBackgroundPage()
+
+ +

Paramètres

+ +
+
None.
+
+ +

Valeur retournée

+ +

object. Window de la page d'arrière plan.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.extension.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
+
+var page = browser.extension.getBackgroundPage();
+page.foo(); // -> "I'm defined in background.js"
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/getextensiontabs/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/getextensiontabs/index.html new file mode 100644 index 0000000000..53f3ebde96 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/getextensiontabs/index.html @@ -0,0 +1,88 @@ +--- +title: extension.getExtensionTabs() +slug: Mozilla/Add-ons/WebExtensions/API/extension/getExtensionTabs +tags: + - API + - Add-ons + - Extension + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getExtensionTabs +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/getExtensionTabs +--- +
{{AddonSidebar()}}
+ +
+

Cette méthode a été dépréciée. Utilisez {{WebExtAPIRef("extension.getViews()")}} à la place.

+
+ +

Renvoie un tableau des objets de la Window JavaScriptpour chacun des onglets qui s'exécutent dans l'extension actuelle. Si windowId est spécifié, renvoie uniquement les objets Window des onglets attachés à la fenêtre spécifiée.

+ +

Syntaxe

+ +
chrome.extension.getExtensionTabs(
+  windowId // optional integer
+)
+
+ +

Cette API est également disponible en tant que browser.extension.getExtensionTabs().

+ +

Paramètres

+ +
+
windowId{{optional_inline}}
+
integer.
+
+ +

Valeur retournée

+ +

array of object. Tableau d'objets de fenêtre globaux

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.extension.getExtensionTabs")}}

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/geturl/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/geturl/index.html new file mode 100644 index 0000000000..dd23369df0 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/geturl/index.html @@ -0,0 +1,94 @@ +--- +title: extension.getURL() +slug: Mozilla/Add-ons/WebExtensions/API/extension/getURL +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getURL +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/getURL +--- +
{{AddonSidebar}}
+ +
+

Cette fonction est obsolète. Veuillez utiliser runtime.getURL.

+
+ +

Convertit un chemin relatif dans le répertoire d'installation d'une extension en une URL complète.

+ +

Syntaxe

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

Paramètres

+ +
+
path
+
string. Un chemin vers une ressource dans une extension exprimée par rapport à son répertoire d'installation.
+
+ +

Valeur retournée

+ +

string. The fully-qualified URL to the resource.

+ +

Compatibilité du navigateur

+ + + +

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

+ +

Exemples

+ +

Donné un fichier empaqueté avec l'add-on à "beasts/frog.html", obtenez l'URL complète comme ceci :

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

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/getviews/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/getviews/index.html new file mode 100644 index 0000000000..48fbbcd5c7 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/getviews/index.html @@ -0,0 +1,117 @@ +--- +title: extension.getViews() +slug: Mozilla/Add-ons/WebExtensions/API/extension/getViews +tags: + - API + - Add-ons + - Extension + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - getViews +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/getViews +--- +
{{AddonSidebar()}}
+ +

Renvoie un tableau des objets Window pour chacune des pages exécutées dans l'extension en cours. Cela inclut, par exemple :

+ + + +

Dans Firefox, si cette méthode est appelée à partir d'une page faisant partie d'une fenêtre de navigation privée, telle qu'une barre latérale dans une fenêtre privée ou une fenêtre ouverte à partir d'une fenêtre privée, sa valeur de retour n'inclut pas la page d'arrière-plan de l'extension.

+ +

Syntaxe

+ +
var windows = browser.extension.getViews(
+  fetchProperties // optional object
+)
+
+ +

Paramètres

+ +
+
fetchProperties{{optional_inline}}
+
object.
+
+
+
type{{optional_inline}}
+
string. Un {{WebExtAPIRef('extension.ViewType')}} indiquant le type de vue à obtenir. Si omis, cette fonction renvoie toutes les vues.
+
windowId{{optional_inline}}
+
integer. La fenêtre pour restreindre la recherche. Si omis, cette fonction renvoie toutes les vues.
+
+
+
+ +

Valeur retournée

+ +

array of object. Un tableau d'objets Window.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.extension.getViews")}}

+ +

Exemples

+ +

Obtenez toutes les fenêtres appartenant à cette extension et consignez leurs URL :

+ +
var windows = browser.extension.getViews();
+
+for (var extensionWindow of windows) {
+  console.log(extensionWindow.location.href);
+}
+ +

Obtenez uniquement des fenêtres dans les onglets du navigateur hébergeant du contenu fourni avec l'extension :

+ +
var windows = browser.extension.getViews({type: "tab"});
+ +

Obtenir seulement des fenêtres dans les popups :

+ +
var windows = browser.extension.getViews({type: "popup"});
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

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

Utilitaires liés à votre extension. Obtenez des URL vers des packages de ressources avec votre extension, récupérez l'objet Window pour les pages de votre extension, récupérez les valeurs pour différents paramètres. Notez que les API de messagerie de ce module sont déconseillées au profit des API équivalentes dans le module runtime.

+ +

Types

+ +
+
{{WebExtAPIRef("extension.ViewType")}}
+
Le type de vue d'extension.
+
+ +

Propriétés

+ +
+
{{WebExtAPIRef("extension.lastError")}}
+
Défini pour la durée de vie d'un rappel si une extension ansychronique a généré une erreur. Si aucune erreur n'est survenue, lastError sera indéfini.
+
{{WebExtAPIRef("extension.inIncognitoContext")}}
+
True pour les scripts de contenu s'exécutant dans les onglets de navigation privée et pour les pages d'extension exécutées dans un processus de navigation privée. Ce dernier ne s'applique qu'aux extensions avec 'incognito_behavior'.
+
+ +

Fonctions

+ +
+
{{WebExtAPIRef("extension.getBackgroundPage()")}}
+
Renvoie l'objet Window pour la page d'arrière-plan qui s'exécute dans l'extension en cours. Renvoie null si l'extension n'a pas de page d'arrière-plan.
+
{{WebExtAPIRef("extension.getExtensionTabs()")}} {{deprecated_inline}}
+
Renvoie un tableau des objets de la Window JavaScript pour chacun des onglets qui s'exécutent dans l'extension actuelle.
+
{{WebExtAPIRef("extension.getURL()")}} {{deprecated_inline}}
+
Convertit un chemin relatif dans un répertoire d'installation d'extension en une URL complète.
+
{{WebExtAPIRef("extension.getViews()")}}
+
Renvoie un tableau des objets Window pour chacune des pages exécutées dans l'extension en cours.
+
{{WebExtAPIRef("extension.isAllowedIncognitoAccess()")}}
+
Récupère l'état de l'accès de l'extension en mode navigation privée (déterminé par la case à cocher "Autorisé dans navigation privée").
+
{{WebExtAPIRef("extension.isAllowedFileSchemeAccess()")}}
+
Récupère l'état de l'accès de l'extension au schéma 'file://' (déterminé par la case à cocher 'Autoriser l'accès aux URL des fichiers').***
+
{{WebExtAPIRef("extension.sendRequest()")}} {{deprecated_inline}}
+
Envoie une seule requête aux autres écouteurs de l'extension.
+
{{WebExtAPIRef("extension.setUpdateUrlData()")}}
+
Définit la valeur du paramètre CGI AP utilisé dans l'URL de mise à jour de l'extension. Cette valeur est ignorée pour les extensions hébergées dans le magasin du fournisseur du navigateur.
+
+ +

Evénements

+ +
+
{{WebExtAPIRef("extension.onRequest")}} {{deprecated_inline}}
+
Lancé lorsqu'une requête est envoyée par un processus d'extension ou un script de contenu.
+
{{WebExtAPIRef("extension.onRequestExternal")}} {{deprecated_inline}}
+
Lancé lorsqu'une requête est envoyée depuis une autre extension.
+
+ +

Compatibilité du navigateur

+ + + +

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

+ +

{{WebExtExamples("h2")}}

+ +
Remerciements : + +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/inincognitocontext/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/inincognitocontext/index.html new file mode 100644 index 0000000000..b27209b60f --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/inincognitocontext/index.html @@ -0,0 +1,64 @@ +--- +title: extension.inIncognitoContext +slug: Mozilla/Add-ons/WebExtensions/API/extension/inIncognitoContext +tags: + - API + - Add-ons + - Extension + - Extensions + - Non-standard + - Property + - Reference + - WebExtensions + - inIncognitoContext +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/inIncognitoContext +--- +
{{AddonSidebar()}}
+ +

Valeur booléenne, true pour les scripts de contenu s'exécutant dans les onglets de navigation privée et pour les pages d'extension exécutées dans un processus de navigation privé..

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.extension.inIncognitoContext")}}

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedfileschemeaccess/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedfileschemeaccess/index.html new file mode 100644 index 0000000000..78b7cfd521 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedfileschemeaccess/index.html @@ -0,0 +1,94 @@ +--- +title: extension.isAllowedFileSchemeAccess() +slug: Mozilla/Add-ons/WebExtensions/API/extension/isAllowedFileSchemeAccess +tags: + - API + - Add-ons + - Extension + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - isAllowedFileSchemeAccess +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/isAllowedFileSchemeAccess +--- +
{{AddonSidebar()}}
+ +
Renvoie true si l'extension peut accéder au schéma "file://", sinon false.
+ +
+ +
+

C'est une fonction asynchrone qui renvoie une Promise.

+
+ +

Syntaxe

+ +
var isAllowed = browser.extension.isAllowedFileSchemeAccess()
+
+ +

Paramètres

+ +

None.

+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un booléen : true si l'extension est autorisée à accéder aux URLs "file://", sinon false.

+ +

Firefox retournera toujours false.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.extension.isAllowedFileSchemeAccess")}}

+ +

Exemples

+ +
function logIsAllowed(answer) {
+  console.log(`Is allowed: ${answer}`);
+}
+
+var isAllowed = browser.extension.isAllowedFileSchemeAccess();
+isAllowed.then(logIsAllowed);
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedincognitoaccess/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedincognitoaccess/index.html new file mode 100644 index 0000000000..367b8af532 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedincognitoaccess/index.html @@ -0,0 +1,92 @@ +--- +title: extension.isAllowedIncognitoAccess() +slug: Mozilla/Add-ons/WebExtensions/API/extension/isAllowedIncognitoAccess +tags: + - API + - Add-ons + - Extension + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - isAllowedIncognitoAccess +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/isAllowedIncognitoAccess +--- +
{{AddonSidebar()}}
+ +

Vérifiez si l'extension est autorisée à accéder aux onglets ouverts en mode "navigation privée".

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var isAllowed = browser.extension.isAllowedIncognitoAccess()
+
+ +

Paramètres

+ +

None.

+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un booléen : true si l'extension est autorisée à accéder aux onglets privés, sinon false.

+ +

 

+ +

Exemples

+ +
function logIsAllowed(answer) {
+  console.log(`Is allowed: ${answer}`);
+}
+
+var isAllowed = browser.extension.isAllowedIncognitoAccess();
+isAllowed.then(logIsAllowed);
+ +

{{WebExtExamples}}

+ +

 

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.extension.isAllowedIncognitoAccess")}}

+ +
Remerciements : + +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/lasterror/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/lasterror/index.html new file mode 100644 index 0000000000..f1803043c3 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/lasterror/index.html @@ -0,0 +1,64 @@ +--- +title: extension.lastError +slug: Mozilla/Add-ons/WebExtensions/API/extension/lastError +tags: + - API + - Add-ons + - Extension + - Extensions + - Non-standard + - Property + - Reference + - WebExtensions + - lastError +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/lastError +--- +
{{AddonSidebar()}}
+ +

Un alias de {{WebExtAPIRef("runtime.lastError")}}.

+ +

Compatibilité du navoigateur

+ + + +

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

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/onrequest/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/onrequest/index.html new file mode 100644 index 0000000000..75e4ea7efe --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/onrequest/index.html @@ -0,0 +1,117 @@ +--- +title: extension.onRequest +slug: Mozilla/Add-ons/WebExtensions/API/extension/onRequest +tags: + - API + - Add-ons + - Event + - Extension + - Extensions + - Reference + - WebExtensions + - onRequest +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/onRequest +--- +
{{AddonSidebar()}}
+ +
+

Not implémenté : Ceci n'est pas implémenté dans Firefox car il est obsolète depuis Chrome 33. Veuillez utiliser runtime.onMessageExternal à la place.

+
+ +

Lancé lorsqu'une requête est envoyée par un processus d'extension ou un script de contenu.

+ +

Syntaxe

+ +
chrome.extension.onRequest.addListener(function(
+  request,         // optional any
+  sender,          // runtime.MessageSender
+  function() {...} // function
+) {...})
+chrome.extension.onRequest.removeListener(listener)
+chrome.extension.onRequest.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érifiez si listener est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.
+
+ + + +

Syntaxe addListener

+ +

Paramètres

+ +
+
callback
+
+

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

+ +
+
request
+
any. La requête envoyée par le script appelant.
+
+ +
+
sender
+
{{WebExtAPIRef('runtime.MessageSender')}}.
+
+ +
+
sendResponse
+
function. Fonction à appeler (au plus une fois) lorsque vous avez une réponse. L'argument doit être n'importe quel objet JSON-ifiable, ou undefined s'il n'y a pas de réponse. Si vous avez plus d'un écouteur onRequest dans le même document, un seul peut envoyer une réponse.
+
+
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.extension.onRequest")}}

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/onrequestexternal/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/onrequestexternal/index.html new file mode 100644 index 0000000000..9eade45d3e --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/onrequestexternal/index.html @@ -0,0 +1,116 @@ +--- +title: extension.onRequestExternal +slug: Mozilla/Add-ons/WebExtensions/API/extension/onRequestExternal +tags: + - API + - Add-ons + - Event + - Extension + - Extensions + - Non-standard + - Reference + - WebExtensions + - onRequestExternal +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/onRequestExternal +--- +
{{AddonSidebar()}}
+ +
+

Not implémenté : Ceci n'est pas implémenté dans Firefox car il est obsolète depuis Chrome 33. Veuillez utiliser runtime.onMessageExternal à la place.

+
+ +

Lancé lorsqu'une requête est envoyée depuis une autre extension.

+ +

Syntaxe

+ +
chrome.extension.onRequestExternal.addListener(function(
+  request,         // optional any
+  sender,          // runtime.MessageSender
+  function() {...} // function
+) {...})
+chrome.extension.onRequestExternal.removeListener(listener)
+chrome.extension.onRequestExternal.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érifiez si listener est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.
+
+ +

Syntaxe addListener

+ +

Paramètres

+ +
+
callback
+
+

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

+ +
+
request
+
any. La requête envoyée par le script appelant.
+
+ +
+
sender
+
{{WebExtAPIRef('runtime.MessageSender')}}.
+
+ +
+
sendResponse
+
function. Fonction à appeler lorsque vous avez une réponse. L'argument doit être n'importe quel objet JSON-ifiable, ou undefined s'il n'y a pas de réponse.
+
+
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.extension.onRequestExternal")}}

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/sendrequest/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/sendrequest/index.html new file mode 100644 index 0000000000..c1f843101e --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/sendrequest/index.html @@ -0,0 +1,97 @@ +--- +title: extension.sendRequest() +slug: Mozilla/Add-ons/WebExtensions/API/extension/sendRequest +tags: + - API + - Add-ons + - Extension + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - sendRequest +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/sendRequest +--- +
{{AddonSidebar}}{{Deprecated_Header}} +
+

Cette méthode est dépréciée. utilisez {{WebExtAPIRef("runtime.sendMessage")}} à la place.

+
+
+ +

Envoie une seule requête aux autres écouteurs de l'extension. Similaire à {{WebExtAPIRef('runtime.connect')}},mais envoie seulement une seule requête avec une réponse optionnelle. L'événement {{WebExtAPIRef('extension.onRequest')}} est déclenché dans chaque page de l'extension

+ +

Syntaxe

+ +
chrome.extension.sendRequest(
+  extensionId,             // optional string
+  request,                 // any
+  function(response) {...} // optional function
+)
+
+ +

Cette API est également disponible en tant que browser.extension.sendRequest() dans une version qui renvoie une promise.

+ +

Paramètres

+ +
+
extensionId{{Optional_Inline}}
+
string. L'ID d'extension de l'extension à laquelle vous souhaitez vous connecter. Si omis, la valeur par défaut est votre propre extension.
+
request
+
any.
+
responseCallback{{Optional_Inline}}
+
function. La fonction est passée les arguments suivants : + + +
+
response
+
any. Objet de réponse JSON envoyé par le gestionnaire de la requête. Si une erreur survient lors de la connexion à l'extension, le rappel sera appelé sans arguments et  {{WebExtAPIRef('runtime.lastError')}} sera défini sur le message d'erreur.
+
+
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.extension.sendRequest")}}

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/extension/setupdateurldata/index.html b/files/fr/mozilla/add-ons/webextensions/api/extension/setupdateurldata/index.html new file mode 100644 index 0000000000..516d490702 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/setupdateurldata/index.html @@ -0,0 +1,80 @@ +--- +title: extension.setUpdateUrlData() +slug: Mozilla/Add-ons/WebExtensions/API/extension/setUpdateUrlData +tags: + - API + - Add-ons + - Extension + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - setUpdateUrlData +translation_of: Mozilla/Add-ons/WebExtensions/API/extension/setUpdateUrlData +--- +
{{AddonSidebar()}}
+ +

Définit les paramètres de l'URL de mise à jour de l'extension. Cette valeur est ignorée pour les extensions hébergées dans le magasin du fournisseur du navigateur.

+ +

Syntaxe

+ +
browser.extension.setUpdateUrlData(
+  data // string
+)
+
+ +

Paramètres

+ +
+
data
+
string.
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.extension.setUpdateUrlData")}}

+ +

Exemples

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

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

Le type de vue de l'extension.

+ +

Type

+ +

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont : "tab", "popup", "sidebar".

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.extension.ViewType")}}

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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

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