diff options
author | julieng <julien.gattelier@gmail.com> | 2021-11-15 21:45:15 +0100 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-11-15 22:10:33 +0100 |
commit | 3cf9bd8b9901006085d4e0f353b0d3b6b8f69d93 (patch) | |
tree | e82ac56afff3bc213cc2971cd8aada25a174eee9 /files/fr/mozilla/add-ons/webextensions/api/management | |
parent | f36cc6a7639a8f1adff02bc7a152bd7f54ceae6d (diff) | |
download | translated-content-3cf9bd8b9901006085d4e0f353b0d3b6b8f69d93.tar.gz translated-content-3cf9bd8b9901006085d4e0f353b0d3b6b8f69d93.tar.bz2 translated-content-3cf9bd8b9901006085d4e0f353b0d3b6b8f69d93.zip |
convert content to md
Diffstat (limited to 'files/fr/mozilla/add-ons/webextensions/api/management')
15 files changed, 627 insertions, 694 deletions
diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/extensioninfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/extensioninfo/index.md index c641aa0a54..2e38003328 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/extensioninfo/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/extensioninfo/index.md @@ -12,89 +12,85 @@ tags: - management translation_of: Mozilla/Add-ons/WebExtensions/API/management/ExtensionInfo --- -<div>{{AddonSidebar()}}</div> - -<p>Un objet <code>ExtensionInfo</code> contenant les informations sur l'extension.</p> - -<h2 id="Type">Type</h2> - -<p>Il s'agit d'un objet avec les propriétés suivantes :</p> - -<dl> - <dt><code>description</code></dt> - <dd><code>string</code>. La description de l'extension, prise à partir de la clé de <a href="/fr/Add-ons/WebExtensions/manifest.json/description">description</a> du manifest.json.</dd> - <dt><code>disabledReason</code></dt> - <dd><code>string</code>. Si l'extension est désactivée, la raison pour laquelle il a été désactivé. L'une des "inconnnues' or "permissions_increase".</dd> - <dt><code>enabled</code></dt> - <dd><code>boolean</code>. Que l'extension soit activée ou pas.</dd> - <dt><code>homepageUrl</code></dt> - <dd><code>string</code>. L'URL de la page d'accueil de l'extension, prise en compte de la clé <a href="/fr/Add-ons/WebExtensions/manifest.json/homepage_url">homepage_url</a> du fichier manifest.json.</dd> - <dt><code>hostPermissions</code></dt> - <dd><code>ensemble</code> de <code>chaîne</code>. Les <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions d'hôtes</a> de l'extension.</dd> - <dt><code>icons</code></dt> - <dd><p><code>array</code> of <code>object</code>. les informations sur les icônes des extensions. Un tableau d'objets, un par chaque icône. Chaque objet contient deux propriétés :</p> - <ul> - <li><code>size</code>: un entier représentant la largeur et la hauteur de l'icônes en pixels.</li> - <li><code>url</code>: une chaîne contenant l'url relative de l'icône, en commençant par la racine de l'extensions.</li> - </ul> - </dd> - <dt><code>id</code></dt> - <dd><code>string</code>. l'ID de l'extension.</dd> - <dt><code>installType</code></dt> - <dd><p><code>string</code>. Une chaîne décriantn comme l'extension a été ajouté. Une des options suivantes :</p> - <ul> - <li>"admin": l'extension a été installé en raison d'une politique administrative.</li> - <li>"development": l'extension a été installé décompressé sur le disque.</li> - <li>"normal": l'extension a été installé normalement à partir du package d'installation.</li> - <li>"sideload": l'extension a été installé par un autre logiciel sur l'ordinateur de l'utilisateur.</li> - <li>"other": l'extension a été installé d'une autre manière.</li> - </ul> - </dd> - <dt><code>mayDisable</code></dt> - <dd><code>boolean</code>. Que cette extensions a été désactivé ou désinstallé par l'utilisateur.</dd> - <dt><code>name</code></dt> - <dd><code>string</code>. Le nom de l'extension, pris à partir de la clé <a href="/fr/Add-ons/WebExtensions/manifest.json/name">name</a> du manifest.json.</dd> - <dt><code>offlineEnabled</code></dt> - <dd><code>boolean</code>. Que les demandes de l'extensions soient prises en charge hors connexion.</dd> - <dt><code>optionsUrl</code></dt> - <dd><code>string</code>. l'URL pour la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/user_interface/Options_pages">page d'options</a> de l'élément, s'il y en a un. Il s'agit d'une URL relative, à partir de la racine de l'extension.</dd> - <dt><code>permissions</code></dt> - <dd><code>array</code> of <code>string</code>. les <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permissions de l'API</a> de l'extension.</dd> - <dt><code>shortName</code></dt> - <dd><code>string</code>. Une courte version du nom de l'extension, prise à partir de la clé <a href="/fr/Add-ons/WebExtensions/manifest.json/short_name">short_name</a> du manifest.json.</dd> - <dt><code>type</code></dt> - <dd><p><code>string</code>. 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 :</p> - <ul> - <li>"extension": le type d'extension la plus courante.</li> - <li>"hosted_app"</li> - <li>"packaged_app"</li> - <li>"legacy_packaged_app"</li> - <li>"theme"</li> - </ul> - </dd> - <dt><code>updateUrl</code></dt> - <dd><code>string</code>. URL pour la mise à jour de l'extension, tiré de la clé <a href="/fr/Add-ons/WebExtensions/manifest.json/applications">applications</a> de manifest.json.</dd> - <dt><code>version</code></dt> - <dd><code>string</code>. La version de l'extension, tiré de la clé <a href="/fr/Add-ons/WebExtensions/manifest.json/version">version</a> du manifest.json</dd> - <dt><code>versionName</code></dt> - <dd><code>string</code>. Le nom descriptif pour la version de l'extension, tiré de la clé <a href="/fr/Add-ons/WebExtensions/manifest.json/version_name">version_name</a> du manifest.json.</dd> -</dl> - -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> - -<p>{{Compat("webextensions.api.management.ExtensionInfo")}}</p> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> - -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> - -<p>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.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +{{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](/fr/Add-ons/WebExtensions/manifest.json/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](/fr/Add-ons/WebExtensions/manifest.json/homepage_url) du fichier manifest.json. +- `hostPermissions` + - : `ensemble` de `chaîne`. Les [permissions d'hôtes](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) 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](/fr/Add-ons/WebExtensions/manifest.json/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](/fr/docs/Mozilla/Add-ons/WebExtensions/user_interface/Options_pages) 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](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) de l'extension. +- `shortName` + - : `string`. Une courte version du nom de l'extension, prise à partir de la clé [short_name](/fr/Add-ons/WebExtensions/manifest.json/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](/fr/Add-ons/WebExtensions/manifest.json/applications) de manifest.json. +- `version` + - : `string`. La version de l'extension, tiré de la clé [version](/fr/Add-ons/WebExtensions/manifest.json/version) du manifest.json +- `versionName` + - : `string`. Le nom descriptif pour la version de l'extension, tiré de la clé [version_name](/fr/Add-ons/WebExtensions/manifest.json/version_name) du manifest.json. + +## Compatibilité du navigateur + +{{Compat("webextensions.api.management.ExtensionInfo")}} + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. + +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -121,5 +117,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/management/ExtensionInfo // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/get/index.md index cffba8e9ab..a5ff7836ae 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/get/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/get/index.md @@ -11,41 +11,41 @@ tags: - management translation_of: Mozilla/Add-ons/WebExtensions/API/management/get --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Récupère un objet {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}} contenant des informations sur l'extension spécifiée.</p> +Récupère un objet {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}} contenant des informations sur l'extension spécifiée. -<p>Cette API requière la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission API</a> "management"</p> +Cette API requière la [permission API](/fr/Add-ons/WebExtensions/manifest.json/permissions) "management" -<p>Il s'agit d'une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var gettingInfo = browser.management.get( +```js +var gettingInfo = browser.management.get( id // string ) -</pre> +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>id</code></dt> - <dd><code>string</code>. l'ID de l'extension dont vous souhaitez récupérer les informations.</dd> -</dl> +- `id` + - : `string`. l'ID de l'extension dont vous souhaitez récupérer les informations. -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> 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.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/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. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.management.get")}}</p> +{{Compat("webextensions.api.management.get")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Enregistrez le nom de l'extension dont l'ID est "my-add-on":</p> +Enregistrez le nom de l'extension dont l'ID est "my-add-on": -<pre class="brush: js">var id = "my-add-on"; +```js +var id = "my-add-on"; function got(info) { console.log(info.name); @@ -53,19 +53,17 @@ function got(info) { var getting = browser.management.get(id); getting.then(got); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> - -<p>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.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -92,5 +90,4 @@ getting.then(got); // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/getall/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/getall/index.md index 03a12b36be..a6f0deb701 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/getall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/getall/index.md @@ -11,38 +11,40 @@ tags: - management translation_of: Mozilla/Add-ons/WebExtensions/API/management/getAll --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Récupère un ensemble d'objets {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}}, un pour chaque extension installé.</p> +Récupère un ensemble d'objets {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}}, un pour chaque extension installé. -<p>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é <code>type</code> de {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}}.</p> +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")}}. -<p>Cette API requiert la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission de l'API</a> de "management"</p> +Cette API requiert la [permission de l'API](/fr/Add-ons/WebExtensions/manifest.json/permissions) de "management" -<p>Il s'agit d'une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var gettingAll = browser.management.getAll() -</pre> +```js +var gettingAll = browser.management.getAll() +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>None.</p> +None. -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera rempli avec un ensemble d'objets {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}}, un pour chaque extension installée.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rempli avec un ensemble d'objets {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}}, un pour chaque extension installée. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.management.getAll")}}</p> +{{Compat("webextensions.api.management.getAll")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Enregistrez le nom de toutes les extensions installées :</p> +Enregistrez le nom de toutes les extensions installées : -<pre class="brush: js">function gotAll(infoArray) { +```js +function gotAll(infoArray) { for (info of infoArray) { if (info.type == "extension") { console.log(info.name); @@ -51,19 +53,18 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/management/getAll } var gettingAll = browser.management.getAll(); -gettingAll.then(gotAll);</pre> +gettingAll.then(gotAll); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> - -<p>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.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -90,5 +91,4 @@ gettingAll.then(gotAll);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbyid/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbyid/index.md index b5a86a0eeb..9b4bb2b30f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbyid/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbyid/index.md @@ -11,45 +11,41 @@ tags: - management translation_of: Mozilla/Add-ons/WebExtensions/API/management/getPermissionWarningsById --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Lorsque l'utilisateur installe ou met à jour une extension, le navigateur peut avertir l'utilisateur des [permissions](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/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. -<div>Lorsque l'utilisateur installe ou met à jour une extension, le navigateur peut avertir l'utilisateur des <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permissions</a> 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.</div> +Compte tenu de l'ID d'une extension, cette fonction retourne les avertisseurs de permissions comme un tableau de chaînes. -<div></div> +Cette API requière l'[API permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "management" -<p>Compte tenu de l'ID d'une extension, cette fonction retourne les avertisseurs de permissions comme un tableau de chaînes.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<p>Cette API requière l'<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">API permission</a> "management"</p> +## Syntaxe -<p>Il s'agit d'une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">var gettingWarnings = browser.management.getPermissionWarningsById( +```js +var gettingWarnings = browser.management.getPermissionWarningsById( id // string ) -</pre> +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>id</code></dt> - <dd><code>string</code>. ID de l'extension dont vous souhaitez récupérer les avertisseurs de permissions.</dd> -</dl> +- `id` + - : `string`. ID de l'extension dont vous souhaitez récupérer les avertisseurs de permissions. -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un ensemble de chaînes, chacune contenant un texte d'un avertissement de permissions.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un ensemble de chaînes, chacune contenant un texte d'un avertissement de permissions. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.management.getPermissionWarningsById")}}</p> +{{Compat("webextensions.api.management.getPermissionWarningsById")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Enregistrez les avertissements de permissions pour l'extension dont l'ID est "my-add-on" :</p> +Enregistrez les avertissements de permissions pour l'extension dont l'ID est "my-add-on" : -<pre class="brush: js">var id = "my-add-on"; +```js +var id = "my-add-on"; function gotWarnings(warnings) { for (warning of warnings) { @@ -58,44 +54,42 @@ function gotWarnings(warnings) { } var gettingWarnings = browser.management.getPermissionWarningsById(id); -gettingWarnings.then(gotWarnings);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> - -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> - -<p>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.</p> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. -// -// Redistribution and use in source and binary forms, with or without -// modification, are permitted provided that the following conditions are -// met: -// -// * Redistributions of source code must retain the above copyright -// notice, this list of conditions and the following disclaimer. -// * Redistributions in binary form must reproduce the above -// copyright notice, this list of conditions and the following disclaimer -// in the documentation and/or other materials provided with the -// distribution. -// * Neither the name of Google Inc. nor the names of its -// contributors may be used to endorse or promote products derived from -// this software without specific prior written permission. -// -// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> -</div> +gettingWarnings.then(gotWarnings); +``` + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. +> +> <div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. +> // +> // Redistribution and use in source and binary forms, with or without +> // modification, are permitted provided that the following conditions are +> // met: +> // +> // * Redistributions of source code must retain the above copyright +> // notice, this list of conditions and the following disclaimer. +> // * Redistributions in binary form must reproduce the above +> // copyright notice, this list of conditions and the following disclaimer +> // in the documentation and/or other materials provided with the +> // distribution. +> // * Neither the name of Google Inc. nor the names of its +> // contributors may be used to endorse or promote products derived from +> // this software without specific prior written permission. +> // +> // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +> // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +> // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +> // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +> // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +> // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +> // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +> // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +> // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +> // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +> </pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbymanifest/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbymanifest/index.md index 9090bd4a56..b6a923e2e7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbymanifest/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/getpermissionwarningsbymanifest/index.md @@ -11,49 +11,45 @@ tags: - management translation_of: Mozilla/Add-ons/WebExtensions/API/management/getPermissionWarningsByManifest --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Lorsque l'utilisateur installe ou met à jour une extension, la navigateur peut avertir l'utilisateur des [permissions](/fr/Add-ons/WebExtensions/manifest.json/permissions) obligatoires. Toutes les permissions ne donnent pas lieu à des avertissements, et cela n'est pas normalisé dans les navigateurs. -<div>Lorsque l'utilisateur installe ou met à jour une extension, la navigateur peut avertir l'utilisateur des <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permissions</a> obligatoires. Toutes les permissions ne donnent pas lieu à des avertissements, et cela n'est pas normalisé dans les navigateurs.</div> +Compte tenu du texte du fichier [manifest.json](/fr/Add-ons/WebExtensions/manifest.json), cette fonction retourne les avertisseurs de permissions qui seraient donnés pour l'extension comme un ensemble de chaines. -<div></div> +Cette API _ne requière pas_ l'[API de permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "management". -<p>Compte tenu du texte du fichier <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a>, cette fonction retourne les avertisseurs de permissions qui seraient donnés pour l'extension comme un ensemble de chaines.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<p>Cette API <em>ne requière pas</em> l'<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">API de permission</a> "management".</p> +## Syntaxe -<p>Il s'agit d'une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">var gettingWarnings = browser.management.getPermissionWarningsByManifest( +```js +var gettingWarnings = browser.management.getPermissionWarningsByManifest( manifestString // string ) -</pre> +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>manifestString</code></dt> - <dd><code>string</code>. Chaîne contenant le fichier manifest. Cela doit être un manifest valide : par exemple, il doit contenir toutes les clés obligatoires du manifest..</dd> -</dl> +- `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.. -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera rempli avec un ensemble de chaînes, chacune contenant le texte un avertisseur de permission.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rempli avec un ensemble de chaînes, chacune contenant le texte un avertisseur de permission. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.management.getPermissionWarningsByManifest")}}</p> +{{Compat("webextensions.api.management.getPermissionWarningsByManifest")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Enregistrez les avertissements de permissions dans le fichier manifest donné :</p> +Enregistrez les avertissements de permissions dans le fichier manifest donné : -<pre class="brush: js">var manifest = { +```js +var manifest = { "manifest_version": 2, "name": "test", "version": "1.0", - "permissions": ["management", "<all_urls>"] + "permissions": ["management", "<all_urls>"] } var manifestString = JSON.stringify(manifest); @@ -67,19 +63,18 @@ function gotError(error) { } var gettingWarnings = browser.management.getPermissionWarningsByManifest(manifestString); -gettingWarnings.then(gotWarnings, gotError);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +gettingWarnings.then(gotWarnings, gotError); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> +{{WebExtExamples}} -<p>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.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -106,5 +101,4 @@ gettingWarnings.then(gotWarnings, gotError);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/getself/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/getself/index.md index e035a6fc23..b7d238acc4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/getself/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/getself/index.md @@ -11,53 +11,54 @@ tags: - management translation_of: Mozilla/Add-ons/WebExtensions/API/management/getSelf --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Récupère un objet {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}} contenant les informations de l'extension appelée.</p> +Récupère un objet {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}} contenant les informations de l'extension appelée. -<p>Cette API <em>ne requière pas</em> l' <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">API de permission</a> "management".</p> +Cette API _ne requière pas_ l' [API de permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "management". -<p>Il s'agit d'une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var gettingSelf = browser.management.getSelf() -</pre> +```js +var gettingSelf = browser.management.getSelf() +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>Aucun.</p> +Aucun. -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}}, contenant les informations sur l'extension.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef("management.ExtensionInfo", "ExtensionInfo")}}, contenant les informations sur l'extension. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.management.getSelf")}}</p> +{{Compat("webextensions.api.management.getSelf")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Enregistrez le nom de l'extension :</p> +Enregistrez le nom de l'extension : -<pre class="brush: js">function gotSelf(info) { +```js +function gotSelf(info) { console.log("Add-on name: " + info.name); } var gettingSelf = browser.management.getSelf(); -gettingSelf.then(gotSelf);</pre> +gettingSelf.then(gotSelf); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> - -<p>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.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -84,5 +85,4 @@ gettingSelf.then(gotSelf);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/index.md index 6d92a0e452..d03a236b1a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/index.md @@ -10,79 +10,70 @@ tags: - management translation_of: Mozilla/Add-ons/WebExtensions/API/management --- -<div>{{AddonSidebar}}</div> - -<p>Obtenez les éléments sur les modules complémentaires installés.</p> - -<p>Avec l'API de <code>gestion</code> vous pouvez :</p> - -<ul> - <li>Obtenir des informations sur les modules complémentaires installés</li> - <li>Activer / Désactiver les modules complémentaires</li> - <li>Désinstaller les modules complémentaires</li> - <li>Découvrez quels sont les alertes des permissions envoyés particulièrement par les modules complémentaires ou les manifest</li> - <li>Obtenir les notifications sur l'ajout des modules complémentaires, désinstallé, activé ou désactivé.</li> -</ul> - -<p>La plupart de ces opérations requièrent les <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permissions d'APIs</a> de gestion. Les opérations qui ne fournissent pas d'accès à d'autres modules complémentaires ne nécessitent pas de permissions.</p> - -<h2 id="Types">Types</h2> - -<dl> - <dt>{{WebExtAPIRef("management.ExtensionInfo")}}</dt> - <dd>Un objet contenant des informations sur un module complémentaire installé.</dd> -</dl> - -<h2 id="Fonctions">Fonctions</h2> - -<dl> - <dt>{{WebExtAPIRef("management.getAll()")}}</dt> - <dd>Renvoie des informations sur tous les modules complémentaires installés</dd> - <dt>{{WebExtAPIRef("management.get()")}}</dt> - <dd>Renvoie des informations sur un module complémentaire particulier, compte tenu de son ID.</dd> - <dt>{{WebExtAPIRef("management.getSelf()")}}</dt> - <dd>Renvoie des informations sur l'appel du module complémentaire.</dd> - <dt>{{WebExtAPIRef("management.install()")}}</dt> - <dd>Installe un thème particulier, étant donné son URL à l'adresse <a href="https://addons.mozilla.org">addons.mozilla.org</a>.</dd> - <dt>{{WebExtAPIRef("management.uninstall()")}}</dt> - <dd>Désinstalle un module complémenaire particulier, compte tenu de son ID.</dd> - <dt>{{WebExtAPIRef("management.uninstallSelf()")}}</dt> - <dd>Désinstalle l'appel d'un module complémentaire.</dd> - <dt>{{WebExtAPIRef("management.getPermissionWarningsById()")}}</dt> - <dd>Obtenez l'ensemble des alertes des permissions particulièrement pour un module complémentaire, compte tenu de son ID.</dd> - <dt>{{WebExtAPIRef("management.getPermissionWarningsByManifest()")}}</dt> - <dd>Obtenez l'ensemble des alertes de permission qui seraient affichés pour la chaîne de manifest donnée.</dd> - <dt>{{WebExtAPIRef("management.setEnabled()")}}</dt> - <dd>Activer / désactiver un module complémentaire, compte tenu de son ID.</dd> -</dl> - -<h2 id="Evénements">Evénements</h2> -<dl> - <dt>{{WebExtAPIRef("management.onInstalled")}}</dt> - <dd>Action quand un module complémentaire est installé.</dd> - <dt>{{WebExtAPIRef("management.onUninstalled")}}</dt> - <dd>Action quand un module complémentaire est désinstallé.</dd> - <dt>{{WebExtAPIRef("management.onEnabled")}}</dt> - <dd>Action quand un module complémentaire est activé.</dd> - <dt>{{WebExtAPIRef("management.onDisabled")}}</dt> - <dd>Action quand un module complémenaire est désactivé.</dd> -</dl> - -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> - -<p>{{Compat("webextensions.api.management")}}</p> - -<p>{{WebExtExamples("h2")}}</p> - -<div class="note"><p><strong>Note :</strong></p> - -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> - -<p>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.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2012 The Chromium Authors. All rights reserved. +{{AddonSidebar}} + +Obtenez les éléments sur les modules complémentaires installés. + +Avec l'API de `gestion` vous pouvez : + +- Obtenir des informations sur les modules complémentaires installés +- Activer / Désactiver les modules complémentaires +- Désinstaller les modules complémentaires +- Découvrez quels sont les alertes des permissions envoyés particulièrement par les modules complémentaires ou les manifest +- Obtenir les notifications sur l'ajout des modules complémentaires, désinstallé, activé ou désactivé. + +La plupart de ces opérations requièrent les [permissions d'APIs](/fr/Add-ons/WebExtensions/manifest.json/permissions) 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](https://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")}} + +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. + +<div class="hidden"><pre>// Copyright 2012 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -109,5 +100,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/management // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/install/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/install/index.md index d17ff0cb12..1045d25d9a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/install/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/install/index.md @@ -12,41 +12,37 @@ tags: - management translation_of: Mozilla/Add-ons/WebExtensions/API/management/install --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Installe et active une extension de thème à partir de l'URL donnée. -<div>Installe et active une extension de thème à partir de l'URL donnée.</div> +Cette API nécessite la [permission de l'API](/fr/Add-ons/WebExtensions/manifest.json/permissions) "management" et ne fonctionnera qu'avec des thèmes signés. -<div></div> +C'est une fonction asynchrone qui renvoie une [Promise](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<p>Cette API nécessite la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission de l'API</a> "management" et ne fonctionnera qu'avec des thèmes signés.</p> +## Syntaxe -<p>C'est une fonction asynchrone qui renvoie une <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a>.</p> +```js +let {id} = await browser.management.install({url}); +``` -<h2 id="Syntaxe">Syntaxe</h2> +### Paramètres -<pre class="brush: js">let {id} = await browser.management.install({url}); -</pre> +- options + - : Un objet qui inclut l'URL du fichier XPI du thème à [addons.mozilla.org](https://addons.mozilla.org) et un hachage facultatif du fichier XPI, en utilisant sha256 ou plus. -<h3 id="Paramètres">Paramètres</h3> +### Valeur retournée -<dl> - <dt>options</dt> - <dd>Un objet qui inclut l'URL du fichier XPI du thème à <a href="https://addons.mozilla.org">addons.mozilla.org</a> et un hachage facultatif du fichier XPI, en utilisant sha256 ou plus.</dd> -</dl> +Une [Promise](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet, contenant l'`ExtensionID` défini pour le thème dans manifest.json. -<h3 id="Valeur_retournée">Valeur retournée</h3> +## Compatibilité du navigateur -<p>Une <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a> qui sera remplie avec un objet, contenant l'<code>ExtensionID</code> défini pour le thème dans manifest.json.</p> +{{Compat("webextensions.api.management.install")}} -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Exemples -<p>{{Compat("webextensions.api.management.install")}}</p> +Parcourez une liste de thèmes : -<h2 id="Exemples">Exemples</h2> - -<p>Parcourez une liste de thèmes :</p> - -<pre class="brush: js">"use strict"; +```js +"use strict"; let themes = [ "https://addons.mozilla.org/firefox/downloads/file/1063216/insightscare-1.0-fx.xpi", @@ -67,7 +63,7 @@ async function install(url) { } } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { let id = themes.indexOf(current); install(themes[(id + 1) % themes.length]); }); @@ -75,9 +71,10 @@ browser.browserAction.onClicked.addListener(() => { for (let url of themes) { browser.menus.create({ title: url, - onclick: () => install(url), + onclick: () => install(url), contexts: ["browser_action"], }); -}</pre> +} +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/ondisabled/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/ondisabled/index.md index 02415286ee..4b99339874 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/ondisabled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/ondisabled/index.md @@ -11,69 +11,63 @@ tags: - onDisabled translation_of: Mozilla/Add-ons/WebExtensions/API/management/onDisabled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Action quand l'extension est désactivée.</p> +Action quand l'extension est désactivée. -<p>L'API requière l'<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">API de permission</a> "management".</p> +L'API requière l'[API de permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "management". -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.management.onDisabled.addListener(listener) +```js +browser.management.onDisabled.addListener(listener) browser.management.onDisabled.removeListener(listener) browser.management.onDisabled.hasListener(listener) -</pre> +``` -<p>Les événement ont trois fonctions :</p> +Les événement ont trois fonctions : -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoutez un auditeur à cet événement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>L'argument de l'auditeur est l'auditeur à supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>Vérifie si l'auditeur est enregistré à l'événement. Renvoie <code>true</code> s'il est à l'écoute, sinon <code>false</code> .</dd> -</dl> +- `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` . -<h2 id="addListener_syntaxe">addListener syntaxe</h2> +## addListener syntaxe -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>function</code></dt> - <dd> - <p>Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant :</p> +- `function` - <dl> - <dt><code>info</code></dt> - <dd><code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/management/ExtensionInfo">ExtensionInfo</a></code>: informations de l'extension qui a été désactivé</dd> - </dl> - </dd> -</dl> + - : Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant : -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> + - `info` + - : [`ExtensionInfo`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/management/ExtensionInfo): informations de l'extension qui a été désactivé -<p>{{Compat("webextensions.api.management.onDisabled")}}</p> +## Compatibilité du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.management.onDisabled")}} -<p>Enregistrez les noms des extensions lorsqu'ils sont désactivés.</p> +## Exemples -<pre class="brush: js">browser.management.onDisabled.addListener((info) => { - console.log(info.name + " was disabled"); -});</pre> - -<p>{{WebExtExamples}}</p> +Enregistrez les noms des extensions lorsqu'ils sont désactivés. -<div class="note"><p><strong>Note :</strong></p> +```js +browser.management.onDisabled.addListener((info) => { + console.log(info.name + " was disabled"); +}); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> +{{WebExtExamples}} -<p>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.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -100,5 +94,4 @@ browser.management.onDisabled.hasListener(listener) // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/onenabled/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/onenabled/index.md index 2528feb6d3..76fba1d6f4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/onenabled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/onenabled/index.md @@ -11,69 +11,63 @@ tags: - onEnabled translation_of: Mozilla/Add-ons/WebExtensions/API/management/onEnabled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'auditeur de l'événement appelé lorsque l'événement <code>enabled</code> est déclenché, indiquant qu'un add-on est maintenant activé.</p> +L'auditeur de l'événement appelé lorsque l'événement `enabled` est déclenché, indiquant qu'un add-on est maintenant activé. -<p>L'API requière l'<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">API de permission </a>"management"</p> +L'API requière l'[API de permission ](/fr/Add-ons/WebExtensions/manifest.json/permissions)"management" -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.management.onEnabled.addListener(listener) +```js +browser.management.onEnabled.addListener(listener) browser.management.onEnabled.removeListener(listener) browser.management.onEnabled.hasListener(listener) -</pre> +``` -<p>Les événements ont trois fonctions :</p> +Les événements ont trois fonctions : -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoutez un auditeur à cet événement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>L'argument de l'auditeur est l'auditeur à supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>Vérifie si l'auditeur est enregistré à l'événement. Renvoie <code>true</code> s'il est à l'écoute, sinon <code>false</code> .</dd> -</dl> +- `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` . -<h2 id="addListener_syntaxe">addListener syntaxe</h2> +## addListener syntaxe -<h3 id="Parameters">Parameters</h3> +### Parameters -<dl> - <dt><code>function</code></dt> - <dd> - <p>Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant :</p> +- `function` - <dl> - <dt><code>info</code></dt> - <dd><code><a href="/fr/Add-ons/WebExtensions/API/management/ExtensionInfo">ExtensionInfo</a></code>: informations de l'extension qui a été désinstallé.</dd> - </dl> - </dd> -</dl> + - : Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant : -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> + - `info` + - : [`ExtensionInfo`](/fr/Add-ons/WebExtensions/API/management/ExtensionInfo): informations de l'extension qui a été désinstallé. -<p>{{Compat("webextensions.api.management.onEnabled")}}</p> +## Compatibilité du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.management.onEnabled")}} -<p>Enregistrez les noms des extensions lorsqu'ils sont activés :</p> +## Exemples -<pre class="brush: js">browser.management.onEnabled.addListener((info) => { - console.log(info.name + " was enabled"); -});</pre> - -<p>{{WebExtExamples}}</p> +Enregistrez les noms des extensions lorsqu'ils sont activés : -<div class="note"><p><strong>Note :</strong></p> +```js +browser.management.onEnabled.addListener((info) => { + console.log(info.name + " was enabled"); +}); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> +{{WebExtExamples}} -<p>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.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -100,5 +94,4 @@ browser.management.onEnabled.hasListener(listener) // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/oninstalled/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/oninstalled/index.md index 38e9192289..ff33122d6a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/oninstalled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/oninstalled/index.md @@ -11,94 +11,87 @@ tags: - onInstalled translation_of: Mozilla/Add-ons/WebExtensions/API/management/onInstalled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Action quand une extension est installée.</p> +Action quand une extension est installée. -<p>Cette API requière l'<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">API de permission </a>"management".</p> +Cette API requière l'[API de permission ](/fr/Add-ons/WebExtensions/manifest.json/permissions)"management". -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.management.onInstalled.addListener(listener) +```js +browser.management.onInstalled.addListener(listener) browser.management.onInstalled.removeListener(listener) browser.management.onInstalled.hasListener(listener) -</pre> +``` -<p>Les événements ont trois fonctions :</p> +Les événements ont trois fonctions : -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajout un auditeur à l'événement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>Arrêtez d'écouvter l'événement. L'argument de l'auditeur est un auditeur à supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>Vérifie si un auditeur est enregistré pour cet événement. Renvoie <code>vrai</code> si elle est à l'écoute, sinon <code>faux</code> .</dd> -</dl> +- `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` . -<h2 id="addListener_syntaxe">addListener syntaxe</h2> +## addListener syntaxe -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>function</code></dt> - <dd> - <p>fonction de rappel qui sera appelée quand l'événement se produira. La fonction passera l'argument suivant :</p> +- `function` - <dl> - <dt><code>info</code></dt> - <dd><code><a href="/fr/Add-ons/WebExtensions/API/management/ExtensionInfo">ExtensionInfo</a></code>: informations sur l'extension qui a été installée.</dd> - </dl> - </dd> -</dl> + - : fonction de rappel qui sera appelée quand l'événement se produira. La fonction passera l'argument suivant : -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> + - `info` + - : [`ExtensionInfo`](/fr/Add-ons/WebExtensions/API/management/ExtensionInfo): informations sur l'extension qui a été installée. -<p>{{Compat("webextensions.api.management.onInstalled")}}</p> +## Compatibilité du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.management.onInstalled")}} -<p>Enregistrez les noms des extensions lorsqu'ils sont installés :</p> +## Exemples -<pre class="brush: js">browser.management.onInstalled.addListener((info) => { +Enregistrez les noms des extensions lorsqu'ils sont installés : + +```js +browser.management.onInstalled.addListener((info) => { console.log(info.name + " was installed"); -});</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> - -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> - -<p>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.</p> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. -// -// Redistribution and use in source and binary forms, with or without -// modification, are permitted provided that the following conditions are -// met: -// -// * Redistributions of source code must retain the above copyright -// notice, this list of conditions and the following disclaimer. -// * Redistributions in binary form must reproduce the above -// copyright notice, this list of conditions and the following disclaimer -// in the documentation and/or other materials provided with the -// distribution. -// * Neither the name of Google Inc. nor the names of its -// contributors may be used to endorse or promote products derived from -// this software without specific prior written permission. -// -// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> -</div> +}); +``` + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. +> +> <div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. +> // +> // Redistribution and use in source and binary forms, with or without +> // modification, are permitted provided that the following conditions are +> // met: +> // +> // * Redistributions of source code must retain the above copyright +> // notice, this list of conditions and the following disclaimer. +> // * Redistributions in binary form must reproduce the above +> // copyright notice, this list of conditions and the following disclaimer +> // in the documentation and/or other materials provided with the +> // distribution. +> // * Neither the name of Google Inc. nor the names of its +> // contributors may be used to endorse or promote products derived from +> // this software without specific prior written permission. +> // +> // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +> // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +> // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +> // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +> // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +> // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +> // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +> // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +> // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +> // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +> </pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/onuninstalled/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/onuninstalled/index.md index d6e3700786..058dd43540 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/onuninstalled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/onuninstalled/index.md @@ -11,69 +11,63 @@ tags: - onUninstalled translation_of: Mozilla/Add-ons/WebExtensions/API/management/onUninstalled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Action quand une extension est désinstallée.</p> +Action quand une extension est désinstallée. -<p>L'API requière l'<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">API de permission </a>"management".</p> +L'API requière l'[API de permission ](/fr/Add-ons/WebExtensions/manifest.json/permissions)"management". -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.management.onUninstalled.addListener(listener) +```js +browser.management.onUninstalled.addListener(listener) browser.management.onUninstalled.removeListener(listener) browser.management.onUninstalled.hasListener(listener) -</pre> +``` -<p>Les événement ont trois fonctions :</p> +Les événement ont trois fonctions : -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoutez un auditeur à cet événement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>L'argument de l'auditeur est l'auditeur à supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>Vérifie si l'auditeur est enregistré à l'événement. Renvoie <code>true</code> s'il est à l'écoute, sinon <code>false</code> .</dd> -</dl> +- `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` . -<h2 id="addListener_syntaxe">addListener syntaxe</h2> +## addListener syntaxe -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>function</code></dt> - <dd> - <p>Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant :</p> +- `function` - <dl> - <dt><code>info</code></dt> - <dd><code><a href="/fr/Add-ons/WebExtensions/API/management/ExtensionInfo">ExtensionInfo</a></code>: informations de l'extension qui a été désinstallé.</dd> - </dl> - </dd> -</dl> + - : Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant : -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> + - `info` + - : [`ExtensionInfo`](/fr/Add-ons/WebExtensions/API/management/ExtensionInfo): informations de l'extension qui a été désinstallé. -<p>{{Compat("webextensions.api.management.onUninstalled")}}</p> +## Compatibilité du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.management.onUninstalled")}} -<p>Enregistrez les noms des extensions lorsqu'ils sont désinstallés :</p> +## Exemples -<pre class="brush: js">browser.management.onUninstalled.addListener((info) => { - console.log(info.name + " was uninstalled"); -});</pre> - -<p>{{WebExtExamples}}</p> +Enregistrez les noms des extensions lorsqu'ils sont désinstallés : -<div class="note"><p><strong>Note :</strong></p> +```js +browser.management.onUninstalled.addListener((info) => { + console.log(info.name + " was uninstalled"); +}); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> +{{WebExtExamples}} -<p>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.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -100,5 +94,4 @@ browser.management.onUninstalled.hasListener(listener) // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/setenabled/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/setenabled/index.md index 08727d7904..e6e5bc013f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/setenabled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/setenabled/index.md @@ -11,68 +11,66 @@ tags: - setEnabled translation_of: Mozilla/Add-ons/WebExtensions/API/management/setEnabled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Active ou désactive l'extension ajoutée.</p> +Active ou désactive l'extension ajoutée. -<p>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.</p> +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. -<p>Cette API requière l'<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">API permission</a> "management".</p> +Cette API requière l'[API permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "management". -<p>Il s'agit d'une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var settingEnabled = browser.management.setEnabled( +```js +var settingEnabled = browser.management.setEnabled( id, // string enabled // boolean ) -</pre> +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>id</code></dt> - <dd><code>string</code>. ID de l'extension pour activer ou désactiver.</dd> - <dt><code>enabled</code></dt> - <dd><code>boolean</code>. Que ce soit pour active ou désactiver l'extension.</dd> -</dl> +- `id` + - : `string`. ID de l'extension pour activer ou désactiver. +- `enabled` + - : `boolean`. Que ce soit pour active ou désactiver l'extension. -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promisee">Promise</a></code> qui sera remplie sans arguments lorsque l'extension a été désactivé ou activé.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promisee) qui sera remplie sans arguments lorsque l'extension a été désactivé ou activé. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.management.setEnabled")}}</p> +{{Compat("webextensions.api.management.setEnabled")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Actviez / Désactivez l'option pour l'extension dont l'ID est "my-add-on":</p> +Actviez / Désactivez l'option pour l'extension dont l'ID est "my-add-on": -<pre class="brush: js">var id = "my-add-on"; +```js +var id = "my-add-on"; function toggleEnabled(id) { var getting = browser.management.get(id); - getting.then((info) => { + getting.then((info) => { browser.management.setEnabled(id, !info.enabled); }); } toggleEnabled(id); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> - -<p>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.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -99,5 +97,4 @@ toggleEnabled(id); // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/uninstall/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/uninstall/index.md index c478300f08..e2f5b98495 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/uninstall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/uninstall/index.md @@ -11,70 +11,68 @@ tags: - uninstall translation_of: Mozilla/Add-ons/WebExtensions/API/management/uninstall --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Désinstalle une extension, compte tenu de son ID.</p> +Désinstalle une extension, compte tenu de son ID. -<p>Cette API requiert l'<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">API de permission</a>. "management"</p> +Cette API requiert l'[API de permission](/fr/Add-ons/WebExtensions/manifest.json/permissions). "management" -<p>Il s'agit d'une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var uninstalling = browser.management.uninstall( +```js +var uninstalling = browser.management.uninstall( id, // string options // object ) -</pre> +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>id</code></dt> - <dd><code>string</code>. ID de l'extensions à désinstaller.</dd> - <dt><code>options{{optional_inline}}</code></dt> - <dd><p><code>object</code>. l'objet qui peut contenir une propriété unique, <code>showConfirmDialog</code>. Si <code>showConfirmDialog</code> est <code>true</code>, le navigateur affiche une boie de dialogue demandant à l'utilisateur de confirmer que le complément doit être désinstallé.</p> - <ul> - <li>Si <code>id</code> est l'ID de l'extension appelant, <code>showConfirmDialog</code> est par défaut à <code>false</code>.</li> - <li>Si <code>id</code> est l'ID d'une extension différente, cette option est ignorée et la boite de dialogue de confirmation s'affche toujours.</li> - </ul> - </dd> -</dl> +- `id` + - : `string`. ID de l'extensions à désinstaller. +- `options{{optional_inline}}` -<h3 id="Valeur_retournée">Valeur retournée</h3> + - : `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é. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera rejetée avec un message d'erreur si l'utilisateur a annulé la désintallatiion.</p> + - 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. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +### Valeur retournée -<p>{{Compat("webextensions.api.management.uninstall")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rejetée avec un message d'erreur si l'utilisateur a annulé la désintallatiion. -<h2 id="Exemples">Exemples</h2> +## Compatibilité du navigateur -<p>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.</p> +{{Compat("webextensions.api.management.uninstall")}} -<p>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.</p> +## Exemples -<pre class="brush: js">var id = "my-addon-id"; +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. + +```js +var id = "my-addon-id"; function onCanceled(error) { console.log(`Uninstall canceled: ${error}`); } var uninstalling = browser.management.uninstall(id); -uninstalling.then(null, onCanceled);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +uninstalling.then(null, onCanceled); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> +{{WebExtExamples}} -<p>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.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -101,5 +99,4 @@ uninstalling.then(null, onCanceled);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/management/uninstallself/index.md b/files/fr/mozilla/add-ons/webextensions/api/management/uninstallself/index.md index 983c91b346..25f46bfb81 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/management/uninstallself/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/management/uninstallself/index.md @@ -11,50 +11,49 @@ tags: - management translation_of: Mozilla/Add-ons/WebExtensions/API/management/uninstallSelf --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Désinstalle l'appel de l'extension.</p> +Désinstalle l'appel de l'extension. -<p>Cette API <em>ne requiert pas</em> la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission API</a> "management"</p> +Cette API _ne requiert pas_ la [permission API](/fr/Add-ons/WebExtensions/manifest.json/permissions) "management" -<p>Il s'agit d'une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var uninstallingSelf = browser.management.uninstallSelf( +```js +var uninstallingSelf = browser.management.uninstallSelf( options // object ) -</pre> +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>options{{optional_inline}}</code></dt> - <dd><p><code>object</code>. L'objet qui peut comporter deux propriétés, toutes deux facultatives :</p> - <dl> - <dt><code>showConfirmDialog{{optional_inline}}</code></dt> - <dd>Boolean. Si <code>showConfirmDialog</code> est <code>true</code>, le navigateur affiche la boite de dialogue demandant à l'utilisateur de confirmer que le complément doit être désinstallé. Par défaut à <code>false</code>.</dd> - <dt><code>dialogMessage{{optional_inline}}</code></dt> - <dd>String. Un message supplémentaire qui sera affiché dans la boite de dialogue de confirmation.</dd> - </dl> - </dd> -</dl> +- `options{{optional_inline}}` -<h3 id="Valeur_retournée">Valeur retournée</h3> + - : `object`. L'objet qui peut comporter deux propriétés, toutes deux facultatives : -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera rejetée avec un message d'erreur si l'utilisateur a annulé la désinstallation.</p> + - `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. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +### Valeur retournée -<p>{{Compat("webextensions.api.management.uninstallSelf")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rejetée avec un message d'erreur si l'utilisateur a annulé la désinstallation. -<h2 id="Exemples">Exemples</h2> +## Compatibilité du navigateur -<p>Désinsallez l'extension, en demandant à l'utilisateur de confirmer. Dans le rappel, vérifiez si l'utilisateur a annulé la désinstallation.</p> +{{Compat("webextensions.api.management.uninstallSelf")}} -<p>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.</p> +## Exemples -<pre class="brush: js">function onCanceled(error) { +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. + +```js +function onCanceled(error) { console.log(`Canceled: ${error}`); } @@ -62,11 +61,13 @@ var uninstalling = browser.management.uninstallSelf({ showConfirmDialog: true }); -uninstalling.then(null, onCanceled);</pre> +uninstalling.then(null, onCanceled); +``` -<p>Le même, mais aussi l'ajout d'un message personnalisé à la boite de dialogue :</p> +Le même, mais aussi l'ajout d'un message personnalisé à la boite de dialogue : -<pre class="brush: js">function onCanceled(error) { +```js +function onCanceled(error) { console.log(`Canceled: ${error}`); } @@ -75,18 +76,18 @@ var uninstalling = browser.management.uninstallSelf({ dialogMessage: "Testing self-uninstall" }); -uninstalling.then(null, onCanceled);</pre> -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +uninstalling.then(null, onCanceled); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/management"><code>chrome.management</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/management.json"><code>management.json</code></a> dans le code de Chromium code.</p> +{{WebExtExamples}} -<p>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.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.management`](https://developer.chrome.com/extensions/management). Cette documentation est dérivée de [`management.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/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. -<div class="hidden"> - <pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -113,5 +114,4 @@ uninstalling.then(null, onCanceled);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> |