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/management/extensioninfo/index.html | 128 +++++++++++++++++++++ .../webextensions/api/management/get/index.html | 98 ++++++++++++++++ .../webextensions/api/management/getall/index.html | 96 ++++++++++++++++ .../getpermissionwarningsbyid/index.html | 103 +++++++++++++++++ .../getpermissionwarningsbymanifest/index.html | 112 ++++++++++++++++++ .../api/management/getself/index.html | 90 +++++++++++++++ .../webextensions/api/management/index.html | 112 ++++++++++++++++++ .../api/management/install/index.html | 85 ++++++++++++++ .../api/management/ondisabled/index.html | 106 +++++++++++++++++ .../api/management/onenabled/index.html | 106 +++++++++++++++++ .../api/management/oninstalled/index.html | 106 +++++++++++++++++ .../api/management/onuninstalled/index.html | 106 +++++++++++++++++ .../api/management/setenabled/index.html | 105 +++++++++++++++++ .../api/management/uninstall/index.html | 111 ++++++++++++++++++ .../api/management/uninstallself/index.html | 121 +++++++++++++++++++ 15 files changed, 1585 insertions(+) create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/extensioninfo/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/get/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/getall/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbyid/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbymanifest/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/getself/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/install/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/ondisabled/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/onenabled/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/oninstalled/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/onuninstalled/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/setenabled/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/uninstall/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/management/uninstallself/index.html (limited to 'files/fr/mozilla/add-ons/webextensions/api/management') diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/extensioninfo/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/extensioninfo/index.html new file mode 100644 index 0000000000..4f58fb50c7 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/extensioninfo/index.html @@ -0,0 +1,128 @@ +--- +title: ExtensionInfo +slug: Mozilla/Add-ons/WebExtensions/API/management/ExtensionInfo +tags: + - API + - Add-ons + - ExtensionInfo + - Extensions + - Reference + - Type + - WebExtensions + - management +translation_of: Mozilla/Add-ons/WebExtensions/API/management/ExtensionInfo +--- +
{{AddonSidebar()}}
+ +

Un objet ExtensionInfo contenant les informations sur l'extension.

+ +

Type

+ +

Il s'agit d'un objet avec les propriétés suivantes :

+ +
+
description
+
string. La description de l'extension, prise à partir de la clé de description du manifest.json.
+
disabledReason
+
string. Si l'extension est désactivée, la raison pour laquelle il a été désactivé. L'une des "inconnnues' or "permissions_increase".
+
enabled
+
boolean. Que l'extension soit activée ou pas.
+
homepageUrl
+
string. L'URL de la page d'accueil de l'extension, prise en compte de la clé  homepage_url du fichier manifest.json.
+
hostPermissions
+
ensemble de chaîne. Les permissions d'hôtes de l'extension.
+
icons
+
array of object. les informations sur les icônes des extensions. Un tableau d'objets, un par chaque icône. Chaque objet contient deux propriétés : +
    +
  • size: un entier représentant la largeur et la hauteur de l'icônes en pixels.
    • +
  • url: une chaîne contenant l'url relative de l'icône, en commençant par la racine de l'extensions.
    • +
+
+
id
+
string. l'ID de l'extension.
+
installType
+
string. Une chaîne décriantn comme l'extension a été ajouté. Une des options suivantes : +
    +
  • "admin": l'extension a été installé en raison d'une politique administrative.
    • +
  • "development": l'extension a été installé décompressé sur le disque.
    • +
  • "normal": l'extension a été installé normalement à partir du package d'installation.
    • +
  • "sideload": l'extension a été installé par un autre logiciel sur l'ordinateur de l'utilisateur.
    • +
  • "other": l'extension a été installé d'une autre manière.
    • +
+
+
mayDisable
+
boolean. Que cette extensions a été désactivé ou désinstallé par l'utilisateur.
+
name
+
string. Le nom de l'extension, pris à partir de la clé name du manifest.json.
+
offlineEnabled
+
boolean. Que les demandes de l'extensions soient prises en charge hors connexion.
+
optionsUrl
+
string. l'URL pour la page d'options de l'élément, s'il y en a un. Il s'agit d'une URL relative, à partir de la racine de l'extension.
+
permissions
+
array of string. les permissions de l'API de l'extension.
+
shortName
+
string. Une courte version du nom de l'extension, prise à partir de la clé  short_name du manifest.json.
+
type
+
string. Chaîne décrivant le type d'extension. Ceci permet de distinguer les extensions des applications et des thèmes. Il peut prendre l'une des valeurs suivantes :
+
+
    +
  • "extension": le type d'extension la plus courante.
    • +
  • "hosted_app"
    • +
  • "packaged_app"
    • +
  • "legacy_packaged_app"
    • +
  • "theme"
    • +
+
+
updateUrl
+
string. URL pour la mise à jour de l'extension, tiré de la clé applications de manifest.json.
+
version
+
string. La version de l'extension, tiré de la clé version du manifest.json
+
versionName
+
string. Le nom descriptif pour la version de l'extension, tiré de la clé  version_name du manifest.json.
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.ExtensionInfo")}}

+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/get/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/get/index.html new file mode 100644 index 0000000000..b345415a15 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/get/index.html @@ -0,0 +1,98 @@ +--- +title: management.get() +slug: Mozilla/Add-ons/WebExtensions/API/management/get +tags: + - API + - Add-ons + - Méthode + - Reference + - WebExtensions + - get + - management +translation_of: Mozilla/Add-ons/WebExtensions/API/management/get +--- +
{{AddonSidebar()}}
+ +

Récupère un objet {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}} contenant des informations sur l'extension spécifiée.

+ +

Cette API requière la permission API "management"

+ +

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

+ +

Syntaxe

+ +
var gettingInfo = browser.management.get(
+  id                  // string
+)
+
+ +

Paramètres

+ +
+
id
+
string. l'ID de l'extension dont vous souhaitez récupérer les informations.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un objet  {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}} , contenant les informations sur l'extension. La promise sera rejetée si aucune extension avec l'ID donné n'est installée ou si l'appelant ne peut pas accéder à l'extension.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.get")}}

+ +

Exemples

+ +

Enregistrez le nom de l'extension dont l'ID est "my-add-on":

+ +
var id = "my-add-on";
+
+function got(info) {
+  console.log(info.name);
+}
+
+var getting = browser.management.get(id);
+getting.then(got);
+
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/getall/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/getall/index.html new file mode 100644 index 0000000000..c8a6ceb193 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/getall/index.html @@ -0,0 +1,96 @@ +--- +title: management.getAll() +slug: Mozilla/Add-ons/WebExtensions/API/management/getAll +tags: + - API + - Add-ons + - Méthode + - Reference + - WebExtensions + - getAll + - management +translation_of: Mozilla/Add-ons/WebExtensions/API/management/getAll +--- +
{{AddonSidebar()}}
+ +

Récupère un ensemble d'objets {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}}, un pour chaque extension installé.

+ +

Notez que Google Chrome récupère les applications ainsi que les modules complémentaires. Dans Chrome vous pouvez distinguer les applications des extensions en utilisant la propriété type de  {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}}.

+ +

Cette API requiert la permission de l'API de "management"

+ +

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

+ +

Syntaxe

+ +
var gettingAll = browser.management.getAll()
+
+ +

Paramètres

+ +

None.

+ +

Valeur retournée

+ +

Une Promise qui sera rempli avec un ensemble d'objets  {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}}, un pour chaque extension installée.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.getAll")}}

+ +

Exemples

+ +

Enregistrez le nom de toutes les extensions installées :

+ +
function gotAll(infoArray) {
+  for (info of infoArray) {
+    if (info.type == "extension") {
+      console.log(info.name);
+    }
+  }
+}
+
+var gettingAll = browser.management.getAll();
+gettingAll.then(gotAll);
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/getpermissionwarningsbyid/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbyid/index.html new file mode 100644 index 0000000000..c3531b3141 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbyid/index.html @@ -0,0 +1,103 @@ +--- +title: management.getPermissionWarningsById() +slug: Mozilla/Add-ons/WebExtensions/API/management/getPermissionWarningsById +tags: + - API + - Add-ons + - Méthode + - Reference + - WebExtensions + - getPermissionWarningsById + - management +translation_of: Mozilla/Add-ons/WebExtensions/API/management/getPermissionWarningsById +--- +
{{AddonSidebar()}}
+ +
Lorsque l'utilisateur installe ou met  à jour une extension, le navigateur peut avertir l'utilisateur des permissions particulièrement puissantes que l'extension a demandée. Toutes les permissions ne donnent pas lieu à des alertes et ce comportement n'est pas normalisé dans les navigateurs.
+ +
+ +

Compte tenu de l'ID d'une extension, cette fonction retourne les avertisseurs de permissions comme un tableau de chaînes.

+ +

Cette API requière l'API permission "management"

+ +

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

+ +

Syntaxe

+ +
var gettingWarnings = browser.management.getPermissionWarningsById(
+  id                  // string
+)
+
+ +

Paramètres

+ +
+
id
+
string. ID de l'extension dont vous souhaitez récupérer les avertisseurs de permissions.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un ensemble de chaînes, chacune contenant un texte d'un avertissement de permissions.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.getPermissionWarningsById")}}

+ +

Exemples

+ +

Enregistrez les avertissements de permissions pour l'extension dont l'ID est "my-add-on" :

+ +
var id = "my-add-on";
+
+function gotWarnings(warnings) {
+  for (warning of warnings) {
+    console.log(warning);
+  }
+}
+
+var gettingWarnings = browser.management.getPermissionWarningsById(id);
+gettingWarnings.then(gotWarnings);
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/getpermissionwarningsbymanifest/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbymanifest/index.html new file mode 100644 index 0000000000..1835063905 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbymanifest/index.html @@ -0,0 +1,112 @@ +--- +title: management.getPermissionWarningsByManifest() +slug: Mozilla/Add-ons/WebExtensions/API/management/getPermissionWarningsByManifest +tags: + - API + - Add-ons + - Méthode + - Reference + - WebExtensions + - getPermissionWarningsByManifest + - management +translation_of: Mozilla/Add-ons/WebExtensions/API/management/getPermissionWarningsByManifest +--- +
{{AddonSidebar()}}
+ +
Lorsque l'utilisateur installe ou met à jour une extension, la navigateur peut avertir l'utilisateur des permissions obligatoires. Toutes les permissions ne donnent pas lieu à des avertissements, et cela n'est pas normalisé dans les navigateurs.
+ +
+ +

Compte tenu du texte du fichier manifest.json, cette fonction retourne les avertisseurs de permissions qui seraient donnés pour l'extension comme un ensemble de chaines.

+ +

Cette API ne requière pas l'API de permission "management".

+ +

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

+ +

Syntaxe

+ +
var gettingWarnings = browser.management.getPermissionWarningsByManifest(
+  manifestString      // string
+)
+
+ +

Paramètres

+ +
+
manifestString
+
string. Chaîne contenant le fichier manifest. Cela doit être un manifest valide : par exemple, il doit contenir toutes les clés obligatoires du manifest..
+
+ +

Valeur retournée

+ +

Une Promise qui sera rempli avec un ensemble de chaînes, chacune contenant le texte un avertisseur de permission.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.getPermissionWarningsByManifest")}}

+ +

Exemples

+ +

Enregistrez les avertissements de permissions dans le fichier manifest donné :

+ +
var manifest = {
+  "manifest_version": 2,
+  "name": "test",
+  "version": "1.0",
+  "permissions": ["management", "<all_urls>"]
+}
+
+var manifestString = JSON.stringify(manifest);
+
+function gotWarnings(warnings) {
+  console.log(warnings);
+}
+
+function gotError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var gettingWarnings = browser.management.getPermissionWarningsByManifest(manifestString);
+gettingWarnings.then(gotWarnings, gotError);
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/getself/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/getself/index.html new file mode 100644 index 0000000000..09d60bab5f --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/getself/index.html @@ -0,0 +1,90 @@ +--- +title: management.getSelf() +slug: Mozilla/Add-ons/WebExtensions/API/management/getSelf +tags: + - API + - Add-ons + - Méthode + - Reference + - WebExtensions + - getSelf + - management +translation_of: Mozilla/Add-ons/WebExtensions/API/management/getSelf +--- +
{{AddonSidebar()}}
+ +

Récupère un objet {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}} contenant les informations de l'extension appelée.

+ +

Cette API ne requière pas l' API de permission "management".

+ +

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

+ +

Syntaxe

+ +
var gettingSelf = browser.management.getSelf()
+
+ +

Paramètres

+ +

Aucun.

+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un objet {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}}, contenant les informations sur l'extension.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.getSelf")}}

+ +

Exemples

+ +

Enregistrez le nom de l'extension :

+ +
function gotSelf(info) {
+  console.log("Add-on name: " + info.name);
+}
+
+var gettingSelf = browser.management.getSelf();
+gettingSelf.then(gotSelf);
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/index.html new file mode 100644 index 0000000000..ccf2d2a647 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/index.html @@ -0,0 +1,112 @@ +--- +title: management +slug: Mozilla/Add-ons/WebExtensions/API/management +tags: + - API + - Add-ons + - Extensions + - Reference + - WebExtensions + - management +translation_of: Mozilla/Add-ons/WebExtensions/API/management +--- +
{{AddonSidebar}}
+ +

Obtenez les éléments sur les modules complémentaires installés.

+ +

Avec l'API de gestion vous pouvez :

+ + + +

La plupart de ces opérations requièrent les permissions d'APIs de gestion. Les opérations qui ne fournissent pas d'accès à d'autres modules complémentaires ne nécessitent pas de permissions.

+ +

Types

+ +
+
{{WebExtAPIRef("management.ExtensionInfo")}}
+
Un objet contenant des informations sur un module complémentaire installé.
+
+ +

Fonctions

+ +
+
{{WebExtAPIRef("management.getAll()")}}
+
Renvoie des informations sur tous les modules complémentaires installés
+
{{WebExtAPIRef("management.get()")}}
+
Renvoie des informations sur un module complémentaire particulier, compte tenu de son ID.
+
{{WebExtAPIRef("management.getSelf()")}}
+
Renvoie des informations sur l'appel du module complémentaire.
+
{{WebExtAPIRef("management.install()")}}
+
Installe un thème particulier, étant donné son URL à l'adresse  addons.mozilla.org.
+
{{WebExtAPIRef("management.uninstall()")}}
+
Désinstalle un module complémenaire particulier, compte tenu de son ID.
+
{{WebExtAPIRef("management.uninstallSelf()")}}
+
Désinstalle l'appel d'un module complémentaire.
+
{{WebExtAPIRef("management.getPermissionWarningsById()")}}
+
Obtenez l'ensemble des alertes des permissions particulièrement pour un module complémentaire, compte tenu de son ID.
+
{{WebExtAPIRef("management.getPermissionWarningsByManifest()")}}
+
Obtenez l'ensemble des alertes de permission qui seraient affichés pour la chaîne de manifest donnée.
+
{{WebExtAPIRef("management.setEnabled()")}}
+
Activer / désactiver un module complémentaire, compte tenu de son ID.
+
+

Evénements

+
+
{{WebExtAPIRef("management.onInstalled")}}
+
Action quand un module complémentaire est installé.
+
{{WebExtAPIRef("management.onUninstalled")}}
+
Action quand un module complémentaire est désinstallé.
+
{{WebExtAPIRef("management.onEnabled")}}
+
Action quand un module complémentaire est activé.
+
{{WebExtAPIRef("management.onDisabled")}}
+
Action quand un module complémenaire est désactivé.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples("h2")}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/install/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/install/index.html new file mode 100644 index 0000000000..7d34f8cf48 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/install/index.html @@ -0,0 +1,85 @@ +--- +title: management.install() +slug: Mozilla/Add-ons/WebExtensions/API/management/install +tags: + - API + - Add-ons + - Méthode + - Reference + - Theme + - WebExtensions + - install + - management +translation_of: Mozilla/Add-ons/WebExtensions/API/management/install +--- +
{{AddonSidebar()}}
+ +
Installe et active une extension de thème à partir de l'URL donnée.
+ +
+ +

Cette API nécessite la permission de l'API "management" et ne fonctionnera qu'avec des thèmes signés.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
let {id} = await browser.management.install({url});
+
+ +

Paramètres

+ +
+
options
+
Un objet qui inclut l'URL du fichier XPI du thème à addons.mozilla.org et un hachage facultatif du fichier XPI, en utilisant sha256 ou plus.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un objet, contenant l'ExtensionID défini pour le thème dans manifest.json.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.install")}}

+ +

Exemples

+ +

Parcourez une liste de thèmes :

+ +
"use strict";
+
+let themes = [
+    "https://addons.mozilla.org/firefox/downloads/file/1063216/insightscare-1.0-fx.xpi",
+    "https://addons.mozilla.org/firefox/downloads/file/1063419/orange_roses-1.0-fx.xpi",
+    "https://addons.mozilla.org/firefox/downloads/file/1062647/sticktoyourguns-2.0-fx.xpi",
+    "https://addons.mozilla.org/firefox/downloads/file/0/bad_url.xpi",
+];
+
+let current;
+
+async function install(url) {
+    try {
+        current = url;
+        let {id} = await browser.management.install({url});
+        console.log("Theme installed: " + id);
+    } catch (e) {
+        console.error("Installation failed: " + e);
+    }
+}
+
+browser.browserAction.onClicked.addListener(() => {
+    let id = themes.indexOf(current);
+    install(themes[(id + 1) % themes.length]);
+});
+
+for (let url of themes) {
+    browser.menus.create({
+        title: url,
+        onclick: () => install(url),
+        contexts: ["browser_action"],
+    });
+}
+ +

{{WebExtExamples}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/ondisabled/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/ondisabled/index.html new file mode 100644 index 0000000000..14d78eb5e0 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/ondisabled/index.html @@ -0,0 +1,106 @@ +--- +title: management.onDisabled() +slug: Mozilla/Add-ons/WebExtensions/API/management/onDisabled +tags: + - API + - Add-ons + - Event + - Reference + - WebExtensions + - management + - onDisabled +translation_of: Mozilla/Add-ons/WebExtensions/API/management/onDisabled +--- +
{{AddonSidebar()}}
+ +

Action quand l'extension est désactivée.

+ +

L'API requière l'API de permission "management".

+ +

Syntaxe

+ +
browser.management.onDisabled.addListener(listener)
+browser.management.onDisabled.removeListener(listener)
+browser.management.onDisabled.hasListener(listener)
+
+ +

Les événement ont trois fonctions :

+ +
+
addListener(callback)
+
Ajoutez un auditeur à cet événement.
+
removeListener(listener)
+
L'argument de l'auditeur est l'auditeur à supprimer.
+
hasListener(listener)
+
Vérifie si l'auditeur est enregistré à l'événement. Renvoie true s'il est à l'écoute, sinon false .
+
+ +

addListener syntaxe

+ +

Paramètres

+ +
+
function
+
+

Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant :

+ +
+
info
+
ExtensionInfo: informations de l'extension qui a été désactivé
+
+
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.onDisabled")}}

+ +

Exemples

+ +

Enregistrez les noms des extensions lorsqu'ils sont désactivés.

+ +
browser.management.onDisabled.addListener((info) => {
+  console.log(info.name + " was disabled");
+});
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/onenabled/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/onenabled/index.html new file mode 100644 index 0000000000..51cc3883cb --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/onenabled/index.html @@ -0,0 +1,106 @@ +--- +title: management.onEnabled() +slug: Mozilla/Add-ons/WebExtensions/API/management/onEnabled +tags: + - API + - Add-ons + - Event + - Reference + - WebExtensions + - management + - onEnabled +translation_of: Mozilla/Add-ons/WebExtensions/API/management/onEnabled +--- +
{{AddonSidebar()}}
+ +

L'auditeur de l'événement appelé lorsque l'événement enabled est déclenché, indiquant qu'un add-on est maintenant activé.

+ +

L'API requière l'API de permission "management"

+ +

Syntaxe

+ +
browser.management.onEnabled.addListener(listener)
+browser.management.onEnabled.removeListener(listener)
+browser.management.onEnabled.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
addListener(callback)
+
Ajoutez un auditeur à cet événement.
+
removeListener(listener)
+
L'argument de l'auditeur est l'auditeur à supprimer.
+
hasListener(listener)
+
Vérifie si l'auditeur est enregistré à l'événement. Renvoie true s'il est à l'écoute, sinon false .
+
+ +

addListener syntaxe

+ +

Parameters

+ +
+
function
+
+

Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant :

+ +
+
info
+
ExtensionInfo: informations de l'extension qui a été désinstallé.
+
+
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.onEnabled")}}

+ +

Exemples

+ +

Enregistrez les noms des extensions lorsqu'ils sont activés :

+ +
browser.management.onEnabled.addListener((info) => {
+  console.log(info.name + " was enabled");
+});
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/oninstalled/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/oninstalled/index.html new file mode 100644 index 0000000000..4133c0101a --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/oninstalled/index.html @@ -0,0 +1,106 @@ +--- +title: management.onInstalled() +slug: Mozilla/Add-ons/WebExtensions/API/management/onInstalled +tags: + - API + - Add-ons + - Event + - Reference + - WebExtensions + - management + - onInstalled +translation_of: Mozilla/Add-ons/WebExtensions/API/management/onInstalled +--- +
{{AddonSidebar()}}
+ +

Action quand une extension est installée.

+ +

Cette API requière l'API de permission "management".

+ +

Syntaxe

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

Les événements ont trois fonctions :

+ +
+
addListener(callback)
+
Ajout un auditeur à l'événement.
+
removeListener(listener)
+
Arrêtez d'écouvter l'événement. L'argument de l'auditeur est un auditeur à supprimer.
+
hasListener(listener)
+
Vérifie si un auditeur est enregistré pour cet événement. Renvoie vrai si elle est à l'écoute, sinon faux .
+
+ +

addListener syntaxe

+ +

Paramètres

+ +
+
function
+
+

fonction de rappel qui sera appelée quand l'événement se produira. La fonction passera l'argument suivant :

+ +
+
info
+
ExtensionInfo: informations sur l'extension qui a été installée.
+
+
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.onInstalled")}}

+ +

Exemples

+ +

Enregistrez les noms des extensions lorsqu'ils sont installés :

+ +
browser.management.onInstalled.addListener((info) => {
+  console.log(info.name + " was installed");
+});
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/onuninstalled/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/onuninstalled/index.html new file mode 100644 index 0000000000..22323ddd12 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/onuninstalled/index.html @@ -0,0 +1,106 @@ +--- +title: management.onUninstalled() +slug: Mozilla/Add-ons/WebExtensions/API/management/onUninstalled +tags: + - API + - Add-ons + - Event + - Reference + - WebExtensions + - management + - onUninstalled +translation_of: Mozilla/Add-ons/WebExtensions/API/management/onUninstalled +--- +
{{AddonSidebar()}}
+ +

Action quand une extension est désinstallée.

+ +

L'API requière l'API de permission "management".

+ +

Syntaxe

+ +
browser.management.onUninstalled.addListener(listener)
+browser.management.onUninstalled.removeListener(listener)
+browser.management.onUninstalled.hasListener(listener)
+
+ +

Les événement ont trois fonctions :

+ +
+
addListener(callback)
+
Ajoutez un auditeur à cet événement.
+
removeListener(listener)
+
L'argument de l'auditeur est l'auditeur à supprimer.
+
hasListener(listener)
+
Vérifie si l'auditeur est enregistré à l'événement. Renvoie true s'il est à l'écoute, sinon false .
+
+ +

addListener syntaxe

+ +

Paramètres

+ +
+
function
+
+

Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant :

+ +
+
info
+
ExtensionInfo: informations de l'extension qui a été désinstallé.
+
+
+
+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.onUninstalled")}}

+ +

Exemples

+ +

Enregistrez les noms des extensions lorsqu'ils sont désinstallés :

+ +
browser.management.onUninstalled.addListener((info) => {
+  console.log(info.name + " was uninstalled");
+});
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/setenabled/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/setenabled/index.html new file mode 100644 index 0000000000..b2f074c381 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/setenabled/index.html @@ -0,0 +1,105 @@ +--- +title: management.setEnabled() +slug: Mozilla/Add-ons/WebExtensions/API/management/setEnabled +tags: + - API + - Add-ons + - Méthode + - Reference + - WebExtensions + - management + - setEnabled +translation_of: Mozilla/Add-ons/WebExtensions/API/management/setEnabled +--- +
{{AddonSidebar()}}
+ +

Active ou désactive l'extension ajoutée.

+ +

Cette fonction doit généralement être appelée dans le contexte d'une action utilisateur, comme le gestionnaire de clics d'un bouton. Le navigateur peut également demander à l'utilisateur de confirmer le changement.

+ +

Cette API requière l'API permission "management".

+ +

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

+ +

Syntaxe

+ +
var settingEnabled = browser.management.setEnabled(
+  id,              // string
+  enabled         // boolean
+)
+
+ +

Paramètres

+ +
+
id
+
string. ID de l'extension pour activer ou désactiver.
+
enabled
+
boolean. Que ce soit pour active ou désactiver l'extension.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie sans arguments lorsque l'extension a été désactivé ou activé.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.setEnabled")}}

+ +

Exemples

+ +

Actviez / Désactivez l'option pour l'extension dont l'ID est "my-add-on":

+ +
var id = "my-add-on";
+
+function toggleEnabled(id) {
+  var getting = browser.management.get(id);
+  getting.then((info) => {
+    browser.management.setEnabled(id, !info.enabled);
+  });
+}
+
+toggleEnabled(id);
+
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/uninstall/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/uninstall/index.html new file mode 100644 index 0000000000..38c6ac84e4 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/uninstall/index.html @@ -0,0 +1,111 @@ +--- +title: management.uninstall() +slug: Mozilla/Add-ons/WebExtensions/API/management/uninstall +tags: + - API + - Add-ons + - Méthode + - Reference + - WebExtensions + - management + - uninstall +translation_of: Mozilla/Add-ons/WebExtensions/API/management/uninstall +--- +
{{AddonSidebar()}}
+ +

Désinstalle une extension, compte tenu de son ID.

+ +

Cette API requiert l'API de permission. "management"

+ +

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

+ +

Syntaxe

+ +
var uninstalling = browser.management.uninstall(
+  id,                  // string
+  options              // object
+)
+
+ +

Paramètres

+ +
+
id
+
string. ID de l'extensions à désinstaller.
+
options{{optional_inline}}
+
object. l'objet qui peut contenir une propriété unique, showConfirmDialog. Si showConfirmDialog est true, le navigateur affiche une boie de dialogue demandant à l'utilisateur de confirmer que le complément doit être désinstallé. +
    +
  • Si id est l'ID de l'extension appelant, showConfirmDialog est par défaut à false.
    • +
  • Si id est l'ID d'une extension différente, cette option est ignorée et la boite de dialogue de confirmation s'affche toujours.
    • +
+
+
+ +

Valeur retournée

+ +

Une Promise qui sera rejetée avec un message d'erreur si l'utilisateur a annulé la désintallatiion.

+ +

Compatibilité du navigateur

+ + + + + +

{{Compat("webextensions.api.management.uninstall")}}

+ + + +

Exemples

+ +

Désinstallez l'extension dont l'ID est "my-addon-id", en demandant à l'utilisateur de confirmer. Dans le rappel, vérifiez si l'utilisateur a annué la désinstallation.

+ +

Notez que nous n'avons réussi un gestionnaire d'exécution, car si la désinstallation  réussit, l'extension n'est plus disponible pour le gérer.

+ +
var id = "my-addon-id";
+
+function onCanceled(error) {
+  console.log(`Uninstall canceled: ${error}`);
+}
+
+var uninstalling = browser.management.uninstall(id);
+uninstalling.then(null, onCanceled);
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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/management/uninstallself/index.html b/files/fr/mozilla/add-ons/webextensions/api/management/uninstallself/index.html new file mode 100644 index 0000000000..9bdfbb763d --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/management/uninstallself/index.html @@ -0,0 +1,121 @@ +--- +title: management.uninstallSelf() +slug: Mozilla/Add-ons/WebExtensions/API/management/uninstallSelf +tags: + - API + - Add-ons + - Méthode + - Reference + - UnintallSeft + - WebExtensions + - management +translation_of: Mozilla/Add-ons/WebExtensions/API/management/uninstallSelf +--- +
{{AddonSidebar()}}
+ +

Désinstalle l'appel de l'extension.

+ +

Cette API ne requiert pas la permission API "management"

+ +

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

+ +

Syntaxe

+ +
var uninstallingSelf = browser.management.uninstallSelf(
+  options              // object
+)
+
+ +

Paramètres

+ +
+
options{{optional_inline}}
+
object. L'objet qui peut comporter deux propriétés, toutes deux facultatives :
+
+
+
showConfirmDialog{{optional_inline}}
+
Boolean. Si showConfirmDialog est true, le navigateur  affiche la boite  de dialogue demandant à l'utilisateur de confirmer que le complément doit être désinstallé. Par défaut à false.
+
dialogMessage{{optional_inline}}
+
String. Un message supplémentaire qui sera affiché dans la boite de dialogue de confirmation.
+
+ +

Valeur retournée

+ +

Une Promise qui sera rejetée avec un message d'erreur si l'utilisateur a annulé la désinstallation.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.management.uninstallSelf")}}

+ +

Exemples

+ +

Désinsallez l'extension, en demandant à l'utilisateur de confirmer. Dans le rappel, vérifiez si l'utilisateur a annulé la désinstallation.

+ +

Notez que n'avons pas passé un gestionnaire d'éxécution, car si la desinstallation  réussit, l'extension n'est plus disponible pour le gérer.

+ + 
function onCanceled(error) {
+  console.log(`Canceled: ${error}`);
+}
+
+var uninstalling = browser.management.uninstallSelf({
+  showConfirmDialog: true
+});
+
+uninstalling.then(null, onCanceled);
+ +

Le même, mais aussi l'ajout d'un message personnalisé à la boite de dialogue :

+ + 
function onCanceled(error) {
+  console.log(`Canceled: ${error}`);
+}
+
+var uninstalling = browser.management.uninstallSelf({
+  showConfirmDialog: true,
+  dialogMessage: "Testing self-uninstall"
+});
+
+uninstalling.then(null, onCanceled);
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

Cette API est basée sur l'API Chromium chrome.management. Cette documentation est dérivée de management.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