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 | |
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')
539 files changed, 19797 insertions, 22317 deletions
diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/alarm/index.md b/files/fr/mozilla/add-ons/webextensions/api/alarms/alarm/index.md index 43a30753a7..1adb3de30f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/alarms/alarm/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/alarm/index.md @@ -13,31 +13,29 @@ tags: - alarms translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/Alarm --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Cette interface fournit des informations sur une alarme donnĂ©e. Cet objet est retournĂ© Ă partir de {{WebExtAPIRef('alarms.get()')}} et {{WebExtAPIRef('alarms.getAll()')}} et est passĂ© au gestionnaire d'Ă©vĂšnement {{WebExtAPIRef('alarms.onAlarm')}}.</p> +Cette interface fournit des informations sur une alarme donnĂ©e. Cet objet est retournĂ© Ă partir de {{WebExtAPIRef('alarms.get()')}} et {{WebExtAPIRef('alarms.getAll()')}} et est passĂ© au gestionnaire d'Ă©vĂšnement {{WebExtAPIRef('alarms.onAlarm')}}. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets contenant les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets contenant les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>name</code></dt> - <dd><code>string</code> Une chaĂźne de caractĂšres contenant le nom de l'alarme. Ce nom provient de celui qui a Ă©tĂ© fourni Ă la mĂ©thode {{WebExtAPIRef('alarms.create()')}} lors de la crĂ©ation de l'alarme.</dd> - <dt><code>scheduledTime</code></dt> - <dd><code>double</code> Un nombre qui reprĂ©sente l'heure Ă laquelle l'alarme doit ĂȘtre dĂ©clenchĂ©e, exprimĂ©e <a href="https://fr.wikipedia.org/wiki/Heure_Unix">en nombre de millisecondes depuis epoch</a>.</dd> - <dt><code>periodInMinutes</code>{{optional_inline}}</dt> - <dd><code>double</code> Un nombre qui, s'il n'est pas <code>null</code>, indique que l'alarme est pĂ©riodique et fournit la pĂ©riode.</dd> -</dl> +- `name` + - : `string` Une chaĂźne de caractĂšres contenant le nom de l'alarme. Ce nom provient de celui qui a Ă©tĂ© fourni Ă la mĂ©thode {{WebExtAPIRef('alarms.create()')}} lors de la crĂ©ation de l'alarme. +- `scheduledTime` + - : `double` Un nombre qui reprĂ©sente l'heure Ă laquelle l'alarme doit ĂȘtre dĂ©clenchĂ©e, exprimĂ©e [en nombre de millisecondes depuis epoch](https://fr.wikipedia.org/wiki/Heure_Unix). +- `periodInMinutes`{{optional_inline}} + - : `double` Un nombre qui, s'il n'est pas `null`, indique que l'alarme est pĂ©riodique et fournit la pĂ©riode. -<h2 id="CompatibilitĂ©_des_navigateur">CompatibilitĂ© des navigateur</h2> +## CompatibilitĂ© des navigateur -<p>{{Compat("webextensions.api.alarms.Alarm")}}</p> +{{Compat("webextensions.api.alarms.Alarm")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<p><strong>Remerciements :</strong></p> +**Remerciements :** -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/alarms"><code>chrome.alarms</code></a>.</p> +Cette API est basĂ©e sur l'API Chromium [`chrome.alarms`](https://developer.chrome.com/extensions/alarms). -<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>
\ No newline at end of file +Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/clear/index.md b/files/fr/mozilla/add-ons/webextensions/api/alarms/clear/index.md index 2895bf2486..2e707a8f74 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/alarms/clear/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/clear/index.md @@ -13,45 +13,44 @@ tags: - clear translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/clear --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Cette mĂ©thode supprime une alarme Ă partir du nom passĂ© en argument. Il s'agit d'une fonction asynchrone qui renvoie une {{jsxref("Promise")}}.</p> +Cette mĂ©thode supprime une alarme Ă partir du nom passĂ© en argument. Il s'agit d'une fonction asynchrone qui renvoie une {{jsxref("Promise")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var clearAlarm = browser.alarms.clear( - name // string -); -</pre> + var clearAlarm = browser.alarms.clear( + name // string + ); -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>name</code>{{optional_inline}}</dt> - <dd><code><code>string</code></code>. Le nom de l'alarme Ă supprimer. Si le paramĂštre n'est pas fourni, c'est la chaĂźne vide "" qui sera utilisĂ©e.</dd> -</dl> +- `name`{{optional_inline}} + - : `string`. Le nom de l'alarme Ă supprimer. Si le paramĂštre n'est pas fourni, c'est la chaĂźne vide "" qui sera utilisĂ©e. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une promesse ({{jsxref("Promise")}}) qui sera tenue avec un boolĂ©en. Ce boolĂ©en vaudra <code>true</code> si l'alarme a bien Ă©tĂ© effacĂ©e et <code>false</code> sinon.</p> +Une promesse ({{jsxref("Promise")}}) qui sera tenue avec un boolĂ©en. Ce boolĂ©en vaudra `true` si l'alarme a bien Ă©tĂ© effacĂ©e et `false` sinon. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function onCleared(wasCleared) { +```js +function onCleared(wasCleared) { console.log(wasCleared); // true/false } var clearAlarm = browser.alarms.clear("my-periodic-alarm"); -clearAlarm.then(onCleared);</pre> +clearAlarm.then(onCleared); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> +## CompatibilitĂ© des navigateurs -<p>{{Compat("webextensions.api.alarms.clear")}}</p> +{{Compat("webextensions.api.alarms.clear")}} -<p><strong>Remerciements :</strong></p> +**Remerciements :** -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/alarms"><code>chrome.alarms</code></a>.</p> +Cette API est basĂ©e sur l'API Chromium [`chrome.alarms`](https://developer.chrome.com/extensions/alarms). -<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> +Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/clearall/index.md b/files/fr/mozilla/add-ons/webextensions/api/alarms/clearall/index.md index 05c10b87c7..e2fd47501e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/alarms/clearall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/clearall/index.md @@ -13,41 +13,43 @@ tags: - clearAll translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/clearAll --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Cette mĂ©thode supprime toutes les alarmes actives. C'est une fonction asynchrone qui renvoie une promesse {{jsxref("Promise")}}.</p> +Cette mĂ©thode supprime toutes les alarmes actives. C'est une fonction asynchrone qui renvoie une promesse {{jsxref("Promise")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var clearAlarms = browser.alarms.clearAll() -</pre> +```js +var clearAlarms = browser.alarms.clearAll() +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<p>Aucun.</p> +Aucun. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une promesse ({{jsxref("Promise")}}) qui sera tenue avec une valeur boolĂ©enne. Ce dernier vaudra <code>true</code> si certaines alarmes ont bien Ă©tĂ© effacĂ©es et <code>false</code> sinon. On notera que Chrome renvoie toujours <code>true</code>.</p> +Une promesse ({{jsxref("Promise")}}) qui sera tenue avec une valeur boolĂ©enne. Ce dernier vaudra `true` si certaines alarmes ont bien Ă©tĂ© effacĂ©es et `false` sinon. On notera que Chrome renvoie toujours `true`. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function onClearedAll(wasCleared) { +```js +function onClearedAll(wasCleared) { console.log(wasCleared); // true/false } var clearAlarms = browser.alarms.clearAll(); -clearAlarms.then(onClearedAll);</pre> +clearAlarms.then(onClearedAll); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> +## CompatibilitĂ© des navigateurs -<p>{{Compat("webextensions.api.alarms.clearAll")}}</p> +{{Compat("webextensions.api.alarms.clearAll")}} -<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/alarms"><code>chrome.alarms</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.alarms`](https://developer.chrome.com/extensions/alarms). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/create/index.md b/files/fr/mozilla/add-ons/webextensions/api/alarms/create/index.md index 8eb55ed95a..2cb86bf346 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/alarms/create/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/create/index.md @@ -13,78 +13,80 @@ tags: - alarms translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/create --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Cette mĂ©thode permet de crĂ©er une nouvelle alarme pour la session de navigation en cours. Une alarme peut se dĂ©clencher une ou plusieurs fois. Une alarme est effacĂ©e aprĂšs qu'elle se soit dĂ©clenchĂ©e pour la derniĂšre fois.</p> +Cette mĂ©thode permet de crĂ©er une nouvelle alarme pour la session de navigation en cours. Une alarme peut se dĂ©clencher une ou plusieurs fois. Une alarme est effacĂ©e aprĂšs qu'elle se soit dĂ©clenchĂ©e pour la derniĂšre fois. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.alarms.create( +```js +browser.alarms.create( name, // une valeur string optionnelle alarmInfo // une valeur object optionnelle ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>name</code>{{optional_inline}}</dt> - <dd><code>string</code>. Le nom utilisĂ© pour l'alarme. Par dĂ©faut, la chaĂźne utilisĂ©e sera la chaĂźne vide. Cette valeur pourra ĂȘtre utilisĂ©e pour indiquer une alarme donnĂ©e avec les mĂ©thodes {{WebExtAPIRef('alarms.get()')}} et {{WebExtAPIRef('alarms.clear()')}}. Il sera Ă©galement disponible pour {{WebExtAPIRef('alarms.onAlarm')}} sous la forme de la propriĂ©tĂ© <code>name</code> de l'objet {{WebExtAPIRef('alarms.Alarm')}} passĂ© au gestionnaire d'Ă©vĂšnement. Pour une extension donnĂ©e, les noms d'alarmes sont toujours uniques (dans le cadre d'une seule extension). Si le nom donnĂ© ici correspond Ă une alarme existante pour cette extension, l'alarme existante sera supprimĂ©e et ne se dĂ©clenchera pas.</dd> - <dt><code>alarmInfo</code>{{optional_inline}}</dt> - <dd> - <p><code>object</code>. Un objet de configuration qui indique le moment du premier dĂ©clenchement comme valeur absolue (<code>when</code>) ou relative (<code>delayInMinutes</code>). Pour que l'alarme se repĂšte, on utilisera le champ <code>periodInMinutes</code>.</p> +- `name`{{optional_inline}} + - : `string`. Le nom utilisĂ© pour l'alarme. Par dĂ©faut, la chaĂźne utilisĂ©e sera la chaĂźne vide. Cette valeur pourra ĂȘtre utilisĂ©e pour indiquer une alarme donnĂ©e avec les mĂ©thodes {{WebExtAPIRef('alarms.get()')}} et {{WebExtAPIRef('alarms.clear()')}}. Il sera Ă©galement disponible pour {{WebExtAPIRef('alarms.onAlarm')}} sous la forme de la propriĂ©tĂ© `name` de l'objet {{WebExtAPIRef('alarms.Alarm')}} passĂ© au gestionnaire d'Ă©vĂšnement. Pour une extension donnĂ©e, les noms d'alarmes sont toujours uniques (dans le cadre d'une seule extension). Si le nom donnĂ© ici correspond Ă une alarme existante pour cette extension, l'alarme existante sera supprimĂ©e et ne se dĂ©clenchera pas. +- `alarmInfo`{{optional_inline}} - <p>Sur Chrome, Ă moins que l'extension ne soit chargĂ©e, les alarmes crĂ©Ă©es ne sont pas autorisĂ©es Ă se dĂ©clencher plus d'une fois par minute. Si une extension tente de dĂ©finir <code>delayInMinutes</code> avec une valeur strictement infĂ©rieure Ă 1 ou avec une valeur strictement infĂ©rieure Ă 1 dans le futur, l'alarme se dĂ©clenchera 1 minute aprĂšs ce dĂ©lai. Si une extension essaie de dĂ©finir <code>periodInMinutes</code> avec une valeur strictement infĂ©rieure Ă 1, l'alarme se dĂ©clenchera alors chaque minute.</p> + - : `object`. Un objet de configuration qui indique le moment du premier dĂ©clenchement comme valeur absolue (`when`) ou relative (`delayInMinutes`). Pour que l'alarme se repĂšte, on utilisera le champ `periodInMinutes`. - <p>L'objet <code>alarmInfo</code> peut contenir les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>when</code>{{optional_inline}}</dt> - <dd><code>double</code>. Le moment oĂč l'alarme se dĂ©clenchera en premier. L'instant est indiquĂ©e comme une valeur absolue, exprimĂ©e en <a href="https://fr.wikipedia.org/wiki/Heure_Unix">millisecondes depuis epoch</a>. Pour obtenir le nombre de millisecondes entre l'Ă©poque et l'heure actuelle, on pourra utiliser {{jsxref("Date.now")}}. Si cette valeur est utilisĂ©e, il ne faut pas fournir <code>delayInMinutes</code>.</dd> - <dt><code>delayInMinutes</code>{{optional_inline}}</dt> - <dd><code>double</code>. Le moment oĂč l'alarme se dĂ©clenchera en premier exprimĂ©e de façon relative au moment oĂč l'alarme est crĂ©Ă©e. Si cette option est utilisĂ©e, il ne faut pas fournir <code>when</code>.</dd> - <dt><code>periodInMinutes</code>{{optional_inline}}</dt> - <dd><code>double</code>. Si cette valeur est indiquĂ©e, l'alarme sera rĂ©pĂ©tĂ©e pĂ©riodiquement (toutes les <code>periodInMinutes</code> minutes) aprĂšs le premier dĂ©clenchement. Si cette valeur est indiquĂ©e, il n'est pas obligatoire de fournir <code>when</code> ou <code>delayInMinutes</code> : l'alarme se dĂ©clenchera au bout de <code>periodInMinutes</code>. Si <code>periodInMinutes</code> n'est pas indiquĂ©e, l'alarme ne se dĂ©clenchera qu'une seule fois.</dd> - </dl> - </dd> -</dl> + Sur Chrome, Ă moins que l'extension ne soit chargĂ©e, les alarmes crĂ©Ă©es ne sont pas autorisĂ©es Ă se dĂ©clencher plus d'une fois par minute. Si une extension tente de dĂ©finir `delayInMinutes` avec une valeur strictement infĂ©rieure Ă 1 ou avec une valeur strictement infĂ©rieure Ă 1 dans le futur, l'alarme se dĂ©clenchera 1 minute aprĂšs ce dĂ©lai. Si une extension essaie de dĂ©finir `periodInMinutes` avec une valeur strictement infĂ©rieure Ă 1, l'alarme se dĂ©clenchera alors chaque minute. -<h2 id="Exemples">Exemples</h2> + L'objet `alarmInfo` peut contenir les propriĂ©tĂ©s suivantes : -<h3 id="Alarme_vide">Alarme vide</h3> + - `when`{{optional_inline}} + - : `double`. Le moment oĂč l'alarme se dĂ©clenchera en premier. L'instant est indiquĂ©e comme une valeur absolue, exprimĂ©e en [millisecondes depuis epoch](https://fr.wikipedia.org/wiki/Heure_Unix). Pour obtenir le nombre de millisecondes entre l'Ă©poque et l'heure actuelle, on pourra utiliser {{jsxref("Date.now")}}. Si cette valeur est utilisĂ©e, il ne faut pas fournir `delayInMinutes`. + - `delayInMinutes`{{optional_inline}} + - : `double`. Le moment oĂč l'alarme se dĂ©clenchera en premier exprimĂ©e de façon relative au moment oĂč l'alarme est crĂ©Ă©e. Si cette option est utilisĂ©e, il ne faut pas fournir `when`. + - `periodInMinutes`{{optional_inline}} + - : `double`. Si cette valeur est indiquĂ©e, l'alarme sera rĂ©pĂ©tĂ©e pĂ©riodiquement (toutes les `periodInMinutes` minutes) aprĂšs le premier dĂ©clenchement. Si cette valeur est indiquĂ©e, il n'est pas obligatoire de fournir `when` ou `delayInMinutes` : l'alarme se dĂ©clenchera au bout de `periodInMinutes`. Si `periodInMinutes` n'est pas indiquĂ©e, l'alarme ne se dĂ©clenchera qu'une seule fois. -<pre class="brush: js">const delayInMinutes = 5; +## Exemples + +### Alarme vide + +```js +const delayInMinutes = 5; browser.alarms.create({ delayInMinutes -});</pre> +}); +``` -<h3 id="Alarme_relative_pĂ©riodique">Alarme relative pĂ©riodique</h3> +### Alarme relative pĂ©riodique -<pre class="brush: js">const delayInMinutes = 5; +```js +const delayInMinutes = 5; const periodInMinutes = 2; browser.alarms.create("my-periodic-alarm", { delayInMinutes, periodInMinutes -});</pre> +}); +``` -<h3 id="Alarme_pĂ©riodique_absolue">Alarme pĂ©riodique absolue</h3> +### Alarme pĂ©riodique absolue -<pre class="brush: js">const when = 1545696000; +```js +const when = 1545696000; const periodInMinutes = 2; browser.alarms.create("my-periodic-alarm", { when, periodInMinutes -});</pre> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.alarms.create")}}</p> +}); +``` -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/alarms"><code>chrome.alarms</code></a>.</p> +{{Compat("webextensions.api.alarms.create")}} -<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.alarms`](https://developer.chrome.com/extensions/alarms). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/alarms/get/index.md index d7f1b3624c..60f09cefec 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/alarms/get/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/get/index.md @@ -13,48 +13,48 @@ tags: - get translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/get --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Cette mĂ©thode permet d'obtenir une alarme en fonction de son nom. Cette fonction est une fonction asynchrone qui renvoie une promesse ({{jsxref("Promise")}}).</p> +Cette mĂ©thode permet d'obtenir une alarme en fonction de son nom. Cette fonction est une fonction asynchrone qui renvoie une promesse ({{jsxref("Promise")}}). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var getAlarm = browser.alarms.get( +```js +var getAlarm = browser.alarms.get( name // optional string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>name</code>{{optional_inline}}</dt> - <dd><code><code>string</code></code>. Le nom de l'alarme qu'on souhaite rĂ©cupĂ©rer. La valeur par dĂ©faut, utilisĂ©e si aucun argument n'est fournie, sera la chaĂźne vide (<code>""</code>).</dd> -</dl> +- `name`{{optional_inline}} + - : `string`. Le nom de l'alarme qu'on souhaite rĂ©cupĂ©rer. La valeur par dĂ©faut, utilisĂ©e si aucun argument n'est fournie, sera la chaĂźne vide (`""`). -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une promesse ({{jsxref("Promise")}}) qui sera tenue avec un objet {{WebExtAPIRef('alarms.Alarm', "Alarm")}}. Cette valeur correspond Ă l'alarme dont le nom correspond au paramĂštre <code>name</code>. Si aucune alarme ne correspond, la valeur renvoyĂ©e sera <code>undefined</code>.</p> +Une promesse ({{jsxref("Promise")}}) qui sera tenue avec un objet {{WebExtAPIRef('alarms.Alarm', "Alarm")}}. Cette valeur correspond Ă l'alarme dont le nom correspond au paramĂštre `name`. Si aucune alarme ne correspond, la valeur renvoyĂ©e sera `undefined`. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function gotAlarm(alarm) { +```js +function gotAlarm(alarm) { if (alarm) { console.log(alarm.name); } } var getAlarm = browser.alarms.get("my-periodic-alarm"); -getAlarm.then(gotAlarm);</pre> +getAlarm.then(gotAlarm); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.alarms.get")}}</p> +{{Compat("webextensions.api.alarms.get")}} -<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/alarms"><code>chrome.alarms</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.alarms`](https://developer.chrome.com/extensions/alarms). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/getall/index.md b/files/fr/mozilla/add-ons/webextensions/api/alarms/getall/index.md index c10f1ab6fd..a11f21a754 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/alarms/getall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/getall/index.md @@ -13,45 +13,47 @@ tags: - getAll translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/getAll --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Obtient toutes les alarmes actives pour le poste.</p> +Obtient toutes les alarmes actives pour le poste. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 getAlarms = browser.alarms.getAll() -</pre> +```js +var getAlarms = browser.alarms.getAll() +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<p>Aucun</p> +Aucun -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise"><code>Promise</code></a> dont la valeur de rĂ©solution sera un tableau d'objets <a href="/fr/Add-ons/WebExtensions/API/alarms/Alarm"><code>Alarm</code></a>. Chaque Ă©lĂ©ment de ce tableau reprĂ©sente une alarme active de l'extension. Si aucune alarme n'est active, le tableau sera vide.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) dont la valeur de rĂ©solution sera un tableau d'objets [`Alarm`](/fr/Add-ons/WebExtensions/API/alarms/Alarm). Chaque Ă©lĂ©ment de ce tableau reprĂ©sente une alarme active de l'extension. Si aucune alarme n'est active, le tableau sera vide. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function gotAll(alarms) { +```js +function gotAll(alarms) { for (var alarm of alarms) { console.log(alarm.name); } } var getAlarms = browser.alarms.getAll(); -getAlarms.then(gotAll);</pre> +getAlarms.then(gotAll); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> +## CompatibilitĂ© des navigateurs -<p>{{Compat("webextensions.api.alarms.getAll")}}</p> +{{Compat("webextensions.api.alarms.getAll")}} -<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/alarms"><code>chrome.alarms</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.alarms`](https://developer.chrome.com/extensions/alarms). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/index.md b/files/fr/mozilla/add-ons/webextensions/api/alarms/index.md index 7b49da9e46..ec858c78d6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/alarms/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/index.md @@ -11,50 +11,43 @@ tags: - alarms translation_of: Mozilla/Add-ons/WebExtensions/API/alarms --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Programmer le code pour qu'il soit exĂ©cutĂ© Ă un moment prĂ©cis dans le futur. C'est comme <code><a href="/fr/docs/Web/API/WindowTimers/setTimeout">setTimeout()</a></code> and <code><a href="/fr/docs/Web/API/WindowTimers/setInterval">setInterval()</a></code> sauf que ces fonctions ne fonctionnent pas avec les pages d'arriĂšre-plan qui sont chargĂ©es Ă la demande. Les alarmes ne persistent pas d'une session Ă l'autre du navigateur</p> +Programmer le code pour qu'il soit exĂ©cutĂ© Ă un moment prĂ©cis dans le futur. C'est comme [`setTimeout()`](/fr/docs/Web/API/WindowTimers/setTimeout) and [`setInterval()`](/fr/docs/Web/API/WindowTimers/setInterval) sauf que ces fonctions ne fonctionnent pas avec les pages d'arriĂšre-plan qui sont chargĂ©es Ă la demande. Les alarmes ne persistent pas d'une session Ă l'autre du navigateur -<p>Pour pouvoir utiliser cette API, vous devez disposer de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>"alarms"</code>.</p> +Pour pouvoir utiliser cette API, vous devez disposer de la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `"alarms"`. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("alarms.Alarm")}}</dt> - <dd>Ce type permet d'obtenir des informations Ă propos d'une alarme donnĂ©e.</dd> -</dl> +- {{WebExtAPIRef("alarms.Alarm")}} + - : Ce type permet d'obtenir des informations Ă propos d'une alarme donnĂ©e. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +## MĂ©thodes -<dl> - <dt>{{WebExtAPIRef("alarms.create()")}}</dt> - <dd>Cette fonction permet de crĂ©er une nouvelle alarme.</dd> - <dt>{{WebExtAPIRef("alarms.get()")}}</dt> - <dd>Cette fonction permet de rĂ©cupĂ©rer une alarme donnĂ©e en fonction de son nom.</dd> - <dt>{{WebExtAPIRef("alarms.getAll()")}}</dt> - <dd>Cette fonction permet de rĂ©cupĂ©rer l'ensemble des alarmes qui sont planifiĂ©es.</dd> - <dt>{{WebExtAPIRef("alarms.clear()")}}</dt> - <dd>Cette fonction permet de supprimer une alarme donnĂ©e en fonction de son nom.</dd> - <dt>{{WebExtAPIRef("alarms.clearAll()")}}</dt> - <dd>Cette fonction permet de supprimer l'ensemble des alarmes qui sont planifiĂ©es.</dd> -</dl> +- {{WebExtAPIRef("alarms.create()")}} + - : Cette fonction permet de crĂ©er une nouvelle alarme. +- {{WebExtAPIRef("alarms.get()")}} + - : Cette fonction permet de rĂ©cupĂ©rer une alarme donnĂ©e en fonction de son nom. +- {{WebExtAPIRef("alarms.getAll()")}} + - : Cette fonction permet de rĂ©cupĂ©rer l'ensemble des alarmes qui sont planifiĂ©es. +- {{WebExtAPIRef("alarms.clear()")}} + - : Cette fonction permet de supprimer une alarme donnĂ©e en fonction de son nom. +- {{WebExtAPIRef("alarms.clearAll()")}} + - : Cette fonction permet de supprimer l'ensemble des alarmes qui sont planifiĂ©es. -<h2 id="ĂvĂšnements">ĂvĂšnements</h2> +## ĂvĂšnements -<dl> - <dt>{{WebExtAPIRef("alarms.onAlarm")}}</dt> - <dd>Cet Ă©vĂšnement est dĂ©clenchĂ© lorsque l'alarme s'Ă©teint.</dd> -</dl> +- {{WebExtAPIRef("alarms.onAlarm")}} + - : Cet Ă©vĂšnement est dĂ©clenchĂ© lorsque l'alarme s'Ă©teint. -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> +## CompatibilitĂ© des navigateurs -<p>{{Compat("webextensions.api.alarms")}}</p> +{{Compat("webextensions.api.alarms")}} -<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/alarms"><code>chrome.alarms</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.alarms`](https://developer.chrome.com/extensions/alarms). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/alarms/onalarm/index.md b/files/fr/mozilla/add-ons/webextensions/api/alarms/onalarm/index.md index 46742021b9..6a1f2af6c5 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/alarms/onalarm/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/alarms/onalarm/index.md @@ -13,65 +13,58 @@ tags: - onAlarm translation_of: Mozilla/Add-ons/WebExtensions/API/alarms/onAlarm --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Cet Ă©vĂšnement est dĂ©clenchĂ© lorsque l'alarme se dĂ©clenche.</p> +Cet Ă©vĂšnement est dĂ©clenchĂ© lorsque l'alarme se dĂ©clenche. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.alarms.onAlarm.addListener(listener) +```js +browser.alarms.onAlarm.addListener(listener) browser.alarms.onAlarm.removeListener(listener) browser.alarms.onAlarm.hasListener(listener) -</pre> +``` -<p>Cet Ă©vĂšnement possĂšde trois mĂ©thodes :</p> +Cet Ă©vĂšnement possĂšde trois mĂ©thodes : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Cette mĂ©thode ajoute un gestionnaire Ă l'Ă©vĂšnement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>Cette mĂ©thode retire le gestionnaire d'Ă©vĂšnement passĂ© en argument.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>Cette mĂ©thode permet de vĂ©rifier si le gestionnaire d'Ă©vĂšnement passĂ© en argument est enregistrĂ© : elle renvoie <code>true</code> s'il est dĂ©jĂ prĂ©sent et <code>false</code> sinon.</dd> -</dl> +- `addListener(listener)` + - : Cette mĂ©thode ajoute un gestionnaire Ă l'Ă©vĂšnement. +- `removeListener(listener)` + - : Cette mĂ©thode retire le gestionnaire d'Ă©vĂšnement passĂ© en argument. +- `hasListener(listener)` + - : Cette mĂ©thode permet de vĂ©rifier si le gestionnaire d'Ă©vĂšnement passĂ© en argument est enregistrĂ© : elle renvoie `true` s'il est dĂ©jĂ prĂ©sent et `false` sinon. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>listener</code></dt> - <dd> - <p>La fonction qui sera appelĂ©e lorsque l'Ă©vĂ©nement se produira. La fonction recevra les arguments suivants :</p> +- `listener` - <dl> - <dt><code>alarm</code></dt> - <dd>{{WebExtAPIRef('alarms.Alarm')}}. L'alarme qui s'est dĂ©clenchĂ©e. La propriĂ©tĂ© <code>Alarm.name</code> pourra ĂȘtre utilisĂ©e afin de dĂ©terminer l'alarme qui s'est dĂ©clenchĂ©e.</dd> - </dl> - </dd> -</dl> + - : La fonction qui sera appelĂ©e lorsque l'Ă©vĂ©nement se produira. La fonction recevra les arguments suivants : -<h2 id="Exemples">Exemples</h2> + - `alarm` + - : {{WebExtAPIRef('alarms.Alarm')}}. L'alarme qui s'est dĂ©clenchĂ©e. La propriĂ©tĂ© `Alarm.name` pourra ĂȘtre utilisĂ©e afin de dĂ©terminer l'alarme qui s'est dĂ©clenchĂ©e. -<p>Voici un exemple illustrant ce qui se produit quand l'alarme se dĂ©clenche</p> +## Exemples -<pre class="brush: js">function handleAlarm(alarmInfo) { +Voici un exemple illustrant ce qui se produit quand l'alarme se dĂ©clenche + +```js +function handleAlarm(alarmInfo) {  console.log("L'alarme " + alarmInfo.name + " s'est dĂ©clenchĂ©e"); } -browser.alarms.onAlarm.addListener(handleAlarm);</pre> - -<p>{{WebExtExamples}}</p> - - - -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> +browser.alarms.onAlarm.addListener(handleAlarm); +``` -<p>{{Compat("webextensions.api.alarms.onAlarm")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© des navigateurs -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/alarms"><code>chrome.alarms</code></a>.</p> +{{Compat("webextensions.api.alarms.onAlarm")}} -<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.alarms`](https://developer.chrome.com/extensions/alarms). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenode/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenode/index.md index c7e94d7184..84fde4dc62 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenode/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenode/index.md @@ -13,52 +13,48 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet de type <code>bookmarks.BookmarkTreeNode</code> reprĂ©sente un nĆud dans l'arborescence de signets, oĂč chaque nĆud est un signet, un dossier de signet ou un sĂ©parateur. Les noeuds enfants sont classĂ©s par <code>index</code> dans leurs dossiers parents respectifs.</p> +Un objet de type `bookmarks.BookmarkTreeNode` reprĂ©sente un nĆud dans l'arborescence de signets, oĂč chaque nĆud est un signet, un dossier de signet ou un sĂ©parateur. Les noeuds enfants sont classĂ©s par `index` dans leurs dossiers parents respectifs. -<h2 id="Type">Type</h2> +## Type -<p>Un {{jsxref("object")}} avec les propriĂ©tĂ©s suivantes :</p> +Un {{jsxref("object")}} avec les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>children</code> {{optional_inline}}</dt> - <dd>Un {{jsxref("array")}} d'objets {{WebExtAPIRef('bookmarks.BookmarkTreeNode')}} qui reprĂ©sentent les enfants du noeud. La liste est classĂ©e dans la liste dans laquelle les enfants apparaissent dans l'interface utilisateur. Ce champ est omis si le noeud n'est pas un dossier.</dd> - <dt><code>dateAdded</code> {{optional_inline}}</dt> - <dd>Un nombre reprĂ©sentant la date de crĂ©ation du noeud en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>dateGroupModified</code> {{optional_inline}}</dt> - <dd>Un nombre reprĂ©sentant la date et l'heure de la derniĂšre modification du contenu de ce dossier, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>id</code></dt> - <dd>Un {{jsxref("string")}} qui identifie le nĆud de maniĂšre unique. Chaque ID est unique dans le profil de l'utilisateur et reste inchangĂ© dans les redĂ©marrages du navigateur.</dd> - <dt><code>index</code> {{optional_inline}}</dt> - <dd>Un nombre qui reprĂ©sente la position zĂ©ro de ce noeud dans son dossier parent, oĂč zĂ©ro reprĂ©sente la premiĂšre entrĂ©e.</dd> - <dt><code>parentId</code> {{optional_inline}}</dt> - <dd>Un {{jsxref("string")}} qui spĂ©cifie l'ID du dossier parent. Cette propriĂ©tĂ© n'est pas prĂ©sente dans le noeud racine.</dd> - <dt><code>title</code></dt> - <dd>Un {{jsxref("string")}} qui contient le texte affichĂ© pour le nĆud dans les menus et les listes de signets.</dd> - <dt><code>type</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef("bookmarks.BookmarkTreeNodeType")}} indiquant s'il s'agit d'un signet, d'un dossier ou d'un sĂ©parateur. La valeur par dĂ©faut est <code>"bookmark"</code> sauf si l'<code>url</code> est omise, auquel cas elle est par dĂ©faut <code>"folder"</code>.</dd> - <dt><code>unmodifiable</code> {{optional_inline}}</dt> - <dd>Un {{jsxref("string")}} comme dĂ©crit par le type {{WebExtAPIRef('bookmarks.BookmarkTreeNodeUnmodifiable')}}. ReprĂ©sente la raison pour laquelle le noeud ne peut pas ĂȘtre modifiĂ©. Si le nĆud peut ĂȘtre changĂ©, ceci est omis.</dd> - <dt><code>url</code> {{optional_inline}}</dt> - <dd>Un {{jsxref("string")}} qui reprĂ©sente l'URL du signet. Si le nĆud reprĂ©sente un dossier, cette propriĂ©tĂ© est omise.</dd> -</dl> +- `children` {{optional_inline}} + - : Un {{jsxref("array")}} d'objets {{WebExtAPIRef('bookmarks.BookmarkTreeNode')}} qui reprĂ©sentent les enfants du noeud. La liste est classĂ©e dans la liste dans laquelle les enfants apparaissent dans l'interface utilisateur. Ce champ est omis si le noeud n'est pas un dossier. +- `dateAdded` {{optional_inline}} + - : Un nombre reprĂ©sentant la date de crĂ©ation du noeud en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `dateGroupModified` {{optional_inline}} + - : Un nombre reprĂ©sentant la date et l'heure de la derniĂšre modification du contenu de ce dossier, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `id` + - : Un {{jsxref("string")}} qui identifie le nĆud de maniĂšre unique. Chaque ID est unique dans le profil de l'utilisateur et reste inchangĂ© dans les redĂ©marrages du navigateur. +- `index` {{optional_inline}} + - : Un nombre qui reprĂ©sente la position zĂ©ro de ce noeud dans son dossier parent, oĂč zĂ©ro reprĂ©sente la premiĂšre entrĂ©e. +- `parentId` {{optional_inline}} + - : Un {{jsxref("string")}} qui spĂ©cifie l'ID du dossier parent. Cette propriĂ©tĂ© n'est pas prĂ©sente dans le noeud racine. +- `title` + - : Un {{jsxref("string")}} qui contient le texte affichĂ© pour le nĆud dans les menus et les listes de signets. +- `type`{{optional_inline}} + - : Un objet {{WebExtAPIRef("bookmarks.BookmarkTreeNodeType")}} indiquant s'il s'agit d'un signet, d'un dossier ou d'un sĂ©parateur. La valeur par dĂ©faut est `"bookmark"` sauf si l'`url` est omise, auquel cas elle est par dĂ©faut `"folder"`. +- `unmodifiable` {{optional_inline}} + - : Un {{jsxref("string")}} comme dĂ©crit par le type {{WebExtAPIRef('bookmarks.BookmarkTreeNodeUnmodifiable')}}. ReprĂ©sente la raison pour laquelle le noeud ne peut pas ĂȘtre modifiĂ©. Si le nĆud peut ĂȘtre changĂ©, ceci est omis. +- `url` {{optional_inline}} + - : Un {{jsxref("string")}} qui reprĂ©sente l'URL du signet. Si le nĆud reprĂ©sente un dossier, cette propriĂ©tĂ© est omise. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.BookmarkTreeNode", 10)}}</p> +{{Compat("webextensions.api.bookmarks.BookmarkTreeNode", 10)}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -85,5 +81,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode // 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/bookmarks/bookmarktreenodetype/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenodetype/index.md index 13419e4584..25f3af8f86 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenodetype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenodetype/index.md @@ -12,22 +12,20 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNodeType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <strong><code>bookmarks.BookmarkTreeNodeType</code></strong> est utilisĂ© pour dĂ©crire si un nĆud de l'arborescence de signets est un signet, un dossier ou un sĂ©parateur.</p> +Le type **`bookmarks.BookmarkTreeNodeType`** est utilisĂ© pour dĂ©crire si un nĆud de l'arborescence de signets est un signet, un dossier ou un sĂ©parateur. -<h2 id="Type">Type</h2> +## Type -<p><code>bookmarks.BookmarkTreeNodeType</code> est un {{jsxref("string")}}qui peut avoir l'une des trois valeurs suivantes :</p> +`bookmarks.BookmarkTreeNodeType` est un {{jsxref("string")}}qui peut avoir l'une des trois valeurs suivantes : -<ul> - <li><code>"bookmark"</code>: le noeud est un signet.</li> - <li><code>"folder"</code>: le noeud est un dossier.</li> - <li><code>"separator"</code>: le noeud est un sĂ©parateur.</li> -</ul> +- `"bookmark"`: le noeud est un signet. +- `"folder"`: le noeud est un dossier. +- `"separator"`: le noeud est un sĂ©parateur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.BookmarkTreeNodeType", 10)}}</p> +{{Compat("webextensions.api.bookmarks.BookmarkTreeNodeType", 10)}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenodeunmodifiable/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenodeunmodifiable/index.md index 28a6704fa7..636b0b1635 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenodeunmodifiable/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/bookmarktreenodeunmodifiable/index.md @@ -13,29 +13,27 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNodeUnmodifiable --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un type <strong><code>bookmarks.BookmarkTreeNodeUnmodifiable</code></strong> est utilisĂ© pour indiquer la raison pour laquelle un nĆud de l'arborescence de signets (oĂč chaque nĆud est un signet ou un dossier de signets) ne peut pas ĂȘtre modifiĂ©. Ceci est utilisĂ© comme valeur du champ {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "bookmarks.BookmarkTreeNode.unmodifiable", "unmodifiable")}} sur les nĆuds de signets.</p> +Un type **`bookmarks.BookmarkTreeNodeUnmodifiable`** est utilisĂ© pour indiquer la raison pour laquelle un nĆud de l'arborescence de signets (oĂč chaque nĆud est un signet ou un dossier de signets) ne peut pas ĂȘtre modifiĂ©. Ceci est utilisĂ© comme valeur du champ {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "bookmarks.BookmarkTreeNode.unmodifiable", "unmodifiable")}} sur les nĆuds de signets. -<h2 id="Type">Type</h2> +## Type -<p><code>bookmarks.BookmarkTreeNodeUnmodifiable</code> est un {{jsxref("string")}} qui ne peut actuellement avoir qu'une seule valeur : <code>"managed"</code>. Cela indique que le nĆud de signet a Ă©tĂ© configurĂ© par un administrateur ou par le dĂ©positaire d'un utilisateur supervisĂ© (tel qu'un parent, dans le cas des contrĂŽles parentaux).</p> +`bookmarks.BookmarkTreeNodeUnmodifiable` est un {{jsxref("string")}} qui ne peut actuellement avoir qu'une seule valeur : `"managed"`. Cela indique que le nĆud de signet a Ă©tĂ© configurĂ© par un administrateur ou par le dĂ©positaire d'un utilisateur supervisĂ© (tel qu'un parent, dans le cas des contrĂŽles parentaux). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.BookmarkTreeNodeUnmodifiable")}}</p> +{{Compat("webextensions.api.bookmarks.BookmarkTreeNodeUnmodifiable")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -62,5 +60,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNodeUnmo // 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/bookmarks/create/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/create/index.md index 78c196778d..3be3d9a469 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/create/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/create/index.md @@ -13,39 +13,37 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/create --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>CrĂ©e un signet ou un dossier en tant qu'enfant de {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} avec <code>parentId</code> spĂ©cifiĂ©. Pour crĂ©er un dossier, omettez ou laissez vide le paramĂštre {{WebExtAPIRef("bookmarks.CreateDetails", "CreateDetails", "url")}}.</p> +CrĂ©e un signet ou un dossier en tant qu'enfant de {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} avec `parentId` spĂ©cifiĂ©. Pour crĂ©er un dossier, omettez ou laissez vide le paramĂštre {{WebExtAPIRef("bookmarks.CreateDetails", "CreateDetails", "url")}}. -<div class="warning"> -<p><strong>Attention :</strong> Si votre extension tente de crĂ©er un nouveau signet dans le nĆud racine de l'arborescence du signet, une erreur est gĂ©nĂ©rĂ©e: "<em>La racine du signet ne peut pas ĂȘtre modifiĂ©e</em>" et le signet ne sera pas crĂ©Ă©.</p> -</div> +> **Attention :** Si votre extension tente de crĂ©er un nouveau signet dans le nĆud racine de l'arborescence du signet, une erreur est gĂ©nĂ©rĂ©e: "_La racine du signet ne peut pas ĂȘtre modifiĂ©e_" et le signet ne sera pas crĂ©Ă©. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 createBookmark = browser.bookmarks.create( +```js +var createBookmark = browser.bookmarks.create( bookmark // CreateDetails object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>bookmark</code></dt> - <dd>Un objet {{WebExtAPIRef("bookmarks.CreateDetails")}}.</dd> -</dl> +- `bookmark` + - : Un objet {{WebExtAPIRef("bookmarks.CreateDetails")}}. -<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 {{WebExtAPIRef('bookmarks.BookmarkTreeNode', 'BookmarkTreeNode')}} qui dĂ©crit le nouveau noeud de marque pages.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un {{WebExtAPIRef('bookmarks.BookmarkTreeNode', 'BookmarkTreeNode')}} qui dĂ©crit le nouveau noeud de marque pages. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple crĂ©e un signet pour cette page, en le plaçant dans le dossier par dĂ©faut ("Autres signets" dans Firefox et Chrome).</p> +Cet exemple crĂ©e un signet pour cette page, en le plaçant dans le dossier par dĂ©faut ("Autres signets" dans Firefox et Chrome). -<pre class="brush: js">function onCreated(node) { +```js +function onCreated(node) { console.log(node); } @@ -54,23 +52,22 @@ var createBookmark = browser.bookmarks.create({  url: "https://developer.mozilla.org/Add-ons/WebExtensions/API/bookmarks/create" }); -createBookmark.then(onCreated);</pre> +createBookmark.then(onCreated); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.create")}}</p> +{{Compat("webextensions.api.bookmarks.create")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -97,5 +94,4 @@ createBookmark.then(onCreated);</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/bookmarks/createdetails/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/createdetails/index.md index 95c51c4da7..37fb7a9833 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/createdetails/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/createdetails/index.md @@ -13,42 +13,38 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/CreateDetails --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>CreateDetails</code> est utilisĂ© pour dĂ©crire les propriĂ©tĂ©s d'un nouveau, d'un signet, d'un dossier de signets ou d'un sĂ©parateur lors de l'appel de la mĂ©thode {{WebExtAPIRef("bookmarks.create()")}}.</p> +Le type `CreateDetails` est utilisĂ© pour dĂ©crire les propriĂ©tĂ©s d'un nouveau, d'un signet, d'un dossier de signets ou d'un sĂ©parateur lors de l'appel de la mĂ©thode {{WebExtAPIRef("bookmarks.create()")}}. -<h2 id="Type">Type</h2> +## Type -<p>Un {{jsxref("object")}} contenant une combinaison des champs suivants :</p> +Un {{jsxref("object")}} contenant une combinaison des champs suivants : -<dl> - <dt><code>index</code> {{optional_inline}}</dt> - <dd>Un entier {{jsxref("Number")}} qui spĂ©cifie la position Ă laquelle placer le nouveau signet sous son parent. Une valeur de 0 le placera en haut de la liste.</dd> - <dt><code>parentId</code> {{optional_inline}}</dt> - <dd>Un {{jsxref("string")}} qui indique l'ID du dossier parent dans lequel placer le nouveau signet ou dossier de signets. Sur Chrome et Firefox, la valeur par dĂ©faut est le dossier "Autres signets" du menu Signets.</dd> - <dt><code>title</code> {{optional_inline}}</dt> - <dd>Un {{jsxref("string")}} qui spĂ©cifie le titre du signet ou le nom du dossier Ă crĂ©er. Si ce n'est pas spĂ©cifiĂ©, le titre est <code>""</code>.</dd> - <dt><code>type</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef("bookmarks.BookmarkTreeNodeType")}}indiquant s'il s'agit d'un signet, d'un dossier ou d'un sĂ©parateur. La valeur par dĂ©faut est <code>"bookmark"</code> sauf si l'<code>url</code> est omise, auquel cas elle est par dĂ©faut <code>"folder"</code>.</dd> - <dt><code>url</code> {{optional_inline}}</dt> - <dd><code>string</code>. Un {{jsxref("string")}} qui spĂ©cifie l'URL de la page Ă mettre en signet. Si ceci est omis ou est <code>null</code>, un dossier est crĂ©Ă© Ă la place d'un signet.</dd> -</dl> +- `index` {{optional_inline}} + - : Un entier {{jsxref("Number")}} qui spĂ©cifie la position Ă laquelle placer le nouveau signet sous son parent. Une valeur de 0 le placera en haut de la liste. +- `parentId` {{optional_inline}} + - : Un {{jsxref("string")}} qui indique l'ID du dossier parent dans lequel placer le nouveau signet ou dossier de signets. Sur Chrome et Firefox, la valeur par dĂ©faut est le dossier "Autres signets" du menu Signets. +- `title` {{optional_inline}} + - : Un {{jsxref("string")}} qui spĂ©cifie le titre du signet ou le nom du dossier Ă crĂ©er. Si ce n'est pas spĂ©cifiĂ©, le titre est `""`. +- `type`{{optional_inline}} + - : Un objet {{WebExtAPIRef("bookmarks.BookmarkTreeNodeType")}}indiquant s'il s'agit d'un signet, d'un dossier ou d'un sĂ©parateur. La valeur par dĂ©faut est `"bookmark"` sauf si l'`url` est omise, auquel cas elle est par dĂ©faut `"folder"`. +- `url` {{optional_inline}} + - : `string`. Un {{jsxref("string")}} qui spĂ©cifie l'URL de la page Ă mettre en signet. Si ceci est omis ou est `null`, un dossier est crĂ©Ă© Ă la place d'un signet. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.CreateDetails", 10)}}</p> +{{Compat("webextensions.api.bookmarks.CreateDetails", 10)}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -75,5 +71,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/CreateDetails // 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/bookmarks/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/get/index.md index d2d2a6f475..d1fcc28113 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/get/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/get/index.md @@ -13,35 +13,35 @@ tags: - get translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/get --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ătant donnĂ© l'ID d'un {{WebExtAPIRef("bookmarks.BookmarkTreeNode")}} ou d'un tableau de ces ID, la mĂ©thode <strong><code>bookmarks.get()</code></strong> rĂ©cupĂšre les nĆuds correspondants.</p> +Ătant donnĂ© l'ID d'un {{WebExtAPIRef("bookmarks.BookmarkTreeNode")}} ou d'un tableau de ces ID, la mĂ©thode **`bookmarks.get()`** rĂ©cupĂšre les nĆuds correspondants. -<p>C'est une fonction asynchrone qui renvoie une {{jsxref("promise")}}.</p> +C'est une fonction asynchrone qui renvoie une {{jsxref("promise")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var getBookmarks = browser.bookmarks.get( +```js +var getBookmarks = browser.bookmarks.get( idOrIdList // string or string array ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>idOrIdList</code></dt> - <dd><code><code>string</code></code> Une {{jsxref("string")}} ou un {{jsxref("array")}} de chaĂźnes spĂ©cifiant les ID d'un ou plusieurs objets {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} Ă rĂ©cupĂ©rer.</dd> -</dl> +- `idOrIdList` + - : `string` Une {{jsxref("string")}} ou un {{jsxref("array")}} de chaĂźnes spĂ©cifiant les ID d'un ou plusieurs objets {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} Ă rĂ©cupĂ©rer. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p>Une {{jsxref("promise")}} qui sera remplie avec un tableau de {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}}, un pour chaque nĆud correspondant. Les sĂ©parateurs ne sont pas inclus dans les rĂ©sultats. Si aucun noeud n'a pu ĂȘtre trouvĂ©, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une {{jsxref("promise")}} qui sera remplie avec un tableau de {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}}, un pour chaque nĆud correspondant. Les sĂ©parateurs ne sont pas inclus dans les rĂ©sultats. Si aucun noeud n'a pu ĂȘtre trouvĂ©, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple essaie d'obtenir le signet dont l'ID est <code>bookmarkAAAA</code>. Si aucun signet avec cet ID n'existe, <code>onRejected</code> est appelĂ© :</p> +Cet exemple essaie d'obtenir le signet dont l'ID est `bookmarkAAAA`. Si aucun signet avec cet ID n'existe, `onRejected` est appelĂ© : -<pre class="brush: js">function onFulfilled(bookmarks) { +```js +function onFulfilled(bookmarks) { console.log(bookmarks); } @@ -50,23 +50,22 @@ function onRejected(error) { } var gettingBookmarks = browser.bookmarks.get("bookmarkAAAA"); -gettingBookmarks.then(onFulfilled, onRejected);</pre> +gettingBookmarks.then(onFulfilled, onRejected); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.get")}}</p> +{{Compat("webextensions.api.bookmarks.get")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -93,5 +92,4 @@ gettingBookmarks.then(onFulfilled, onRejected);</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/bookmarks/getchildren/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/getchildren/index.md index 6738cbe514..0eb705ed19 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/getchildren/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/getchildren/index.md @@ -13,35 +13,35 @@ tags: - getChildren translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/getChildren --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p><strong><code>bookmarks.getChildren()</code></strong> rĂ©cupĂšre tous les enfants immĂ©diats d'un dossier de signets donnĂ©, identifiĂ© comme {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} ID.</p> +**`bookmarks.getChildren()`** rĂ©cupĂšre tous les enfants immĂ©diats d'un dossier de signets donnĂ©, identifiĂ© comme {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} ID. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingChildren = browser.bookmarks.getChildren( +```js +var gettingChildren = browser.bookmarks.getChildren( id // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>id</code></dt> - <dd>Un {{jsxref("string")}} qui spĂ©cifie l'ID du dossier dont les enfants doivent ĂȘtre rĂ©cupĂ©rĂ©s.</dd> -</dl> +- `id` + - : Un {{jsxref("string")}} qui spĂ©cifie l'ID du dossier dont les enfants doivent ĂȘtre rĂ©cupĂ©rĂ©s. -<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 tableau d'objets <a href="/fr/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode"><code>BookmarkTreeNode</code></a>. Chaque entrĂ©e reprĂ©sente un seul noeud enfant. La liste est triĂ©e dans le mĂȘme ordre dans lequel les signets apparaissent dans l'interface utilisateur. Les sĂ©parateurs ne sont actuellement pas inclus dans les rĂ©sultats. La liste inclut les sous-dossiers, mais n'inclut aucun enfant contenu dans les sous-dossiers.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un tableau d'objets [`BookmarkTreeNode`](/fr/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode). Chaque entrĂ©e reprĂ©sente un seul noeud enfant. La liste est triĂ©e dans le mĂȘme ordre dans lequel les signets apparaissent dans l'interface utilisateur. Les sĂ©parateurs ne sont actuellement pas inclus dans les rĂ©sultats. La liste inclut les sous-dossiers, mais n'inclut aucun enfant contenu dans les sous-dossiers. -<p>Si le noeud spĂ©cifiĂ© n'a pas d'enfants, le tableau est vide.Si le noeud identifiĂ© par <code>id</code> n'est pas trouvĂ©, la promise est rejetĂ©e avec un message d'erreur.</p> +Si le noeud spĂ©cifiĂ© n'a pas d'enfants, le tableau est vide.Si le noeud identifiĂ© par `id` n'est pas trouvĂ©, la promise est rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function onFulfilled(children) { +```js +function onFulfilled(children) { for (child of children) { console.log(child.id); } @@ -52,23 +52,22 @@ function onRejected(error) { } var gettingChildren = browser.bookmarks.getChildren("unfiled_____"); -gettingChildren.then(onFulfilled, onRejected);</pre> +gettingChildren.then(onFulfilled, onRejected); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.getChildren")}}</p> +{{Compat("webextensions.api.bookmarks.getChildren")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -95,5 +94,4 @@ gettingChildren.then(onFulfilled, onRejected);</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/bookmarks/getrecent/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/getrecent/index.md index a8e59ca423..931d9c88e0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/getrecent/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/getrecent/index.md @@ -13,35 +13,35 @@ tags: - getRecent translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/getRecent --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La mĂ©thode <code>bookmarks.getRecent()</code> rĂ©cupĂšre un nombre spĂ©cifiĂ© de signets ajoutĂ©s le plus rĂ©cemment en tant que tableau d'objets {{WebExtAPIRef('bookmarks.BookmarkTreeNode', 'BookmarkTreeNode')}}.</p> +La mĂ©thode `bookmarks.getRecent()` rĂ©cupĂšre un nombre spĂ©cifiĂ© de signets ajoutĂ©s le plus rĂ©cemment en tant que tableau d'objets {{WebExtAPIRef('bookmarks.BookmarkTreeNode', 'BookmarkTreeNode')}}. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingRecent = browser.bookmarks.getRecent( +```js +var gettingRecent = browser.bookmarks.getRecent( numberOfItems // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>numberOfItems</code></dt> - <dd>Un nombre reprĂ©sentant le nombre maximum d'Ă©lĂ©ments Ă renvoyer. La liste renvoyĂ©e contiendra jusqu'Ă ce nombre des Ă©lĂ©ments les plus rĂ©cemment ajoutĂ©s. La valeur minimale autorisĂ©e ici est 1. Si vous transmettez 0 ou moins, la fonction gĂ©nĂšre une erreur.</dd> -</dl> +- `numberOfItems` + - : Un nombre reprĂ©sentant le nombre maximum d'Ă©lĂ©ments Ă renvoyer. La liste renvoyĂ©e contiendra jusqu'Ă ce nombre des Ă©lĂ©ments les plus rĂ©cemment ajoutĂ©s. La valeur minimale autorisĂ©e ici est 1. Si vous transmettez 0 ou moins, la fonction gĂ©nĂšre une erreur. -<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 tableau d'objets <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode"><code>BookmarkTreeNode</code></a>.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un tableau d'objets [`BookmarkTreeNode`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode). -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple enregistre l'URL du dernier signet ajoutĂ© :</p> +Cet exemple enregistre l'URL du dernier signet ajoutĂ© : -<pre class="brush: js">function onFulfilled(bookmarks) { +```js +function onFulfilled(bookmarks) { for (bookmark of bookmarks) { console.log(bookmark.url); } @@ -52,23 +52,22 @@ function onRejected(error) { } var gettingRecent = browser.bookmarks.getRecent(1); -gettingRecent.then(onFulfilled, onRejected);</pre> +gettingRecent.then(onFulfilled, onRejected); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.getRecent")}}</p> +{{Compat("webextensions.api.bookmarks.getRecent")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -95,5 +94,4 @@ gettingRecent.then(onFulfilled, onRejected);</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/bookmarks/getsubtree/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/getsubtree/index.md index 023c3a7368..0f2b9bef7f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/getsubtree/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/getsubtree/index.md @@ -13,37 +13,37 @@ tags: - getSubTree translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/getSubTree --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La mĂ©thode <strong><code>bookmarks.getSubTree()</code></strong> rĂ©cupĂšre de façon asynchrone un {{WebExtAPIRef("bookmarks.BookmarkTreeNode")}}, Ă©tant donnĂ© son ID.</p> +La mĂ©thode **`bookmarks.getSubTree()`** rĂ©cupĂšre de façon asynchrone un {{WebExtAPIRef("bookmarks.BookmarkTreeNode")}}, Ă©tant donnĂ© son ID. -<p>Si l'Ă©lĂ©ment est un dossier, vous pouvez accĂ©der Ă tous ses descendants de maniĂšre rĂ©cursive en utilisant sa propriĂ©tĂ© <code>children</code> et la propriĂ©tĂ©Â <code>children</code> de ses descendants, s'ils sont eux-mĂȘmes des dossiers.</p> +Si l'Ă©lĂ©ment est un dossier, vous pouvez accĂ©der Ă tous ses descendants de maniĂšre rĂ©cursive en utilisant sa propriĂ©tĂ© `children` et la propriĂ©tĂ©Â `children` de ses descendants, s'ils sont eux-mĂȘmes des dossiers. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingSubTree = browser.bookmarks.getSubTree( +```js +var gettingSubTree = browser.bookmarks.getSubTree( id // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>id</code></dt> - <dd>Un {{jsxref("string")}} spĂ©cifiant l'ID de la racine du sous-arbre Ă rĂ©cupĂ©rer.</dd> -</dl> +- `id` + - : Un {{jsxref("string")}} spĂ©cifiant l'ID de la racine du sous-arbre Ă rĂ©cupĂ©rer. -<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 tableau contenant un objet unique, un objet {{WebExtAPIRef('bookmarks.BookmarkTreeNode')}}, reprĂ©sentant l'Ă©lĂ©ment avec l'ID donnĂ©.Si un nĆud correspondant Ă <code>id</code> n'a pas pu ĂȘtre trouvĂ©, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un tableau contenant un objet unique, un objet {{WebExtAPIRef('bookmarks.BookmarkTreeNode')}}, reprĂ©sentant l'Ă©lĂ©ment avec l'ID donnĂ©.Si un nĆud correspondant Ă `id` n'a pas pu ĂȘtre trouvĂ©, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple imprime rĂ©cursivement le sous-arbre sous un noeud donnĂ© :</p> +Cet exemple imprime rĂ©cursivement le sous-arbre sous un noeud donnĂ© : -<pre class="brush: js">function makeIndent(indentLength) { +```js +function makeIndent(indentLength) { return ".".repeat(indentLength); } @@ -72,23 +72,22 @@ function onRejected(error) { var subTreeID = "root_____"; var gettingSubTree = browser.bookmarks.getSubTree(subTreeID); -gettingSubTree.then(logSubTree, onRejected);</pre> +gettingSubTree.then(logSubTree, onRejected); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.getSubTree")}}</p> +{{Compat("webextensions.api.bookmarks.getSubTree")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -115,5 +114,4 @@ gettingSubTree.then(logSubTree, onRejected);</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/bookmarks/gettree/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/gettree/index.md index a1e8033e89..e329479423 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/gettree/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/gettree/index.md @@ -13,32 +13,34 @@ tags: - getTree translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/getTree --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p><strong><code>bookmarks.getTree()</code></strong> renvoie un tableau contenant la racine de l'arborescence des signets en tant qu'objet {{WebExtAPIRef("bookmarks.BookmarkTreeNode")}}.</p> +**`bookmarks.getTree()`** renvoie un tableau contenant la racine de l'arborescence des signets en tant qu'objet {{WebExtAPIRef("bookmarks.BookmarkTreeNode")}}. -<p>Vous pouvez accĂ©der Ă l'intĂ©gralitĂ© de l'arborescence de maniĂšre rĂ©cursive en utilisant sa propriĂ©tĂ© <code>children</code> et la propriĂ©tĂ© <code>children</code> de ses descendants, s'ils sont eux-mĂȘmes des dossiers.</p> +Vous pouvez accĂ©der Ă l'intĂ©gralitĂ© de l'arborescence de maniĂšre rĂ©cursive en utilisant sa propriĂ©tĂ© `children` et la propriĂ©tĂ© `children` de ses descendants, s'ils sont eux-mĂȘmes des dossiers. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingTree = browser.bookmarks.getTree() -</pre> +```js +var gettingTree = browser.bookmarks.getTree() +``` -<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 remplie avec un tableau contenant un objet, un objet <a href="/fr/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode"><code>bookmarks.BookmarkTreeNode</code></a> le noeud racine.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un tableau contenant un objet, un objet [`bookmarks.BookmarkTreeNode`](/fr/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode) le noeud racine. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple imprime l'intĂ©gralitĂ© de l'arborescence des signets :</p> +Cet exemple imprime l'intĂ©gralitĂ© de l'arborescence des signets : -<pre class="brush: js">function makeIndent(indentLength) { +```js +function makeIndent(indentLength) { return ".".repeat(indentLength); } @@ -67,23 +69,21 @@ function onRejected(error) { var gettingTree = browser.bookmarks.getTree(); gettingTree.then(logTree, onRejected); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.getTree")}}</p> +{{Compat("webextensions.api.bookmarks.getTree")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -110,5 +110,4 @@ gettingTree.then(logTree, onRejected); // 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/bookmarks/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/index.md index b935b48f56..c2a8af71d3 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/index.md @@ -12,88 +12,80 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks --- -<div>{{AddonSidebar}}</div> - -<p>LâAPI de la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions">WebExtensions</a> {{WebExtAPIRef("bookmarks")}} permet Ă une extension dâinteragir et de manipuler le systĂšme de Bookmarking du navigateur. Vous pouvez lâutiliser pour enregistrer des marque-pages, rĂ©cupĂ©rer des marque-pages existants et Ă©diter, supprimer ou organiser des marque-pages.</p> - -<p>Pour utiliser cette API, une extension doit demander la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> « bookmarks » dans son fichier <code><a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a></code>.</p> - -<p>Les extensions ne peuvent pas crĂ©er, modifier ou supprimer des signets dans le nĆud racine de l'arborescence de signets. Cela provoquerait une erreur avec le message: <em>"La racine du signet ne peut pas ĂȘtre modifiĂ©e"</em></p> - -<h2 id="Les_Types">Les Types</h2> - -<dl> - <dt>{{WebExtAPIRef("bookmarks.BookmarkTreeNode")}}</dt> - <dd>ReprĂ©sente un marque-page ou un dossier dans l'arborescence des marque-pages.</dd> - <dt>{{WebExtAPIRef("bookmarks.BookmarkTreeNodeType")}}</dt> - <dd>Un Ă©numĂ©rateur {{jsxref("String")}} qui dĂ©crit si un nĆud de lâarbre est un marque-page, un dossier ou un sĂ©parateur.</dd> - <dt>{{WebExtAPIRef("bookmarks.BookmarkTreeNodeUnmodifiable")}}</dt> - <dd>Un {{jsxref("String")}} Ă©numĂšre ce qui spĂ©cifie pourquoi un marque-page ou un dossier nâest pas possible.</dd> - <dt>{{WebExtAPIRef("bookmarks.CreateDetails")}}</dt> - <dd>Contient des informations passĂ©es Ă la fonction {{WebExtAPIRef("bookmarks.create()")}} lors de la crĂ©ation dâun nouveau marque-page.</dd> -</dl> - -<h2 id="Les_fonctions">Les fonctions</h2> - -<dl> - <dt>{{WebExtAPIRef("bookmarks.create()")}}</dt> - <dd>CrĂ©er un marque-page ou un dossier.</dd> - <dt>{{WebExtAPIRef("bookmarks.get()")}}</dt> - <dd>RĂ©cupĂšre un ou plusieurs {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}}s, compte tenu dâun identifiant de marque-page ou dâun ensemble dâidentifiants de marque-pages.</dd> - <dt>{{WebExtAPIRef("bookmarks.getChildren()")}}</dt> - <dd>RĂ©cupĂšre les enfants spĂ©cifiĂ©s {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}}.</dd> - <dt>{{WebExtAPIRef("bookmarks.getRecent()")}}</dt> - <dd>RĂ©cupĂšre un nombre demandĂ© de marque-page rĂ©cemment ajoutĂ©s.</dd> - <dt>{{WebExtAPIRef("bookmarks.getSubTree()")}}</dt> - <dd>RĂ©cupĂšre un nombre demandĂ© de favoris rĂ©cemment ajoutĂ©s.</dd> - <dt>{{WebExtAPIRef("bookmarks.getTree()")}}</dt> - <dd>RĂ©cupĂšre lâintĂ©gralitĂ© de lâarborescence des marques pages dans un tableau dâobjets {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}}.</dd> - <dt>{{WebExtAPIRef("bookmarks.move()")}}</dt> - <dd>DĂ©place le {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} vers un nouvel emplacement dans lâarborescence de marque-pages.</dd> - <dt>{{WebExtAPIRef("bookmarks.remove()")}}</dt> - <dd>Supprime un marque page ou un dossier de marque-pages vide, en fonction de lâID du noeud.</dd> - <dt>{{WebExtAPIRef("bookmarks.removeTree()")}}</dt> - <dd>Supprime de maniĂšre rĂ©cursive un dossier de marque-pages ; câest-Ă -dire, Ă©tant donnĂ© lâID dâun noeud de dossier, supprime ce noeud et tous ses descendants.</dd> - <dt>{{WebExtAPIRef("bookmarks.search()")}}</dt> - <dd>Recherche {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} une correspondant Ă un ensemble de critĂšres spĂ©cifiĂ©.</dd> - <dt>{{WebExtAPIRef("bookmarks.update()")}}</dt> - <dd>Met Ă jour le titre et/ou lâURL dâun marque-page, ou un nom de dossier de marque-pages, en fonction de lâID dâun marque-page.</dd> -</dl> - -<h2 id="Events">Events</h2> - -<dl> - <dt>{{WebExtAPIRef("bookmarks.onCreated")}}</dt> - <dd>DĂ©clenchĂ© lorsquâun marque-page ou un dossier est crĂ©Ă©.</dd> - <dt>{{WebExtAPIRef("bookmarks.onRemoved")}}</dt> - <dd>DĂ©clenchĂ© lorsquâun marque-page ou un dossier est supprimĂ©. Lorsquâun dossier est supprimĂ© de maniĂšre rĂ©cursive, une seule notification est envoyĂ©e pour le dossier et aucune pour son contenu.</dd> - <dt>{{WebExtAPIRef("bookmarks.onChanged")}}</dt> - <dd>DĂ©clenchĂ© lorsquâun marque-page ou un dossier change. Actuellement, seuls les changements de titre et dâURL dĂ©clenchent ce type dâĂ©vĂ©nement.</dd> - <dt>{{WebExtAPIRef("bookmarks.onMoved")}}</dt> - <dd>DĂ©clenchĂ© lorsquâun marque-page ou un dossier est dĂ©placĂ© vers un dossier parent diffĂ©rent ou vers un nouveau dĂ©calage dans son dossier.</dd> - <dt>{{WebExtAPIRef("bookmarks.onChildrenReordered")}}</dt> - <dd>DĂ©clenchĂ© lorsque lâutilisateur a triĂ© les enfants dâun dossier dans lâinterface utilisateur du navigateur. Ceci nâest pas dĂ©clenchĂ© par un appel {{WebExtAPIRef("bookmarks.move", "move()")}}.</dd> - <dt>{{WebExtAPIRef("bookmarks.onImportBegan")}}</dt> - <dd>DĂ©clenchĂ© lorsquâune session dâimportation de marque-pages est commencĂ©e. Les observateurs coĂ»teux doivent ignorer les {{WebExtAPIRef("bookmarks.onCreated")}} mises Ă jour jusquâĂ ce que {{WebExtAPIRef("bookmarks.onImportEnded")}} soit dĂ©clenchĂ©. Les observateurs doivent toujours gĂ©rer dâautres notifications immĂ©diatement.</dd> - <dt>{{WebExtAPIRef("bookmarks.onImportEnded")}}</dt> - <dd>DĂ©clenchĂ© lorsquâune session dâimportation de marque-pages est terminĂ©e.</dd> -</dl> - -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> - -<p>{{Compat("webextensions.api.bookmarks")}}</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/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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}} + +LâAPI de la [WebExtensions](/fr/docs/Mozilla/Add-ons/WebExtensions) {{WebExtAPIRef("bookmarks")}} permet Ă une extension dâinteragir et de manipuler le systĂšme de Bookmarking du navigateur. Vous pouvez lâutiliser pour enregistrer des marque-pages, rĂ©cupĂ©rer des marque-pages existants et Ă©diter, supprimer ou organiser des marque-pages. + +Pour utiliser cette API, une extension doit demander la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) « bookmarks » dans son fichier [`manifest.json`](/fr/Add-ons/WebExtensions/manifest.json). + +Les extensions ne peuvent pas crĂ©er, modifier ou supprimer des signets dans le nĆud racine de l'arborescence de signets. Cela provoquerait une erreur avec le message: _"La racine du signet ne peut pas ĂȘtre modifiĂ©e"_ + +## Les Types + +- {{WebExtAPIRef("bookmarks.BookmarkTreeNode")}} + - : ReprĂ©sente un marque-page ou un dossier dans l'arborescence des marque-pages. +- {{WebExtAPIRef("bookmarks.BookmarkTreeNodeType")}} + - : Un Ă©numĂ©rateur {{jsxref("String")}} qui dĂ©crit si un nĆud de lâarbre est un marque-page, un dossier ou un sĂ©parateur. +- {{WebExtAPIRef("bookmarks.BookmarkTreeNodeUnmodifiable")}} + - : Un {{jsxref("String")}} Ă©numĂšre ce qui spĂ©cifie pourquoi un marque-page ou un dossier nâest pas possible. +- {{WebExtAPIRef("bookmarks.CreateDetails")}} + - : Contient des informations passĂ©es Ă la fonction {{WebExtAPIRef("bookmarks.create()")}} lors de la crĂ©ation dâun nouveau marque-page. + +## Les fonctions + +- {{WebExtAPIRef("bookmarks.create()")}} + - : CrĂ©er un marque-page ou un dossier. +- {{WebExtAPIRef("bookmarks.get()")}} + - : RĂ©cupĂšre un ou plusieurs {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}}s, compte tenu dâun identifiant de marque-page ou dâun ensemble dâidentifiants de marque-pages. +- {{WebExtAPIRef("bookmarks.getChildren()")}} + - : RĂ©cupĂšre les enfants spĂ©cifiĂ©s {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}}. +- {{WebExtAPIRef("bookmarks.getRecent()")}} + - : RĂ©cupĂšre un nombre demandĂ© de marque-page rĂ©cemment ajoutĂ©s. +- {{WebExtAPIRef("bookmarks.getSubTree()")}} + - : RĂ©cupĂšre un nombre demandĂ© de favoris rĂ©cemment ajoutĂ©s. +- {{WebExtAPIRef("bookmarks.getTree()")}} + - : RĂ©cupĂšre lâintĂ©gralitĂ© de lâarborescence des marques pages dans un tableau dâobjets {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}}. +- {{WebExtAPIRef("bookmarks.move()")}} + - : DĂ©place le {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} vers un nouvel emplacement dans lâarborescence de marque-pages. +- {{WebExtAPIRef("bookmarks.remove()")}} + - : Supprime un marque page ou un dossier de marque-pages vide, en fonction de lâID du noeud. +- {{WebExtAPIRef("bookmarks.removeTree()")}} + - : Supprime de maniĂšre rĂ©cursive un dossier de marque-pages ; câest-Ă -dire, Ă©tant donnĂ© lâID dâun noeud de dossier, supprime ce noeud et tous ses descendants. +- {{WebExtAPIRef("bookmarks.search()")}} + - : Recherche {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} une correspondant Ă un ensemble de critĂšres spĂ©cifiĂ©. +- {{WebExtAPIRef("bookmarks.update()")}} + - : Met Ă jour le titre et/ou lâURL dâun marque-page, ou un nom de dossier de marque-pages, en fonction de lâID dâun marque-page. + +## Events + +- {{WebExtAPIRef("bookmarks.onCreated")}} + - : DĂ©clenchĂ© lorsquâun marque-page ou un dossier est crĂ©Ă©. +- {{WebExtAPIRef("bookmarks.onRemoved")}} + - : DĂ©clenchĂ© lorsquâun marque-page ou un dossier est supprimĂ©. Lorsquâun dossier est supprimĂ© de maniĂšre rĂ©cursive, une seule notification est envoyĂ©e pour le dossier et aucune pour son contenu. +- {{WebExtAPIRef("bookmarks.onChanged")}} + - : DĂ©clenchĂ© lorsquâun marque-page ou un dossier change. Actuellement, seuls les changements de titre et dâURL dĂ©clenchent ce type dâĂ©vĂ©nement. +- {{WebExtAPIRef("bookmarks.onMoved")}} + - : DĂ©clenchĂ© lorsquâun marque-page ou un dossier est dĂ©placĂ© vers un dossier parent diffĂ©rent ou vers un nouveau dĂ©calage dans son dossier. +- {{WebExtAPIRef("bookmarks.onChildrenReordered")}} + - : DĂ©clenchĂ© lorsque lâutilisateur a triĂ© les enfants dâun dossier dans lâinterface utilisateur du navigateur. Ceci nâest pas dĂ©clenchĂ© par un appel {{WebExtAPIRef("bookmarks.move", "move()")}}. +- {{WebExtAPIRef("bookmarks.onImportBegan")}} + - : DĂ©clenchĂ© lorsquâune session dâimportation de marque-pages est commencĂ©e. Les observateurs coĂ»teux doivent ignorer les {{WebExtAPIRef("bookmarks.onCreated")}} mises Ă jour jusquâĂ ce que {{WebExtAPIRef("bookmarks.onImportEnded")}} soit dĂ©clenchĂ©. Les observateurs doivent toujours gĂ©rer dâautres notifications immĂ©diatement. +- {{WebExtAPIRef("bookmarks.onImportEnded")}} + - : DĂ©clenchĂ© lorsquâune session dâimportation de marque-pages est terminĂ©e. + +## CompatibilitĂ© des navigateurs + +{{Compat("webextensions.api.bookmarks")}} + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basĂ©e sur lâAPI Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. + +<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 @@ -120,5 +112,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks // 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/bookmarks/move/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/move/index.md index cb8f56ae57..6ee739393b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/move/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/move/index.md @@ -13,50 +13,46 @@ tags: - move translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/move --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La mĂ©thode <strong><code>bookmarks.move()</code></strong> dĂ©place le {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} Ă la destination spĂ©cifiĂ©e dans l'arborescence des signets. Cela vous permet de dĂ©placer un signet vers un nouveau dossier et / ou une position dans le dossier.</p> +La mĂ©thode **`bookmarks.move()`** dĂ©place le {{WebExtAPIRef("bookmarks.BookmarkTreeNode", "BookmarkTreeNode")}} Ă la destination spĂ©cifiĂ©e dans l'arborescence des signets. Cela vous permet de dĂ©placer un signet vers un nouveau dossier et / ou une position dans le dossier. -<div class="warning"> -<p><strong>Attention :</strong> Si votre extension tente de dĂ©placer un signet dans le nĆud racine de lâarborescence de signets, lâappel dĂ©clenche une erreur avec le message suivant: "<em>La racine du signet ne peut pas ĂȘtre modifiĂ©e</em>" et le dĂ©placement ne sera pas terminĂ©.</p> -</div> +> **Attention :** Si votre extension tente de dĂ©placer un signet dans le nĆud racine de lâarborescence de signets, lâappel dĂ©clenche une erreur avec le message suivant: "_La racine du signet ne peut pas ĂȘtre modifiĂ©e_" et le dĂ©placement ne sera pas terminĂ©. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 movingBookmark = browser.bookmarks.move( +```js +var movingBookmark = browser.bookmarks.move( id, // string destination // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres :</h3> +### ParamĂštres : -<dl> - <dt><code>id</code></dt> - <dd>Un {{jsxref("string")}} contenant l'ID du signet ou du dossier Ă dĂ©placer.</dd> - <dt><code>destination</code></dt> - <dd><p>Un {{jsxref("object")}} qui spĂ©cifie la destination du signet. Cet objet doit contenir un ou les deux champs suivants :</p> - - <dl> - <dt><code>parentId</code> {{optional_inline}}</dt> - <dd>Un {{jsxref("string")}} qui spĂ©cifie l'ID du dossier de destination. Si cette valeur est omise, le signet est dĂ©placĂ© vers un nouvel emplacement dans son dossier actuel.</dd> - <dt><code>index</code> {{optional_inline}}</dt> - <dd>Un index basĂ© sur 0 spĂ©cifiant la position dans le dossier vers lequel dĂ©placer le signet. La valeur 0 dĂ©place le signet vers le haut du dossier. Si cette valeur est omise, le signet est placĂ© Ă la fin du nouveau dossier parent..</dd> - </dl> - </dd> -</dl> +- `id` + - : Un {{jsxref("string")}} contenant l'ID du signet ou du dossier Ă dĂ©placer. +- `destination` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : Un {{jsxref("object")}} qui spĂ©cifie la destination du signet. Cet objet doit contenir un ou les deux champs suivants : -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un seul objet <a href="/fr/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode"><code>bookmarks.BookmarkTreeNode</code></a> dĂ©crivant le noeud dĂ©placĂ©.Si le noeud correspondant au paramĂštre <code>id</code> ne peut pas ĂȘtre trouvĂ©, la promesse est rejetĂ©e avec un message d'erreur.</p> + - `parentId` {{optional_inline}} + - : Un {{jsxref("string")}} qui spĂ©cifie l'ID du dossier de destination. Si cette valeur est omise, le signet est dĂ©placĂ© vers un nouvel emplacement dans son dossier actuel. + - `index` {{optional_inline}} + - : Un index basĂ© sur 0 spĂ©cifiant la position dans le dossier vers lequel dĂ©placer le signet. La valeur 0 dĂ©place le signet vers le haut du dossier. Si cette valeur est omise, le signet est placĂ© Ă la fin du nouveau dossier parent.. -<h2 id="Exemples">Exemples</h2> +### Valeur retournĂ©e -<p>Cet exemple dĂ©place un signet afin qu'il soit le premier signet dans son dossier actuel.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un seul objet [`bookmarks.BookmarkTreeNode`](/fr/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode) dĂ©crivant le noeud dĂ©placĂ©.Si le noeud correspondant au paramĂštre `id` ne peut pas ĂȘtre trouvĂ©, la promesse est rejetĂ©e avec un message d'erreur. -<pre class="brush: js">function onMoved(bookmarkItem) { +## Exemples + +Cet exemple dĂ©place un signet afin qu'il soit le premier signet dans son dossier actuel. + +```js +function onMoved(bookmarkItem) { console.log(bookmarkItem.index); } @@ -67,25 +63,22 @@ function onRejected(error) { var bookmarkId = "abcdefghilkl"; var movingBookmark = browser.bookmarks.move(bookmarkId, {index: 0}); -movingBookmark.then(onMoved, onRejected);</pre> - -<p>{{WebExtExamples}}</p> - - - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +movingBookmark.then(onMoved, onRejected); +``` -<p>{{Compat("webextensions.api.bookmarks.move")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</p> +{{Compat("webextensions.api.bookmarks.move")}} -<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.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -112,5 +105,4 @@ movingBookmark.then(onMoved, onRejected);</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/bookmarks/onchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onchanged/index.md index 50b31946cd..d70280c75f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onchanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onchanged/index.md @@ -13,61 +13,52 @@ tags: - onChanged translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/onChanged --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Mise en place quand il y a un changement Ă :</p> +Mise en place quand il y a un changement Ă : -<ul> - <li>le titre ou l'URL d'un signet</li> - <li>le nom d'un dossier.</li> -</ul> +- le titre ou l'URL d'un signet +- le nom d'un dossier. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.bookmarks.onChanged.addListener(listener) +```js +browser.bookmarks.onChanged.addListener(listener) browser.bookmarks.onChanged.removeListener(listener) browser.bookmarks.onChanged.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>id</code></dt> - <dd><code>string</code>. ID de l'article qui a changĂ©.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>changeInfo</code></dt> - <dd><a href="#changeInfo"><code>object</code></a>. Objet contenant deux propriĂ©tĂ©s : <code>title</code>, une chaĂźne contenant le titre de l'Ă©lĂ©ment et <code>url</code>, une chaĂźne contenant l'URL de l'Ă©lĂ©ment. Si l'Ă©lĂ©ment est un dossier, l'<code>url</code> est omise.</dd> - </dl> - </dd> -</dl> + - `id` + - : `string`. ID de l'article qui a changĂ©. -<div class="note"> -<p><strong>Note :</strong> Plusieurs Ă©vĂ©nements peuvent se produire lorsqu'un signet change, et cet objet changeInfo peut contenir uniquement les donnĂ©es qui ont changĂ©, plutĂŽt que toutes les donnĂ©es du signet. En d'autres termes, si l'<code>url</code> d'un signet change, le changeInfo ne peut contenir que les nouvelles informations de l'<code>url</code>.</p> -</div> + <!----> -<h2 id="Exemples">Exemples</h2> + - `changeInfo` + - : [`object`](#changeInfo). Objet contenant deux propriĂ©tĂ©s : `title`, une chaĂźne contenant le titre de l'Ă©lĂ©ment et `url`, une chaĂźne contenant l'URL de l'Ă©lĂ©ment. Si l'Ă©lĂ©ment est un dossier, l'`url` est omise. -<pre class="brush: js">function handleChanged(id, changeInfo) { +> **Note :** Plusieurs Ă©vĂ©nements peuvent se produire lorsqu'un signet change, et cet objet changeInfo peut contenir uniquement les donnĂ©es qui ont changĂ©, plutĂŽt que toutes les donnĂ©es du signet. En d'autres termes, si l'`url` d'un signet change, le changeInfo ne peut contenir que les nouvelles informations de l'`url`. + +## Exemples + +```js +function handleChanged(id, changeInfo) { console.log("Item: " + id + " changed"); console.log("Title: " + changeInfo.title); console.log("Url: " + changeInfo.url); @@ -78,27 +69,21 @@ function handleClick() { } browser.browserAction.onClicked.addListener(handleClick); -</pre> - -<p>{{WebExtExamples}}</p> - - - - - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +``` -<p>{{Compat("webextensions.api.bookmarks.onChanged")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</p> +{{Compat("webextensions.api.bookmarks.onChanged")}} -<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.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -125,5 +110,4 @@ browser.browserAction.onClicked.addListener(handleClick); // 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/bookmarks/onchildrenreordered/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onchildrenreordered/index.md index e6d6097773..f499f7090d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onchildrenreordered/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onchildrenreordered/index.md @@ -13,65 +13,58 @@ tags: - onChildrenReordered translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/onChildrenReordered --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque les enfants d'un dossier ont changĂ© leur commande en raison de la commande triĂ©e dans l'interface utilisateur. Cela n'est pas appelĂ© Ă la suite d'un appel Ă Â {{WebExtAPIRef("bookmarks.move()")}} ou une opĂ©ration glisser dans l'interface utilisateur.</p> +LancĂ© lorsque les enfants d'un dossier ont changĂ© leur commande en raison de la commande triĂ©e dans l'interface utilisateur. Cela n'est pas appelĂ© Ă la suite d'un appel Ă Â {{WebExtAPIRef("bookmarks.move()")}} ou une opĂ©ration glisser dans l'interface utilisateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.bookmarks.onChildrenReordered.addListener(listener) +```js +browser.bookmarks.onChildrenReordered.addListener(listener) browser.bookmarks.onChildrenReordered.removeListener(listener) browser.bookmarks.onChildrenReordered.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Synatxe_addListener">Synatxe addListener</h2> +## Synatxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera trĂšs semblable Ă cet Ă©vĂ©nement. La fonction suivante les arguments suivants :</p> +- `callback` - <dl> - <dt><code>id</code></dt> - <dd><code>string</code>. ID du dossier dont les enfants ont Ă©tĂ© rĂ©organisĂ©s.</dd> - </dl> + - : Fonction qui sera trĂšs semblable Ă cet Ă©vĂ©nement. La fonction suivante les arguments suivants : - <dl> - <dt><code>reorderInfo</code></dt> - <dd><a href="#reorderInfo"><code>object</code></a>. Objet contenant des objets supplĂ©mentaires.</dd> - </dl> - </dd> -</dl> + - `id` + - : `string`. ID du dossier dont les enfants ont Ă©tĂ© rĂ©organisĂ©s. -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + <!----> -<h3 id="reorderInfo">reorderInfo</h3> + - `reorderInfo` + - : [`object`](#reorderInfo). Objet contenant des objets supplĂ©mentaires. -<dl> - <dt><code>childIds</code></dt> - <dd><code>array</code> de <code><code>string</code></code>. Tableau contenant les ID de tous les Ă©lĂ©ments de signets de ce dossier, dans l'ordre oĂč ils apparaissent maintenant dans l'interface utilisateur.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### reorderInfo -<p>{{Compat("webextensions.api.bookmarks.onChildrenReordered")}}</p> +- `childIds` + - : `array` de `string`. Tableau contenant les ID de tous les Ă©lĂ©ments de signets de ce dossier, dans l'ordre oĂč ils apparaissent maintenant dans l'interface utilisateur. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function handleChildrenReordered(id, reorderInfo) { +{{Compat("webextensions.api.bookmarks.onChildrenReordered")}} + +## Exemples + +```js +function handleChildrenReordered(id, reorderInfo) { console.log("Item: " + id + " children reordered"); console.log("Children: " + reorderInfo.childIds); } @@ -81,19 +74,17 @@ function handleClick() { } browser.browserAction.onClicked.addListener(handleClick); -</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/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -120,5 +111,4 @@ browser.browserAction.onClicked.addListener(handleClick); // 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/bookmarks/oncreated/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/oncreated/index.md index 92cb03124e..aa459d406a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/oncreated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/oncreated/index.md @@ -13,73 +13,67 @@ tags: - onCreated translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/onCreated --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'un Ă©lĂ©ment de signet (un signet ou un dossier) est crĂ©Ă©.</p> +LancĂ© lorsqu'un Ă©lĂ©ment de signet (un signet ou un dossier) est crĂ©Ă©. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.bookmarks.onCreated.addListener() +```js +browser.bookmarks.onCreated.addListener() browser.bookmarks.onCreated.removeListener(listener) browser.bookmarks.onCreated.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>id</code></dt> - <dd><code>string</code>. L'ID du nouvel Ă©lĂ©ment de favori.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>bookmark</code></dt> - <dd>{{WebExtAPIRef('bookmarks.BookmarkTreeNode')}}. Informations sur le nouvel Ă©lĂ©ment de favori.</dd> - </dl> - </dd> -</dl> + - `id` + - : `string`. L'ID du nouvel Ă©lĂ©ment de favori. -<h2 id="Exemples">Exemples</h2> + <!----> -<pre class="brush: js">function handleCreated(id, bookmarkInfo) { + - `bookmark` + - : {{WebExtAPIRef('bookmarks.BookmarkTreeNode')}}. Informations sur le nouvel Ă©lĂ©ment de favori. + +## Exemples + +```js +function handleCreated(id, bookmarkInfo) { console.log(`New bookmark ID: ${id}`); console.log(`New bookmark URL: ${bookmarkInfo.url}`); } -browser.bookmarks.onCreated.addListener(handleCreated);</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +browser.bookmarks.onCreated.addListener(handleCreated); +``` -<p>{{Compat("webextensions.api.bookmarks.onCreated")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</p> +{{Compat("webextensions.api.bookmarks.onCreated")}} -<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.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 +100,4 @@ browser.bookmarks.onCreated.addListener(handleCreated);</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/bookmarks/onimportbegan/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onimportbegan/index.md index 4c2a02eabe..daf1badb36 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onimportbegan/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onimportbegan/index.md @@ -13,48 +13,44 @@ tags: - onImportBegan translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/onImportBegan --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque le navigateur a commencĂ© Ă importer un ensemble de signet.</p> +LancĂ© lorsque le navigateur a commencĂ© Ă importer un ensemble de signet. -<p>Pendant l'importation d'un ensemble de signets, {{WebExtAPIRef("bookmarks.onCreated", "onCreated")}} peut dĂ©clencher plusieurs fois. Si votre extension Ă©coute <code>onCreated</code>, et que l'Ă©couteur est cher, vous devez Ă©galement Ă©couter <code>onImportBegan</code> et {{WebExtAPIRef("bookmarks.onImportEnded", "onImportEnded")}}. Lorsque vous recevez <code>onImportBegan</code>, ignorez <code>onCreated</code> jusqu'Ă ce que vous receviez <code>onImportEnded</code>. Vous pouvez gĂ©rer toutes les autres notifications comme d'habitude.</p> +Pendant l'importation d'un ensemble de signets, {{WebExtAPIRef("bookmarks.onCreated", "onCreated")}} peut dĂ©clencher plusieurs fois. Si votre extension Ă©coute `onCreated`, et que l'Ă©couteur est cher, vous devez Ă©galement Ă©couter `onImportBegan` et {{WebExtAPIRef("bookmarks.onImportEnded", "onImportEnded")}}. Lorsque vous recevez `onImportBegan`, ignorez `onCreated` jusqu'Ă ce que vous receviez `onImportEnded`. Vous pouvez gĂ©rer toutes les autres notifications comme d'habitude. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.bookmarks.onImportBegan.addListener(listener) +```js +browser.bookmarks.onImportBegan.addListener(listener) browser.bookmarks.onImportBegan.removeListener(listener) browser.bookmarks.onImportBegan.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="Parameters">Parameters</h3> +### Parameters -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. Il n'y a pas de paramĂštres.</p> - </dd> -</dl> +- `callback` + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. Il n'y a pas de paramĂštres. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.onImportBegan")}}</p> +{{Compat("webextensions.api.bookmarks.onImportBegan")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function handleImportBegan() { +```js +function handleImportBegan() { console.log("Importing..."); } @@ -68,19 +64,17 @@ function handleClick() { } browser.browserAction.onClicked.addListener(handleClick); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -107,5 +101,4 @@ browser.browserAction.onClicked.addListener(handleClick); // 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/bookmarks/onimportended/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onimportended/index.md index c70be82f29..f785ff1901 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onimportended/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onimportended/index.md @@ -13,48 +13,44 @@ tags: - onImportEnded translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/onImportEnded --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque le navigateur a fini d'importer un ensemble de signets.</p> +LancĂ© lorsque le navigateur a fini d'importer un ensemble de signets. -<p>Voir {{WebExtAPIRef("bookmarks.onImportBegan")}}.</p> +Voir {{WebExtAPIRef("bookmarks.onImportBegan")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.bookmarks.onImportEnded.addListener(listener) +```js +browser.bookmarks.onImportEnded.addListener(listener) browser.bookmarks.onImportEnded.removeListener(listener) browser.bookmarks.onImportEnded.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. Il n'a pas passĂ© de paramĂštres.</p> - </dd> -</dl> +- `callback` + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. Il n'a pas passĂ© de paramĂštres. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.bookmarks.onImportEnded")}}</p> +{{Compat("webextensions.api.bookmarks.onImportEnded")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function handleImportBegan() { +```js +function handleImportBegan() { console.log("Importing..."); } @@ -68,19 +64,17 @@ function handleClick() { } browser.browserAction.onClicked.addListener(handleClick); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -107,5 +101,4 @@ browser.browserAction.onClicked.addListener(handleClick); // 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/bookmarks/onmoved/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onmoved/index.md index 1b39e36c37..b3e7e0e1ba 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onmoved/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onmoved/index.md @@ -13,71 +13,64 @@ tags: - onMoved translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/onMoved --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'un signet ou un dossier est dĂ©placĂ© vers un autre dossier parent et / ou position dans un dossier.</p> +LancĂ© lorsqu'un signet ou un dossier est dĂ©placĂ© vers un autre dossier parent et / ou position dans un dossier. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.bookmarks.onMoved.addListener(listener) +```js +browser.bookmarks.onMoved.addListener(listener) browser.bookmarks.onMoved.removeListener(listener) browser.bookmarks.onMoved.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="Parameters">Parameters</h3> +### Parameters -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Function that will be called when this event occurs. The function will be passed the following arguments:</p> +- `callback` - <dl> - <dt><code>id</code></dt> - <dd><code>string</code>. ID of the item that was moved.</dd> - </dl> + - : Function that will be called when this event occurs. The function will be passed the following arguments: - <dl> - <dt><code>moveInfo</code></dt> - <dd><a href="#moveInfo"><code>object</code></a>. Object containing more details about the move.</dd> - </dl> - </dd> -</dl> + - `id` + - : `string`. ID of the item that was moved. -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + <!----> -<h3 id="moveInfo">moveInfo</h3> + - `moveInfo` + - : [`object`](#moveInfo). Object containing more details about the move. -<dl> - <dt><code>parentId</code></dt> - <dd><code>string</code>. Le nouveau dossier parent.</dd> - <dt><code>index</code></dt> - <dd><code>integer</code>. Le nouvel index de cet Ă©lĂ©ment dans son parent.</dd> - <dt><code>oldParentId</code></dt> - <dd><code>string</code>. L'ancien dossier parent.</dd> - <dt><code>oldIndex</code></dt> - <dd><code>integer</code>. L'ancien index de l'Ă©lĂ©ment dans son parent.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### moveInfo -<p>{{Compat("webextensions.api.bookmarks.onMoved")}}</p> +- `parentId` + - : `string`. Le nouveau dossier parent. +- `index` + - : `integer`. Le nouvel index de cet Ă©lĂ©ment dans son parent. +- `oldParentId` + - : `string`. L'ancien dossier parent. +- `oldIndex` + - : `integer`. L'ancien index de l'Ă©lĂ©ment dans son parent. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function handleMoved(id, moveInfo) { +{{Compat("webextensions.api.bookmarks.onMoved")}} + +## Exemples + +```js +function handleMoved(id, moveInfo) { console.log("Item: " + id + " moved"); console.log("Old index: " + moveInfo.oldIndex); console.log("New index: " + moveInfo.index); @@ -90,19 +83,17 @@ function handleClick() { } browser.browserAction.onClicked.addListener(handleClick); -</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/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -129,5 +120,4 @@ browser.browserAction.onClicked.addListener(handleClick); // 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/bookmarks/onremoved/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onremoved/index.md index 272fdfa0af..4886833f57 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onremoved/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/onremoved/index.md @@ -13,65 +13,58 @@ tags: - onRemoved translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/onRemoved --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'un signet ou un dossier est supprimĂ©. Lorsqu'un dossier est supprimĂ© de maniĂšre rĂ©cursive, une seule notification est envoyĂ©e pour le dossier et aucune pour son contenu.</p> +LancĂ© lorsqu'un signet ou un dossier est supprimĂ©. Lorsqu'un dossier est supprimĂ© de maniĂšre rĂ©cursive, une seule notification est envoyĂ©e pour le dossier et aucune pour son contenu. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.bookmarks.onRemoved.addListener(listener) +```js +browser.bookmarks.onRemoved.addListener(listener) browser.bookmarks.onRemoved.removeListener(listener) browser.bookmarks.onRemoved.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>id</code></dt> - <dd><code>string</code>. ID de l'article qui a Ă©tĂ© supprimĂ©.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>removeInfo</code></dt> - <dd><a href="#removeInfo"><code>object</code></a>. Plus de dĂ©tails sur l'Ă©lĂ©ment supprimĂ©.</dd> - </dl> - </dd> -</dl> + - `id` + - : `string`. ID de l'article qui a Ă©tĂ© supprimĂ©. -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + <!----> -<h3 id="removeInfo">removeInfo</h3> + - `removeInfo` + - : [`object`](#removeInfo). Plus de dĂ©tails sur l'Ă©lĂ©ment supprimĂ©. -<dl> - <dt><code>parentId</code></dt> - <dd><code>string</code>. ID du parent de l'Ă©lĂ©ment dans l'arborescence.</dd> - <dt><code>index</code></dt> - <dd><code>integer</code>. Position d'index basĂ©e sur zĂ©ro de cet Ă©lĂ©ment dans son parent.</dd> - <dt><code>node</code></dt> - <dd>{{WebExtAPIRef('bookmarks.BookmarkTreeNode')}}. Informations dĂ©taillĂ©es sur l'Ă©lĂ©ment qui a Ă©tĂ© supprimĂ©.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="Exemples">Exemples</h2> +### removeInfo -<pre class="brush: js">function handleRemoved(id, removeInfo) { +- `parentId` + - : `string`. ID du parent de l'Ă©lĂ©ment dans l'arborescence. +- `index` + - : `integer`. Position d'index basĂ©e sur zĂ©ro de cet Ă©lĂ©ment dans son parent. +- `node` + - : {{WebExtAPIRef('bookmarks.BookmarkTreeNode')}}. Informations dĂ©taillĂ©es sur l'Ă©lĂ©ment qui a Ă©tĂ© supprimĂ©. + +## Exemples + +```js +function handleRemoved(id, removeInfo) { console.log("Item: " + id + " removed"); console.log("Title: " + removeInfo.node.title); console.log("Url: " + removeInfo.node.url); @@ -81,23 +74,22 @@ function handleClick() { browser.bookmarks.onRemoved.addListener(handleRemoved); } -browser.browserAction.onClicked.addListener(handleClick);</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +browser.browserAction.onClicked.addListener(handleClick); +``` -<p>{{Compat("webextensions.api.bookmarks.onRemoved")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</p> +{{Compat("webextensions.api.bookmarks.onRemoved")}} -<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.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -124,5 +116,4 @@ browser.browserAction.onClicked.addListener(handleClick);</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/bookmarks/remove/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/remove/index.md index 8e17a38a86..462f4b4526 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/remove/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/remove/index.md @@ -14,37 +14,35 @@ tags: - supprimer translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/remove --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La mĂ©thode <strong><code>bookmarks.remove()</code></strong> supprime un seul signet ou un dossier de signets vide.</p> +La mĂ©thode **`bookmarks.remove()`** supprime un seul signet ou un dossier de signets vide. -<div class="warning"> -<p><strong>Attention :</strong> Si votre extension tente de supprimer un signet du nĆud racine de lâarborescence de signets, lâappel dĂ©clenche une erreur avec le message suivant: "<em>La racine du signet ne peut pas ĂȘtre modifiĂ©e</em>" et le signet ne sera pas supprimĂ©.</p> -</div> +> **Attention :** Si votre extension tente de supprimer un signet du nĆud racine de lâarborescence de signets, lâappel dĂ©clenche une erreur avec le message suivant: "_La racine du signet ne peut pas ĂȘtre modifiĂ©e_" et le signet ne sera pas supprimĂ©. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removingBookmark = browser.bookmarks.remove( +```js +var removingBookmark = browser.bookmarks.remove( id // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>id</code></dt> - <dd>Un {{jsxref("string")}} spĂ©cifiant l'ID du signet ou du dossier vide Ă supprimer.</dd> -</dl> +- `id` + - : Un {{jsxref("string")}} spĂ©cifiant l'ID du signet ou du dossier vide Ă supprimer. -<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 accomplie sans arguments..Si le nĆud correspondant au paramĂštre <code>id</code> ne peut ĂȘtre trouvĂ© ou s'il s'agit d'un dossier non vide, la promesse est rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera accomplie sans arguments..Si le nĆud correspondant au paramĂštre `id` ne peut ĂȘtre trouvĂ© ou s'il s'agit d'un dossier non vide, la promesse est rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("Removed!"); } @@ -55,25 +53,22 @@ function onRejected(error) { var bookmarkId = "abcdefghijkl"; var removingBookmark = browser.bookmarks.remove(bookmarkId); -removingBookmark.then(onRemoved, onRejected);</pre> +removingBookmark.then(onRemoved, onRejected); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.bookmarks.remove")}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>{{Compat("webextensions.api.bookmarks.remove")}}</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/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -100,5 +95,4 @@ removingBookmark.then(onRemoved, onRejected);</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/bookmarks/removetree/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/removetree/index.md index 81cb531cfd..c486d554ff 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/removetree/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/removetree/index.md @@ -13,39 +13,37 @@ tags: - removeTree translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/removeTree --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La mĂ©thode <strong><code>bookmarks.removeTree()</code></strong> supprime rĂ©cursivement un dossier de signets et tout son contenu.</p> +La mĂ©thode **`bookmarks.removeTree()`** supprime rĂ©cursivement un dossier de signets et tout son contenu. -<div class="warning"> -<p><strong>Attention :</strong> Si votre extension tente de supprimer une arborescence de signets du nĆud racine de cette derniĂšre, l'appel dĂ©clenche une erreur avec le message suivant: "La racine de signet ne peut pas ĂȘtre modifiĂ©e" et le signet ne sera pas supprimĂ©.</p> -</div> +> **Attention :** Si votre extension tente de supprimer une arborescence de signets du nĆud racine de cette derniĂšre, l'appel dĂ©clenche une erreur avec le message suivant: "La racine de signet ne peut pas ĂȘtre modifiĂ©e" et le signet ne sera pas supprimĂ©. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removingTree = browser.bookmarks.removeTree( +```js +var removingTree = browser.bookmarks.removeTree( id // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>id</code></dt> - <dd>Un {{jsxref("string")}} spĂ©cifiant l'ID du noeud de dossier Ă supprimer avec ses descendants.</dd> -</dl> +- `id` + - : Un {{jsxref("string")}} spĂ©cifiant l'ID du noeud de dossier Ă supprimer avec ses descendants. -<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 sans arguments lorsque l'arbre a Ă©tĂ© retirĂ©.Si le noeud correspondant au paramĂštre <code>id</code> ne peut pas ĂȘtre trouvĂ©, la promesse est rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments lorsque l'arbre a Ă©tĂ© retirĂ©.Si le noeud correspondant au paramĂštre `id` ne peut pas ĂȘtre trouvĂ©, la promesse est rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple localise un dossier de signets nommĂ© "MDN" et le supprime avec tout son contenu.</p> +Cet exemple localise un dossier de signets nommĂ© "MDN" et le supprime avec tout son contenu. -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("bookmark item removed!"); } @@ -61,25 +59,22 @@ function removeMDN(searchResults) { } var searchingBookmarks = browser.bookmarks.search({ title: "MDN" }); -searchingBookmarks.then(removeMDN, onRejected);</pre> +searchingBookmarks.then(removeMDN, onRejected); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.bookmarks.removeTree")}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>{{Compat("webextensions.api.bookmarks.removeTree")}}</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/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</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 @@ -106,5 +101,4 @@ searchingBookmarks.then(removeMDN, onRejected);</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/bookmarks/search/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/search/index.md index 0e2955e21c..64e5dace86 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/search/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/search/index.md @@ -14,51 +14,49 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/search --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <strong><code>bookmarks.search()</code></strong> recherche les nĆuds d'arborescence de signets correspondant Ă la requĂȘte donnĂ©e.</p> +La fonction **`bookmarks.search()`** recherche les nĆuds d'arborescence de signets correspondant Ă la requĂȘte donnĂ©e. -<p>Cette fonction dĂ©clenche une exception si l'un des paramĂštres d'entrĂ©e n'est pas valide ou n'est pas d'un type appropriĂ© ; regardez dans la <a href="/fr/Add-ons/WebExtensions/Debugging">console</a> pour le message d'erreur. Les exceptions n'ont pas d'ID d'erreur et les messages eux-mĂȘmes peuvent changer, donc n'Ă©crivez pas de code qui essaie de les interprĂ©ter.</p> +Cette fonction dĂ©clenche une exception si l'un des paramĂštres d'entrĂ©e n'est pas valide ou n'est pas d'un type appropriĂ© ; regardez dans la [console](/fr/Add-ons/WebExtensions/Debugging) pour le message d'erreur. Les exceptions n'ont pas d'ID d'erreur et les messages eux-mĂȘmes peuvent changer, donc n'Ă©crivez pas de code qui essaie de les interprĂ©ter. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 searching = browser.bookmarks.search( +```js +var searching = browser.bookmarks.search( query // string or object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>query</code></dt> - <dd><p>Un {{jsxref("string")}} ou {{jsxref("object")}} dĂ©crivant la requĂȘte Ă effectuer.</p> - <p>Si la <code>query</code> est une chaĂźne, elle comprend zĂ©ro ou plusieurs termes de recherche. Les termes de recherche sont dĂ©limitĂ©s par des espaces et peuvent ĂȘtre placĂ©s entre guillemets pour permettre la recherche dans des expressions de plusieurs mots. Chaque terme de recherche correspond s'il correspond Ă une sous-chaĂźne dans l'URL ou le titre du signet. La correspondance est insensible Ă la casse. Pour qu'un signet corresponde Ă la requĂȘte, tous les termes de recherche de la requĂȘte doivent correspondre.</p> +- `query` - <p>Si la <code>query</code> un objet, elle possĂšde zĂ©ro ou plus des trois propriĂ©tĂ©s suivantes : <code>query</code>, <code>title</code>, et <code>url</code>, qui sont dĂ©crites ci-dessous. Pour qu'un signet corresponde Ă la requĂȘte, tous les termes de propriĂ©tĂ©s fournis doivent correspondre aux valeurs spĂ©cifiĂ©es.</p> + - : Un {{jsxref("string")}} ou {{jsxref("object")}} dĂ©crivant la requĂȘte Ă effectuer. - <dl> - <dt><code>query</code> {{optional_inline}}</dt> - <dd>Un {{jsxref("string")}} spĂ©cifiant un ou plusieurs termes Ă comparer; le format est identique Ă la forme de chaĂźne du paramĂštre du <code>query</code>. Si ce n'est pas une chaĂźne, une exception est levĂ©e.</dd> - <dt><code>url</code> {{optional_inline}}</dt> - <dd><p>Un {{jsxref("string")}} qui doit correspondre exactement Ă l'URL du signet. La correspondance est insensible Ă la casse et les barres obliques de fin sont ignorĂ©es.Si vous passez une URL invalide ici, la fonction lĂšvera une exception.</p> - </dd> - <dt><code>title</code> {{optional_inline}}</dt> - <dd>Un {{jsxref("string")}} Ceci doit correspondre exactement au titre du noeud de l'arbre du signet. La correspondance est sensible Ă la casse.</dd> - </dl> - </dd> -</dl> + Si la `query` est une chaĂźne, elle comprend zĂ©ro ou plusieurs termes de recherche. Les termes de recherche sont dĂ©limitĂ©s par des espaces et peuvent ĂȘtre placĂ©s entre guillemets pour permettre la recherche dans des expressions de plusieurs mots. Chaque terme de recherche correspond s'il correspond Ă une sous-chaĂźne dans l'URL ou le titre du signet. La correspondance est insensible Ă la casse. Pour qu'un signet corresponde Ă la requĂȘte, tous les termes de recherche de la requĂȘte doivent correspondre. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + Si la `query` un objet, elle possĂšde zĂ©ro ou plus des trois propriĂ©tĂ©s suivantes : `query`, `title`, et `url`, qui sont dĂ©crites ci-dessous. Pour qu'un signet corresponde Ă la requĂȘte, tous les termes de propriĂ©tĂ©s fournis doivent correspondre aux valeurs spĂ©cifiĂ©es. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera accompli avec un tableau d'objets {{WebExtAPIRef('bookmarks.BookmarkTreeNode')}}, chacun reprĂ©sentant un seul nĆud d'arbre de signet correspondant. Les rĂ©sultats sont renvoyĂ©s dans l'ordre de crĂ©ation des nĆuds. Le tableau est vide si aucun rĂ©sultat n'a Ă©tĂ© trouvĂ©.Le <code><a href="/fr/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode">BookmarkTreeNodes</a></code>âmĂȘme du type <code>"folder"</code> â renvoyĂ© par <code>bookmarks.search()</code> ne contiennent pas la propriĂ©tĂ© children. Pour obtenir un <code>BookmarkTreeNode</code> utilisez <code><a href="/fr/Add-ons/WebExtensions/API/bookmarks/getSubTree">bookmarks.getSubTree()</a></code>.</p> + - `query` {{optional_inline}} + - : Un {{jsxref("string")}} spĂ©cifiant un ou plusieurs termes Ă comparer; le format est identique Ă la forme de chaĂźne du paramĂštre du `query`. Si ce n'est pas une chaĂźne, une exception est levĂ©e. + - `url` {{optional_inline}} + - : Un {{jsxref("string")}} qui doit correspondre exactement Ă l'URL du signet. La correspondance est insensible Ă la casse et les barres obliques de fin sont ignorĂ©es.Si vous passez une URL invalide ici, la fonction lĂšvera une exception. + - `title` {{optional_inline}} + - : Un {{jsxref("string")}} Ceci doit correspondre exactement au titre du noeud de l'arbre du signet. La correspondance est sensible Ă la casse. -<h2 id="Exemple">Exemple</h2> +### Valeur retournĂ©e -<p>Cet exemple enregistre les ID de tous les signets :</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera accompli avec un tableau d'objets {{WebExtAPIRef('bookmarks.BookmarkTreeNode')}}, chacun reprĂ©sentant un seul nĆud d'arbre de signet correspondant. Les rĂ©sultats sont renvoyĂ©s dans l'ordre de crĂ©ation des nĆuds. Le tableau est vide si aucun rĂ©sultat n'a Ă©tĂ© trouvĂ©.Le [`BookmarkTreeNodes`](/fr/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode)âmĂȘme du type `"folder"` â renvoyĂ© par `bookmarks.search()` ne contiennent pas la propriĂ©tĂ© children. Pour obtenir un `BookmarkTreeNode` utilisez [`bookmarks.getSubTree()`](/fr/Add-ons/WebExtensions/API/bookmarks/getSubTree). -<pre class="brush: js">function onFulfilled(bookmarkItems) { +## Exemple + +Cet exemple enregistre les ID de tous les signets : + +```js +function onFulfilled(bookmarkItems) { for (item of bookmarkItems) { console.log(item.id); } @@ -70,11 +68,13 @@ function onRejected(error) { var searching = browser.bookmarks.search({}); -searching.then(onFulfilled, onRejected);</pre> +searching.then(onFulfilled, onRejected); +``` -<p>Cet exemple cherche Ă voir si l'onglet actuellement actif est marquĂ© d'un signet :</p> +Cet exemple cherche Ă voir si l'onglet actuellement actif est marquĂ© d'un signet : -<pre class="brush: js">function onFulfilled(bookmarkItems) { +```js +function onFulfilled(bookmarkItems) { if (bookmarkItems.length) { console.log("active tab is bookmarked"); } else { @@ -92,23 +92,21 @@ function checkActiveTab(tab) { } browser.browserAction.onClicked.addListener(checkActiveTab); -</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +``` -<p>{{Compat("webextensions.api.bookmarks.search")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</p> +{{Compat("webextensions.api.bookmarks.search")}} -<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.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -135,5 +133,4 @@ browser.browserAction.onClicked.addListener(checkActiveTab); // 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/bookmarks/update/index.md b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/update/index.md index 0bfaea33ef..b842453466 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/bookmarks/update/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/bookmarks/update/index.md @@ -13,49 +13,46 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/bookmarks/update --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p><strong><code>bookmarks.update()</code></strong> met Ă jour le titre et / ou l'URL d'un signet ou le nom d'un dossier de signets.</p> +**`bookmarks.update()`** met Ă jour le titre et / ou l'URL d'un signet ou le nom d'un dossier de signets. -<div class="warning"> -<p><strong>Attention :</strong> Si votre extension tente de mettre Ă jour un signet dans le nĆud racine de l'arborescence de signets, l'appel dĂ©clenche une erreur avec le message suivant: "La racine du signet ne peut pas ĂȘtre modifiĂ©e" et le signet ne sera pas mis Ă jour.</p> -</div> +> **Attention :** Si votre extension tente de mettre Ă jour un signet dans le nĆud racine de l'arborescence de signets, l'appel dĂ©clenche une erreur avec le message suivant: "La racine du signet ne peut pas ĂȘtre modifiĂ©e" et le signet ne sera pas mis Ă jour. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 updating = browser.bookmarks.update( +```js +var updating = browser.bookmarks.update( id, // string changes // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>id</code></dt> - <dd>Un {{jsxref("string")}} spĂ©cifiant l'ID du dossier de signet ou de dossier de signets Ă mettre Ă jour.</dd> - <dt><code>changes</code></dt> - <dd><p>Un {{jsxref("object")}} spĂ©cifiant les changements Ă appliquer, avec une combinaison des champs suivants. Tous les Ă©lĂ©ments non spĂ©cifiĂ©s ne sont pas modifiĂ©s dans le signet ou le dossier rĂ©fĂ©rencĂ© :</p> - <dl> - <dt><code>title</code> {{optional_inline}}</dt> - <dd>Un {{jsxref("string")}} contenant le nouveau titre du signet, ou le nouveau nom du dossier si l'<code>id</code> fait rĂ©fĂ©rence Ă un dossier.</dd> - <dt><code>url</code> {{optional_inline}}</dt> - <dd>Un {{jsxref("string")}} fournissant une nouvelle URL pour le signet.</dd> - </dl> - </dd> -</dl> +- `id` + - : Un {{jsxref("string")}} spĂ©cifiant l'ID du dossier de signet ou de dossier de signets Ă mettre Ă jour. +- `changes` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : Un {{jsxref("object")}} spĂ©cifiant les changements Ă appliquer, avec une combinaison des champs suivants. Tous les Ă©lĂ©ments non spĂ©cifiĂ©s ne sont pas modifiĂ©s dans le signet ou le dossier rĂ©fĂ©rencĂ© : -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera satisfaite avec un seul objet <a href="/fr/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode"><code>bookmarks.BookmarkTreeNode</code></a> reprĂ©sentant le signet mis Ă jour. Si l'Ă©lĂ©ment de signet correspondant au paramĂštre <code>id</code> ne peut pas ĂȘtre trouvĂ©, la promesse est rejetĂ©e.</p> + - `title` {{optional_inline}} + - : Un {{jsxref("string")}} contenant le nouveau titre du signet, ou le nouveau nom du dossier si l'`id` fait rĂ©fĂ©rence Ă un dossier. + - `url` {{optional_inline}} + - : Un {{jsxref("string")}} fournissant une nouvelle URL pour le signet. -<h2 id="Exemples">Exemples</h2> +### Valeur retournĂ©e -<p>Cet exemple renomme tous les dossiers nommĂ©s "MDN" en "Mozilla Developer Network (MDN)".</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera satisfaite avec un seul objet [`bookmarks.BookmarkTreeNode`](/fr/Add-ons/WebExtensions/API/bookmarks/BookmarkTreeNode) reprĂ©sentant le signet mis Ă jour. Si l'Ă©lĂ©ment de signet correspondant au paramĂštre `id` ne peut pas ĂȘtre trouvĂ©, la promesse est rejetĂ©e. -<pre class="brush: js">function onFulfilled(bookmarkItem) { +## Exemples + +Cet exemple renomme tous les dossiers nommĂ©s "MDN" en "Mozilla Developer Network (MDN)". + +```js +function onFulfilled(bookmarkItem) { console.log(bookmarkItem.title); } @@ -76,23 +73,22 @@ function updateFolders(items) { } var searching = browser.bookmarks.search({ title: "MDN" }); -searching.then(updateFolders, onRejected);</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +searching.then(updateFolders, onRejected); +``` -<p>{{Compat("webextensions.api.bookmarks.update")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/bookmarks"><code>chrome.bookmarks</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json"><code>bookmarks.json</code></a> dans le code Chromium.</p> +{{Compat("webextensions.api.bookmarks.update")}} -<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.bookmarks`](https://developer.chrome.com/extensions/bookmarks). Cette documentation provient de [`bookmarks.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/bookmarks.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -119,5 +115,4 @@ searching.then(updateFolders, onRejected);</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/browseraction/colorarray/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/colorarray/index.md index 105713c961..07857eb111 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/colorarray/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/colorarray/index.md @@ -13,36 +13,32 @@ tags: - browserAction translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/ColorArray --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<h2 id="Type">Type</h2> +## Type -<p>Un tableau de quatre nombres entiers entre 0-255 dĂ©finie une couleur RGBA. Les quatres couleurs spĂ©cifient les canaux suivants :</p> +Un tableau de quatre nombres entiers entre 0-255 dĂ©finie une couleur RGBA. Les quatres couleurs spĂ©cifient les canaux suivants : -<ol> - <li>Rouge</li> - <li>Vert</li> - <li>Bleu</li> - <li>Alpha (opacitĂ©).</li> -</ol> +1. Rouge +2. Vert +3. Bleu +4. Alpha (opacitĂ©). -<p>Par exemple , le rouge opaque est <code>[255, 0, 0, 255]</code>.</p> +Par exemple , le rouge opaque est `[255, 0, 0, 255]`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserAction.ColorArray")}}</p> +{{Compat("webextensions.api.browserAction.ColorArray")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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 @@ -69,5 +65,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/ColorArray // 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/browseraction/disable/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/disable/index.md index 1b44f9386e..11092ccff7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/disable/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/disable/index.md @@ -13,56 +13,56 @@ tags: - disable translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/disable --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©sactive l'action du navigateur pour un onglet, ce qui signifie qu'il ne peut pas ĂȘtre cliquĂ© lorsque cet onglet est actif.</p> +DĂ©sactive l'action du navigateur pour un onglet, ce qui signifie qu'il ne peut pas ĂȘtre cliquĂ© lorsque cet onglet est actif. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.browserAction.disable( +```js +browser.browserAction.disable( tabId // optional integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'identifiant (ID) de l'onglet pour lequel vous souhaitez dĂ©sactiver l'action du navigateur.</dd> -</dl> +- `tabId`{{optional_inline}} + - : `integer`. L'identifiant (ID) de l'onglet pour lequel vous souhaitez dĂ©sactiver l'action du navigateur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserAction.disable")}}</p> +{{Compat("webextensions.api.browserAction.disable")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©sactive l'action du navigateur lorsque vous cliquez et rĂ©activez-le chaque fois qu'un nouveau onglet est ouvert :</p> +DĂ©sactive l'action du navigateur lorsque vous cliquez et rĂ©activez-le chaque fois qu'un nouveau onglet est ouvert : -<pre class="brush: js">browser.tabs.onCreated.addListener(() => { +```js +browser.tabs.onCreated.addListener(() => { browser.browserAction.enable(); }); -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { browser.browserAction.disable(); }); -</pre> +``` -<p>DĂ©sactivez l'action du navigateur uniquement pour l'onglet actif :</p> +DĂ©sactivez l'action du navigateur uniquement pour l'onglet actif : -<pre class="brush: js">browser.browserAction.onClicked.addListener((tab) => { +```js +browser.browserAction.onClicked.addListener((tab) => { browser.browserAction.disable(tab.id); -});</pre> - -<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/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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 @@ -89,5 +89,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/browseraction/enable/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/enable/index.md index f7e8f6139c..b7593aded9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/enable/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/enable/index.md @@ -13,52 +13,50 @@ tags: - browserAction translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/enable --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Active l'action du navigateur pour un onglet. Par dĂ©faut, les actions du navigateur sont activĂ©es pour tous les onglets.</p> +Active l'action du navigateur pour un onglet. Par dĂ©faut, les actions du navigateur sont activĂ©es pour tous les onglets. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.browserAction.enable( +```js +browser.browserAction.enable( tabId // optional integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'identifiant (ID) de l'onglet pour lequel vous souhaitez activer l'action du navigateur.</dd> -</dl> +- `tabId`{{optional_inline}} + - : `integer`. L'identifiant (ID) de l'onglet pour lequel vous souhaitez activer l'action du navigateur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserAction.enable")}}</p> +{{Compat("webextensions.api.browserAction.enable")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p> DĂ©sactivez l'option du navigateur lorsque vous cliquez et rĂ©activez-le chaque fois qu'un nouveau onglet est ouvert :</p> +DĂ©sactivez l'option du navigateur lorsque vous cliquez et rĂ©activez-le chaque fois qu'un nouveau onglet est ouvert : -<pre class="brush: js">browser.tabs.onCreated.addListener(() => { +```js +browser.tabs.onCreated.addListener(() => { browser.browserAction.enable(); }); -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { browser.browserAction.disable(); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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 @@ -85,5 +83,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/browseraction/getbadgebackgroundcolor/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/getbadgebackgroundcolor/index.md index 665501decf..23b461fc6f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/getbadgebackgroundcolor/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/getbadgebackgroundcolor/index.md @@ -13,49 +13,50 @@ tags: - getBadgeBackgroundColor translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/getBadgeBackgroundColor --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient la couleur d'arriĂšre plan du badge de l'action du navigateur.</p> +Obtient la couleur d'arriĂšre plan du badge de l'action du navigateur. -<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">browser.browserAction.getBadgeBackgroundColor ( +```js +browser.browserAction.getBadgeBackgroundColor ( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<p><code>details</code></p> +`details` -<p><code>object</code></p> - <dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Specifie l'onglet pour obtenir la couleur d'arriĂšre-plan du badge.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. SpĂ©cifie la fenĂȘtre Ă partir de laquelle obtenir la couleur de fond du badge.</dd> - </dl> +`object` -<ul> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous les deux fournis, la fonction Ă©choue..</li> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous les deux omis, la couleur de fond du badge global est retournĂ©e.</li> -</ul> +- `tabId`{{optional_inline}} + - : `integer`. Specifie l'onglet pour obtenir la couleur d'arriĂšre-plan du badge. +- `windowId`{{optional_inline}} + - : `integer`. SpĂ©cifie la fenĂȘtre Ă partir de laquelle obtenir la couleur de fond du badge. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +<!----> -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec la couleur rĂ©cupĂ©rĂ©e en tant que {{WebExtAPIRef('browserAction.ColorArray')}}.</p> +- Si `windowId` et `tabId` sont tous les deux fournis, la fonction Ă©choue.. +- Si `windowId` et `tabId` sont tous les deux omis, la couleur de fond du badge global est retournĂ©e. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.browserAction.getBadgeBackgroundColor",2)}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec la couleur rĂ©cupĂ©rĂ©e en tant que {{WebExtAPIRef('browserAction.ColorArray')}}. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Enregistrez la couleur de fond du badge :</p> +{{Compat("webextensions.api.browserAction.getBadgeBackgroundColor",2)}} -<pre class="brush: js">function onGot(color) { +## Exemples + +Enregistrez la couleur de fond du badge : + +```js +function onGot(color) { console.log(color); } @@ -63,19 +64,18 @@ function onFailure(error) { console.log(error); } -browser.browserAction.getBadgeBackgroundColor({}).then(onGot, onFailure);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.browserAction.getBadgeBackgroundColor({}).then(onGot, onFailure); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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 @@ -102,5 +102,4 @@ browser.browserAction.getBadgeBackgroundColor({}).then(onGot, onFailure);</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/browseraction/getbadgetext/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/getbadgetext/index.md index 96f04dba54..d368cc8a1c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/getbadgetext/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/getbadgetext/index.md @@ -13,68 +13,66 @@ tags: - getBadgeText translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/getBadgeText --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient le texte du badge de l'action du navigateur.</p> +Obtient le texte du badge de l'action du navigateur. -<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 gettingText = browser.browserAction.getBadgeText ( +```js +var gettingText = browser.browserAction.getBadgeText ( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code></p> - <dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. SpĂ©cifie l'onglet pour obtenir le texte du badge.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. SpĂ©cifie la fenĂȘtre Ă partir de laquelle obtenir le texte du badge.</dd> - </dl> - </dd> -</dl> +- `details` -<ul> - <li>Si windowId et tabId sont tous les deux fournis, la fonction Ă©choue.</li> - <li>Si windowId et tabId sont tous les deux omis, le texte global du badge est renvoyĂ©.</li> -</ul> + - : `object` -<h3 id="Valeur_de_retour">Valeur de retour</h3> + - `tabId`{{optional_inline}} + - : `integer`. SpĂ©cifie l'onglet pour obtenir le texte du badge. + - `windowId`{{optional_inline}} + - : `integer`. SpĂ©cifie la fenĂȘtre Ă partir de laquelle obtenir le texte du badge. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec une chaĂźne contenant le texte du badge.</p> +<!----> -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- Si windowId et tabId sont tous les deux fournis, la fonction Ă©choue. +- Si windowId et tabId sont tous les deux omis, le texte global du badge est renvoyĂ©. -<p>{{Compat("webextensions.api.browserAction.getBadgeText",2)}}</p> +### Valeur de retour -<h2 id="Exemples">Exemples</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec une chaĂźne contenant le texte du badge. -<p>Enregistrez le texte du badge : </p> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function gotBadgeText(text) { +{{Compat("webextensions.api.browserAction.getBadgeText",2)}} + +## Exemples + +Enregistrez le texte du badge : + +```js +function gotBadgeText(text) { console.log(text); } var gettingBadgeText = browser.browserAction.getBadgeText({}); -gettingBadgeText.then(gotBadgeText);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +gettingBadgeText.then(gotBadgeText); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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 @@ gettingBadgeText.then(gotBadgeText);</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/browseraction/getbadgetextcolor/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/getbadgetextcolor/index.md index d1caee0152..366cad5e15 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/getbadgetextcolor/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/getbadgetextcolor/index.md @@ -3,55 +3,54 @@ title: browserAction.getBadgeTextColor() slug: Mozilla/Add-ons/WebExtensions/API/browserAction/getBadgeTextColor translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/getBadgeTextColor --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient la couleur du texte du badge de l'action du navigateur.</p> +Obtient la couleur du texte du badge de l'action du navigateur. -<p>A partir de Firefox 63, Ă moins que la couleur du texte du badge ne soit explicitement dĂ©finie Ă l'aide de {{WebExtAPIRef("browserAction.setBadgeTextColor()")}}, la couleur du texte du badge sera automatiquement dĂ©finie en noir ou blanc afin d'optimiser le contraste avec la couleur de fond du badge spĂ©cifiĂ©. Par exemple, si vous dĂ©finissez la couleur de fond du badge sur blanc, la couleur par dĂ©faut du texte du badge sera dĂ©finie sur noir, et vice versa.</p> +A partir de Firefox 63, Ă moins que la couleur du texte du badge ne soit explicitement dĂ©finie Ă l'aide de {{WebExtAPIRef("browserAction.setBadgeTextColor()")}}, la couleur du texte du badge sera automatiquement dĂ©finie en noir ou blanc afin d'optimiser le contraste avec la couleur de fond du badge spĂ©cifiĂ©. Par exemple, si vous dĂ©finissez la couleur de fond du badge sur blanc, la couleur par dĂ©faut du texte du badge sera dĂ©finie sur noir, et vice versa. -<p>Les autres navigateurs utilisent toujours une couleur de texte blanche.</p> +Les autres navigateurs utilisent toujours une couleur de texte blanche. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.browserAction.getBadgeTextColor( +```js +browser.browserAction.getBadgeTextColor( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code></p> - <dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. SpĂ©cifie l'onglet pour obtenir la couleur du texte du badge.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. SpĂ©cifie la fenĂȘtre Ă partir de laquelle obtenir la couleur du texte du badge.</dd> - </dl> - </dd> -</dl> +- `details` -<ul> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous deux fournis, la fonction Ă©choue.</li> - <li>SI <code>windowId</code> et <code>tabId</code> sont tous deux omis, la couleur globale du texte du badge est retournĂ©e.</li> -</ul> + - : `object` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - `tabId`{{optional_inline}} + - : `integer`. SpĂ©cifie l'onglet pour obtenir la couleur du texte du badge. + - `windowId`{{optional_inline}} + - : `integer`. SpĂ©cifie la fenĂȘtre Ă partir de laquelle obtenir la couleur du texte du badge. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise</a></code> qui sera remplie avec la couleur rĂ©cupĂ©rĂ©e comme un {{WebExtAPIRef('browserAction.ColorArray')}}.</p> +<!----> -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- Si `windowId` et `tabId` sont tous deux fournis, la fonction Ă©choue. +- SI `windowId` et `tabId` sont tous deux omis, la couleur globale du texte du badge est retournĂ©e. -<p>{{Compat("webextensions.api.browserAction.getBadgeTextColor",2)}}</p> +### Valeur retournĂ©e -<h2 id="Exemples">Exemples</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise) qui sera remplie avec la couleur rĂ©cupĂ©rĂ©e comme un {{WebExtAPIRef('browserAction.ColorArray')}}. -<p>Enregistrer la couleur du texte du badge :</p> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function onGot(color) { +{{Compat("webextensions.api.browserAction.getBadgeTextColor",2)}} + +## Exemples + +Enregistrer la couleur du texte du badge : + +```js +function onGot(color) { console.log(color); } @@ -59,17 +58,16 @@ function onFailure(error) { console.log(error); } -browser.browserAction.getBadgeTextColor({}).then(onGot, onFailure);</pre> - -<p>{{WebExtExamples}}</p> +browser.browserAction.getBadgeTextColor({}).then(onGot, onFailure); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.json</code></a> dans le code de Chromium code.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json) dans le code de Chromium code. -<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 @@ -96,5 +94,4 @@ browser.browserAction.getBadgeTextColor({}).then(onGot, onFailure);</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/browseraction/getpopup/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/getpopup/index.md index e641899dc9..62cb67125b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/getpopup/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/getpopup/index.md @@ -13,68 +13,66 @@ tags: - getPopup translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/getPopup --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient le document HTML dĂ©fini comme la popup pour cette action du navigateur.</p> +Obtient le document HTML dĂ©fini comme la popup pour cette action du navigateur. -<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 gettingPopup = browser.browserAction.getPopup( +```js +var gettingPopup = browser.browserAction.getPopup( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'onglet dont le menu dĂ©roulant reçoit un entier.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Les fenĂȘtres dont le popup Ă obtenir.</dd> - </dl> - </dd> -</dl> +- `details` -<ul> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous les deux fournis, la fonction Ă©choue.</li> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous deux omis, la fenĂȘtre contextuelle globale est retournĂ©e.</li> -</ul> + - : `object`. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - `tabId`{{optional_inline}} + - : `integer`. L'onglet dont le menu dĂ©roulant reçoit un entier. + - `windowId`{{optional_inline}} + - : `integer`. Les fenĂȘtres dont le popup Ă obtenir. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec une chaine cntenant l'URL du document contextuel. Ce sera une URL entiĂšrement qualifiĂ©e, telle que <code>moz-extension://d1d8a2eb-fe60-f646-af30-a866c5b39942/popups/popup2.html</code>.</p> +<!----> -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- Si `windowId` et `tabId` sont tous les deux fournis, la fonction Ă©choue. +- Si `windowId` et `tabId` sont tous deux omis, la fenĂȘtre contextuelle globale est retournĂ©e. -<p>{{Compat("webextensions.api.browserAction.getPopup",2)}}</p> +### Valeur retournĂ©e -<h2 id="Exemples">Exemples</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec une chaine cntenant l'URL du document contextuel. Ce sera une URL entiĂšrement qualifiĂ©e, telle que `moz-extension://d1d8a2eb-fe60-f646-af30-a866c5b39942/popups/popup2.html`. -<p>Obtenez l'URL du Popup:</p> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function gotPopup(popupURL) { +{{Compat("webextensions.api.browserAction.getPopup",2)}} + +## Exemples + +Obtenez l'URL du Popup: + +```js +function gotPopup(popupURL) { console.log(popupURL) } var gettingPopup = browser.browserAction.getPopup({}); -gettingPopup.then(gotPopup); </pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +gettingPopup.then(gotPopup); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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 @@ gettingPopup.then(gotPopup); </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/browseraction/gettitle/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/gettitle/index.md index b18eb58a0b..6e2bc02afe 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/gettitle/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/gettitle/index.md @@ -13,53 +13,52 @@ tags: - getTitle translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/getTitle --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient le titre de l'action du navigateur.</p> +Obtient le titre de l'action du navigateur. -<p>Tout comme vous pouvez dĂ©finir le titre par onglet en utilisant {{WebExtAPIRef("browserAction.setTitle()")}}, vous pouvez donc rĂ©cupĂ©rer un titre spĂ©cifique Ă un onglet en passant l'ID de l'onglet dans cette fonction.</p> +Tout comme vous pouvez dĂ©finir le titre par onglet en utilisant {{WebExtAPIRef("browserAction.setTitle()")}}, vous pouvez donc rĂ©cupĂ©rer un titre spĂ©cifique Ă un onglet en passant l'ID de l'onglet dans cette fonction. -<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 gettingTitle = browser.browserAction.getTitle( +```js +var gettingTitle = browser.browserAction.getTitle( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code><p> - <dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. SpĂ©cifiez l'onglet pour obtenir le titre.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. SpĂ©cifiez la fenĂȘtre Ă partir de laquelle vous souhaitez obtenir le titre.</dd> - </dl> - </dd> -</dl> +- `details` -<ul> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous deux fournis, la fonction Ă©choue et la promesse qu'elle renvoie est rejetĂ©e.</li> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous les deux omis, le titre global est renvoyĂ©.</li> -</ul> + - : `object` -<h3 id="Return_value">Return value</h3> + - `tabId`{{optional_inline}} + - : `integer`. SpĂ©cifiez l'onglet pour obtenir le titre. + - `windowId`{{optional_inline}} + - : `integer`. SpĂ©cifiez la fenĂȘtre Ă partir de laquelle vous souhaitez obtenir le titre. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec une chaĂźne contenant le titre de l'action du navigateur.</p> +<!----> -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- Si `windowId` et `tabId` sont tous deux fournis, la fonction Ă©choue et la promesse qu'elle renvoie est rejetĂ©e. +- Si `windowId` et `tabId` sont tous les deux omis, le titre global est renvoyĂ©. -<p>{{Compat("webextensions.api.browserAction.getTitle",2)}}</p> +### Return value -<h2 id="Exemples">Exemples</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec une chaĂźne contenant le titre de l'action du navigateur. -<p>Ce code change le titre entre "ceci" et "cela" chaque fois que l'utilisateur clique sur l'action du navigateur :</p> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function toggleTitle(title) { +{{Compat("webextensions.api.browserAction.getTitle",2)}} + +## Exemples + +Ce code change le titre entre "ceci" et "cela" chaque fois que l'utilisateur clique sur l'action du navigateur : + +```js +function toggleTitle(title) { if (title == "this") { browser.browserAction.setTitle({title: "that"}); } else { @@ -67,22 +66,21 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/getTitle } } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { var gettingTitle = browser.browserAction.getTitle({}); gettingTitle.then(toggleTitle); -});</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/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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 @@ -109,5 +107,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/browseraction/imagedatatype/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/imagedatatype/index.md index a93726876c..9e1913e5e9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/imagedatatype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/imagedatatype/index.md @@ -13,29 +13,27 @@ tags: - browserAction translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/ImageDataType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DonnĂ©es en pixels pour une image. Doit ĂȘtre un objet <code><a href="/fr/docs/Web/API/ImageData">ImageData</a></code> (par exemple, un Ă©lĂ©ment {{htmlelement("canvas")}}).</p> +DonnĂ©es en pixels pour une image. Doit ĂȘtre un objet [`ImageData`](/fr/docs/Web/API/ImageData) (par exemple, un Ă©lĂ©ment {{htmlelement("canvas")}}). -<h2 id="Type">Type</h2> +## Type -<p>Un objet <code><a href="/fr/docs/Web/API/ImageData">ImageData</a></code>.</p> +Un objet [`ImageData`](/fr/docs/Web/API/ImageData). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserAction.ImageDataType")}}</p> +{{Compat("webextensions.api.browserAction.ImageDataType")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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 @@ -62,5 +60,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/ImageDataType // 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/browseraction/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/index.md index ea193dbd49..c649767225 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/index.md @@ -12,91 +12,81 @@ tags: - browserAction translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction --- -<div>{{AddonSidebar}}</div> - -<p>Ajoute un bouton Ă la barre d'outils du navigateur.</p> - -<p>Une <a href="/fr/Add-ons/WebExtensions/Browser_action">action du navigateur</a> est un bouton dans la barre d'outils du navigateur.</p> - -<p>Vous pouvez associer une fenĂȘtre contextuelle au bouton. La fenĂȘtre contextuelle est spĂ©cifĂ©e en utilisant HTML, CSS et JavaScript, tout comme une page Web normale. JavaScript en cours d'exĂ©cution dans le popup accĂšde Ă toutes les mĂȘmes API WebExtension que vos scripts de fond, mais son contexte global est le popup, et non la page courrante affichĂ©e dans le navigateur. Pour effectuer les pages Web, vous devez communiquer avec eux par des <a href="/fr/Add-ons/WebExtensions/Modify_a_web_page#Messaging">messages</a>.</p> - -<p>Si vous spĂ©cifiez une fenĂȘtre contextuelle, elle sera affichĂ©e â et le contenu sera chargĂ© â quand l'utilisateur clique sur l'icĂŽne. Si vous ne spĂ©cifiez pas de fenĂȘtre contextuelle, alors lorsque l'utilisateur clique sur l'icĂŽne, un Ă©vĂ©nement est envoyĂ© Ă votre extension.</p> - -<p>Vous pouvez dĂ©finir la plupart des propriĂ©tĂ©s d'une action de navigateur en utilisant la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action">browser_action</a></code> dans le manifest.json.</p> - -<p>Quand l'API <code>browserAction</code>, vous pouvez :</p> - -<ul> - <li>Utiliser {{WebExtAPIRef("browserAction.onClicked")}} pour Ă©couter les clics sur l'icĂŽne.</li> - <li>Obtenir et dĂ©finir les propriĂ©tĂ©s de l'icĂŽne â icĂŽne, titre, popup, etc. Vous pouvez les dĂ©finir globalement dans tous les onglets ou pour un onglet spĂ©cifique en passant l'ID de l'onglet comme un argument supplĂ©mentaire.</li> -</ul> - -<h2 id="Types">Types</h2> - -<dl> - <dt>{{WebExtAPIRef("browserAction.ColorArray")}}</dt> - <dd>Un tableau de quatre nombres entiers entre 0-255 dĂ©finie une couleur RGBA.</dd> - <dt>{{WebExtAPIRef("browserAction.ImageDataType")}}</dt> - <dd>DonnĂ©es en pixels pour une image. Doit ĂȘtre un objet <code><a href="/fr/docs/Web/API/ImageData">ImageData</a></code> (par exemple, un Ă©lĂ©ment {{htmlelement("canvas")}} ).</dd> -</dl> - -<h2 id="Fonctions">Fonctions</h2> - -<dl> - <dt>{{WebExtAPIRef("browserAction.setTitle()")}}</dt> - <dd>DĂ©finit le titre de l'action du navigateur. Cela sera affichĂ© dans une info-bulle.</dd> - <dt>{{WebExtAPIRef("browserAction.getTitle()")}}</dt> - <dd>Obtient le titre de l'action du navigateur.</dd> - <dt>{{WebExtAPIRef("browserAction.setIcon()")}}</dt> - <dd>DĂ©finit l'icĂŽne de l'action du navigateur.</dd> - <dt>{{WebExtAPIRef("browserAction.setPopup()")}}</dt> - <dd>DĂ©finit le document HTML Ă ouvrir en popup lorsque l'utilisateur clique sur l'icĂŽne de l'action du navigateur.</dd> - <dt>{{WebExtAPIRef("browserAction.getPopup()")}}</dt> - <dd>Permet de dĂ©finir le document HTML en tant que popup de l'action du navigateur.</dd> - <dt>{{WebExtAPIRef("browserAction.openPopup()")}}</dt> - <dd>Ouvrez le popup de l'action du navigateur.</dd> - <dt>{{WebExtAPIRef("browserAction.setBadgeText()")}}</dt> - <dd>DĂ©finit le texte du badge de l'action du navigateur. Le badge est affichĂ© en haut de l'icĂŽne.</dd> - <dt>{{WebExtAPIRef("browserAction.getBadgeText()")}}</dt> - <dd>Obtient le texte du badge de l'action du navigateur.</dd> - <dt>{{WebExtAPIRef("browserAction.setBadgeBackgroundColor()")}}</dt> - <dd>DĂ©finit la couleur de fond du badge.</dd> - <dt>{{WebExtAPIRef("browserAction.getBadgeBackgroundColor()")}}</dt> - <dd>Obtient la couleur de fond du badge.</dd> - <dt>{{WebExtAPIRef("browserAction.setBadgeTextColor()")}}</dt> - <dd>DĂ©finit la couleur du texte du badge.</dd> - <dt>{{WebExtAPIRef("browserAction.getBadgeTextColor()")}}</dt> - <dd>Obtient la couleur du texte du badge.</dd> - <dt>{{WebExtAPIRef("browserAction.enable()")}}</dt> - <dd>Active l'action du navigateur pour un onglet. Par dĂ©faut, les actions du navigateur sont activĂ©es pour tous les onglets.</dd> - <dt>{{WebExtAPIRef("browserAction.disable()")}}</dt> - <dd>DĂ©sactive l'action du navigateur pour un onglet, ce qui signifie qu'il ne peut pas ĂȘtre cliquĂ© lorsque cet onglet est actif.</dd> - <dt>{{WebExtAPIRef("browserAction.isEnabled()")}}</dt> - <dd>VĂ©rifie si l'action du navigateur est activĂ©e ou non.</dd> -</dl> - -<h2 id="EvĂ©nements">EvĂ©nements</h2> - -<dl> - <dt>{{WebExtAPIRef("browserAction.onClicked")}}</dt> - <dd>Action quand l'icone d'action du navigateur est cliquĂ©. Cet Ă©vĂ©nement ne dĂ©clenchera pas si l'action du navigateur comporte une fenĂȘtre contextuelle.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.browserAction")}}</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/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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}} + +Ajoute un bouton Ă la barre d'outils du navigateur. + +Une [action du navigateur](/fr/Add-ons/WebExtensions/Browser_action) est un bouton dans la barre d'outils du navigateur. + +Vous pouvez associer une fenĂȘtre contextuelle au bouton. La fenĂȘtre contextuelle est spĂ©cifĂ©e en utilisant HTML, CSS et JavaScript, tout comme une page Web normale. JavaScript en cours d'exĂ©cution dans le popup accĂšde Ă toutes les mĂȘmes API WebExtension que vos scripts de fond, mais son contexte global est le popup, et non la page courrante affichĂ©e dans le navigateur. Pour effectuer les pages Web, vous devez communiquer avec eux par des [messages](/fr/Add-ons/WebExtensions/Modify_a_web_page#Messaging). + +Si vous spĂ©cifiez une fenĂȘtre contextuelle, elle sera affichĂ©e â et le contenu sera chargĂ© â quand l'utilisateur clique sur l'icĂŽne. Si vous ne spĂ©cifiez pas de fenĂȘtre contextuelle, alors lorsque l'utilisateur clique sur l'icĂŽne, un Ă©vĂ©nement est envoyĂ© Ă votre extension. + +Vous pouvez dĂ©finir la plupart des propriĂ©tĂ©s d'une action de navigateur en utilisant la clĂ© [`browser_action`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action) dans le manifest.json. + +Quand l'API `browserAction`, vous pouvez : + +- Utiliser {{WebExtAPIRef("browserAction.onClicked")}} pour Ă©couter les clics sur l'icĂŽne. +- Obtenir et dĂ©finir les propriĂ©tĂ©s de l'icĂŽne â icĂŽne, titre, popup, etc. Vous pouvez les dĂ©finir globalement dans tous les onglets ou pour un onglet spĂ©cifique en passant l'ID de l'onglet comme un argument supplĂ©mentaire. + +## Types + +- {{WebExtAPIRef("browserAction.ColorArray")}} + - : Un tableau de quatre nombres entiers entre 0-255 dĂ©finie une couleur RGBA. +- {{WebExtAPIRef("browserAction.ImageDataType")}} + - : DonnĂ©es en pixels pour une image. Doit ĂȘtre un objet [`ImageData`](/fr/docs/Web/API/ImageData) (par exemple, un Ă©lĂ©ment {{htmlelement("canvas")}} ). + +## Fonctions + +- {{WebExtAPIRef("browserAction.setTitle()")}} + - : DĂ©finit le titre de l'action du navigateur. Cela sera affichĂ© dans une info-bulle. +- {{WebExtAPIRef("browserAction.getTitle()")}} + - : Obtient le titre de l'action du navigateur. +- {{WebExtAPIRef("browserAction.setIcon()")}} + - : DĂ©finit l'icĂŽne de l'action du navigateur. +- {{WebExtAPIRef("browserAction.setPopup()")}} + - : DĂ©finit le document HTML Ă ouvrir en popup lorsque l'utilisateur clique sur l'icĂŽne de l'action du navigateur. +- {{WebExtAPIRef("browserAction.getPopup()")}} + - : Permet de dĂ©finir le document HTML en tant que popup de l'action du navigateur. +- {{WebExtAPIRef("browserAction.openPopup()")}} + - : Ouvrez le popup de l'action du navigateur. +- {{WebExtAPIRef("browserAction.setBadgeText()")}} + - : DĂ©finit le texte du badge de l'action du navigateur. Le badge est affichĂ© en haut de l'icĂŽne. +- {{WebExtAPIRef("browserAction.getBadgeText()")}} + - : Obtient le texte du badge de l'action du navigateur. +- {{WebExtAPIRef("browserAction.setBadgeBackgroundColor()")}} + - : DĂ©finit la couleur de fond du badge. +- {{WebExtAPIRef("browserAction.getBadgeBackgroundColor()")}} + - : Obtient la couleur de fond du badge. +- {{WebExtAPIRef("browserAction.setBadgeTextColor()")}} + - : DĂ©finit la couleur du texte du badge. +- {{WebExtAPIRef("browserAction.getBadgeTextColor()")}} + - : Obtient la couleur du texte du badge. +- {{WebExtAPIRef("browserAction.enable()")}} + - : Active l'action du navigateur pour un onglet. Par dĂ©faut, les actions du navigateur sont activĂ©es pour tous les onglets. +- {{WebExtAPIRef("browserAction.disable()")}} + - : DĂ©sactive l'action du navigateur pour un onglet, ce qui signifie qu'il ne peut pas ĂȘtre cliquĂ© lorsque cet onglet est actif. +- {{WebExtAPIRef("browserAction.isEnabled()")}} + - : VĂ©rifie si l'action du navigateur est activĂ©e ou non. + +## EvĂ©nements + +- {{WebExtAPIRef("browserAction.onClicked")}} + - : Action quand l'icone d'action du navigateur est cliquĂ©. Cet Ă©vĂ©nement ne dĂ©clenchera pas si l'action du navigateur comporte une fenĂȘtre contextuelle. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.browserAction")}} + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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 @@ -123,5 +113,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction // 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/browseraction/isenabled/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/isenabled/index.md index 851dc1e386..f71c30074e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/isenabled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/isenabled/index.md @@ -12,59 +12,58 @@ tags: - isEnabled translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/isEnabled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Renvoie <code>true</code> si l'action du navigateur est activĂ©e.</p> +Renvoie `true` si l'action du navigateur est activĂ©e. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">let gettingIsEnabled = browser.browserAction.isEnabled( +```js +let gettingIsEnabled = browser.browserAction.isEnabled( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Un objet contenant Ă©ventuellement le <code>tabId</code> ou <code>windowId</code> Ă vĂ©rifier.</p> - <dl> - <dt><code>tabId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. ID d'un onglet Ă vĂ©rifier</dd> - <dt><code>windowId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. ID d'une fenĂȘtre Ă vĂ©rifier.</dd> - </dl> - </dd> -</dl> +- `details` + - : `object`. Un objet contenant Ă©ventuellement le `tabId` ou `windowId` Ă vĂ©rifier. + - `tabId` {{optional_inline}} + - : `integer`. ID d'un onglet Ă vĂ©rifier + - `windowId` {{optional_inline}} + - : `integer`. ID d'une fenĂȘtre Ă vĂ©rifier. -<ul> - <li>Si windowId et tabId sont tous les deux fournis, la fonction Ă©choue.</li> - <li>Si windowId et tabId sont tous les deux omis, l'Ă©tat global activĂ©/dĂ©sactivĂ© est renvoyĂ©.</li> -</ul> +<!----> -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +- Si windowId et tabId sont tous les deux fournis, la fonction Ă©choue. +- Si windowId et tabId sont tous les deux omis, l'Ă©tat global activĂ©/dĂ©sactivĂ© est renvoyĂ©. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec <code>true</code> si l'action du navigateur de l'extension est activĂ©e, et <code>false</code> dans le cas contraire.</p> +### Valeur retournĂ©e -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec `true` si l'action du navigateur de l'extension est activĂ©e, et `false` dans le cas contraire. -<p>{{Compat("webextensions.api.browserAction.isEnabled",2)}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.browserAction.isEnabled",2)}} -<p>VĂ©rifiez l'Ă©tat global :</p> +## Exemples -<pre class="brush: js">browser.browserAction.isEnabled({}).then(result => { +VĂ©rifiez l'Ă©tat global : + +```js +browser.browserAction.isEnabled({}).then(result => {  console.log(result); -});</pre> +}); +``` -<p>VĂ©rifiez l'Ă©tat de l'onglet actuellement actif :</p> +VĂ©rifiez l'Ă©tat de l'onglet actuellement actif : -<pre class="brush: js">async function enabledInActiveTab() { +```js +async function enabledInActiveTab() {  let tabs = await browser.tabs.query({ currentWindow:true, active: true @@ -73,6 +72,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/isEnabled tabId: tabs[0].id });  console.log(enabled); -}</pre> +} +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.md index 9a109b7082..b68b3a524c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/onclicked/index.md @@ -13,73 +13,66 @@ tags: - onClicked translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/onClicked --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Action quand l'icone d'action du navigateur est cliquĂ©. Cet Ă©vĂ©nement ne dĂ©clenchera pas si l'action du navigateur comporte une fenĂȘtre contextuelle.</p> +Action quand l'icone d'action du navigateur est cliquĂ©. Cet Ă©vĂ©nement ne dĂ©clenchera pas si l'action du navigateur comporte une fenĂȘtre contextuelle. -<p>Pour dĂ©finir une action de clic droit, utilisez l'API <a href="/fr/Add-ons/WebExtensions/API/contextMenus"><code>contextMenus</code></a> avec le <a href="/fr/Add-ons/WebExtensions/API/contextMenus/ContextType">type de contexte</a> "browser_action".</p> +Pour dĂ©finir une action de clic droit, utilisez l'API [`contextMenus`](/fr/Add-ons/WebExtensions/API/contextMenus) avec le [type de contexte](/fr/Add-ons/WebExtensions/API/contextMenus/ContextType) "browser_action". -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.browserAction.onClicked.addListener(<code>listener</code>) +```js +browser.browserAction.onClicked.addListener(listener) browser.browserAction.onClicked.removeListener(listener) browser.browserAction.onClicked.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoutez un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>Arretez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifier si l'autditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> si elle est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener)` + - : Ajoutez un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : Arretez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifier si l'autditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` si elle est Ă©coutĂ©, sinon `false`. -<h2 id="addListener_syntaxe">addListener syntaxe</h2> +## addListener syntaxe -<h3 id="ParamĂštre">ParamĂštre</h3> +### ParamĂštre -<dl> - <dt><code>callback</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> +- `callback` - <dl> - <dt><code>tab</code></dt> - <dd>{{WebExtAPIRef('tabs.Tab')}}. L'onglet qui Ă©tait actif lorsque l'icĂŽne a Ă©tĂ© cliquĂ©e .</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> + - `tab` + - : {{WebExtAPIRef('tabs.Tab')}}. L'onglet qui Ă©tait actif lorsque l'icĂŽne a Ă©tĂ© cliquĂ©e . -<p>{{Compat("webextensions.api.browserAction.onClicked")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.browserAction.onClicked")}} -<p>Lorsque l'utilisateur clique sur l'icĂŽne, dĂ©sactivez-la pour l'onglet actif et enregistrez l'URL de l'onglet</p> +## Exemples -<pre class="brush: js">browser.browserAction.onClicked.addListener((tab) => { +Lorsque l'utilisateur clique sur l'icĂŽne, dĂ©sactivez-la pour l'onglet actif et enregistrez l'URL de l'onglet + +```js +browser.browserAction.onClicked.addListener((tab) => { // disable the active tab browser.browserAction.disable(tab.id); // requires the "tabs" or "activeTab" permission console.log(tab.url); }); -</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/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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 +99,4 @@ browser.browserAction.onClicked.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/browseraction/openpopup/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/openpopup/index.md index 32f07cc370..93fc503f0e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/openpopup/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/openpopup/index.md @@ -12,45 +12,42 @@ tags: - openPopup translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/openPopup --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Ouvrez le popup de l'action du navigateur. -<div>Ouvrez le popup de l'action du navigateur.</div> +Vous pouvez uniquement appeler cette fonction Ă partir du gestionnaire pour une [action utilisateur](/fr/Add-ons/WebExtensions/User_actions). -<div></div> +## Syntaxe -<div> -<p>Vous pouvez uniquement appeler cette fonction Ă partir du gestionnaire pour une <a href="/fr/Add-ons/WebExtensions/User_actions">action utilisateur</a>.</p> -</div> +```js +browser.browserAction.openPopup() +``` -<h2 id="Syntaxe">Syntaxe</h2> +### ParamĂštres -<pre class="brush: js">browser.browserAction.openPopup() -</pre> +None. -<h3 id="ParamĂštres">ParamĂštres</h3> +### Valeur retournĂ©e -<p>None.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) cela est rĂ©solu sans arguments. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +## CompatibilitĂ© du navigateur -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> cela est rĂ©solu sans arguments.</p> +{{Compat("webextensions.api.browserAction.openPopup", 10)}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## Exemples -<p>{{Compat("webextensions.api.browserAction.openPopup", 10)}}</p> +Ouvrez la fenĂȘtre contextuelle lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu contextuel : -<h2 id="Exemples">Exemples</h2> - -<p>Ouvrez la fenĂȘtre contextuelle lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu contextuel :</p> - -<pre class="brush: js">browser.menus.create({ +```js +browser.menus.create({ id: "open-popup", title: "open popup", contexts: ["all"] }); -browser.menus.onClicked.addListener(() => { +browser.menus.onClicked.addListener(() => { browser.browserAction.openPopup(); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browseraction/setbadgebackgroundcolor/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/setbadgebackgroundcolor/index.md index 0482f401d6..5659d72235 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/setbadgebackgroundcolor/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/setbadgebackgroundcolor/index.md @@ -13,113 +13,112 @@ tags: - setBadgeBackgroundColor translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/setBadgeBackgroundColor --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit la couleur de fond du badge. Les onglets sans couleur de fond de badge spĂ©cifique hĂ©riteront de la couleur de fond de badge globale, qui par dĂ©faut est <code>[217, 0, 0, 255]</code> dans Firefox.</p> +DĂ©finit la couleur de fond du badge. Les onglets sans couleur de fond de badge spĂ©cifique hĂ©riteront de la couleur de fond de badge globale, qui par dĂ©faut est `[217, 0, 0, 255]` dans Firefox. -<p>A partir de Firefox 63, Ă moins que la couleur du texte du badge ne soit explicitement dĂ©finie Ă l'aide de {{WebExtAPIRef("browserAction.setBadgeTextColor()")}}, la couleur du texte du badge sera automatiquement dĂ©finie en noir ou blanc afin d'optimiser le contraste avec la couleur de fond du badge spĂ©cifiĂ©. Par exemple, si vous dĂ©finissez la couleur de fond du badge sur blanc, la couleur par dĂ©faut du texte du badge sera dĂ©finie sur noir, et vice versa.</p> +A partir de Firefox 63, Ă moins que la couleur du texte du badge ne soit explicitement dĂ©finie Ă l'aide de {{WebExtAPIRef("browserAction.setBadgeTextColor()")}}, la couleur du texte du badge sera automatiquement dĂ©finie en noir ou blanc afin d'optimiser le contraste avec la couleur de fond du badge spĂ©cifiĂ©. Par exemple, si vous dĂ©finissez la couleur de fond du badge sur blanc, la couleur par dĂ©faut du texte du badge sera dĂ©finie sur noir, et vice versa. -<p>D'autres navigateurs utilisent toujours une couleur de texte blanche, il est donc prĂ©fĂ©rable d'utiliser un fond foncĂ© pour assurer la lisibilitĂ© du texte</p> +D'autres navigateurs utilisent toujours une couleur de texte blanche, il est donc prĂ©fĂ©rable d'utiliser un fond foncĂ© pour assurer la lisibilitĂ© du texte -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.browserAction.setBadgeBackgroundColor( +```js +browser.browserAction.setBadgeBackgroundColor( details // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code></p> - <dl> - <dt><code>color</code></dt> - <dd><p>La couleur, spĂ©cifiĂ©e comme l'un des suivants :</p> - <ul> - <li>une chaĂźne : toute valeur CSS <a href="/fr/docs/Web/CSS/color_value"><color></a> , par exemple <code>"red"</code>, <code>"#FF0000"</code>, ou <code>"rgb(255,0,0)"</code>. Si la chaĂźne n'est pas une couleur valide, la promesse renvoyĂ©e sera rejetĂ©e et la couleur d'arriĂšre-plan ne sera pas modifiĂ©e.</li> - <li>Un objet <code>{{WebExtAPIRef('browserAction.ColorArray')}}</code>.</li> - <li><code>null</code>. Si un <code>tabId</code> est spĂ©cifiĂ©, il supprime la couleur d'arriĂšre-plan du badge spĂ©cifique Ă l'onglet pour que l'onglet hĂ©rite de la couleur d'arriĂšre-plan du badge global. Sinon, la couleur d'arriĂšre-plan du badge global revient Ă la valeur par dĂ©faut.</li> - </ul> - </dd> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit la couleur d'arriĂšre-plan du badge uniquement pour l'onglet donnĂ©. La couleur est rĂ©initialisĂ©e lorsque l'utilisateur navigue sur cet onglet vers une nouvelle page.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit la couleur d'arriĂšre-plan du badge uniquement pour l'onglet donnĂ©.</dd> - </dl> - </dd> -</dl> - -<ul> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous deux fournis, la fonction Ă©choue et la couleur n'est pas dĂ©finie.</li> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous deux omis, la couleur d'arriĂšre-plan du badge global est dĂ©finie Ă la place.</li> -</ul> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.browserAction.setBadgeBackgroundColor",2)}}</p> - -<p>La couleur par dĂ©faut dans Firefox est : <code>[217, 0, 0, 255]</code>.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Une couleur d'arriĂšre plan qui commence en rouge et devient verte lorsque l'action du navigateur est cliquĂ©e :</p> - -<pre class="brush: js">browser.browserAction.setBadgeText({text: "1234"}); +``` + +### ParamĂštres + +- `details` + + - : `object` + + - `color` + + - : La couleur, spĂ©cifiĂ©e comme l'un des suivants : + + - une chaĂźne : toute valeur CSS [\<color>](/fr/docs/Web/CSS/color_value) , par exemple `"red"`, `"#FF0000"`, ou `"rgb(255,0,0)"`. Si la chaĂźne n'est pas une couleur valide, la promesse renvoyĂ©e sera rejetĂ©e et la couleur d'arriĂšre-plan ne sera pas modifiĂ©e. + - Un objet `{{WebExtAPIRef('browserAction.ColorArray')}}`. + - `null`. Si un `tabId` est spĂ©cifiĂ©, il supprime la couleur d'arriĂšre-plan du badge spĂ©cifique Ă l'onglet pour que l'onglet hĂ©rite de la couleur d'arriĂšre-plan du badge global. Sinon, la couleur d'arriĂšre-plan du badge global revient Ă la valeur par dĂ©faut. + + - `tabId`{{optional_inline}} + - : `integer`. DĂ©finit la couleur d'arriĂšre-plan du badge uniquement pour l'onglet donnĂ©. La couleur est rĂ©initialisĂ©e lorsque l'utilisateur navigue sur cet onglet vers une nouvelle page. + - `windowId`{{optional_inline}} + - : `integer`. DĂ©finit la couleur d'arriĂšre-plan du badge uniquement pour l'onglet donnĂ©. + +<!----> + +- Si `windowId` et `tabId` sont tous deux fournis, la fonction Ă©choue et la couleur n'est pas dĂ©finie. +- Si `windowId` et `tabId` sont tous deux omis, la couleur d'arriĂšre-plan du badge global est dĂ©finie Ă la place. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.browserAction.setBadgeBackgroundColor",2)}} + +La couleur par dĂ©faut dans Firefox est : `[217, 0, 0, 255]`. + +## Exemples + +Une couleur d'arriĂšre plan qui commence en rouge et devient verte lorsque l'action du navigateur est cliquĂ©e : + +```js +browser.browserAction.setBadgeText({text: "1234"}); browser.browserAction.setBadgeBackgroundColor({color: "red"}); -browser.browserAction.onClicked.addListener(()=> { +browser.browserAction.onClicked.addListener(()=> { browser.browserAction.setBadgeBackgroundColor({color: "green"}); -});</pre> +}); +``` -<p>RĂ©glez la couleur d'arriĂšre-plan du badge uniquement pour l'onget actif :</p> +RĂ©glez la couleur d'arriĂšre-plan du badge uniquement pour l'onget actif : -<pre class="brush: js">browser.browserAction.setBadgeText({text: "1234"}); +```js +browser.browserAction.setBadgeText({text: "1234"}); browser.browserAction.setBadgeBackgroundColor({color: "red"}); -browser.browserAction.onClicked.addListener((tab)=> { +browser.browserAction.onClicked.addListener((tab)=> { browser.browserAction.setBadgeBackgroundColor({ color: "green", tabId: tab.id }); -});</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/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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/browseraction/setbadgetext/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/setbadgetext/index.md index 90e7209425..688fc96352 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/setbadgetext/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/setbadgetext/index.md @@ -13,77 +13,75 @@ tags: - setBadgeText translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/setBadgeText --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit le texte du badge pour l'action du navigateur. Le badge est affichĂ© en haut de l'icĂŽne.</p> +DĂ©finit le texte du badge pour l'action du navigateur. Le badge est affichĂ© en haut de l'icĂŽne. -<p>Les onglets sans texte de badge spĂ©cifique hĂ©riteront du texte global du badge, qui est <code>""</code> par dĂ©faut.</p> +Les onglets sans texte de badge spĂ©cifique hĂ©riteront du texte global du badge, qui est `""` par dĂ©faut. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.browserAction.setBadgeText( +```js +browser.browserAction.setBadgeText( details // object ) -</pre> +``` -<p>Cette API est Ă©galement disponible sous <code>chrome.browserAction.setBadgeText()</code>.</p> +Cette API est Ă©galement disponible sous `chrome.browserAction.setBadgeText()`. -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code></p> - <dl> - <dt><code>text</code></dt> - <dd> - <p><code>string</code> or <code>null</code>. N'importe quel nombre de caractĂšres peut ĂȘtre passĂ©, mais seulement quatre environ peuvent tenir dans l'espace.</p> +- `details` - <p>Utilisez une chaĂźne vide - <code>""</code> - si vous ne voulez pas de badge.</p> + - : `object` - <p>Si un <code>tabId</code> est spĂ©cifiĂ©, <code>null</code> supprime le texte du badge spĂ©cifique Ă l'onglet afin que l'onglet hĂ©rite du texte global du badge. Dans le cas contraire, le texte du badge global devient <code>""</code>.</p> + - `text` - <p>Si un <code>windowId</code> est spĂ©cifiĂ©, <code>null</code> supprime le texte du badge spĂ©cifique Ă la fenĂȘtre afin que l'onglet hĂ©rite du texte global du badge. Dans le cas contraire, le texte du badge global devient <code>""</code>.</p> - </dd> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finir le texte du badge uniquement pour l'onglet donnĂ©. Le texte est rĂ©initialisĂ© lorsque l'utilisateur navigue dans cet onglet vers une nouvelle page.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finir le texte du badge pour la fenĂȘtre donnĂ©e.</dd> - </dl> - </dd> -</dl> + - : `string` or `null`. N'importe quel nombre de caractĂšres peut ĂȘtre passĂ©, mais seulement quatre environ peuvent tenir dans l'espace. -<ul> - <li>si <code>windowId</code> et <code>tabId</code> sont tous les deux fournis, la fonction Ă©choue.</li> - <li>si <code>windowId</code> et <code>tabId</code> sont tous les deux omis, le badge global est dĂ©fini.</li> -</ul> + Utilisez une chaĂźne vide - `""` - si vous ne voulez pas de badge. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + Si un `tabId` est spĂ©cifiĂ©, `null` supprime le texte du badge spĂ©cifique Ă l'onglet afin que l'onglet hĂ©rite du texte global du badge. Dans le cas contraire, le texte du badge global devient `""`. -<p>{{Compat("webextensions.api.browserAction.setBadgeText",2)}}</p> + Si un `windowId` est spĂ©cifiĂ©, `null` supprime le texte du badge spĂ©cifique Ă la fenĂȘtre afin que l'onglet hĂ©rite du texte global du badge. Dans le cas contraire, le texte du badge global devient `""`. -<h2 id="Exemples">Exemples</h2> + - `tabId`{{optional_inline}} + - : `integer`. DĂ©finir le texte du badge uniquement pour l'onglet donnĂ©. Le texte est rĂ©initialisĂ© lorsque l'utilisateur navigue dans cet onglet vers une nouvelle page. + - `windowId`{{optional_inline}} + - : `integer`. DĂ©finir le texte du badge pour la fenĂȘtre donnĂ©e. -<p>Ajouter un badge indiquant combien de fois l'utilisateur a cliquĂ© sur le bouton : </p> +<!----> -<pre class="brush: js">var clicks = 0; +- si `windowId` et `tabId` sont tous les deux fournis, la fonction Ă©choue. +- si `windowId` et `tabId` sont tous les deux omis, le badge global est dĂ©fini. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.browserAction.setBadgeText",2)}} + +## Exemples + +Ajouter un badge indiquant combien de fois l'utilisateur a cliquĂ© sur le bouton : + +```js +var clicks = 0; function increment() { browser.browserAction.setBadgeText({text: (++clicks).toString()}); } -browser.browserAction.onClicked.addListener(increment);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.browserAction.onClicked.addListener(increment); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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 @@ -110,5 +108,4 @@ browser.browserAction.onClicked.addListener(increment);</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/browseraction/setbadgetextcolor/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/setbadgetextcolor/index.md index a03c34cf47..aff66a65d4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/setbadgetextcolor/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/setbadgetextcolor/index.md @@ -12,80 +12,80 @@ tags: - setBadgeTextColor translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/setBadgeTextColor --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit la couleur du texte du badge de l'action du navigateur. Les onglets sans couleur de texte de badge spĂ©cifique hĂ©riteront de la couleur globale du texte de badge.</p> +DĂ©finit la couleur du texte du badge de l'action du navigateur. Les onglets sans couleur de texte de badge spĂ©cifique hĂ©riteront de la couleur globale du texte de badge. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.browserAction.setBadgeTextColor( +```js +browser.browserAction.setBadgeTextColor( details // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code></p> - <dl> - <dt><code>color</code></dt> - <dd><p>La couleur, spĂ©cifiĂ©e comme l'une des couleurs :</p> - <ul> - <li> une chaĂźne : toute valeur CSS <a href="/fr/docs/Web/CSS/color_value"><color></a>, par exemple <code>"red"</code>, <code>"#FF0000"</code>, ou <code>"rgb(255,0,0)"</code>. Si la chaĂźne n'est pas une couleur valide, la promesse retournĂ©e sera rejetĂ©e et la couleur du texte ne sera pas modifiĂ©e.</li> - <li>Un objet <code>{{WebExtAPIRef('browserAction.ColorArray')}}</code>.</li> - <li><code>null</code>. Si un <code>tabId</code> est spĂ©cifiĂ©, il supprime la couleur du texte du badge spĂ©cifique Ă l'onglet afin que l'onglet hĂ©rite de la couleur globale du texte du badge. Dans le cas contraire, la couleur globale du texte du badge est ramenĂ©e Ă la valeur par dĂ©faut.</li> - </ul> - </dd> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit la couleur du texte du badge uniquement pour l'onglet donnĂ©. La couleur est rĂ©initialisĂ©e lorsque l'utilisateur navigue dans cet onglet vers une nouvelle page.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit la couleur du texte du badge uniquement pour l'onglet donnĂ©.</dd> - </dl> - </dd> -</dl> - -<ul> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous deux fournis, la fonction Ă©choue et la couleur n'est pas dĂ©finie.</li> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous deux omis, la couleur globale du texte du badge est dĂ©finie Ă la place.</li> -</ul> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.browserAction.setBadgeTextColor",2)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Une couleur de texte de badge qui commence par le rouge et passe au vert lorsque l'on clique sur l'action du navigateur :</p> - -<pre class="brush: js">browser.browserAction.setBadgeText({text: "1234"}); +``` + +### ParamĂštres + +- `details` + + - : `object` + + - `color` + + - : La couleur, spĂ©cifiĂ©e comme l'une des couleurs : + + - une chaĂźne : toute valeur CSS [\<color>](/fr/docs/Web/CSS/color_value), par exemple `"red"`, `"#FF0000"`, ou `"rgb(255,0,0)"`. Si la chaĂźne n'est pas une couleur valide, la promesse retournĂ©e sera rejetĂ©e et la couleur du texte ne sera pas modifiĂ©e. + - Un objet `{{WebExtAPIRef('browserAction.ColorArray')}}`. + - `null`. Si un `tabId` est spĂ©cifiĂ©, il supprime la couleur du texte du badge spĂ©cifique Ă l'onglet afin que l'onglet hĂ©rite de la couleur globale du texte du badge. Dans le cas contraire, la couleur globale du texte du badge est ramenĂ©e Ă la valeur par dĂ©faut. + + - `tabId`{{optional_inline}} + - : `integer`. DĂ©finit la couleur du texte du badge uniquement pour l'onglet donnĂ©. La couleur est rĂ©initialisĂ©e lorsque l'utilisateur navigue dans cet onglet vers une nouvelle page. + - `windowId`{{optional_inline}} + - : `integer`. DĂ©finit la couleur du texte du badge uniquement pour l'onglet donnĂ©. + +<!----> + +- Si `windowId` et `tabId` sont tous deux fournis, la fonction Ă©choue et la couleur n'est pas dĂ©finie. +- Si `windowId` et `tabId` sont tous deux omis, la couleur globale du texte du badge est dĂ©finie Ă la place. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.browserAction.setBadgeTextColor",2)}} + +## Exemples + +Une couleur de texte de badge qui commence par le rouge et passe au vert lorsque l'on clique sur l'action du navigateur : + +```js +browser.browserAction.setBadgeText({text: "1234"}); browser.browserAction.setBadgeTextColor({color: "red"}); -browser.browserAction.onClicked.addListener(()=> { +browser.browserAction.onClicked.addListener(()=> { browser.browserAction.setBadgeTextColor({color: "green"}); -});</pre> +}); +``` -<p>DĂ©finissez la couleur du texte du badge uniquement pour l'onglet actif :</p> +DĂ©finissez la couleur du texte du badge uniquement pour l'onglet actif : -<pre class="brush: js">browser.browserAction.setBadgeText({text: "1234"}); +```js +browser.browserAction.setBadgeText({text: "1234"}); browser.browserAction.setBadgeTextColor({color: "red"}); -browser.browserAction.onClicked.addListener((tab)=> { +browser.browserAction.onClicked.addListener((tab)=> { browser.browserAction.setBadgeTextColor({ color: "green", tabId: tab.id }); -});</pre> - -<p>{{WebExtExamples}}</p> +}); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.json</code></a> dans le code de Chromium code.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json) dans le code de Chromium code. -<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 @@ -112,5 +112,4 @@ browser.browserAction.onClicked.addListener((tab)=> { // 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/browseraction/seticon/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/seticon/index.md index 04ca4243fb..2b23af2136 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/seticon/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/seticon/index.md @@ -13,98 +13,99 @@ tags: - setIcon translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/setIcon --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit l'icĂŽne pour l'action du navigateur.</p> +DĂ©finit l'icĂŽne pour l'action du navigateur. -<p>Vous pouvez spĂ©cifier une seule icĂŽne comme chemin d'accĂšs Ă un fichier ou un objet {{WebExtAPIRef('browserAction.ImageDataType')}} .</p> +Vous pouvez spĂ©cifier une seule icĂŽne comme chemin d'accĂšs Ă un fichier ou un objet {{WebExtAPIRef('browserAction.ImageDataType')}} . -<p>Vous pouvez spĂ©cifier plusieurs icĂŽnes dans diffĂ©rentes tailles en fournissant un dictionnaire contenant plusieurs chemins ou des objets <code>ImageData</code>. Cela signifie que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixels diffĂ©rente.</p> +Vous pouvez spĂ©cifier plusieurs icĂŽnes dans diffĂ©rentes tailles en fournissant un dictionnaire contenant plusieurs chemins ou des objets `ImageData`. Cela signifie que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixels diffĂ©rente. -<p>Les onglets sans icĂŽne spĂ©cifique hĂ©riteront de l'icĂŽne globale, qui par dĂ©faut est <a href="/fr/Add-ons/WebExtensions/manifest.json/browser_action"><code>default_icon</code></a> specifiĂ© dans le manifest.</p> +Les onglets sans icĂŽne spĂ©cifique hĂ©riteront de l'icĂŽne globale, qui par dĂ©faut est [`default_icon`](/fr/Add-ons/WebExtensions/manifest.json/browser_action) specifiĂ© dans le manifest. -<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 settingIcon = browser.browserAction.setIcon( +```js +var settingIcon = browser.browserAction.setIcon( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Un objet contenant des propriĂ©tĂ©s <code>imageData</code> ou <code>path</code>, et Ă©ventuellement une propriĂ©tĂ© <code>tabId</code> .</p> - <dl> - <dt><code>imageData</code>{{optional_inline}}</dt> - <dd> - <p><code>{{WebExtAPIRef('browserAction.ImageDataType')}}</code> ou <code><code>object</code></code>. Il s'agit soit d'un seul objet <code>ImageData</code> ou un dictionnaire d'objet.</p> +- `details` - <p>Utilisez un dictionnaire d'objet pour spĂ©cifier plusieurs objets <code>ImageData</code> dans diffĂ©rentes tailles, de sorte que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixel diffĂ©rentes. Si <code>imageData</code> est un dictionnaire, la valeur de chaque propriĂ©tĂ©Â est un objet<code>ImageData</code>, et son nom est sa taille, comme ceci :</p> + - : `object`. Un objet contenant des propriĂ©tĂ©s `imageData` ou `path`, et Ă©ventuellement une propriĂ©tĂ© `tabId` . - <pre class="brush: json">{ - 16: image16, - 32: image32 -}</pre> + - `imageData`{{optional_inline}} - <p>Le navigateur choisira l'image Ă utiliser en fonction de la densitĂ© de pixels de l'Ă©cran. Voir <a href="/fr/Add-ons/WebExtensions/manifest.json/browser_action#Choosing_icon_sizes">Choix de la tailles d'icĂŽnes</a> pour plus d'informations Ă ce sujet.</p> - </dd> - <dt><code>path</code>{{optional_inline}}</dt> - <dd> - <p><code><code>string</code></code> or <code><code>object</code></code>. Il s'agit du chemin relatif d'un fichier d'icĂŽne ou d'un objet de dictionnaire. </p> + - : `{{WebExtAPIRef('browserAction.ImageDataType')}}` ou `object`. Il s'agit soit d'un seul objet `ImageData` ou un dictionnaire d'objet. - <p>Utilisez un dictionnaire d'objet pour spĂ©cifier plusieurs fichiers d'icĂŽnes dans diffĂ©rentes tailles, de sorte que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixels diffĂ©rentes. Si <code>path</code> est un dictionnaire, la valeur de chaque propriĂ©tĂ© est un chemin relatif , et son nom est sa taille, comme ceci :</p> + Utilisez un dictionnaire d'objet pour spĂ©cifier plusieurs objets `ImageData` dans diffĂ©rentes tailles, de sorte que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixel diffĂ©rentes. Si `imageData` est un dictionnaire, la valeur de chaque propriĂ©tĂ©Â est un objet`ImageData`, et son nom est sa taille, comme ceci : - <pre class="brush: json">{ - 16: "path/to/image16.jpg", - 32: "path/to/image32.jpg" -}</pre> + ```json + { + 16: image16, + 32: image32 + } + ``` - <p>Le navigateur choisira l'image Ă utiliser en fonction de la densitĂ© de pixels de l'Ă©cran. Voir <a href="/fr/Add-ons/WebExtensions/manifest.json/browser_action#Choosing_icon_sizes">Choix de la tailles d'icĂŽnes</a> pour plus d'informations Ă ce sujet.</p> - </dd> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit l'icĂŽne uniquement pour l'onglet donnĂ©. L'icĂŽne est rĂ©initialisĂ©e lorsque l'utilisateur navigue dans cet onglet vers une nouvelle page.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit l'icĂŽne de la fenĂȘtre donnĂ©e.</dd> - </dl> - </dd> -</dl> + Le navigateur choisira l'image Ă utiliser en fonction de la densitĂ© de pixels de l'Ă©cran. Voir [Choix de la tailles d'icĂŽnes](/fr/Add-ons/WebExtensions/manifest.json/browser_action#Choosing_icon_sizes) pour plus d'informations Ă ce sujet. -<ul> - <li>si <code>windowId</code> et <code>tabId</code> sont tous deux fournis, la fonction Ă©choue et l'icĂŽne n'est pas dĂ©finie.</li> - <li>si <code>windowId</code> et <code>tabId</code> sont tous les deux omis, l'icĂŽne globale est dĂ©finie.</li> -</ul> + - `path`{{optional_inline}} -<p>Si chaque <code>imageData</code> et <code>path</code> est un objet <code>undefined</code>, <code>null</code> ou vide :</p> + - : `string` or `object`. Il s'agit du chemin relatif d'un fichier d'icĂŽne ou d'un objet de dictionnaire. -<ul> - <li>si <code>tabId</code> est spĂ©cifiĂ©, et que l'onglet a un jeu d'icĂŽnes spĂ©cifique Ă l'onglet, alors l'onglet hĂ©ritera de l'icĂŽne de la fenĂȘtre Ă laquelle il appartient.</li> - <li>si <code>windowId</code> est spĂ©cifiĂ© et que la fenĂȘtre a un jeu d'icĂŽnes spĂ©cifiques Ă la fenĂȘtre, alors la fenĂȘtre hĂ©ritera de l'icĂŽne globale.</li> - <li>Sinon, l'icĂŽne globale sera rĂ©initialisĂ©e Ă l'icĂŽne du manifest.</li> -</ul> + Utilisez un dictionnaire d'objet pour spĂ©cifier plusieurs fichiers d'icĂŽnes dans diffĂ©rentes tailles, de sorte que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixels diffĂ©rentes. Si `path` est un dictionnaire, la valeur de chaque propriĂ©tĂ© est un chemin relatif , et son nom est sa taille, comme ceci : -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + ```json + { + 16: "path/to/image16.jpg", + 32: "path/to/image32.jpg" + } + ``` -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans arguments une fois que l'icĂŽne a Ă©tĂ© dĂ©finie.</p> + Le navigateur choisira l'image Ă utiliser en fonction de la densitĂ© de pixels de l'Ă©cran. Voir [Choix de la tailles d'icĂŽnes](/fr/Add-ons/WebExtensions/manifest.json/browser_action#Choosing_icon_sizes) pour plus d'informations Ă ce sujet. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `tabId`{{optional_inline}} + - : `integer`. DĂ©finit l'icĂŽne uniquement pour l'onglet donnĂ©. L'icĂŽne est rĂ©initialisĂ©e lorsque l'utilisateur navigue dans cet onglet vers une nouvelle page. + - `windowId`{{optional_inline}} + - : `integer`. DĂ©finit l'icĂŽne de la fenĂȘtre donnĂ©e. -<p>{{Compat("webextensions.api.browserAction.setIcon",2)}}</p> +<!----> -<h2 id="Exemples">Exemples</h2> +- si `windowId` et `tabId` sont tous deux fournis, la fonction Ă©choue et l'icĂŽne n'est pas dĂ©finie. +- si `windowId` et `tabId` sont tous les deux omis, l'icĂŽne globale est dĂ©finie. -<p>Le code ci-dessous utilise une action du navigateur pour basculer un auditeur pour {{WebExtAPIRef("webRequest.onHeadersReceived")}}, et utilise <code>setIcon()</code> pour indiquer si l'Ă©coute est activĂ©e ou dĂ©sactivĂ©e :</p> +Si chaque `imageData` et `path` est un objet `undefined`, `null` ou vide : -<pre class="brush: js">function logResponseHeaders(requestDetails) { +- si `tabId` est spĂ©cifiĂ©, et que l'onglet a un jeu d'icĂŽnes spĂ©cifique Ă l'onglet, alors l'onglet hĂ©ritera de l'icĂŽne de la fenĂȘtre Ă laquelle il appartient. +- si `windowId` est spĂ©cifiĂ© et que la fenĂȘtre a un jeu d'icĂŽnes spĂ©cifiques Ă la fenĂȘtre, alors la fenĂȘtre hĂ©ritera de l'icĂŽne globale. +- Sinon, l'icĂŽne globale sera rĂ©initialisĂ©e Ă l'icĂŽne du manifest. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments une fois que l'icĂŽne a Ă©tĂ© dĂ©finie. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.browserAction.setIcon",2)}} + +## Exemples + +Le code ci-dessous utilise une action du navigateur pour basculer un auditeur pour {{WebExtAPIRef("webRequest.onHeadersReceived")}}, et utilise `setIcon()` pour indiquer si l'Ă©coute est activĂ©e ou dĂ©sactivĂ©e : + +```js +function logResponseHeaders(requestDetails) { console.log(requestDetails); } function startListening() { browser.webRequest.onHeadersReceived.addListener( logResponseHeaders, - {urls: ["<all_urls>"]}, + {urls: ["<all_urls>"]}, ["responseHeaders"] ); browser.browserAction.setIcon({path: "icons/listening-on.svg"}); @@ -123,11 +124,13 @@ function toggleListener() { } } -browser.browserAction.onClicked.addListener(toggleListener);</pre> +browser.browserAction.onClicked.addListener(toggleListener); +``` -<p>Le code ci-dessous dĂ©finit l'icĂŽne Ă l'aide d'un objet<code><a href="/fr/docs/Web/API/ImageData">ImageData</a></code> :</p> +Le code ci-dessous dĂ©finit l'icĂŽne Ă l'aide d'un objet[`ImageData`](/fr/docs/Web/API/ImageData) : -<pre class="brush: js">function getImageData() { +```js +function getImageData() { var canvas = document.createElement("canvas"); var ctx = canvas.getContext("2d"); @@ -137,30 +140,30 @@ browser.browserAction.onClicked.addListener(toggleListener);</pre> return ctx.getImageData(50, 50, 100, 100); } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { browser.browserAction.setIcon({imageData: getImageData()}); }); -</pre> +``` -<p>L'extrait suivant met Ă jour l'icĂŽne lorsque l'utilisateur clique, mais uniquement pour l'onglet actif :</p> +L'extrait suivant met Ă jour l'icĂŽne lorsque l'utilisateur clique, mais uniquement pour l'onglet actif : -<pre class="brush: js">browser.browserAction.onClicked.addListener((tab) => { +```js +browser.browserAction.onClicked.addListener((tab) => { browser.browserAction.setIcon({ tabId: tab.id, path: "icons/updated-48.png" }); -});</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/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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 @@ -187,5 +190,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/browseraction/setpopup/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/setpopup/index.md index 02458b82c4..8236f249bd 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/setpopup/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/setpopup/index.md @@ -13,61 +13,59 @@ tags: - setPopup translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/setPopup --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit le document HTML qui sera ouvert en tant que popup lorsque l'utilisateur clique sur l'icĂŽne de l'action du navigateur. Les onglets sans popup spĂ©cifique hĂ©riteront de la popup globale, qui par dĂ©faut est la <a href="/fr/Add-ons/WebExtensions/manifest.json/browser_action"><code>default_popup</code></a> spĂ©cifiĂ©e dans le manifest.</p> +DĂ©finit le document HTML qui sera ouvert en tant que popup lorsque l'utilisateur clique sur l'icĂŽne de l'action du navigateur. Les onglets sans popup spĂ©cifique hĂ©riteront de la popup globale, qui par dĂ©faut est la [`default_popup`](/fr/Add-ons/WebExtensions/manifest.json/browser_action) spĂ©cifiĂ©e dans le manifest. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.browserAction.setPopup( +```js +browser.browserAction.setPopup( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit la fenĂȘtre contextuelle uniquement pour un onglet spĂ©cifique. La fenĂȘtre contextuelle est rĂ©initialisĂ©e lorsque l'utilisateur navigue dans cet onglet vers une nouvelle page.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit le popup uniquement pour la fenĂȘtre spĂ©cifiĂ©e.</dd> - <dt><code>popup</code></dt> - <dd> - <p><code>string</code> ou <code>null</code>. Le fichier HTML Ă afficher dans un popup, spĂ©cifiĂ© comme URL.</p> +- `details` - <p>Ceci peut pointer vers un fichier empaquetĂ© dans l'extension (par exemple, crĂ©Ă© Ă l'aide de {{WebExtAPIRef("extension.getURL")}}), ou un document distant (par exemple <code>https://example.org/</code>).</p> + - : `object`. - <p>Si une chaĂźne vide (<code>""</code>) est passĂ©e ici, le popup est dĂ©sactivĂ©, et l'extension recevra les Ă©vĂ©nements {{WebExtAPIRef("browserAction.onClicked")}}.</p> + - `tabId`{{optional_inline}} + - : `integer`. DĂ©finit la fenĂȘtre contextuelle uniquement pour un onglet spĂ©cifique. La fenĂȘtre contextuelle est rĂ©initialisĂ©e lorsque l'utilisateur navigue dans cet onglet vers une nouvelle page. + - `windowId`{{optional_inline}} + - : `integer`. DĂ©finit le popup uniquement pour la fenĂȘtre spĂ©cifiĂ©e. + - `popup` - <p>Si le <code>popup</code> est <code>null</code>:</p> + - : `string` ou `null`. Le fichier HTML Ă afficher dans un popup, spĂ©cifiĂ© comme URL. - <p>Si <code>tabId</code> est spĂ©cifiĂ©, supprime la fenĂȘtre popup spĂ©cifique Ă l'onglet afin que l'onglet hĂ©rite de la fenĂȘtre popup globale..</p> + Ceci peut pointer vers un fichier empaquetĂ© dans l'extension (par exemple, crĂ©Ă© Ă l'aide de {{WebExtAPIRef("extension.getURL")}}), ou un document distant (par exemple `https://example.org/`). - <p>Si <code>windowId</code> est spĂ©cifiĂ©, supprime le popup spĂ©cifique Ă la fenĂȘtre afin que la fenĂȘtre hĂ©rite du popup global.</p> + Si une chaĂźne vide (`""`) est passĂ©e ici, le popup est dĂ©sactivĂ©, et l'extension recevra les Ă©vĂ©nements {{WebExtAPIRef("browserAction.onClicked")}}. - <p>Sinon, la fenĂȘtre contextuelle globale revient Ă la valeur par dĂ©faut.</p> - </dd> - </dl> - </dd> -</dl> + Si le `popup` est `null`: -<ul> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous les deux fournis, la fonction Ă©choue et le popup n'est pas dĂ©fini.</li> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous les deux omis, la fenĂȘtre contextuelle globale est dĂ©finie.</li> -</ul> + Si `tabId` est spĂ©cifiĂ©, supprime la fenĂȘtre popup spĂ©cifique Ă l'onglet afin que l'onglet hĂ©rite de la fenĂȘtre popup globale.. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + Si `windowId` est spĂ©cifiĂ©, supprime le popup spĂ©cifique Ă la fenĂȘtre afin que la fenĂȘtre hĂ©rite du popup global. -<p>{{Compat("webextensions.api.browserAction.setPopup",2)}}</p> + Sinon, la fenĂȘtre contextuelle globale revient Ă la valeur par dĂ©faut. -<h2 id="Exemples">Exemples</h2> +<!----> -<p>Ce code ajoute une paire d'Ă©lĂ©ments de menu contextuel que vous pouvez utiliser pour basculer entre deux fenĂȘtres contextuelles. Notez que vous aurez besoin de la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "contextMenus" dĂ©finie dans le manifest de l'extension pour crĂ©er des Ă©lĂ©ments du menu contextuel.</p> +- Si `windowId` et `tabId` sont tous les deux fournis, la fonction Ă©choue et le popup n'est pas dĂ©fini. +- Si `windowId` et `tabId` sont tous les deux omis, la fenĂȘtre contextuelle globale est dĂ©finie. -<pre class="brush: js">function onCreated() { +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.browserAction.setPopup",2)}} + +## Exemples + +Ce code ajoute une paire d'Ă©lĂ©ments de menu contextuel que vous pouvez utiliser pour basculer entre deux fenĂȘtres contextuelles. Notez que vous aurez besoin de la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) "contextMenus" dĂ©finie dans le manifest de l'extension pour crĂ©er des Ă©lĂ©ments du menu contextuel. + +```js +function onCreated() { if (browser.runtime.lastError) { console.log("error creating item:" + browser.runtime.lastError); } else { @@ -97,19 +95,18 @@ browser.contextMenus.onClicked.addListener(function(info, tab) { } else if (info.menuItemId == "popup-2") { browser.browserAction.setPopup({popup: "/popup/popup2.html"}) } -});</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/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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 @@ -136,5 +133,4 @@ browser.contextMenus.onClicked.addListener(function(info, tab) { // 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/browseraction/settitle/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/settitle/index.md index 9de3566dcd..35b0c602e8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browseraction/settitle/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/settitle/index.md @@ -13,65 +13,56 @@ tags: - setTitle translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/setTitle --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>DĂ©finit le titre de l'action du navigateur. Le titre est affichĂ© dans une infobulle au-dessus de l'icĂŽne de l'action du navigateur. Vous pouvez passer un <code>tabId</code> dans ou une <code>windowId</code> comme paramĂštre optionnel â si vous le faites, le titre est changĂ© seulement pour l'onglet donnĂ© ou la fenĂȘtre donnĂ©e. Les onglets ou les fenĂȘtres sans titre spĂ©cifique hĂ©riteront du texte du titre global, qui est par dĂ©faut Ă l'option <a href="/fr/Add-ons/WebExtensions/manifest.json/browser_action"><code>default_title</code></a> ou <a href="/fr/Add-ons/WebExtensions/manifest.json/name"><code>name</code></a> specifiĂ© dans le manifest.</p> +DĂ©finit le titre de l'action du navigateur. Le titre est affichĂ© dans une infobulle au-dessus de l'icĂŽne de l'action du navigateur. Vous pouvez passer un `tabId` dans ou une `windowId` comme paramĂštre optionnel â si vous le faites, le titre est changĂ© seulement pour l'onglet donnĂ© ou la fenĂȘtre donnĂ©e. Les onglets ou les fenĂȘtres sans titre spĂ©cifique hĂ©riteront du texte du titre global, qui est par dĂ©faut Ă l'option [`default_title`](/fr/Add-ons/WebExtensions/manifest.json/browser_action) ou [`name`](/fr/Add-ons/WebExtensions/manifest.json/name) specifiĂ© dans le manifest. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.browserAction.setTitle( +```js +browser.browserAction.setTitle( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Le nouveau titre et Ă©ventuellement l'ID de l'onglet ou de la fenĂȘtre Ă cibler.</p> - <dl> - <dt><code>title</code></dt> - <dd> - <p><code>string</code> ou <code>null</code>. La chaĂźne de caractĂšres que l'action du navigateur doit afficher lorsqu'il y a une souris.</p> +- `details` - <p>Si <code>title</code> est une chaĂźne vide, le titre utilisĂ© sera le nom de l'extension, mais {{WebExtAPIRef("browserAction.getTitle")}} fournira toujours la chaĂźne vide.</p> + - : `object`. Le nouveau titre et Ă©ventuellement l'ID de l'onglet ou de la fenĂȘtre Ă cibler. - <p>Si <code>title</code> est <code>null</code>:</p> + - `title` - <ul> - <li>Si <code>tabId</code> est spĂ©cifiĂ©, et que l'onglet a un jeu de titres spĂ©cifiques aux onglets, alors l'onglet hĂ©ritera du titre de la fenĂȘtre Ă laquelle il appartient.</li> - <li>Si <code>windowId</code> est spĂ©cifiĂ©, et que la fenĂȘtre a un titre spĂ©cifique Ă la fenĂȘtre, alors la fenĂȘtre hĂ©ritera du titre global.</li> - <li>Sinon, le titre global sera rĂ©initialisĂ© au titre du manifest.</li> - </ul> - </dd> - <dt><code>tabId</code>{{Optional_Inline}}</dt> - <dd> - <p><code>integer</code>. DĂ©finit le titre uniquement pour l'onglet donnĂ©.</p> - </dd> - <dt><code>windowId</code>{{Optional_Inline}}</dt> - <dd> - <p><code>integer</code>. DĂ©finit le titre de la fenĂȘtre donnĂ©e.</p> - </dd> - </dl> - </dd> -</dl> + - : `string` ou `null`. La chaĂźne de caractĂšres que l'action du navigateur doit afficher lorsqu'il y a une souris. -<ul> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous deux fournis, la fonction Ă©choue et le titre n'est pas dĂ©fini.</li> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous les deux omis, le titre global est dĂ©fini.</li> -</ul> + Si `title` est une chaĂźne vide, le titre utilisĂ© sera le nom de l'extension, mais {{WebExtAPIRef("browserAction.getTitle")}} fournira toujours la chaĂźne vide. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + Si `title` est `null`: + - Si `tabId` est spĂ©cifiĂ©, et que l'onglet a un jeu de titres spĂ©cifiques aux onglets, alors l'onglet hĂ©ritera du titre de la fenĂȘtre Ă laquelle il appartient. + - Si `windowId` est spĂ©cifiĂ©, et que la fenĂȘtre a un titre spĂ©cifique Ă la fenĂȘtre, alors la fenĂȘtre hĂ©ritera du titre global. + - Sinon, le titre global sera rĂ©initialisĂ© au titre du manifest. + - `tabId`{{Optional_Inline}} + - : `integer`. DĂ©finit le titre uniquement pour l'onglet donnĂ©. + - `windowId`{{Optional_Inline}} + - : `integer`. DĂ©finit le titre de la fenĂȘtre donnĂ©e. -<p>{{Compat("webextensions.api.browserAction.setTitle",10)}}</p> +<!----> -<h2 id="Exemples">Exemples</h2> +- Si `windowId` et `tabId` sont tous deux fournis, la fonction Ă©choue et le titre n'est pas dĂ©fini. +- Si `windowId` et `tabId` sont tous les deux omis, le titre global est dĂ©fini. -<p>Ce code change le titre entre "ceci" et "ça" chaque fois que l'utilisateur clique sur l'action du navigateur :</p> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function toggleTitle(title) { +{{Compat("webextensions.api.browserAction.setTitle",10)}} + +## Exemples + +Ce code change le titre entre "ceci" et "ça" chaque fois que l'utilisateur clique sur l'action du navigateur : + +```js +function toggleTitle(title) { if (title == "this") { browser.browserAction.setTitle({title: "that"}); } else { @@ -79,23 +70,21 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/setTitle } } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { var gettingTitle = browser.browserAction.getTitle({}); gettingTitle.then(toggleTitle); }); -</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/browserAction"><code>chrome.browserAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json"><code>browser_action.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.browserAction`](https://developer.chrome.com/extensions/browserAction). Cette documentation est dĂ©rivĂ©e de [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.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 @@ -122,5 +111,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/browsersettings/allowpopupsforuserevents/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/allowpopupsforuserevents/index.md index e3f24ec22b..9c37535515 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/allowpopupsforuserevents/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/allowpopupsforuserevents/index.md @@ -11,32 +11,34 @@ tags: - allowPopupsForUserEvents translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/allowPopupsForUserEvents --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut etre utilisĂ© pour activer ou dĂ©sactiver la capacitĂ© des pages web d'ouvrir des popups en rĂ©ponse aux actions de l'utilisateur.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut etre utilisĂ© pour activer ou dĂ©sactiver la capacitĂ© des pages web d'ouvrir des popups en rĂ©ponse aux actions de l'utilisateur. -<p>La valeur sous-jacente est un boolĂ©en.</p> +La valeur sous-jacente est un boolĂ©en. -<p>Par dĂ©faut, les navigateurs permettent aux pages Web d'ouvrir des fenĂȘtres contextuelles en rĂ©ponse Ă un ensemble particulier d'Ă©vĂ©nements : par exemple <a href="/fr/docs/Web/Events/click">click</a>, <a href="/fr/docs/Web/Events/mouseup">mouseup</a>, <a href="/fr/docs/Web/Events/submit">submit</a>. Si <code>allowPopupsForUserEvents</code> est dĂ©fini sur <code>false</code>, aucun Ă©vĂ©nement utilisateur ne pourra ouvrir des fenĂȘtres contextuelles. Si elle est dĂ©finie sur <code>true</code>, l'ensemble d'Ă©vĂ©nements par dĂ©faut sera autorisĂ© Ă ouvrir des fenĂȘtres contextuelles.</p> +Par dĂ©faut, les navigateurs permettent aux pages Web d'ouvrir des fenĂȘtres contextuelles en rĂ©ponse Ă un ensemble particulier d'Ă©vĂ©nements : par exemple [click](/fr/docs/Web/Events/click), [mouseup](/fr/docs/Web/Events/mouseup), [submit](/fr/docs/Web/Events/submit). Si `allowPopupsForUserEvents` est dĂ©fini sur `false`, aucun Ă©vĂ©nement utilisateur ne pourra ouvrir des fenĂȘtres contextuelles. Si elle est dĂ©finie sur `true`, l'ensemble d'Ă©vĂ©nements par dĂ©faut sera autorisĂ© Ă ouvrir des fenĂȘtres contextuelles. -<p>Par exemple, supposons qu'une page web comporte un code comme celui-ci :</p> +Par exemple, supposons qu'une page web comporte un code comme celui-ci : -<pre class="brush: js">window.addEventListener("click", (e) => { +```js +window.addEventListener("click", (e) => { window.open("https://example.com","myPopup",'height=400,width=400'); }); -</pre> +``` -<p>Par dĂ©faut, cela ouvrira une fenĂȘtre contextuelle. Si vos extensions dĂ©finient <code>allowPopupsForUserEvents</code> Ă <code>false</code>, cela n'ouvrira pas la fenĂȘtre contextuelle, et l'utilisateur sera informĂ© que le popup Ă©tait bloquĂ©.</p> +Par dĂ©faut, cela ouvrira une fenĂȘtre contextuelle. Si vos extensions dĂ©finient `allowPopupsForUserEvents` Ă `false`, cela n'ouvrira pas la fenĂȘtre contextuelle, et l'utilisateur sera informĂ© que le popup Ă©tait bloquĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.allowPopupsForUserEvents")}}</p> +{{Compat("webextensions.api.browserSettings.allowPopupsForUserEvents")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Basculer le rĂ©glage :</p> +Basculer le rĂ©glage : -<pre class="brush: js">function toggleAllowPopup() { +```js +function toggleAllowPopup() { function toggle(current) { console.log(`Current value: ${current.value}`); @@ -46,9 +48,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/allowPopupsFor browser.browserSettings.allowPopupsForUserEvents.get({}).then(toggle); } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { toggleAllowPopup(); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/cacheenabled/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/cacheenabled/index.md index df7a1e5500..3b798a864a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/cacheenabled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/cacheenabled/index.md @@ -12,35 +12,39 @@ tags: - cacheEnabled translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/cacheEnabled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour activer ou dĂ©sactiver globalement le cache du navigateur.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour activer ou dĂ©sactiver globalement le cache du navigateur. -<p>La valeur sous-jacente est un boolĂ©en.</p> +La valeur sous-jacente est un boolĂ©en. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.cacheEnabled")}}</p> +{{Compat("webextensions.api.browserSettings.cacheEnabled")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Obtenir une valeur actuelle de ce paramĂštre :</p> +Obtenir une valeur actuelle de ce paramĂštre : -<pre class="brush: js">function logResult(result) { +```js +function logResult(result) { console.log(`Current value: ${result.value}`); console.log(`Current level of control: ${result.levelOfControl}`); } browser.browserSettings.cacheEnabled.get({}). - then(logResult);</pre> + then(logResult); +``` -<p>DĂ©sactivation du cache du navigateur :</p> +DĂ©sactivation du cache du navigateur : -<pre class="brush: js">function logResult(result) { +```js +function logResult(result) { console.log(`Setting was modified: ${result}`); } browser.browserSettings.cacheEnabled.set({value: false}). - then(logResult);</pre> + then(logResult); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/closetabsbydoubleclick/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/closetabsbydoubleclick/index.md index 1bc3269a59..8bdab9f4a4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/closetabsbydoubleclick/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/closetabsbydoubleclick/index.md @@ -12,14 +12,14 @@ tags: - closeTabsByDoubleClick translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/closeTabsByDoubleClick --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour activer ou dĂ©sactiver la possibilitĂ© pour l'utilisateur de fermer un onglet en double-cliquant.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour activer ou dĂ©sactiver la possibilitĂ© pour l'utilisateur de fermer un onglet en double-cliquant. -<p>La valeur sous-jacente est un boolĂ©en.</p> +La valeur sous-jacente est un boolĂ©en. -<p>Par dĂ©faut, closeTabsByDoubleClick est faux. Le rĂ©glage peut ĂȘtre modifiĂ© par l'utilisateur dans about:config.</p> +Par dĂ©faut, closeTabsByDoubleClick est faux. Le rĂ©glage peut ĂȘtre modifiĂ© par l'utilisateur dans about:config. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.closeTabsByDoubleClick")}}</p> +{{Compat("webextensions.api.browserSettings.closeTabsByDoubleClick")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/contextmenushowevent/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/contextmenushowevent/index.md index 99c1f5dd1f..053b45d868 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/contextmenushowevent/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/contextmenushowevent/index.md @@ -12,27 +12,29 @@ tags: - contextMenuShowEvent translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/contextMenuShowEvent --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui dĂ©termine si le menu contextuel du navigateur est affichĂ© sur l'Ă©vĂ©nement mouseup ou sur l'Ă©vĂ©nement mousedown.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui dĂ©termine si le menu contextuel du navigateur est affichĂ© sur l'Ă©vĂ©nement mouseup ou sur l'Ă©vĂ©nement mousedown. -<p>Sa valeur sous-jacente est une chaĂźne qui peut ĂȘtre "mouseup" ou "mousedown".</p> +Sa valeur sous-jacente est une chaĂźne qui peut ĂȘtre "mouseup" ou "mousedown". -<p>La valeur par dĂ©faut est "mouseup" sur Windows, et "mousedown" sur macOS et Linux. 'affectation Ă Windows n'a aucun effet - le paramĂštre est uniquement conçu pour permettre l'ouverture du menu contextuel sur mouseup au lieu de mousedown, pas l'inverse.</p> +La valeur par dĂ©faut est "mouseup" sur Windows, et "mousedown" sur macOS et Linux. 'affectation Ă Windows n'a aucun effet - le paramĂštre est uniquement conçu pour permettre l'ouverture du menu contextuel sur mouseup au lieu de mousedown, pas l'inverse. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.contextMenuShowEvent")}}</p> +{{Compat("webextensions.api.browserSettings.contextMenuShowEvent")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>RĂ©glez le paramĂštre sur "mouseup":</p> +RĂ©glez le paramĂštre sur "mouseup": -<pre class="brush: js">function logResult(result) { +```js +function logResult(result) { console.log(`Setting was modified: ${result}`); } browser.browserSettings.contextMenuShowEvent.set({value: "mouseup"}). - then(logResult);</pre> + then(logResult); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/ftpprotocolenabled/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/ftpprotocolenabled/index.md index 592a79ed11..76e4a143ec 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/ftpprotocolenabled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/ftpprotocolenabled/index.md @@ -13,21 +13,22 @@ tags: - ftpProtocolEnabled translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/ftpProtocolEnabled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui dĂ©termine si le protocole FTP est activĂ© dans le navigateur.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui dĂ©termine si le protocole FTP est activĂ© dans le navigateur. -<p>La valeur sous-jaccente est un boolĂ©en.</p> +La valeur sous-jaccente est un boolĂ©en. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.ftpProtocolEnabled")}}</p> +{{Compat("webextensions.api.browserSettings.ftpProtocolEnabled")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Changer le rĂ©glage:</p> +Changer le rĂ©glage: -<pre class="brush: js">function toggleAllowFtp() { +```js +function toggleAllowFtp() { function toggle(current) { console.log(`Valeur actuelle: ${current.value}`); @@ -37,9 +38,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/ftpProtocolEna browser.browserSettings.ftpProtocolEnabled.get({}).then(toggle); } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { toggleAllowFtp(); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/homepageoverride/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/homepageoverride/index.md index e91be7db8d..ac06e90606 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/homepageoverride/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/homepageoverride/index.md @@ -12,23 +12,24 @@ tags: - homepageOverride translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/homepageOverride --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour obtenir une chaĂźne reprĂ©sentant l'URL actuellement dĂ©finie comme page d'accueil du navigateur.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour obtenir une chaĂźne reprĂ©sentant l'URL actuellement dĂ©finie comme page d'accueil du navigateur. -<p>Notez qu'il s'agit d'un paramĂštre en lecture seule. Pour changer la page d'accueil, voir <a href="/fr/Add-ons/WebExtensions/manifest.json/chrome_settings_overrides">chrome_settings_overrides</a>.</p> +Notez qu'il s'agit d'un paramĂštre en lecture seule. Pour changer la page d'accueil, voir [chrome_settings_overrides](/fr/Add-ons/WebExtensions/manifest.json/chrome_settings_overrides). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.homepageOverride", 10)}}</p> +{{Compat("webextensions.api.browserSettings.homepageOverride", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Obtenez la valeur actuelle de l'URL de la page d'accueil :</p> +Obtenez la valeur actuelle de l'URL de la page d'accueil : -<pre class="brush: js">browser.browserSettings.homepageOverride.get({}).then(result => { +```js +browser.browserSettings.homepageOverride.get({}).then(result => { console.log(result.value); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/imageanimationbehavior/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/imageanimationbehavior/index.md index aca79c796c..f0e8d39d2b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/imageanimationbehavior/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/imageanimationbehavior/index.md @@ -11,26 +11,26 @@ tags: - imageAnimationBehavior translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/imageAnimationBehavior --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour modifier la façon dont le navigateur traite les images animĂ©es, telles que les GIF.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour modifier la façon dont le navigateur traite les images animĂ©es, telles que les GIF. -<p>La valeur sous-jacente est une chaĂźne qui peut prendre l'une des trois valeurs suivantes:</p> +La valeur sous-jacente est une chaĂźne qui peut prendre l'une des trois valeurs suivantes: -<ul> - <li>"normal": la valeur par dĂ©faut Jouer des images animĂ©es comme d'habitude.</li> - <li>"none": n'anime pas les images du tout.</li> - <li>"once": joue une fois l'animation.</li> -</ul> +- "normal": la valeur par dĂ©faut Jouer des images animĂ©es comme d'habitude. +- "none": n'anime pas les images du tout. +- "once": joue une fois l'animation. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.imageAnimationBehavior", 10)}}</p> +{{Compat("webextensions.api.browserSettings.imageAnimationBehavior", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©sactiver les images animĂ©es :</p> +DĂ©sactiver les images animĂ©es : -<pre class="brush: js"> browser.browserSettings.imageAnimationBehavior.set({value: "none"});</pre> +```js + browser.browserSettings.imageAnimationBehavior.set({value: "none"}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/index.md index ef39e6380a..9a7cbe43fc 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/index.md @@ -11,61 +11,49 @@ tags: - browserSettings translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings --- -<div>{{AddonSidebar}}</div> - -<div>Permet Ă une extension de modifier certaines paramĂštres globaux du navigateur. Chaque propriĂ©tĂ© de cette API est un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}}, fournissant la possibilitĂ© de modifier un paramĂštre particulier.</div> - -<div></div> - -<div>Parce que ce sont les paramĂštres globaux, il est possible d'Ă©tendre les conflits des extensions. voir la documentation de <code><a href="/fr/Add-ons/WebExtensions/API/types/BrowserSetting/set">BrowserSetting.set()</a></code> pour plus dĂ©tails sur la façon dont les conflits sont traitĂ©s.</div> - -<div></div> - -<div> -<p>Pour utiliser cette API, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "browserSettings".</p> -</div> - -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> - -<dl> - <dt>{{WebExtAPIRef("browserSettings.allowPopupsForUserEvents")}}</dt> - <dd>DĂ©terminer si le code exĂ©cutĂ© dans les pages Web peut afficher les fenĂȘtres contextuelles en rĂ©ponse aux Ă©vĂ©nements utilisateur.</dd> - <dt>{{WebExtAPIRef("browserSettings.cacheEnabled")}}</dt> - <dd>DĂ©terminer si le cache du navigateur est activĂ© ou pas.</dd> - <dt>{{WebExtAPIRef("browserSettings.closeTabsByDoubleClick")}}</dt> - <dd>DĂ©termine si l'onglet sĂ©lectionnĂ© peut ĂȘtre fermĂ© en double-cliquant</dd> - <dt>{{WebExtAPIRef("browserSettings.contextMenuShowEvent")}}</dt> - <dd>DĂ©termine l'Ă©vĂ©nement de souris qui dĂ©clenche un menu contextuel.</dd> - <dt>{{WebExtAPIRef("browserSettings.ftpProtocolEnabled")}}</dt> - <dd>DĂ©termine si le protocole FTP est activĂ©.</dd> - <dt>{{WebExtAPIRef("browserSettings.homepageOverride")}}</dt> - <dd>Lire la valeur de la page d'accueil du navigateur.</dd> - <dt>{{WebExtAPIRef("browserSettings.imageAnimationBehavior")}}</dt> - <dd>DĂ©termine comment le navigateur traite les images animĂ©es.</dd> - <dt>{{WebExtAPIRef("browserSettings.newTabPageOverride")}}</dt> - <dd>Lire la valeur de la nouvelle page de l'onglet du navigateur.</dd> - <dt>{{WebExtAPIRef("browserSettings.newTabPosition")}}</dt> - <dd>ContrĂŽle la position des onglets nouvellement ouverts par rapport aux onglets dĂ©jĂ ouverts.</dd> - <dt>{{WebExtAPIRef("browserSettings.openBookmarksInNewTabs")}}</dt> - <dd>DĂ©termine si les signets sont ouverts dans l'onglet actuel ou dans un nouvel onglet.</dd> - <dt>{{WebExtAPIRef("browserSettings.openSearchResultsInNewTabs")}}</dt> - <dd>DĂ©termine si les rĂ©sultats de recherche sont ouverts dans l'onglet actuel ou dans un nouvel onglet.</dd> - <dt>{{WebExtAPIRef("browserSettings.openUrlbarResultsInNewTabs")}}</dt> - <dd>DĂ©termine si les suggestions de saisie semi-automatique de la barre d'adresse sont ouvertes dans l'onglet actuel ou dans un nouvel onglet.</dd> - <dt>{{WebExtAPIRef("browserSettings.overrideDocumentColors")}}</dt> - <dd>ContrĂŽle si les couleurs choisies par l'utilisateur remplacent les couleurs de la page.</dd> - <dt>{{WebExtAPIRef("browserSettings.useDocumentFonts")}}</dt> - <dd>ContrĂŽle si le navigateur utilisera les polices spĂ©cifiĂ©es par une page Web ou n'utilisera que des polices intĂ©grĂ©es.</dd> - <dt>{{WebExtAPIRef("browserSettings.webNotificationsDisabled")}}</dt> - <dd>EmpĂȘche les sites Web d'afficher des notifications Ă l'aide de la web API <code><a href="/fr/docs/Web/API/notification">Notification</a></code>.</dd> - <dt>{{WebExtAPIRef("browserSettings.zoomFullPage")}}</dt> - <dd>ContrĂŽle si le zoom est appliquĂ© Ă la page entiĂšre ou seulement au texte.</dd> - <dt>{{WebExtAPIRef("browserSettings.zoomSiteSpecific")}}</dt> - <dd>ContrĂŽle si le zoom est appliquĂ© sur un modĂšle par-site ou par-onglet. Si {{WebExtAPIRef("privacy.websites")}}<code>.resistFingerprinting</code> est Ă vrai, ce rĂ©glage n'a aucun effet et le modĂšle de zoom appliquĂ© reste par-onglet.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.browserSettings")}}</p> - -<p>{{WebExtExamples("h2")}}</p> +{{AddonSidebar}}Permet Ă une extension de modifier certaines paramĂštres globaux du navigateur. Chaque propriĂ©tĂ© de cette API est un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}}, fournissant la possibilitĂ© de modifier un paramĂštre particulier.Parce que ce sont les paramĂštres globaux, il est possible d'Ă©tendre les conflits des extensions. voir la documentation de [`BrowserSetting.set()`](/fr/Add-ons/WebExtensions/API/types/BrowserSetting/set) pour plus dĂ©tails sur la façon dont les conflits sont traitĂ©s. + +Pour utiliser cette API, vous devez avoir la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "browserSettings". + +## PropriĂ©tĂ©s + +- {{WebExtAPIRef("browserSettings.allowPopupsForUserEvents")}} + - : DĂ©terminer si le code exĂ©cutĂ© dans les pages Web peut afficher les fenĂȘtres contextuelles en rĂ©ponse aux Ă©vĂ©nements utilisateur. +- {{WebExtAPIRef("browserSettings.cacheEnabled")}} + - : DĂ©terminer si le cache du navigateur est activĂ© ou pas. +- {{WebExtAPIRef("browserSettings.closeTabsByDoubleClick")}} + - : DĂ©termine si l'onglet sĂ©lectionnĂ© peut ĂȘtre fermĂ© en double-cliquant +- {{WebExtAPIRef("browserSettings.contextMenuShowEvent")}} + - : DĂ©termine l'Ă©vĂ©nement de souris qui dĂ©clenche un menu contextuel. +- {{WebExtAPIRef("browserSettings.ftpProtocolEnabled")}} + - : DĂ©termine si le protocole FTP est activĂ©. +- {{WebExtAPIRef("browserSettings.homepageOverride")}} + - : Lire la valeur de la page d'accueil du navigateur. +- {{WebExtAPIRef("browserSettings.imageAnimationBehavior")}} + - : DĂ©termine comment le navigateur traite les images animĂ©es. +- {{WebExtAPIRef("browserSettings.newTabPageOverride")}} + - : Lire la valeur de la nouvelle page de l'onglet du navigateur. +- {{WebExtAPIRef("browserSettings.newTabPosition")}} + - : ContrĂŽle la position des onglets nouvellement ouverts par rapport aux onglets dĂ©jĂ ouverts. +- {{WebExtAPIRef("browserSettings.openBookmarksInNewTabs")}} + - : DĂ©termine si les signets sont ouverts dans l'onglet actuel ou dans un nouvel onglet. +- {{WebExtAPIRef("browserSettings.openSearchResultsInNewTabs")}} + - : DĂ©termine si les rĂ©sultats de recherche sont ouverts dans l'onglet actuel ou dans un nouvel onglet. +- {{WebExtAPIRef("browserSettings.openUrlbarResultsInNewTabs")}} + - : DĂ©termine si les suggestions de saisie semi-automatique de la barre d'adresse sont ouvertes dans l'onglet actuel ou dans un nouvel onglet. +- {{WebExtAPIRef("browserSettings.overrideDocumentColors")}} + - : ContrĂŽle si les couleurs choisies par l'utilisateur remplacent les couleurs de la page. +- {{WebExtAPIRef("browserSettings.useDocumentFonts")}} + - : ContrĂŽle si le navigateur utilisera les polices spĂ©cifiĂ©es par une page Web ou n'utilisera que des polices intĂ©grĂ©es. +- {{WebExtAPIRef("browserSettings.webNotificationsDisabled")}} + - : EmpĂȘche les sites Web d'afficher des notifications Ă l'aide de la web API [`Notification`](/fr/docs/Web/API/notification). +- {{WebExtAPIRef("browserSettings.zoomFullPage")}} + - : ContrĂŽle si le zoom est appliquĂ© Ă la page entiĂšre ou seulement au texte. +- {{WebExtAPIRef("browserSettings.zoomSiteSpecific")}} + - : ContrĂŽle si le zoom est appliquĂ© sur un modĂšle par-site ou par-onglet. Si {{WebExtAPIRef("privacy.websites")}}`.resistFingerprinting` est Ă vrai, ce rĂ©glage n'a aucun effet et le modĂšle de zoom appliquĂ© reste par-onglet. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.browserSettings")}} + +{{WebExtExamples("h2")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/newtabpageoverride/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/newtabpageoverride/index.md index 544110550b..3b7b16d57f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/newtabpageoverride/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/newtabpageoverride/index.md @@ -12,23 +12,24 @@ tags: - newTabPageOverride translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/newTabPageOverride --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour obtenir une chaĂźne reprĂ©sentant l'URL de la page "nouvel onglet": c'est-Ă -dire, la page chargĂ©e lorsque l'utilisateur ouvre une nouvelle onglet vide.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour obtenir une chaĂźne reprĂ©sentant l'URL de la page "nouvel onglet": c'est-Ă -dire, la page chargĂ©e lorsque l'utilisateur ouvre une nouvelle onglet vide. -<p>Notez qu'il s'agit d'un paramĂštre en lecture seule.</p> +Notez qu'il s'agit d'un paramĂštre en lecture seule. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.newTabPageOverride", 10)}}</p> +{{Compat("webextensions.api.browserSettings.newTabPageOverride", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Obtenir la valeur actuelle de la nouvelle URL de l'onglet :</p> +Obtenir la valeur actuelle de la nouvelle URL de l'onglet : -<pre class="brush: js">browser.browserSettings.newTabPageOverride.get({}).then(result => { +```js +browser.browserSettings.newTabPageOverride.get({}).then(result => { console.log(result.value); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/newtabposition/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/newtabposition/index.md index 7acc08e98a..0ee1033c2e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/newtabposition/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/newtabposition/index.md @@ -3,32 +3,31 @@ title: browserSettings.newTabPosition slug: Mozilla/Add-ons/WebExtensions/API/browserSettings/newTabPosition translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/newTabPosition --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour contrĂŽler la position des onglets nouvellement ouverts par rapport aux onglets dĂ©jĂ ouverts.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour contrĂŽler la position des onglets nouvellement ouverts par rapport aux onglets dĂ©jĂ ouverts. -<p>La valeur sous-jacente est une chaĂźne qui peut prendre l'une des trois valeurs suivantes :</p> +La valeur sous-jacente est une chaĂźne qui peut prendre l'une des trois valeurs suivantes : -<ul> - <li>"afterCurrent": ouvre tous les nouveaux onglets Ă cĂŽtĂ© de l'onglet actuel.</li> - <li>"relatedAfterCurrent": La valeur par dĂ©faut. Ouvrez les nouveaux onglets Ă cĂŽtĂ© de l'onglet en cours s'ils sont liĂ©s Ă l'onglet en cours (par exemple, s'ils ont Ă©tĂ© ouverts via un lien dans l'onglet en cours). Sinon, ouvrez les nouveaux onglets Ă la fin de la bande d'onglets.</li> - <li>"atEnd": ouvre tous les onglets Ă la fin de la bande d'onglets.</li> -</ul> +- "afterCurrent": ouvre tous les nouveaux onglets Ă cĂŽtĂ© de l'onglet actuel. +- "relatedAfterCurrent": La valeur par dĂ©faut. Ouvrez les nouveaux onglets Ă cĂŽtĂ© de l'onglet en cours s'ils sont liĂ©s Ă l'onglet en cours (par exemple, s'ils ont Ă©tĂ© ouverts via un lien dans l'onglet en cours). Sinon, ouvrez les nouveaux onglets Ă la fin de la bande d'onglets. +- "atEnd": ouvre tous les onglets Ă la fin de la bande d'onglets. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.newTabPosition", 10)}}</p> +{{Compat("webextensions.api.browserSettings.newTabPosition", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code dĂ©finit la valeur Ă "afterCurrent" puis enregistre la nouvelle valeur :</p> +Ce code dĂ©finit la valeur Ă "afterCurrent" puis enregistre la nouvelle valeur : -<pre class="brush: js">async function setAfterCurrent() { +```js +async function setAfterCurrent() {  let result = await browser.browserSettings.newTabPosition.set({value: "afterCurrent"});  console.log(`Result: ${result}`);  let newValue = await browser.browserSettings.newTabPosition.get({});  console.log(`New value: ${newValue.value}`); } -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/openbookmarksinnewtabs/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/openbookmarksinnewtabs/index.md index b83b8657b1..98f935eca1 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/openbookmarksinnewtabs/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/openbookmarksinnewtabs/index.md @@ -12,25 +12,27 @@ tags: - openBookmarksInNewTabs translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/openBookmarksInNewTabs --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. -<p>Si la valeur est <code>true</code>, alors lorsque l'utilisateur sĂ©lectionne un signet, il sera ouvert dans un nouvel onglet. Si la valeur est<code>false</code> (valeur par dĂ©faut), les marque-pages sont ouverts dans l'onglet en cours.</p> +Si la valeur est `true`, alors lorsque l'utilisateur sĂ©lectionne un signet, il sera ouvert dans un nouvel onglet. Si la valeur est`false` (valeur par dĂ©faut), les marque-pages sont ouverts dans l'onglet en cours. -<h2 id="CompatibilitĂ©_de_navigateur">CompatibilitĂ© de navigateur</h2> +## CompatibilitĂ© de navigateur -<p>{{Compat("webextensions.api.browserSettings.openBookmarksInNewTabs")}}</p> +{{Compat("webextensions.api.browserSettings.openBookmarksInNewTabs")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©finissez le paramĂštre sur <code>true</code>:</p> +DĂ©finissez le paramĂštre sur `true`: -<pre class="brush: js">function logResult(result) { +```js +function logResult(result) { console.log(`Setting was modified: ${result}`); } browser.browserSettings.openBookmarksInNewTabs.set({value: true}). - then(logResult);</pre> + then(logResult); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/opensearchresultsinnewtabs/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/opensearchresultsinnewtabs/index.md index 0c2873fd64..23f86a3e9b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/opensearchresultsinnewtabs/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/opensearchresultsinnewtabs/index.md @@ -12,27 +12,29 @@ tags: - openSearchResultsInNewTabs translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/openSearchResultsInNewTabs --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. -<p>Si la valeur est dĂ©finie Ă <code>true</code>, lorsque l'utilisateur sĂ©lectionne un terme dans la zone de recherche du navigateur, les rĂ©sultats de la recherche s'affichent dans un nouvel onglet. Si la valeur est <code>false</code> (valeur par dĂ©faut), les rĂ©sultats de la recherche apparaissent dans l'onglet en cours.</p> +Si la valeur est dĂ©finie Ă `true`, lorsque l'utilisateur sĂ©lectionne un terme dans la zone de recherche du navigateur, les rĂ©sultats de la recherche s'affichent dans un nouvel onglet. Si la valeur est `false` (valeur par dĂ©faut), les rĂ©sultats de la recherche apparaissent dans l'onglet en cours. -<p>Notez que cela n'affecte pas le comportement lors de la sĂ©lection des Ă©lĂ©ments de omnibox/awesomebar, uniquement la zone de recherche dĂ©diĂ©e..</p> +Notez que cela n'affecte pas le comportement lors de la sĂ©lection des Ă©lĂ©ments de omnibox/awesomebar, uniquement la zone de recherche dĂ©diĂ©e.. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.openSearchResultsInNewTabs")}}</p> +{{Compat("webextensions.api.browserSettings.openSearchResultsInNewTabs")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©finissez le paramĂštre sur <code>true</code>:</p> +DĂ©finissez le paramĂštre sur `true`: -<pre class="brush: js">function logResult(result) { +```js +function logResult(result) { console.log(`Setting was modified: ${result}`); } browser.browserSettings.openSearchResultsInNewTabs.set({value: true}). - then(logResult);</pre> + then(logResult); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/openurlbarresultsinnewtabs/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/openurlbarresultsinnewtabs/index.md index 40d8b35aaf..fb65282c6d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/openurlbarresultsinnewtabs/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/openurlbarresultsinnewtabs/index.md @@ -12,27 +12,29 @@ tags: - openUrlbarResultsInNewTabs translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/openUrlbarResultsInNewTabs --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. -<p>Quand l'utilisateur facalise la barre d'adresse et commence Ă taper, le navigateur propose des suggestions de saisie semi-automatique : une liste dĂ©roulante de pages web basĂ©e sur l'entrĂ©e incomplĂšte de l'utilisateur et son historique de navigation.</p> +Quand l'utilisateur facalise la barre d'adresse et commence Ă taper, le navigateur propose des suggestions de saisie semi-automatique : une liste dĂ©roulante de pages web basĂ©e sur l'entrĂ©e incomplĂšte de l'utilisateur et son historique de navigation. -<p>Si la valeur est <code>true</code>, alors lorsque l'utiliseur sĂ©lectionne l'un des Ă©lĂ©ments, l'Ă©lĂ©ment est ouvert dans un nouvel onglet. Si la valeur est <code>false</code> (valeur par dĂ©faut) l'Ă©lĂ©ment est ouvert dans l'onglet en cours.</p> +Si la valeur est `true`, alors lorsque l'utiliseur sĂ©lectionne l'un des Ă©lĂ©ments, l'Ă©lĂ©ment est ouvert dans un nouvel onglet. Si la valeur est `false` (valeur par dĂ©faut) l'Ă©lĂ©ment est ouvert dans l'onglet en cours. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.openUrlbarResultsInNewTabs")}}</p> +{{Compat("webextensions.api.browserSettings.openUrlbarResultsInNewTabs")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©finit le paramĂštre Ă <code>true</code>:</p> +DĂ©finit le paramĂštre Ă `true`: -<pre class="brush: js">function logResult(result) { +```js +function logResult(result) { console.log(`Setting was modified: ${result}`); } browser.browserSettings.openUrlbarResultsInNewTabs.set({value: true}). - then(logResult);</pre> + then(logResult); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/overridedocumentcolors/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/overridedocumentcolors/index.md index 13946e6f18..73a6198499 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/overridedocumentcolors/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/overridedocumentcolors/index.md @@ -12,33 +12,33 @@ tags: - overrideDocumentColors translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/overrideDocumentColors --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jacente est une chaĂźne.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jacente est une chaĂźne. -<p>Firefox permet Ă l'utilisateur de dĂ©finir ses propres couleurs pour les arriĂšre-plans et le texte du document. Par dĂ©faut, ces valeurs ne sont appliquĂ©es que lorsqu'un thĂšme Ă fort contraste est sĂ©lectionnĂ© (un thĂšme Ă contraste Ă©levĂ© est une caractĂ©ristique de certaines interfaces utilisateur du systĂšme d'exploitation qui augmente le contraste pour une meilleure accessibilitĂ©). Cependant, les utilisateurs peuvent Ă©galement choisir d'appliquer ces couleurs toujours ou jamais. Ce paramĂštre du navigateur expose cette prĂ©fĂ©rence.</p> +Firefox permet Ă l'utilisateur de dĂ©finir ses propres couleurs pour les arriĂšre-plans et le texte du document. Par dĂ©faut, ces valeurs ne sont appliquĂ©es que lorsqu'un thĂšme Ă fort contraste est sĂ©lectionnĂ© (un thĂšme Ă contraste Ă©levĂ© est une caractĂ©ristique de certaines interfaces utilisateur du systĂšme d'exploitation qui augmente le contraste pour une meilleure accessibilitĂ©). Cependant, les utilisateurs peuvent Ă©galement choisir d'appliquer ces couleurs toujours ou jamais. Ce paramĂštre du navigateur expose cette prĂ©fĂ©rence. -<p>Sa valeur sous-jacente est une chaĂźne qui peut prendre l'une des valeurs suivantes:</p> +Sa valeur sous-jacente est une chaĂźne qui peut prendre l'une des valeurs suivantes: -<ul> - <li>"high-contrast-only": applique les choix de l'utilisateur uniquement lorsqu'un thĂšme Ă contraste Ă©levĂ© est sĂ©lectionnĂ©. C'est la valeur par dĂ©faut.</li> - <li>"never": n'applique jamais les choix de l'utilisateur</li> - <li>"always": Toujours appliquer les choix de l'utilisateur.</li> -</ul> +- "high-contrast-only": applique les choix de l'utilisateur uniquement lorsqu'un thĂšme Ă contraste Ă©levĂ© est sĂ©lectionnĂ©. C'est la valeur par dĂ©faut. +- "never": n'applique jamais les choix de l'utilisateur +- "always": Toujours appliquer les choix de l'utilisateur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.openUrlbarResultsInNewTabs")}}</p> +{{Compat("webextensions.api.browserSettings.openUrlbarResultsInNewTabs")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©finissez le paramĂštre sur "always":</p> +DĂ©finissez le paramĂštre sur "always": -<pre class="brush: js">function logResult(result) { +```js +function logResult(result) { console.log(`Setting was modified: ${result}`); } browser.browserSettings.overrideDocumentColors.set({value: "always"}). - then(logResult);</pre> + then(logResult); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/usedocumentfonts/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/usedocumentfonts/index.md index fc9a4ee16c..6add95e654 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/usedocumentfonts/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/usedocumentfonts/index.md @@ -12,32 +12,32 @@ tags: - useDocumentFonts translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/useDocumentFonts --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. -<p>Par dĂ©faut, bien sĂ»r, les pages Web peuvent spĂ©cifier les polices qu'ils veulent utiliser les propriĂ©tĂ©s CSS comme <code><a href="/fr/docs/Web/CSS/font-family">font-family</a></code>. Ce paramĂštre permet Ă une extension d'indiquer Ă Firefox d'ignorer les polices spĂ©cifiĂ©es par la page et d'utiliser uniquement les polices systĂšme.</p> +Par dĂ©faut, bien sĂ»r, les pages Web peuvent spĂ©cifier les polices qu'ils veulent utiliser les propriĂ©tĂ©s CSS comme [`font-family`](/fr/docs/Web/CSS/font-family). Ce paramĂštre permet Ă une extension d'indiquer Ă Firefox d'ignorer les polices spĂ©cifiĂ©es par la page et d'utiliser uniquement les polices systĂšme. -<p>Sa valeur sous-jacente est un boolĂ©en :</p> +Sa valeur sous-jacente est un boolĂ©en : -<ul> - <li><code>true</code>: utilise les polices spĂ©cifiĂ©es par la page Web. C'est la valeur par dĂ©faut.</li> - <li><code>false</code>: utilise les polices du systĂšme.</li> -</ul> +- `true`: utilise les polices spĂ©cifiĂ©es par la page Web. C'est la valeur par dĂ©faut. +- `false`: utilise les polices du systĂšme. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.useDocumentFonts")}}</p> +{{Compat("webextensions.api.browserSettings.useDocumentFonts")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©finissez le paramĂštre sur <code>false</code>:</p> +DĂ©finissez le paramĂštre sur `false`: -<pre class="brush: js">function logResult(result) { +```js +function logResult(result) { console.log(`Setting was modified: ${result}`); } browser.browserSettings.useDocumentFonts.set({value: false}). - then(logResult);</pre> + then(logResult); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/webnotificationsdisabled/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/webnotificationsdisabled/index.md index 799854cd60..24413ee57e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/webnotificationsdisabled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/webnotificationsdisabled/index.md @@ -12,36 +12,38 @@ tags: - webNotificationsDisabled translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/webNotificationsDisabled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour empĂȘcher les sites Web d'afficher des <code><a href="/fr/docs/Web/API/Notifications_API">Notifications</a></code> Ă l'aide de l'API Web de notifications.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour empĂȘcher les sites Web d'afficher des [`Notifications`](/fr/docs/Web/API/Notifications_API) Ă l'aide de l'API Web de notifications. -<p>L'API <code>Notifications</code> est utilisĂ©e pour afficher les notifications de bureau Ă l'utilisateur. Il existe trois niveaux d'autorisation pour les notifications :<em> allow</em>,<em> deny</em>, et <em>prompt</em>. Les utilisateurs peuvent dĂ©finir cette autorisation pour chaque site. Si l'utilisateur n'a pas dĂ©fini d'autorisation pour un site particulier, le navigateur reviendra Ă une autorisation globale, qui sera par dĂ©faut <em>invitĂ©</em>e.</p> +L'API `Notifications` est utilisĂ©e pour afficher les notifications de bureau Ă l'utilisateur. Il existe trois niveaux d'autorisation pour les notifications : _allow_, _deny_, et _prompt_. Les utilisateurs peuvent dĂ©finir cette autorisation pour chaque site. Si l'utilisateur n'a pas dĂ©fini d'autorisation pour un site particulier, le navigateur reviendra Ă une autorisation globale, qui sera par dĂ©faut *invitĂ©*e. -<p>DĂ©finir <code>browserSettings.webNotificationsDisabled</code> Ă <code>true</code> change l'autorisation globale Ă <em> refuser</em>.</p> +DĂ©finir `browserSettings.webNotificationsDisabled` Ă `true` change l'autorisation globale Ă _refuser_. -<p>Notez que cela n'affectera pas les sites pour lesquels l'utilisateur a dĂ©fini une prĂ©fĂ©rence par site. Par exemple, si l'utilisateur dĂ©finit <a href="https://example.org">https://example.org</a> pour<em> autoriser</em>, et une extension place ensuite <code>browserSettings.webNotificationsDisabled</code> Ă <code>true</code>, alors les pages sous <a href="https://example.org">https://example.org </a>seront toujours autorisĂ©es Ă afficher des notifications..</p> +Notez que cela n'affectera pas les sites pour lesquels l'utilisateur a dĂ©fini une prĂ©fĂ©rence par site. Par exemple, si l'utilisateur dĂ©finit <https://example.org> pour _autoriser_, et une extension place ensuite `browserSettings.webNotificationsDisabled` Ă `true`, alors les pages sous [https://example.org ](https://example.org)seront toujours autorisĂ©es Ă afficher des notifications.. -<p>Si vous dĂ©finissez <code>browserSettings.webNotificationsDisabled</code> Ă <code>false</code> la valeur par dĂ©faut globale est rĂ©tablie.</p> +Si vous dĂ©finissez `browserSettings.webNotificationsDisabled` Ă `false` la valeur par dĂ©faut globale est rĂ©tablie. -<p>Notez que ce paramĂštre n'a aucun effet sur les notifications crĂ©Ă©es par des extensions Ă l'aide de l'API de <code><a href="/fr/Add-ons/WebExtensions/API/notifications">notifications</a></code>.</p> +Notez que ce paramĂštre n'a aucun effet sur les notifications crĂ©Ă©es par des extensions Ă l'aide de l'API de [`notifications`](/fr/Add-ons/WebExtensions/API/notifications). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.webNotificationsDisabled")}}</p> +{{Compat("webextensions.api.browserSettings.webNotificationsDisabled")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Basculer le paramĂštre :</p> +Basculer le paramĂštre : -<pre class="brush: js">async function toggleWebNotifications() { +```js +async function toggleWebNotifications() { let current = await browser.browserSettings.webNotificationsDisabled.get({}); console.log(`Current value: ${current.value}`); browser.browserSettings.webNotificationsDisabled.set({value: !current.value}); } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { toggleWebNotifications(); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/zoomfullpage/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/zoomfullpage/index.md index 044dcf1a7f..289aafea66 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/zoomfullpage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/zoomfullpage/index.md @@ -12,32 +12,32 @@ tags: - zoomFullPage translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/zoomFullPage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jaccente est un boolĂ©en.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jaccente est un boolĂ©en. -<p>Par dĂ©faut, le zoom s'applique Ă la page web entiĂšre. En utilisant le <a href="https://support.mozilla.org/fr/kb/taille-police-zoom-augmenter-taille-pages#w_daefinir-un-niveau-de-zoom-par-daefaut-pour-tous-les-sites-web">Zoom Text Only setting</a> les utilisateurs/utilisatrices peuvent choisir de zoomer uniquement le texte de la page. Ce rĂ©glage permet Ă une web extension de modifier et de dĂ©terminer la valeur du paramĂštre, le zoom est appliquĂ© Ă la page entiĂšre ou bien au texte seulement.</p> +Par dĂ©faut, le zoom s'applique Ă la page web entiĂšre. En utilisant le [Zoom Text Only setting](https://support.mozilla.org/fr/kb/taille-police-zoom-augmenter-taille-pages#w_daefinir-un-niveau-de-zoom-par-daefaut-pour-tous-les-sites-web) les utilisateurs/utilisatrices peuvent choisir de zoomer uniquement le texte de la page. Ce rĂ©glage permet Ă une web extension de modifier et de dĂ©terminer la valeur du paramĂštre, le zoom est appliquĂ© Ă la page entiĂšre ou bien au texte seulement. -<p>Valeurs du paramĂštre:</p> +Valeurs du paramĂštre: -<ul> - <li><code>true</code>: le zoom s'applique Ă la page web en entier (par dĂ©faut).</li> - <li><code>false</code>: le zoom s'applique au texte de la page web seulement.</li> -</ul> +- `true`: le zoom s'applique Ă la page web en entier (par dĂ©faut). +- `false`: le zoom s'applique au texte de la page web seulement. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.zoomFullPage")}}</p> +{{Compat("webextensions.api.browserSettings.zoomFullPage")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Mettre le rĂ©glage Ă <code>false</code>:</p> +Mettre le rĂ©glage Ă `false`: -<pre class="brush: js">function afficherResultat(resultat) { +```js +function afficherResultat(resultat) { console.log(`Le paramĂštre a Ă©tĂ© modifiĂ©: ${resultat}`); } browser.browserSettings.zoomFullPage.set({value: false}). - then(afficherResultat);</pre> + then(afficherResultat); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/zoomsitespecific/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/zoomsitespecific/index.md index 35121f3702..fcaae13ff8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsersettings/zoomsitespecific/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsersettings/zoomsitespecific/index.md @@ -11,43 +11,41 @@ tags: - zoomSiteSpecific translation_of: Mozilla/Add-ons/WebExtensions/API/browserSettings/zoomSiteSpecific --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jaccente est un boolĂ©en.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} dont la valeur sous-jaccente est un boolĂ©en. -<p>Cette propriĂ©tĂ© contrĂŽle le <a href="https://support.mozilla.org/fr/kb/editeur-configuration-firefox">rĂ©glage de configuration</a><code> browser.zoom.siteSpecific</code>, qui rĂšgle comment le zoom est appliquĂ© aux sites et onglets.</p> +Cette propriĂ©tĂ© contrĂŽle le [rĂ©glage de configuration](https://support.mozilla.org/fr/kb/editeur-configuration-firefox)` browser.zoom.siteSpecific`, qui rĂšgle comment le zoom est appliquĂ© aux sites et onglets. -<p>Si <code>browser.zoom.siteSpecific</code> est Ă vrai, les opĂ©rations de zoom s'appliquent Ă toutes les pages du mĂȘme site selon les rĂšgles :</p> +Si `browser.zoom.siteSpecific` est Ă vrai, les opĂ©rations de zoom s'appliquent Ă toutes les pages du mĂȘme site selon les rĂšgles : -<ul> - <li>quand une page charge, si il existe un niveau de zoom pour ce site alors il est appliquĂ© par le navigateur sinon le niveau de zoom par dĂ©faut "global" est appliquĂ©.</li> - <li>quand le niveau de zoom change pour une page, le niveau des autres pages (dans d'autres onglets) de ce site sont mises Ă jour.</li> -</ul> +- quand une page charge, si il existe un niveau de zoom pour ce site alors il est appliquĂ© par le navigateur sinon le niveau de zoom par dĂ©faut "global" est appliquĂ©. +- quand le niveau de zoom change pour une page, le niveau des autres pages (dans d'autres onglets) de ce site sont mises Ă jour. -<p>Si la prĂ©fĂ©rence <code>browser.zoom.siteSpecific</code> est Ă faux, les opĂ©rations de zoom s'appliquent uniquement Ă l'onglet actif selon les rĂšgles :</p> +Si la prĂ©fĂ©rence `browser.zoom.siteSpecific` est Ă faux, les opĂ©rations de zoom s'appliquent uniquement Ă l'onglet actif selon les rĂšgles : -<ul> - <li>quand un nouvel onglet s'ouvre, le niveau de zoom par dĂ©faut "global" est appliquĂ©.</li> - <li>quand le niveau de zoom change dans un onglet, il sera appliquĂ© durant toute la navigation dans cet onglet et n'affectera pas le niveau de zoom des autres onglets.</li> -</ul> +- quand un nouvel onglet s'ouvre, le niveau de zoom par dĂ©faut "global" est appliquĂ©. +- quand le niveau de zoom change dans un onglet, il sera appliquĂ© durant toute la navigation dans cet onglet et n'affectera pas le niveau de zoom des autres onglets. -<p>Lors de l'installation de Firefox, <code>browser.zoom.siteSpecific</code> est Ă vrai.</p> +Lors de l'installation de Firefox, `browser.zoom.siteSpecific` est Ă vrai. -<p>Si <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/privacy/websites"><code>privacy.websites</code></a><code>.resistFingerprinting</code> est Ă vrai, ce rĂ©glage ne peut pas ĂȘtre changĂ© et le niveau de zoom est appliquĂ© sur le schĂ©ma par-onglet.</p> +Si [`privacy.websites`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/privacy/websites)`.resistFingerprinting` est Ă vrai, ce rĂ©glage ne peut pas ĂȘtre changĂ© et le niveau de zoom est appliquĂ© sur le schĂ©ma par-onglet. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browserSettings.zoomSiteSpecific")}}</p> +{{Compat("webextensions.api.browserSettings.zoomSiteSpecific")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Mettre le rĂ©glage Ă <code>false</code>:</p> +Mettre le rĂ©glage Ă `false`: -<pre class="brush: js">function logResult(result) { +```js +function logResult(result) { console.log(`Setting was modified: ${result}`); } browser.browserSettings.zoomSiteSpecific.set({value: false}). - then(logResult);</pre> + then(logResult); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/datatypeset/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/datatypeset/index.md index 19b6f90179..e471a1800b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/datatypeset/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/datatypeset/index.md @@ -12,63 +12,57 @@ tags: - browsingData translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/DataTypeSet --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <strong><code>browsingData.DataTypeSet</code></strong> dĂ©crit un ensemble de types de donnĂ©es.</p> +Le type **`browsingData.DataTypeSet`** dĂ©crit un ensemble de types de donnĂ©es. -<p>Il contient un certains nombres de propriĂ©tĂ©s boolĂ©ennes. Le nom de chaque propriĂ©tĂ© est le nom d'un type particulier de donnĂ©es de navigations : "TĂ©lĂ©chargements", "historique" et ainsi de suite. Toutes les propriĂ©tĂ©s sont facultatives.</p> +Il contient un certains nombres de propriĂ©tĂ©s boolĂ©ennes. Le nom de chaque propriĂ©tĂ© est le nom d'un type particulier de donnĂ©es de navigations : "TĂ©lĂ©chargements", "historique" et ainsi de suite. Toutes les propriĂ©tĂ©s sont facultatives. -<p>Ce type est utilisĂ© :</p> +Ce type est utilisĂ© : -<ul> - <li>dans {{WebExtAPIRef("browsingData.remove()")}} pour dĂ©crire les types de donnĂ©es Ă supprimer</li> - <li>dans {{WebExtAPIRef("browsingData.settings()")}} pour dĂ©crire les types de donnĂ©es actuellement sĂ©lectionnĂ©s dans la fonction "effacer l'historique" du navigateur.</li> -</ul> +- dans {{WebExtAPIRef("browsingData.remove()")}} pour dĂ©crire les types de donnĂ©es Ă supprimer +- dans {{WebExtAPIRef("browsingData.settings()")}} pour dĂ©crire les types de donnĂ©es actuellement sĂ©lectionnĂ©s dans la fonction "effacer l'historique" du navigateur. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>cache</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Le cache du navigateur</dd> - <dt><code>cookies</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Cookies acquis en cours de la navigation.</dd> - <dt><code>downloads</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. L'historique de tĂ©lĂ©chargement de l'utilisateur.</dd> - <dt><code>fileSystems</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Les systĂšmes de fichiers du site Web.</dd> - <dt><code>formData</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. DonnĂ©es de formulaire enregistrĂ©es, pour la saisie semi-automatique.</dd> - <dt><code>history</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. L'histoire de navigation de l'utilisateur.</dd> - <dt><code>indexedDB</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. DonnĂ©es IndexedDB.</dd> - <dt><code>localStorage</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. DonnĂ©es de stockage local.</dd> - <dt><code>passwords</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Mots de pass enregistrĂ©s, pour la saisie semi-automatique.</dd> - <dt><code>pluginData</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. DonnĂ©es stockĂ©es associĂ©es aux plugins.</dd> - <dt><code>serverBoundCertificates</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Certificats liĂ©s au serveur stockĂ©s.</dd> - <dt><code>serviceWorkers</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. DonnĂ©es mises en cache par les travailleurs du service.</dd> -</dl> +- `cache` {{optional_inline}} + - : `boolean`. Le cache du navigateur +- `cookies` {{optional_inline}} + - : `boolean`. Cookies acquis en cours de la navigation. +- `downloads` {{optional_inline}} + - : `boolean`. L'historique de tĂ©lĂ©chargement de l'utilisateur. +- `fileSystems` {{optional_inline}} + - : `boolean`. Les systĂšmes de fichiers du site Web. +- `formData` {{optional_inline}} + - : `boolean`. DonnĂ©es de formulaire enregistrĂ©es, pour la saisie semi-automatique. +- `history` {{optional_inline}} + - : `boolean`. L'histoire de navigation de l'utilisateur. +- `indexedDB` {{optional_inline}} + - : `boolean`. DonnĂ©es IndexedDB. +- `localStorage` {{optional_inline}} + - : `boolean`. DonnĂ©es de stockage local. +- `passwords` {{optional_inline}} + - : `boolean`. Mots de pass enregistrĂ©s, pour la saisie semi-automatique. +- `pluginData` {{optional_inline}} + - : `boolean`. DonnĂ©es stockĂ©es associĂ©es aux plugins. +- `serverBoundCertificates` {{optional_inline}} + - : `boolean`. Certificats liĂ©s au serveur stockĂ©s. +- `serviceWorkers` {{optional_inline}} + - : `boolean`. DonnĂ©es mises en cache par les travailleurs du service. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browsingData.DataTypeSet")}}</p> +{{Compat("webextensions.api.browsingData.DataTypeSet")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). +> +> 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/browsingData"><code>chrome.browsingData</code></a>.</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 @@ -95,5 +89,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/DataTypeSet // 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/browsingdata/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/index.md index fb8a350fa3..5caea7fed8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/index.md @@ -11,87 +11,75 @@ tags: - browsingData translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Permet aux extensions d'effacer les donnĂ©es accumulĂ©es pendant la navigation de l'utilisateur.</p> +Permet aux extensions d'effacer les donnĂ©es accumulĂ©es pendant la navigation de l'utilisateur. -<p>Dans l'API <code>browsingData</code>, les donnĂ©es de navigations sont divisĂ©es en types :</p> +Dans l'API `browsingData`, les donnĂ©es de navigations sont divisĂ©es en types : -<ul> - <li>cache du navigateur</li> - <li>cookies</li> - <li>TĂ©lĂ©chargements</li> - <li>historique</li> - <li>stockage local</li> - <li>donnĂ©es du plugin</li> - <li>donnĂ©es de formulaire enregistrĂ©es</li> - <li>Mots de passe enregistrĂ©s</li> -</ul> +- cache du navigateur +- cookies +- TĂ©lĂ©chargements +- historique +- stockage local +- donnĂ©es du plugin +- donnĂ©es de formulaire enregistrĂ©es +- Mots de passe enregistrĂ©s -<p>Vous pouvez utiliser la fonction {{WebExtAPIRef("browsingData.remove()")}} pour supprimer toute combinaison de ces types. Il existe Ă©galement des fonctions dĂ©diĂ©es pour supprimer chaque type particulier de donnĂ©es, comme {{WebExtAPIRef("browsingData.removePasswords()", "removePasswords()")}}, {{WebExtAPIRef("browsingData.removeHistory()", "removeHistory()")}} etc.</p> +Vous pouvez utiliser la fonction {{WebExtAPIRef("browsingData.remove()")}} pour supprimer toute combinaison de ces types. Il existe Ă©galement des fonctions dĂ©diĂ©es pour supprimer chaque type particulier de donnĂ©es, comme {{WebExtAPIRef("browsingData.removePasswords()", "removePasswords()")}}, {{WebExtAPIRef("browsingData.removeHistory()", "removeHistory()")}} etc. -<p>Toutes les fonctions <code>browsingData.remove[X]()</code> prennent un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} que vous pouvez utiliser pour contrĂŽler deux autres aspects de la suppression des donnĂ©es :</p> +Toutes les fonctions `browsingData.remove[X]()` prennent un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} que vous pouvez utiliser pour contrĂŽler deux autres aspects de la suppression des donnĂ©es : -<ul> - <li>dans quelle mesure remonter dans le temps pour supprimer des donnĂ©es</li> - <li>qu'il s'agisse de supprimer des donnĂ©es uniquement de pages Web normales ou d'applications Web hĂ©bergĂ©es et de modules complĂ©mentaires. Notez que cette option n'est pas encore supportĂ©e dans Firefox.</li> -</ul> +- dans quelle mesure remonter dans le temps pour supprimer des donnĂ©es +- qu'il s'agisse de supprimer des donnĂ©es uniquement de pages Web normales ou d'applications Web hĂ©bergĂ©es et de modules complĂ©mentaires. Notez que cette option n'est pas encore supportĂ©e dans Firefox. -<p>Enfin, cette API vous donne une fonction {{WebExtAPIRef("browsingData.settings()")}} qui vous donne la valeur actuelle des paramĂštres de la fonction "Effacer l'historique" du navigateur.</p> +Enfin, cette API vous donne une fonction {{WebExtAPIRef("browsingData.settings()")}} qui vous donne la valeur actuelle des paramĂštres de la fonction "Effacer l'historique" du navigateur. -<p>Pour utiliser cette API, vous devez disposer de l'<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">API permission</a> "browseData".</p> +Pour utiliser cette API, vous devez disposer de l'[API permission](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "browseData". -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("browsingData.DataTypeSet")}}</dt> - <dd>Objet utilisĂ© pour spĂ©cifier le type de donnĂ©es Ă supprimer: par exemple, l'historique, les tĂ©lĂ©chargements, les mots de passe, etc.</dd> - <dt>{{WebExtAPIRef("browsingData.RemovalOptions")}}</dt> - <dd>Objet utilisĂ© pour spĂ©cifier le retour arriĂšre des donnĂ©es, et la suppression des donnĂ©es ajoutĂ©es par le biais de la navigation Web normale, des applications hĂ©bergĂ©es ou des modules complĂ©mentaires.</dd> -</dl> +- {{WebExtAPIRef("browsingData.DataTypeSet")}} + - : Objet utilisĂ© pour spĂ©cifier le type de donnĂ©es Ă supprimer: par exemple, l'historique, les tĂ©lĂ©chargements, les mots de passe, etc. +- {{WebExtAPIRef("browsingData.RemovalOptions")}} + - : Objet utilisĂ© pour spĂ©cifier le retour arriĂšre des donnĂ©es, et la suppression des donnĂ©es ajoutĂ©es par le biais de la navigation Web normale, des applications hĂ©bergĂ©es ou des modules complĂ©mentaires. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +## MĂ©thodes -<dl> - <dt>{{WebExtAPIRef("browsingData.remove()")}}</dt> - <dd>Supprime les donnĂ©es de navigation pour les types de donnĂ©es spĂ©cifiĂ©s.</dd> - <dt>{{WebExtAPIRef("browsingData.removeCache()")}}</dt> - <dd>Efface le cache du navigateur.</dd> - <dt>{{WebExtAPIRef("browsingData.removeCookies()")}}</dt> - <dd>Supprime les cookies</dd> - <dt>{{WebExtAPIRef("browsingData.removeDownloads()")}}</dt> - <dd>Supprime la liste des fichiers tĂ©lĂ©chargĂ©s.</dd> - <dt>{{WebExtAPIRef("browsingData.removeFormData()")}}</dt> - <dd>Efface les donnĂ©es de formulaire enregistrĂ©es.</dd> - <dt>{{WebExtAPIRef("browsingData.removeHistory()")}}</dt> - <dd>Efface l'historique du navigateur.</dd> - <dt>{{WebExtAPIRef("browsingData.removeLocalStorage()")}}</dt> - <dd>Efface tout <a href="/fr/docs/Web/API/Window/localStorage">stockage local</a> crĂ©Ă© par des sites web.</dd> - <dt>{{WebExtAPIRef("browsingData.removePasswords()")}}</dt> - <dd>Efface les mots de passe enregistrĂ©s.</dd> - <dt>{{WebExtAPIRef("browsingData.removePluginData()")}}</dt> - <dd>Efface les donnĂ©es associĂ©es aux plugins.</dd> - <dt>{{WebExtAPIRef("browsingData.settings()")}}</dt> - <dd>Obtient la valeur actuelle des paramĂštres dans la fonction "Effacer l'historique" du navigateur</dd> -</dl> +- {{WebExtAPIRef("browsingData.remove()")}} + - : Supprime les donnĂ©es de navigation pour les types de donnĂ©es spĂ©cifiĂ©s. +- {{WebExtAPIRef("browsingData.removeCache()")}} + - : Efface le cache du navigateur. +- {{WebExtAPIRef("browsingData.removeCookies()")}} + - : Supprime les cookies +- {{WebExtAPIRef("browsingData.removeDownloads()")}} + - : Supprime la liste des fichiers tĂ©lĂ©chargĂ©s. +- {{WebExtAPIRef("browsingData.removeFormData()")}} + - : Efface les donnĂ©es de formulaire enregistrĂ©es. +- {{WebExtAPIRef("browsingData.removeHistory()")}} + - : Efface l'historique du navigateur. +- {{WebExtAPIRef("browsingData.removeLocalStorage()")}} + - : Efface tout [stockage local](/fr/docs/Web/API/Window/localStorage) crĂ©Ă© par des sites web. +- {{WebExtAPIRef("browsingData.removePasswords()")}} + - : Efface les mots de passe enregistrĂ©s. +- {{WebExtAPIRef("browsingData.removePluginData()")}} + - : Efface les donnĂ©es associĂ©es aux plugins. +- {{WebExtAPIRef("browsingData.settings()")}} + - : Obtient la valeur actuelle des paramĂštres dans la fonction "Effacer l'historique" du navigateur -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.browsingData", 2)}} +{{WebExtExamples("h2")}} -<p>{{Compat("webextensions.api.browsingData", 2)}}</p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). +> +> 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>{{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/browsingData"><code>chrome.browsingData</code></a>.</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 @@ -118,5 +106,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData // 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/browsingdata/removaloptions/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removaloptions/index.md index 02beb4443c..165ac30fbe 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removaloptions/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removaloptions/index.md @@ -12,53 +12,45 @@ tags: - browsingData translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/RemovalOptions --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <strong><code>browsingData.RemovalOptions</code></strong> contient des options permettant de contrĂŽler certains aspects de la suppression des donnĂ©es de navigation.</p> +Le type **`browsingData.RemovalOptions`** contient des options permettant de contrĂŽler certains aspects de la suppression des donnĂ©es de navigation. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes:</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes: -<dl> - <dt><code>hostnames</code> {{optional_inline}}</dt> - <dd> - <p><code>Array</code> of <code>string</code>. Cette propriĂ©tĂ© s'applique uniquement aux cookies et aux Ă©lĂ©ments de stockage locaux. Ne supprimez que les cookies et les Ă©lĂ©ments de stockage locaux associĂ©s Ă ces noms d'hĂŽte.</p> +- `hostnames` {{optional_inline}} - <p>Vous devez indiquer ici un nom d'hĂŽte, sans protocole (par exemple : "google.com" et non https://google.com"). Vous pouvez utiliser l'interface <code><a href="/fr/docs/Web/API/URL">URL</a></code> pour analyser une URL brute  et rĂ©cupĂ©rer uniquement le nom d'hĂŽte. Les sous-domaines d'un nom d'hĂŽte donnĂ© ne seront pas supprimĂ©s: vous devez explicitement lister les sous-domaines.</p> - </dd> - <dt><code>originTypes</code> {{optional_inline}}</dt> - <dd> - <p><code>object</code>. Permet de contrĂŽler si les donnĂ©es doivent ĂȘtre supprimĂ©es uniquement des pages Web normales ou des applications et extensions Web hĂ©bergĂ©es. Si cette option est omise, seules les donnĂ©es des pages Web normales ("<code>unprotectedWeb</code>") sont supprimĂ©es. Avant de supprimer des donnĂ©es d'applications ou d'extensions Web, veillez Ă ce que ce soit vraiment ce que l'utilisateur souhaite.</p> + - : `Array` of `string`. Cette propriĂ©tĂ© s'applique uniquement aux cookies et aux Ă©lĂ©ments de stockage locaux. Ne supprimez que les cookies et les Ă©lĂ©ments de stockage locaux associĂ©s Ă ces noms d'hĂŽte. - <p>Cet objet peut contenir l'une des propriĂ©tĂ©s suivantes :</p> + Vous devez indiquer ici un nom d'hĂŽte, sans protocole (par exemple : "google.com" et non https\://google.com"). Vous pouvez utiliser l'interface [`URL`](/fr/docs/Web/API/URL) pour analyser une URL brute  et rĂ©cupĂ©rer uniquement le nom d'hĂŽte. Les sous-domaines d'un nom d'hĂŽte donnĂ© ne seront pas supprimĂ©s: vous devez explicitement lister les sous-domaines. - <dl> - <dt><code>unprotectedWeb</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si prĂ©sent et <code>true</code>, supprime les donnĂ©es de la pages Web normales.</dd> - <dt><code>protectedWeb</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si prĂ©sent et <code>true</code>, supprime les donnĂ©es de site Web qui ont Ă©tĂ© installĂ©s en tant qu'applications hĂ©bergĂ©es.</dd> - <dt><code>extension</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si prĂ©sent et <code>true</code>, supprime les donnĂ©es d'extensions.</dd> - </dl> - </dd> - <dt><code>since</code> {{optional_inline}}</dt> - <dd><code>number</code>. Jusqu'Ă quand remontent les donnĂ©es, donnĂ©es en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque UNIX</a>. Notez que lorsque vous supprimez le cache du navigateur, le cache entier est toujours supprimĂ© et cette option est ignorĂ©e. Si la propriĂ©tĂ© <code>since</code> est omise, la valeur par dĂ©faut est 0, ce qui signifie "pour toujours".</dd> -</dl> +- `originTypes` {{optional_inline}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : `object`. Permet de contrĂŽler si les donnĂ©es doivent ĂȘtre supprimĂ©es uniquement des pages Web normales ou des applications et extensions Web hĂ©bergĂ©es. Si cette option est omise, seules les donnĂ©es des pages Web normales ("`unprotectedWeb`") sont supprimĂ©es. Avant de supprimer des donnĂ©es d'applications ou d'extensions Web, veillez Ă ce que ce soit vraiment ce que l'utilisateur souhaite. + Cet objet peut contenir l'une des propriĂ©tĂ©s suivantes : + - `unprotectedWeb` {{optional_inline}} + - : `boolean`. Si prĂ©sent et `true`, supprime les donnĂ©es de la pages Web normales. + - `protectedWeb` {{optional_inline}} + - : `boolean`. Si prĂ©sent et `true`, supprime les donnĂ©es de site Web qui ont Ă©tĂ© installĂ©s en tant qu'applications hĂ©bergĂ©es. + - `extension` {{optional_inline}} + - : `boolean`. Si prĂ©sent et `true`, supprime les donnĂ©es d'extensions. -<p>{{Compat("webextensions.api.browsingData.RemovalOptions", 2)}}</p> +- `since` {{optional_inline}} + - : `number`. Jusqu'Ă quand remontent les donnĂ©es, donnĂ©es en [millisecondes depuis l'Ă©poque UNIX](https://en.wikipedia.org/wiki/Unix_time). Notez que lorsque vous supprimez le cache du navigateur, le cache entier est toujours supprimĂ© et cette option est ignorĂ©e. Si la propriĂ©tĂ© `since` est omise, la valeur par dĂ©faut est 0, ce qui signifie "pour toujours". -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/browsingData"><code>chrome.browsingData</code></a>.</p> -</div> +{{Compat("webextensions.api.browsingData.RemovalOptions", 2)}} -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). + +<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 @@ -85,5 +77,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/RemovalOptions // 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/browsingdata/remove/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/remove/index.md index 304ad17451..adabcdd691 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/remove/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/remove/index.md @@ -13,46 +13,46 @@ tags: - supprimer translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/remove --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime les donnĂ©es de navigation spĂ©cifiĂ©es.</p> +Supprime les donnĂ©es de navigation spĂ©cifiĂ©es. -<p>Les donnĂ©es de navigation Ă supprimer sont spĂ©cifiĂ©es dans l'option <code>dataTypes</code>, qui est un objet {{WebExtAPIRef("browsingData.DataTypeSet")}}.</p> +Les donnĂ©es de navigation Ă supprimer sont spĂ©cifiĂ©es dans l'option `dataTypes`, qui est un objet {{WebExtAPIRef("browsingData.DataTypeSet")}}. -<p>Vous pouvez utiliser l'option <code>removalOptions</code>, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, pour contrĂŽler Ă quelle distance remonter dans le temps pour supprimer des donnĂ©es et supprimer les donnĂ©es uniquement Ă partir de pages Web normales ou pour supprimer des donnĂ©es hĂ©bergĂ©es d'applications et extensions aussi.</p> +Vous pouvez utiliser l'option `removalOptions`, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, pour contrĂŽler Ă quelle distance remonter dans le temps pour supprimer des donnĂ©es et supprimer les donnĂ©es uniquement Ă partir de pages Web normales ou pour supprimer des donnĂ©es hĂ©bergĂ©es d'applications et extensions aussi. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.browsingData.remove( +```js +var removing = browser.browsingData.remove( removalOptions, // RemovalOptions object dataTypes // DataTypeSet object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>removalOptions</code></dt> - <dd><code>object</code>. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut ĂȘtre utilisĂ© pour contrĂŽler Ă quelle distance remonter dans le temps pour supprimer des donnĂ©es, et si vous souhaitez supprimer des donnĂ©es des applications Web hĂ©bergĂ©es et des extensions ou simplement des pages Web normales.</dd> - <dt><code>dataTypes</code></dt> - <dd><code>object</code>. Un objet {{WebExtAPIRef("browsingData.DataTypeSet")}}, dĂ©crit les types de donnĂ©es Ă supprimer (par exemple, historique, les tĂ©lĂ©chargements,...).</dd> -</dl> +- `removalOptions` + - : `object`. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut ĂȘtre utilisĂ© pour contrĂŽler Ă quelle distance remonter dans le temps pour supprimer des donnĂ©es, et si vous souhaitez supprimer des donnĂ©es des applications Web hĂ©bergĂ©es et des extensions ou simplement des pages Web normales. +- `dataTypes` + - : `object`. Un objet {{WebExtAPIRef("browsingData.DataTypeSet")}}, dĂ©crit les types de donnĂ©es Ă supprimer (par exemple, historique, les tĂ©lĂ©chargements,...). -<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 sans argument lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browsingData.remove")}}</p> +{{Compat("webextensions.api.browsingData.remove")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprimer l'historique des tĂ©lĂ©chargements et de l'histoire de navigation de la semaine derniĂšre :</p> +Supprimer l'historique des tĂ©lĂ©chargements et de l'histoire de navigation de la semaine derniĂšre : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -70,11 +70,12 @@ browser.browsingData.remove( {since: oneWeekAgo}, {downloads: true, history: true}). then(onRemoved, onError); -</pre> +``` -<p>Supprimer tout l'historique de tĂ©lĂ©chargement et de navigation :</p> +Supprimer tout l'historique de tĂ©lĂ©chargement et de navigation : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -84,19 +85,18 @@ function onError(error) { browser.browsingData.remove({}, {downloads: true, history: true}). -then(onRemoved, onError);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +then(onRemoved, onError); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/browsingData"><code>chrome.browsingData</code></a>.</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.browsingData`](https://developer.chrome.com/extensions/browsingData). +> +> 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 @@ -123,5 +123,4 @@ then(onRemoved, onError);</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/browsingdata/removecache/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removecache/index.md index 4159e5bd9d..3d7bcb7fe0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removecache/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removecache/index.md @@ -12,41 +12,41 @@ tags: - removeCache translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/removeCache --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Effacer le cache du navigateur.</p> +Effacer le cache du navigateur. -<p>Notez que cette fonction puisse prendre un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, elle sera ignorĂ©e. Le cache entier est toujours effacĂ© lors de l'utilisation de cette fonction.</p> +Notez que cette fonction puisse prendre un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, elle sera ignorĂ©e. Le cache entier est toujours effacĂ© lors de l'utilisation de cette fonction. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.browsingData.removeCache( +```js +var removing = browser.browsingData.removeCache( removalOptions // RemovalOptions object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>removalOptions </code>{{optional_inline}}</dt> - <dd><code>object</code>. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}. Ce paramĂštre n'a aucun effet</dd> -</dl> +- `removalOptions `{{optional_inline}} + - : `object`. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}. Ce paramĂštre n'a aucun effet -<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 sans arguments lorsque la suppression est terminĂ©e. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rempli sans arguments lorsque la suppression est terminĂ©e. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browsingData.removeCache")}}</p> +{{Compat("webextensions.api.browsingData.removeCache")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Effacer le cache du navigateur :</p> +Effacer le cache du navigateur : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -55,19 +55,18 @@ function onError(error) { } browser.browsingData.removeCache({}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). +> +> 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/browsingData"><code>chrome.browsingData</code></a>.</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 @@ -94,5 +93,4 @@ then(onRemoved, onError);</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/browsingdata/removecookies/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removecookies/index.md index dd543a2a24..942402edba 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removecookies/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removecookies/index.md @@ -12,46 +12,44 @@ tags: - removeCookies translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/removeCookies --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Efface les cookies du navigateur</p> +Efface les cookies du navigateur -<p>Vous pouvez utiliser le paramĂštre <code>removalOptions</code>, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} pour :</p> +Vous pouvez utiliser le paramĂštre `removalOptions`, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} pour : -<ul> - <li>Efface seulement les cookies crĂ©Ă©s aprĂšs un temps donnĂ©</li> - <li>ContrĂŽlez si les cookies doivent ĂȘtre supprimĂ©s uniquement Ă partir des pages Webnormales ou si vous souhaitez supprimer les cookies des applications et des extensions hĂ©bergĂ©es.</li> -</ul> +- Efface seulement les cookies crĂ©Ă©s aprĂšs un temps donnĂ© +- ContrĂŽlez si les cookies doivent ĂȘtre supprimĂ©s uniquement Ă partir des pages Webnormales ou si vous souhaitez supprimer les cookies des applications et des extensions hĂ©bergĂ©es. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.browsingData.removeCookies( +```js +var removing = browser.browsingData.removeCookies( removalOptions // RemovalOptions object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>removalOptions</code></dt> - <dd><code>object</code>. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut ĂȘtre utilisĂ© pour effacer uniquement les cookies crĂ©Ă©s aprĂšs un dĂ©lais donnĂ©, et pour supprimer les cookies uniquement des pages Web normales ou pour supprimer les cookies des applications et extensions hĂ©bergĂ©es.</dd> -</dl> +- `removalOptions` + - : `object`. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut ĂȘtre utilisĂ© pour effacer uniquement les cookies crĂ©Ă©s aprĂšs un dĂ©lais donnĂ©, et pour supprimer les cookies uniquement des pages Web normales ou pour supprimer les cookies des applications et extensions hĂ©bergĂ©es. -<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 sans argument lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browsingData.removeCookies")}}</p> +{{Compat("webextensions.api.browsingData.removeCookies")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprime les cookies crĂ©Ă©s la semaine derniĂšre :</p> +Supprime les cookies crĂ©Ă©s la semaine derniĂšre : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -67,17 +65,19 @@ var oneWeekAgo = (new Date()).getTime() - weekInMilliseconds(); browser.browsingData.removeCookies( {since: oneWeekAgo}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>Supprime tous les cookies :</p> +Supprime tous les cookies : -<div class="warning"> -<p><strong>Attention :</strong></p> -<p>L'utilisation de l'API pour supprimer tous les cookies effacera simultanĂ©ment tous les objets de stockage locaux (y compris ceux des autres extensions).</p> -<p>Si vous souhaitez simplement effacer tous les cookies sans perturber les installations de stockage locales, utilisez <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/cookies">browser.cookies</a> pour faire une boucle et supprimer le contenu de tous les magasins de cookies.</p> -</div> +> **Attention :** +> +> L'utilisation de l'API pour supprimer tous les cookies effacera simultanĂ©ment tous les objets de stockage locaux (y compris ceux des autres extensions). +> +> Si vous souhaitez simplement effacer tous les cookies sans perturber les installations de stockage locales, utilisez [browser.cookies](/fr/docs/Mozilla/Add-ons/WebExtensions/API/cookies) pour faire une boucle et supprimer le contenu de tous les magasins de cookies. -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -86,19 +86,18 @@ function onError(error) { } browser.browsingData.removeCookies({}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). +> +> 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/browsingData"><code>chrome.browsingData</code></a>.</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 @@ -125,5 +124,4 @@ then(onRemoved, onError);</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/browsingdata/removedownloads/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removedownloads/index.md index 625cb99a06..2d708ac98c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removedownloads/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removedownloads/index.md @@ -12,46 +12,44 @@ tags: - removeDownloads translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/removeDownloads --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Efface l'historique de tĂ©lĂ©chargement du navigateur. Notez que cela ne supprime pas les objets tĂ©lĂ©chargĂ©s eux-mĂȘmes, seulement les enregistrements de tĂ©lĂ©chargements dans l'historique du navigateur.</p> +Efface l'historique de tĂ©lĂ©chargement du navigateur. Notez que cela ne supprime pas les objets tĂ©lĂ©chargĂ©s eux-mĂȘmes, seulement les enregistrements de tĂ©lĂ©chargements dans l'historique du navigateur. -<p>Vous pouvez utiliser le paramĂštre <code>removalOptions</code>, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} pour :</p> +Vous pouvez utiliser le paramĂštre `removalOptions`, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} pour : -<ul> - <li>Efface les enregistrements des Ă©lements tĂ©lĂ©chargĂ©s aprĂšs un temps donnĂ©</li> - <li>contrĂŽle si vous souhaitez effacer uniquement les enregistrements d'Ă©lĂ©ments tĂ©lĂ©chargĂ©s Ă partir de pages Web normales ou pour supprimer Ă©galement les enregistrements des applications hĂ©bergĂ©es et des extensions.</li> -</ul> +- Efface les enregistrements des Ă©lements tĂ©lĂ©chargĂ©s aprĂšs un temps donnĂ© +- contrĂŽle si vous souhaitez effacer uniquement les enregistrements d'Ă©lĂ©ments tĂ©lĂ©chargĂ©s Ă partir de pages Web normales ou pour supprimer Ă©galement les enregistrements des applications hĂ©bergĂ©es et des extensions. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.browsingData.removeDownloads( +```js +var removing = browser.browsingData.removeDownloads( removalOptions // RemovalOptions object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>removalOptions</code></dt> - <dd><code>object</code>. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut-ĂȘtre utilisĂ© pour effacer uniquement les enregistrements crĂ©Ă©s aprĂšs une heure donnĂ©e, et pour effacer uniquement les enregistrements d'Ă©lĂ©ments tĂ©lĂ©chargĂ©s depuis les pages Web normales ou pour effacer des enregistrements d'applications hĂ©bergĂ©es et extensions aussi bien.</dd> -</dl> +- `removalOptions` + - : `object`. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut-ĂȘtre utilisĂ© pour effacer uniquement les enregistrements crĂ©Ă©s aprĂšs une heure donnĂ©e, et pour effacer uniquement les enregistrements d'Ă©lĂ©ments tĂ©lĂ©chargĂ©s depuis les pages Web normales ou pour effacer des enregistrements d'applications hĂ©bergĂ©es et extensions aussi bien. -<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 sans argument lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browsingData.removeDownloads")}}</p> +{{Compat("webextensions.api.browsingData.removeDownloads")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprime les enregistrements d'objets tĂ©lĂ©chargĂ©s la semaine derniĂšre :</p> +Supprime les enregistrements d'objets tĂ©lĂ©chargĂ©s la semaine derniĂšre : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -67,11 +65,13 @@ var oneWeekAgo = (new Date()).getTime() - weekInMilliseconds(); browser.browsingData.removeDownloads( {since: oneWeekAgo}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>Supprime tous les enregistrements d'objets tĂ©lĂ©chargĂ©s :</p> +Supprime tous les enregistrements d'objets tĂ©lĂ©chargĂ©s : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -80,19 +80,18 @@ function onError(error) { } browser.browsingData.removeDownloads({}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). +> +> 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/browsingData"><code>chrome.browsingData</code></a>.</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 @@ -119,5 +118,4 @@ then(onRemoved, onError);</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/browsingdata/removeformdata/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removeformdata/index.md index b793697877..673963ce0f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removeformdata/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removeformdata/index.md @@ -12,43 +12,43 @@ tags: - removeDownloads translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/removeFormData --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Efface les donnĂ©es que le navigateur a enregistrĂ© pour les formulaires de remplissage automatique.</p> +Efface les donnĂ©es que le navigateur a enregistrĂ© pour les formulaires de remplissage automatique. -<p>Vous pouvez utiliser le paramĂštre <code>removalOptions</code>, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, pour :</p> +Vous pouvez utiliser le paramĂštre `removalOptions`, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, pour : -<ul> - <li>Efface uniquement les donnĂ©es de formulaire entrĂ©es aprĂšs une heure donnĂ©e</li> - <li>ContrĂŽle si vous souhaitez supprimer uniquement les donnĂ©es saisies dans les pages Web normales ou effacer les donnĂ©es saisies dans les applications et extensions hĂ©bergĂ©es.</li> -</ul> +- Efface uniquement les donnĂ©es de formulaire entrĂ©es aprĂšs une heure donnĂ©e +- ContrĂŽle si vous souhaitez supprimer uniquement les donnĂ©es saisies dans les pages Web normales ou effacer les donnĂ©es saisies dans les applications et extensions hĂ©bergĂ©es. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.browsingData.removeFormData( +```js +var removing = browser.browsingData.removeFormData( removalOptions // RemovalOptions object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<p><code>object</code>. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut ĂȘtre utilisĂ© pour effacer uniquement les donnĂ©es de formulaire saisies aprĂšs une heure donnĂ©e, et pour effacer uniquement les donnĂ©es saisies dans les pages Web normales ou pour effacer les donnĂ©es saisies dans les applications hĂ©bergĂ©es et des extensions aussi.</p> +`object`. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut ĂȘtre utilisĂ© pour effacer uniquement les donnĂ©es de formulaire saisies aprĂšs une heure donnĂ©e, et pour effacer uniquement les donnĂ©es saisies dans les pages Web normales ou pour effacer les donnĂ©es saisies dans les applications hĂ©bergĂ©es et des extensions aussi. -<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 sans argument lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browsingData.removeFormData")}}</p> +{{Compat("webextensions.api.browsingData.removeFormData")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprimer les donnĂ©es de formulaire enregistrĂ©es la semaine derniĂšre :</p> +Supprimer les donnĂ©es de formulaire enregistrĂ©es la semaine derniĂšre : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -64,11 +64,13 @@ var oneWeekAgo = (new Date()).getTime() - weekInMilliseconds(); browser.browsingData.removeFormData( {since: oneWeekAgo}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>Supprimer tous les donnĂ©es de formulaire enregistrĂ©es :</p> +Supprimer tous les donnĂ©es de formulaire enregistrĂ©es : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -77,19 +79,18 @@ function onError(error) { } browser.browsingData.removeFormData({}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). +> +> 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/browsingData"><code>chrome.browsingData</code></a>.</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 @@ -116,5 +117,4 @@ then(onRemoved, onError);</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/browsingdata/removehistory/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removehistory/index.md index 5c8e2bd1b3..a26942c835 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removehistory/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removehistory/index.md @@ -12,46 +12,44 @@ tags: - removeHistory translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/removeHistory --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Efface l'enregistrement des pages Web que l'utilisateur a visitĂ© (historique de navigation).</p> +Efface l'enregistrement des pages Web que l'utilisateur a visitĂ© (historique de navigation). -<p>Vous pouvez utiliser le paramĂštre <code>removalOptions</code>, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} pour :</p> +Vous pouvez utiliser le paramĂštre `removalOptions`, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} pour : -<ul> - <li>Effacer uniquement les eenregistrements des pages Web visitĂ©es aprĂšs un certain temps.</li> - <li>ContrĂŽlez si vous souhaitez effacer uniquement les enregistrements des pages web normales ou effacer les enregistrements des applications hĂ©bergĂ©es et des extensions.</li> -</ul> +- Effacer uniquement les eenregistrements des pages Web visitĂ©es aprĂšs un certain temps. +- ContrĂŽlez si vous souhaitez effacer uniquement les enregistrements des pages web normales ou effacer les enregistrements des applications hĂ©bergĂ©es et des extensions. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.browsingData.removeHistory( +```js +var removing = browser.browsingData.removeHistory( removalOptions // RemovalOptions object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>removalOptions</code></dt> - <dd><code>object</code>. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut-ĂȘtre utilisĂ© pour effacer uniquement les enregistrements des pages Web visitĂ©es aprĂšs un certain temp, et pour effacer uniquement les enregistrements des pages Web normales ou pour effacer les enregistrements des applications hĂ©bergĂ©es et extensions aussi bien.</dd> -</dl> +- `removalOptions` + - : `object`. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut-ĂȘtre utilisĂ© pour effacer uniquement les enregistrements des pages Web visitĂ©es aprĂšs un certain temp, et pour effacer uniquement les enregistrements des pages Web normales ou pour effacer les enregistrements des applications hĂ©bergĂ©es et extensions aussi bien. -<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> sera rempli sans arguments lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera rempli sans arguments lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browsingData.removeHistory", 10)}}</p> +{{Compat("webextensions.api.browsingData.removeHistory", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprimer les enregistrements de la page visitĂ©es de la semaine derniĂšre :</p> +Supprimer les enregistrements de la page visitĂ©es de la semaine derniĂšre : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -67,11 +65,13 @@ var oneWeekAgo = (new Date()).getTime() - weekInMilliseconds(); browser.browsingData.removeHistory( {since: oneWeekAgo}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>Supprimer tous les enregistrements des pages visitĂ©es :</p> +Supprimer tous les enregistrements des pages visitĂ©es : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -80,19 +80,18 @@ function onError(error) { } browser.browsingData.removeHistory({}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). +> +> 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/browsingData"><code>chrome.browsingData</code></a>.</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 @@ -119,5 +118,4 @@ then(onRemoved, onError);</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/browsingdata/removelocalstorage/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removelocalstorage/index.md index 9cf0b59e81..7b14d6da78 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removelocalstorage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removelocalstorage/index.md @@ -12,46 +12,44 @@ tags: - removeLocalStorage translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/removeLocalStorage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Efface tout le <a href="/fr/docs/Web/API/Window/localStorage">stockage local</a> crĂ©Ă© par des sites Web.</p> +Efface tout le [stockage local](/fr/docs/Web/API/Window/localStorage) crĂ©Ă© par des sites Web. -<p>Vous pouvez utiliser le paramĂštre <code>removalOptions</code>, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} pour :</p> +Vous pouvez utiliser le paramĂštre `removalOptions`, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} pour : -<ul> - <li>Effacer uniquement les objets de stockage locaux crĂ©Ă©s aprĂšs un dĂ©lai donnĂ©</li> - <li>Controler si vous souhaitez effacer uniquement les objets de stockage locaux crĂ©Ă©s par des pages Web normales ou supprimer des objets crĂ©Ă©s par des applications et des extensions hĂ©bergĂ©es.</li> -</ul> +- Effacer uniquement les objets de stockage locaux crĂ©Ă©s aprĂšs un dĂ©lai donnĂ© +- Controler si vous souhaitez effacer uniquement les objets de stockage locaux crĂ©Ă©s par des pages Web normales ou supprimer des objets crĂ©Ă©s par des applications et des extensions hĂ©bergĂ©es. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.browsingData.removeLocalStorage( +```js +var removing = browser.browsingData.removeLocalStorage( removalOptions // RemovalOptions object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>removalOptions</code></dt> - <dd><code>object</code>. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut etre utilisĂ© pour effacer uniquement les objets de stockage locaux crĂ©Ă©s par des pages Web normales ou pour effacer des objets crĂ©Ă©s par des applications et des extensions hĂ©bergĂ©es.</dd> -</dl> +- `removalOptions` + - : `object`. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut etre utilisĂ© pour effacer uniquement les objets de stockage locaux crĂ©Ă©s par des pages Web normales ou pour effacer des objets crĂ©Ă©s par des applications et des extensions hĂ©bergĂ©es. -<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 sans argument lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browsingData.removeLocalStorage", 10)}}</p> +{{Compat("webextensions.api.browsingData.removeLocalStorage", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprime tout le stockage local :</p> +Supprime tout le stockage local : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -60,17 +58,16 @@ function onError(error) { } browser.browsingData.removeLocalStorage({}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/browsingData"><code>chrome.browsingData</code></a>.</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 @@ -97,5 +94,4 @@ then(onRemoved, onError);</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/browsingdata/removepasswords/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removepasswords/index.md index 474fb9aced..e5d54a19dc 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removepasswords/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removepasswords/index.md @@ -12,46 +12,44 @@ tags: - removePasswords translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/removePasswords --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Efface les mots de passes enregistrĂ©s</p> +Efface les mots de passes enregistrĂ©s -<p>Vous pouvez utiliser le paremĂštre <code>removalOptions</code>, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} pour :</p> +Vous pouvez utiliser le paremĂštre `removalOptions`, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}} pour : -<ul> - <li>Effacer uniquement les mots de passe enregistrĂ©s aprĂšs un certain temp</li> - <li>ContrĂŽlez si vous souhaitez supprimer les mots de passe enregistrĂ©s sur les pages Web normales ou effacer les mots de passe enregistrĂ©s sur les applications et les extensions hĂ©bergĂ©es.</li> -</ul> +- Effacer uniquement les mots de passe enregistrĂ©s aprĂšs un certain temp +- ContrĂŽlez si vous souhaitez supprimer les mots de passe enregistrĂ©s sur les pages Web normales ou effacer les mots de passe enregistrĂ©s sur les applications et les extensions hĂ©bergĂ©es. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.browsingData.removePasswords( +```js +var removing = browser.browsingData.removePasswords( removalOptions // RemovalOptions object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>removalOptions</code></dt> - <dd><code>object</code>. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut ĂȘtre utilisĂ© pour effacer uniquement les mots de passe enregistrĂ©s aprĂšs un certain temps, et pour effacer les mots de passe enregistrĂ©s sur les pages Web normales ou pour effacer les mots de passe enregistrĂ©s sur les applications et les extensions hĂ©bergĂ©es.</dd> -</dl> +- `removalOptions` + - : `object`. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut ĂȘtre utilisĂ© pour effacer uniquement les mots de passe enregistrĂ©s aprĂšs un certain temps, et pour effacer les mots de passe enregistrĂ©s sur les pages Web normales ou pour effacer les mots de passe enregistrĂ©s sur les applications et les extensions hĂ©bergĂ©es. -<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 sans arguments lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments lorsque la suppression est terminĂ©e. Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browsingData.removePasswords")}}</p> +{{Compat("webextensions.api.browsingData.removePasswords")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprimer les mots de passe enregistrĂ©s la semaine derniĂšre :</p> +Supprimer les mots de passe enregistrĂ©s la semaine derniĂšre : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -66,11 +64,13 @@ function weekInMilliseconds() { var oneWeekAgo = (new Date()).getTime() - weekInMilliseconds(); browser.browsingData.removePasswords({since: oneWeekAgo}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>Supprime tous les mots de passe enregistrĂ©s :</p> +Supprime tous les mots de passe enregistrĂ©s : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -78,19 +78,18 @@ function onError(error) { console.error(error); } -browser.browsingData.removePasswords({}).then(onRemoved, onError);</pre> +browser.browsingData.removePasswords({}).then(onRemoved, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). +> +> 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/browsingData"><code>chrome.browsingData</code></a>.</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 @@ -117,5 +116,4 @@ browser.browsingData.removePasswords({}).then(onRemoved, onError);</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/browsingdata/removeplugindata/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removeplugindata/index.md index 3bc02e928c..3e989421b8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removeplugindata/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/removeplugindata/index.md @@ -12,46 +12,44 @@ tags: - removePluginData translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/removePluginData --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Efface les donnĂ©es stockĂ©es par les plugins du navigateur.</p> +Efface les donnĂ©es stockĂ©es par les plugins du navigateur. -<p>Vous pouvez utiliser le paramĂštre <code>removalOptions</code>, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, pour :</p> +Vous pouvez utiliser le paramĂštre `removalOptions`, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, pour : -<ul> - <li>effacer seulement les donnĂ©es du plugins stockĂ©es aprĂšs un temps donnĂ©</li> - <li>controler si vous souhaitez effacer uniquement les donnĂ©es stockĂ©es par les plugins qui s'exĂ©cutent dans les pages Web normales ou effacer les donnĂ©es par les plugins qui s'exĂ©cutent dans les applications et les extensions hĂ©bergĂ©es.</li> -</ul> +- effacer seulement les donnĂ©es du plugins stockĂ©es aprĂšs un temps donnĂ© +- controler si vous souhaitez effacer uniquement les donnĂ©es stockĂ©es par les plugins qui s'exĂ©cutent dans les pages Web normales ou effacer les donnĂ©es par les plugins qui s'exĂ©cutent dans les applications et les extensions hĂ©bergĂ©es. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.browsingData.removePluginData( +```js +var removing = browser.browsingData.removePluginData( removalOptions // RemovalOptions object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>removalOptions</code></dt> - <dd><code>object</code>. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut ĂȘtre utilisĂ© pour effacer uniquement les donnĂ©es de plugin stockĂ©es aprĂšs un certain temps, et pour effacer uniquement les donnĂ©es stockĂ©es par des plugins fonctionnant sur des pages web normales ou pour effacer des donnĂ©es stockĂ©es par des plugins fonctionnant dans des applications et extensions hĂ©bergĂ©es.</dd> -</dl> +- `removalOptions` + - : `object`. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut ĂȘtre utilisĂ© pour effacer uniquement les donnĂ©es de plugin stockĂ©es aprĂšs un certain temps, et pour effacer uniquement les donnĂ©es stockĂ©es par des plugins fonctionnant sur des pages web normales ou pour effacer des donnĂ©es stockĂ©es par des plugins fonctionnant dans des applications et extensions hĂ©bergĂ©es. -<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 sans arguments lorsque la suppression est terminĂ©e. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rempli sans arguments lorsque la suppression est terminĂ©e. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browsingData.removePluginData")}}</p> +{{Compat("webextensions.api.browsingData.removePluginData")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprimer les donnĂ©es stockĂ©es par les plugins au cours de la derniĂšre semaine :</p> +Supprimer les donnĂ©es stockĂ©es par les plugins au cours de la derniĂšre semaine : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -66,11 +64,13 @@ function weekInMilliseconds() { var oneWeekAgo = (new Date()).getTime() - weekInMilliseconds(); browser.browsingData.removePluginData({since: oneWeekAgo}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>Supprimer toutes les donnĂ©es stockĂ©es par les plugins :</p> +Supprimer toutes les donnĂ©es stockĂ©es par les plugins : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("removed"); } @@ -79,19 +79,18 @@ function onError(error) { } browser.browsingData.removePluginData({}). -then(onRemoved, onError);</pre> +then(onRemoved, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). +> +> 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/browsingData"><code>chrome.browsingData</code></a>.</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 @@ -118,5 +117,4 @@ then(onRemoved, onError);</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/browsingdata/settings/index.md b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/settings/index.md index fae7fb7b8e..57bb718e2e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/browsingdata/settings/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/browsingdata/settings/index.md @@ -12,49 +12,49 @@ tags: - browsingData translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/settings --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Les navigateurs disposent d'une fonction "Effacer l'historique" intĂ©grĂ©e, qui permet Ă l'utilisateur d'effacer diffĂ©rents types de donnĂ©es de navigation. Cela a une interface utilisateur qui permet Ă l'utilisateur de sĂ©lectionner le type de donnĂ©es Ă supprimer (par exemple l'historique, les tĂ©lĂ©chargements, ...) et Ă quelle distance remonter dans le temps pour supprimer des donnĂ©es.</p> +Les navigateurs disposent d'une fonction "Effacer l'historique" intĂ©grĂ©e, qui permet Ă l'utilisateur d'effacer diffĂ©rents types de donnĂ©es de navigation. Cela a une interface utilisateur qui permet Ă l'utilisateur de sĂ©lectionner le type de donnĂ©es Ă supprimer (par exemple l'historique, les tĂ©lĂ©chargements, ...) et Ă quelle distance remonter dans le temps pour supprimer des donnĂ©es. -<p>Cette fonction renvoie la valeur actuelle de ces paramĂštres.</p> +Cette fonction renvoie la valeur actuelle de ces paramĂštres. -<p>Notez que tous les types de donnĂ©es ne peuvent pas toujours ĂȘtre supprimĂ©s via l'interface utilisateur et certaines options d'interface utilisateur peuvent correspondre Ă plusieurs types de donnĂ©es.</p> +Notez que tous les types de donnĂ©es ne peuvent pas toujours ĂȘtre supprimĂ©s via l'interface utilisateur et certaines options d'interface utilisateur peuvent correspondre Ă plusieurs types de donnĂ©es. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 getSettings = browser.browsingData.settings() -</pre> +```js +var getSettings = browser.browsingData.settings() +``` -<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 contenant les informations sur les paramĂštres. Cet objet a trois propriĂ©tĂ©s :</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet contenant les informations sur les paramĂštres. Cet objet a trois propriĂ©tĂ©s : -<dl> - <dt><code>options</code></dt> - <dd><code>{{WebExtAPIRef("browsingData.RemovalOptions")}}</code>. Un objet <code>RemovalOptions</code> dĂ©crivant les options de suppression actuellement sĂ©lectionnĂ©es.</dd> - <dt><code>dataToRemove</code></dt> - <dd><code>{{WebExtAPIRef("browsingData.DataTypeSet")}}</code>. Cela contiendra une propriĂ©tĂ© pour chaque type de donnĂ©es pouvant ĂȘtre basculĂ© dans l'interface utilisateur du navigateur. Chaque propriĂ©tĂ© aura une valeur <code>true</code> si ce type est sĂ©lectionnĂ© pour la suppression et <code>false</code> dans le cas contraire.</dd> - <dt><code>dataRemovalPermitted</code></dt> - <dd><code>{{WebExtAPIRef("browsingData.DataTypeSet")}}</code>. Cela contiendra une propriĂ©tĂ© pour chaque type de donnĂ©es pouvant ĂȘtre basculĂ© dans l'interface utilisateur du navigateur. Chacune aura la valeur <code>true</code> si l'administrateur du pĂ©riphĂ©rique a autorisĂ© l'utilisateur Ă supprimer ce type, et <code>false</code> dans le cas contraire.</dd> -</dl> +- `options` + - : `{{WebExtAPIRef("browsingData.RemovalOptions")}}`. Un objet `RemovalOptions` dĂ©crivant les options de suppression actuellement sĂ©lectionnĂ©es. +- `dataToRemove` + - : `{{WebExtAPIRef("browsingData.DataTypeSet")}}`. Cela contiendra une propriĂ©tĂ© pour chaque type de donnĂ©es pouvant ĂȘtre basculĂ© dans l'interface utilisateur du navigateur. Chaque propriĂ©tĂ© aura une valeur `true` si ce type est sĂ©lectionnĂ© pour la suppression et `false` dans le cas contraire. +- `dataRemovalPermitted` + - : `{{WebExtAPIRef("browsingData.DataTypeSet")}}`. Cela contiendra une propriĂ©tĂ© pour chaque type de donnĂ©es pouvant ĂȘtre basculĂ© dans l'interface utilisateur du navigateur. Chacune aura la valeur `true` si l'administrateur du pĂ©riphĂ©rique a autorisĂ© l'utilisateur Ă supprimer ce type, et `false` dans le cas contraire. -<p>Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur.</p> +Si une erreur se produit, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.browsingData.settings")}}</p> +{{Compat("webextensions.api.browsingData.settings")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>ParamĂštres des Logs courrants :</p> +ParamĂštres des Logs courrants : -<pre class="brush: js">function onGotSettings(settings) { +```js +function onGotSettings(settings) { console.log(settings.options); console.log(settings.dataToRemove); console.log(settings.dataRemovalPermitted); @@ -64,19 +64,18 @@ function onError(error) { console.error(error); } -browser.browsingData.settings().then(onGotSettings, onError);</pre> +browser.browsingData.settings().then(onGotSettings, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.browsingData`](https://developer.chrome.com/extensions/browsingData). +> +> 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/browsingData"><code>chrome.browsingData</code></a>.</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 @@ -103,5 +102,4 @@ browser.browsingData.settings().then(onGotSettings, onError);</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/captiveportal/canonicalurl/index.md b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/canonicalurl/index.md index 23f1e1cd17..d75b6ba325 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/captiveportal/canonicalurl/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/canonicalurl/index.md @@ -9,27 +9,23 @@ tags: - captivePortal translation_of: Mozilla/Add-ons/WebExtensions/API/captivePortal/canonicalURL --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Renvoyer l'URL canonique de la page de dĂ©tection du portail des prisonniers. En lecture seule.</p> +Renvoyer l'URL canonique de la page de dĂ©tection du portail des prisonniers. En lecture seule. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.captivePortal.canonicalURL")}} +{{WebExtExamples}} -<p>{{Compat("webextensions.api.captivePortal.canonicalURL")}}</p> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#property-TAB_ID_NONE) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence amĂ©ricaine Creative Commons Attribution 3.0. -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> - -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/tabs#property-TAB_ID_NONE"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence amĂ©ricaine Creative Commons Attribution 3.0.</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 @@ -56,5 +52,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/captivePortal/canonicalURL // 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/captiveportal/getlastchecked/index.md b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/getlastchecked/index.md index 3a5b92c58b..74ed8a7d3d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/captiveportal/getlastchecked/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/getlastchecked/index.md @@ -11,27 +11,27 @@ tags: - captivePortal translation_of: Mozilla/Add-ons/WebExtensions/API/captivePortal/getLastChecked --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Retourne le temps Ă©coulĂ© depuis que la derniĂšre demande a Ă©tĂ© complĂ©tĂ©e.</p> +Retourne le temps Ă©coulĂ© depuis que la derniĂšre demande a Ă©tĂ© complĂ©tĂ©e. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var state = browser.captivePortal.getLastChecked() -</pre> +```js +var state = browser.captivePortal.getLastChecked() +``` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p>Une <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a> qui est remplie avec un nombre entier reprĂ©sentant le temps en millisecondes.</p> +Une [Promise](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est remplie avec un nombre entier reprĂ©sentant le temps en millisecondes. -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.captivePortal.getLastChecked")}}</p> +{{Compat("webextensions.api.captivePortal.getLastChecked")}} -<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 @@ -58,5 +58,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/captivePortal/getLastChecked // 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/captiveportal/getstate/index.md b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/getstate/index.md index 4fdaffb2ee..586b6c13f9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/captiveportal/getstate/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/getstate/index.md @@ -11,27 +11,27 @@ tags: - captivePortal translation_of: Mozilla/Add-ons/WebExtensions/API/captivePortal/getState --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Renvoie l'Ă©tat du portail comme <code>unknown</code>, <code>not_captive</code>, <code>unlocked_portal</code>, ou <code>locked_portal</code>.</p> +Renvoie l'Ă©tat du portail comme `unknown`, `not_captive`, `unlocked_portal`, ou `locked_portal`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var state = browser.captivePortal.getState() -</pre> +```js +var state = browser.captivePortal.getState() +``` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p>Une <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a> qui est remplie avec une chaĂźne de caractĂšres contenant l'un des Ă©lĂ©ments suivants <code>unknown</code>, <code>not_captive</code>, <code>unlocked_portal</code>, ou <code>locked_portal</code>.</p> +Une [Promise](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est remplie avec une chaĂźne de caractĂšres contenant l'un des Ă©lĂ©ments suivants `unknown`, `not_captive`, `unlocked_portal`, ou `locked_portal`. -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.captivePortal.getState")}}</p> +{{Compat("webextensions.api.captivePortal.getState")}} -<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 @@ -58,5 +58,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/captivePortal/getState // 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/captiveportal/index.md b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/index.md index 8223e321c6..c79aa328f4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/captiveportal/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/index.md @@ -13,47 +13,38 @@ tags: - captivePortal translation_of: Mozilla/Add-ons/WebExtensions/API/captivePortal --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>DĂ©terminer l'Ă©tat du portail captif de la connexion de l'utilisateur. Un portail captif est une page web qui s'affiche lorsqu'un utilisateur se connecte pour la premiĂšre fois Ă un rĂ©seau Wi-Fi. L'utilisateur fournit des informations ou agit sur la page web du portail captif afin d'obtenir un accĂšs plus large aux ressources du rĂ©seau, par exemple en acceptant les conditions gĂ©nĂ©rales ou en effectuant un paiement.</p> +DĂ©terminer l'Ă©tat du portail captif de la connexion de l'utilisateur. Un portail captif est une page web qui s'affiche lorsqu'un utilisateur se connecte pour la premiĂšre fois Ă un rĂ©seau Wi-Fi. L'utilisateur fournit des informations ou agit sur la page web du portail captif afin d'obtenir un accĂšs plus large aux ressources du rĂ©seau, par exemple en acceptant les conditions gĂ©nĂ©rales ou en effectuant un paiement. -<p>Pour utiliser cette API, vous devez disposer de la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "captivePortal".</p> +Pour utiliser cette API, vous devez disposer de la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) "captivePortal". -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> +## PropriĂ©tĂ©s -<dl> - <dt>{{WebExtAPIRef("captivePortal.canonicalURL")}}</dt> - <dd>Renvoyer l'URL canonique de la page de dĂ©tection du portail des prisonniers. En lecture seule.</dd> -</dl> +- {{WebExtAPIRef("captivePortal.canonicalURL")}} + - : Renvoyer l'URL canonique de la page de dĂ©tection du portail des prisonniers. En lecture seule. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("captivePortal.getLastChecked()")}}</dt> - <dd>Retourne le temps, en millisecondes, depuis que la derniĂšre demande a Ă©tĂ© complĂ©tĂ©e.</dd> - <dt>{{WebExtAPIRef("captivePortal.getState()")}}</dt> - <dd>Renvoie l'Ă©tat du portail comme Ă©tant inconnu, <code>unknown</code>, <code>not_captive</code>, <code>unlocked_portal</code>, ou <code>locked_portal</code>.</dd> -</dl> +- {{WebExtAPIRef("captivePortal.getLastChecked()")}} + - : Retourne le temps, en millisecondes, depuis que la derniĂšre demande a Ă©tĂ© complĂ©tĂ©e. +- {{WebExtAPIRef("captivePortal.getState()")}} + - : Renvoie l'Ă©tat du portail comme Ă©tant inconnu, `unknown`, `not_captive`, `unlocked_portal`, ou `locked_portal`. -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt>{{WebExtAPIRef("captivePortal.onConnectivityAvailable")}}</dt> - <dd>S'allume lorsque le service de portail captif dĂ©termine que l'utilisateur peut se connecter Ă l'internet.</dd> - <dt>{{WebExtAPIRef("captivePortal.onStateChanged")}}</dt> - <dd> - <p>S'allume lorsque l'Ă©tat de portail captif change</p> - </dd> -</dl> +- {{WebExtAPIRef("captivePortal.onConnectivityAvailable")}} + - : S'allume lorsque le service de portail captif dĂ©termine que l'utilisateur peut se connecter Ă l'internet. +- {{WebExtAPIRef("captivePortal.onStateChanged")}} + - : S'allume lorsque l'Ă©tat de portail captif change -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.captivePortal")}}</p> +{{Compat("webextensions.api.captivePortal")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<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 @@ -80,5 +71,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/captivePortal // 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/captiveportal/onconnectivityavailable/index.md b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/onconnectivityavailable/index.md index d276a97ab6..0055b84d98 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/captiveportal/onconnectivityavailable/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/onconnectivityavailable/index.md @@ -11,63 +11,57 @@ tags: - captivePortal translation_of: Mozilla/Add-ons/WebExtensions/API/captivePortal/onConnectivityAvailable --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>S'allume lorsque le service de portail captif dĂ©termine que l'utilisateur peut se connecter Ă l'internet.</p> +S'allume lorsque le service de portail captif dĂ©termine que l'utilisateur peut se connecter Ă l'internet. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.captivePortal.onConnectivityAvailable.addListener(callback) +```js +browser.captivePortal.onConnectivityAvailable.addListener(callback) browser.captivePortal.onConnectivityAvailable.removeListener(listener) browser.captivePortal.onConnectivityAvailable.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>Ajoute un auditeur Ă cet Ă©vĂ©nement</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'auditeur Ă retirer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est inscrit Ă cet Ă©vĂ©nement. Renvoie <code>true</code> si c'est un auditeur, sinon <code>false</code> .</dd> -</dl> +- `addListener(callback)` + - : Ajoute un auditeur Ă cet Ă©vĂ©nement +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'auditeur Ă retirer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est inscrit Ă cet Ă©vĂ©nement. Renvoie `true` si c'est un auditeur, sinon `false` . -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂ©tres">ParamĂ©tres</h3> +### ParamĂ©tres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui est appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction se voit transmettre les arguments suivants :</p> +- `callback` - <dl> - <dt><code>status</code></dt> - <dd><code>string</code> Le statut du service, Ă©tant celui de <code>captive</code> s'il y a un portail captif dĂ©verrouillĂ© prĂ©sent ou <code>clear</code> si aucun portail captif n'est dĂ©tectĂ©</dd> - </dl> - </dd> -</dl> + - : Fonction qui est appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction se voit transmettre les arguments suivants : -<h2 id="Exemples">Exemples</h2> + - `status` + - : `string` Le statut du service, Ă©tant celui de `captive` s'il y a un portail captif dĂ©verrouillĂ© prĂ©sent ou `clear` si aucun portail captif n'est dĂ©tectĂ© -<p>GĂ©rer la capacitĂ© d'un utilisateur de changement Ă se connecter Ă l'internet :</p> +## Exemples -<pre class="brush: js">function handleConnectivity(connectivityInfo) { +GĂ©rer la capacitĂ© d'un utilisateur de changement Ă se connecter Ă l'internet : + +```js +function handleConnectivity(connectivityInfo) { console.log("The captive portal status: " + connectivityInfo.status); } browser.captivePortal.onConnectivityAvailable.addListener(handleConnectivity); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.captivePortal.onConnectivityAvailable")}}</p> +{{Compat("webextensions.api.captivePortal.onConnectivityAvailable")}} -<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 @@ -94,5 +88,4 @@ browser.captivePortal.onConnectivityAvailable.addListener(handleConnectivity); // 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/captiveportal/onstatechanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/onstatechanged/index.md index 09bff21405..21f125a80a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/captiveportal/onstatechanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/captiveportal/onstatechanged/index.md @@ -11,65 +11,57 @@ tags: - captivePortal translation_of: Mozilla/Add-ons/WebExtensions/API/captivePortal/onStateChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>S'allume lorsque l'Ă©tat de portail captif change.</p> +S'allume lorsque l'Ă©tat de portail captif change. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.captivePortal.onStateChanged.addListener(callback) +```js +browser.captivePortal.onStateChanged.addListener(callback) browser.captivePortal.onStateChanged.removeListener(listener) browser.captivePortal.onStateChanged.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>Ajoute un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de <code>listener</code> est l'auditeur Ă retirer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est inscrit Ă cet Ă©vĂ©nement. Renvoie <code>true</code> si c'est un auditeur, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de `listener` est l'auditeur Ă retirer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est inscrit Ă cet Ă©vĂ©nement. Renvoie `true` si c'est un auditeur, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂ©tres">ParamĂ©tres</h3> +### ParamĂ©tres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui est appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction se voit transmettre les arguments suivants :</p> +- `callback` - <dl> - <dt><code>details</code></dt> - <dd> - <p><code>string</code> L'Ătat portail captif, Ă©tant l'un des <code>unknown</code>, <code>not_captive</code>, <code>unlocked_portal</code>, ou <code>locked_portal</code>.</p> - </dd> - </dl> - </dd> -</dl> + - : Fonction qui est appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction se voit transmettre les arguments suivants : -<h2 id="Exemples">Exemples</h2> + - `details` + - : `string` L'Ătat portail captif, Ă©tant l'un des `unknown`, `not_captive`, `unlocked_portal`, ou `locked_portal`. -<p>GĂ©rer un changement de statut de portail captif :</p> +## Exemples -<pre class="brush: js">function handlePortalStatus(portalstatusInfo) { +GĂ©rer un changement de statut de portail captif : + +```js +function handlePortalStatus(portalstatusInfo) { console.log("The portal status is now: " + portalstatusInfo.details); } browser.captivePortal.onStateChanged.addListener(handlePortalStatus) -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.captivePortal.onStateChanged")}}</p> +{{Compat("webextensions.api.captivePortal.onStateChanged")}} -<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 @@ -96,5 +88,4 @@ browser.captivePortal.onStateChanged.addListener(handlePortalStatus) // 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/clipboard/index.md b/files/fr/mozilla/add-ons/webextensions/api/clipboard/index.md index abb0395447..d8633a147f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/clipboard/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/clipboard/index.md @@ -10,30 +10,27 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/clipboard --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>L'API <code>presse-papiers</code> permet Ă une extension de copier des Ă©lĂ©ments dans le presse papier du systĂšme. Actuellement l'API ne prend en charge que la copie d'images, mais elle est destinĂ©e Ă prendre en charge la copie de texte et HTML dans l'avenir.</p> +L'API `presse-papiers` permet Ă une extension de copier des Ă©lĂ©ments dans le presse papier du systĂšme. Actuellement l'API ne prend en charge que la copie d'images, mais elle est destinĂ©e Ă prendre en charge la copie de texte et HTML dans l'avenir. -<p>Cette API WebExtension existe principalement parce que l'API standard du presse-papiers Web <a href="https://w3c.github.io/clipboard-apis/#writing-to-clipboard">ne prend pas en charge l'Ă©criture d'images dans le presse-papiers</a>. Cette API peut ĂȘtre dĂ©prĂ©ciĂ©e une fois que le support de l'API Clipboard pour les contenus non textuels du presse-papiers est entrĂ© en usage gĂ©nĂ©ral.</p> +Cette API WebExtension existe principalement parce que l'API standard du presse-papiers Web [ne prend pas en charge l'Ă©criture d'images dans le presse-papiers](https://w3c.github.io/clipboard-apis/#writing-to-clipboard). Cette API peut ĂȘtre dĂ©prĂ©ciĂ©e une fois que le support de l'API Clipboard pour les contenus non textuels du presse-papiers est entrĂ© en usage gĂ©nĂ©ral. -<p>La lecture depuis le presse-papiers n'est pas prise en charge par cette API, car le presse-papiers peut dĂ©jĂ ĂȘtre lu Ă l'aide des API de plate-forme Web standard. Voir <a href="/fr/Add-ons/WebExtensions/Interact_with_the_clipboard#Reading_from_the_clipboard">Interaction avec le presse-papier</a>.</p> +La lecture depuis le presse-papiers n'est pas prise en charge par cette API, car le presse-papiers peut dĂ©jĂ ĂȘtre lu Ă l'aide des API de plate-forme Web standard. Voir [Interaction avec le presse-papier](/fr/Add-ons/WebExtensions/Interact_with_the_clipboard#Reading_from_the_clipboard). -<p>Cette API est basĂ©e sur l'API de <code><a href="https://developer.chrome.com/apps/clipboard">clipboard</a></code> de Chrome, mais cette API n'est disponible que pour les applications Chrome et non pour les extensions.</p> +Cette API est basĂ©e sur l'API de [`clipboard`](https://developer.chrome.com/apps/clipboard) de Chrome, mais cette API n'est disponible que pour les applications Chrome et non pour les extensions. -<p>Pour utiliser cette API, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>"clipboardWrite"</code>.</p> +Pour utiliser cette API, vous devez avoir la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `"clipboardWrite"`. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("clipboard.setImageData()")}}</dt> - <dd>Copiez une image dans le presse-papiers.</dd> -</dl> +- {{WebExtAPIRef("clipboard.setImageData()")}} + - : Copiez une image dans le presse-papiers. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.clipboard", 1, 1)}} {{WebExtExamples("h2")}}</p> +{{Compat("webextensions.api.clipboard", 1, 1)}} {{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> - -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/apps/clipboard"><code>chrome.clipboard</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.clipboard`](https://developer.chrome.com/apps/clipboard). diff --git a/files/fr/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md b/files/fr/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md index 13c76084b9..80c6d7473d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/clipboard/setimagedata/index.md @@ -12,68 +12,68 @@ tags: - setImageData translation_of: Mozilla/Add-ons/WebExtensions/API/clipboard/setImageData --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Copie une image dans le presse-papiers. L'image est recodĂ©e avant d'ĂȘtre Ă©crite dans le presse-papiers. Si l'image n'est pas valide, le presse-papiers n'est pas modifiĂ©.</p> +Copie une image dans le presse-papiers. L'image est recodĂ©e avant d'ĂȘtre Ă©crite dans le presse-papiers. Si l'image n'est pas valide, le presse-papiers n'est pas modifiĂ©. -<p>L'image est fournie en tant que <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer">ArrayBuffer</a></code> contenant l'image codĂ©e. Les formats JPEG et PNG sont pris en charge.</p> +L'image est fournie en tant que [`ArrayBuffer`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer) contenant l'image codĂ©e. Les formats JPEG et PNG sont pris en charge. -<p>Bien que cette API soit basĂ©e sur l'API <code><a href="https://developer.chrome.com/apps/clipboard">clipboard.setImageData()</a></code> de Chrome, il existe certaines diffĂ©rentes :</p> +Bien que cette API soit basĂ©e sur l'API [`clipboard.setImageData()`](https://developer.chrome.com/apps/clipboard) de Chrome, il existe certaines diffĂ©rentes : -<ul> - <li>L'API Chrome est rĂ©servĂ©e aux applications et non aux extensions.</li> - <li>Cette API nĂ©cessite uniquement la permission <code>"clipboardWrite"</code>, tandis que la version Chrome nĂ©cessite Ă©galement la permission <code>"clipboard"</code>.</li> - <li>L'API de Chrome utilise des rappels et cette API ne prend en charge que les promises.</li> - <li>Cette API ne prend pas en charge le paramĂštre <code>additionalItems</code>.</li> -</ul> +- L'API Chrome est rĂ©servĂ©e aux applications et non aux extensions. +- Cette API nĂ©cessite uniquement la permission `"clipboardWrite"`, tandis que la version Chrome nĂ©cessite Ă©galement la permission `"clipboard"`. +- L'API de Chrome utilise des rappels et cette API ne prend en charge que les promises. +- Cette API ne prend pas en charge le paramĂštre `additionalItems`. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">browser.clipboard.setImageData(<em>imageData</em>, <em>imageType</em>) -</pre> +```js +browser.clipboard.setImageData(imageData, imageType) +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>imageData</code></dt> - <dd><code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer">ArrayBuffer</a></code>. Les donnĂ©es de l'image codĂ©es.</dd> - <dt><code>imageType</code></dt> - <dd>Un {{domxref("DOMString")}} indiquant le type d'image contenue dans le fichier <code>imageData</code>: <code>"png"</code> ou <code>"jpeg"</code>.</dd> -</dl> +- `imageData` + - : [`ArrayBuffer`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer). Les donnĂ©es de l'image codĂ©es. +- `imageType` + - : Un {{domxref("DOMString")}} indiquant le type d'image contenue dans le fichier `imageData`: `"png"` ou `"jpeg"`. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans arguments si l'opĂ©ration a rĂ©ussi, ou rejetĂ©e, s'il y a une erreur (par exemple parce que les donnĂ©es ne reprĂ©sentaient pas une image valide).</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments si l'opĂ©ration a rĂ©ussi, ou rejetĂ©e, s'il y a une erreur (par exemple parce que les donnĂ©es ne reprĂ©sentaient pas une image valide). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.clipboard.setImageData", 10)}}</p> +{{Compat("webextensions.api.clipboard.setImageData", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Copiez une image distante :</p> +Copiez une image distante : -<pre class="brush: js">// requires: +```js +// requires: // * the host permission for "https://cdn.mdn.mozilla.net/*" // * the API permission "clipboardWrite" fetch('https://cdn.mdn.mozilla.net/static/img/favicon144.png') -.then(response => response.arrayBuffer()) -.then(buffer => browser.clipboard.setImageData(buffer, 'png'));</pre> +.then(response => response.arrayBuffer()) +.then(buffer => browser.clipboard.setImageData(buffer, 'png')); +``` -<p>Copiez une image fournie avec l'extension :</p> +Copiez une image fournie avec l'extension : -<pre class="brush: js">// requires the API permission "clipboardWrite" +```js +// requires the API permission "clipboardWrite" fetch(browser.runtime.getURL('image.png')) -.then(response => response.arrayBuffer()) -.then(buffer => browser.clipboard.setImageData(buffer, 'png'));</pre> +.then(response => response.arrayBuffer()) +.then(buffer => browser.clipboard.setImageData(buffer, 'png')); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> - -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/apps/clipboard"><code>chrome.clipboard</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.clipboard`](https://developer.chrome.com/apps/clipboard). diff --git a/files/fr/mozilla/add-ons/webextensions/api/commands/command/index.md b/files/fr/mozilla/add-ons/webextensions/api/commands/command/index.md index a51148fc1e..a25670f205 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/commands/command/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/commands/command/index.md @@ -13,32 +13,29 @@ tags: - commands translation_of: Mozilla/Add-ons/WebExtensions/API/commands/Command --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Information sur une commande. Cela contient les informations spĂ©cifiĂ©es pour la commande dans la <a href="/fr/Add-ons/WebExtensions/manifest.json/commands"><code>commande</code> clef manifest.json</a>.</p> +Information sur une commande. Cela contient les informations spĂ©cifiĂ©es pour la commande dans la [`commande` clef manifest.json](/fr/Add-ons/WebExtensions/manifest.json/commands). -<p>Un tableau de ces objets est renvoyĂ© par {{WebExtAPIRef('commands.getAll()')}}.</p> +Un tableau de ces objets est renvoyĂ© par {{WebExtAPIRef('commands.getAll()')}}. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>name</code>{{optional_inline}}</dt> - <dd><code>string</code>. Nom de la commande. Cela sera passĂ© dans l'Ă©couteur de l'Ă©vĂ©nement {{WebExtAPIRef('commands.onCommand')}}.</dd> - <dt><code>description</code>{{optional_inline}}</dt> - <dd><code>string</code>. Description de cette commande. Ceci est principalement utilisĂ© pour expliquer Ă l'utilisateur ce que cette commande fait.</dd> - <dt><code>shortcut</code>{{optional_inline}}</dt> - <dd><code>string</code>. clef(s) utilisĂ©e pour exĂ©cuter cette commande , spĂ©cifiĂ©e comme une chaĂźne comme "Ctrl+Shift+Y".</dd> -</dl> +- `name`{{optional_inline}} + - : `string`. Nom de la commande. Cela sera passĂ© dans l'Ă©couteur de l'Ă©vĂ©nement {{WebExtAPIRef('commands.onCommand')}}. +- `description`{{optional_inline}} + - : `string`. Description de cette commande. Ceci est principalement utilisĂ© pour expliquer Ă l'utilisateur ce que cette commande fait. +- `shortcut`{{optional_inline}} + - : `string`. clef(s) utilisĂ©e pour exĂ©cuter cette commande , spĂ©cifiĂ©e comme une chaĂźne comme "Ctrl+Shift+Y". -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.commands.Command")}}</p> +{{Compat("webextensions.api.commands.Command")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/commands"><code>chrome.commands</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.commands`](https://developer.chrome.com/extensions/commands). diff --git a/files/fr/mozilla/add-ons/webextensions/api/commands/getall/index.md b/files/fr/mozilla/add-ons/webextensions/api/commands/getall/index.md index c3c2e9b2da..8730added4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/commands/getall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/commands/getall/index.md @@ -13,47 +13,49 @@ tags: - getAll translation_of: Mozilla/Add-ons/WebExtensions/API/commands/getAll --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obient toutes les commandes pour l'exĂ©cution que vous avez enregistrĂ© Ă l'aide d'une des <a href="/fr/Add-ons/WebExtensions/manifest.json/commands"><code>commandes</code> clef du manifest.json</a>.</p> +Obient toutes les commandes pour l'exĂ©cution que vous avez enregistrĂ© Ă l'aide d'une des [`commandes` clef du manifest.json](/fr/Add-ons/WebExtensions/manifest.json/commands). -<p>Les commandes sont renvoyĂ©es sous la forme d'un tableau d'objets  {{WebExtAPIRef('commands.Command')}}. Altenativement, si vous utilisez la version de base promise de l'API, <code>browser.commands.getAll()</code>, les commandes sont passĂ©es dans l'argument <code>onFulfilled</code> Ă <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise/then">Promise.then()</a></code>.</p> +Les commandes sont renvoyĂ©es sous la forme d'un tableau d'objets  {{WebExtAPIRef('commands.Command')}}. Altenativement, si vous utilisez la version de base promise de l'API, `browser.commands.getAll()`, les commandes sont passĂ©es dans l'argument `onFulfilled` Ă [`Promise.then()`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise/then). -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 getCommands = browser.commands.getAll(); -</pre> +```js +var getCommands = browser.commands.getAll(); +``` -<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 accompli avec un tableau d'objets <code>{{WebExtAPIRef('commands.Command')}}</code>, un pour chaque commande enregistrĂ©e pour l'extension. Si aucune n'a Ă©tĂ© enregistrĂ©e, le tableau sera vide.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera accompli avec un tableau d'objets `{{WebExtAPIRef('commands.Command')}}`, un pour chaque commande enregistrĂ©e pour l'extension. Si aucune n'a Ă©tĂ© enregistrĂ©e, le tableau sera vide. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.commands.getAll")}}</p> +{{Compat("webextensions.api.commands.getAll")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function logCommands(commands) { +```js +function logCommands(commands) {  commands.forEach(function(command) {    console.log(command);  }); } var getCommands = browser.commands.getAll(); -getCommands.then(logCommands);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +getCommands.then(logCommands); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/commands"><code>chrome.commands</code></a>.</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.commands`](https://developer.chrome.com/extensions/commands). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/commands/index.md b/files/fr/mozilla/add-ons/webextensions/api/commands/index.md index 3321458882..de0b79e761 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/commands/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/commands/index.md @@ -11,56 +11,40 @@ tags: - commands translation_of: Mozilla/Add-ons/WebExtensions/API/commands --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Ăcoutez l'utilisateur exĂ©cutant les commandes que vous avez enregistrĂ©es Ă l'aide des <a href="/fr/Add-ons/WebExtensions/manifest.json/commands">clĂ©s <code>commandes</code> du fichier manifest.json</a>.</p> +Ăcoutez l'utilisateur exĂ©cutant les commandes que vous avez enregistrĂ©es Ă l'aide des [clĂ©s `commandes` du fichier manifest.json](/fr/Add-ons/WebExtensions/manifest.json/commands). -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("commands.Command")}}</dt> - <dd>Objet reprĂ©sentant une commande. Il contient les informations spĂ©cifiĂ©es pour la commande dans les <a href="/fr/Add-ons/WebExtensions/manifest.json/commands">clĂ©s <code>commands</code> du fichier manifest.json</a>.</dd> -</dl> +- {{WebExtAPIRef("commands.Command")}} + - : Objet reprĂ©sentant une commande. Il contient les informations spĂ©cifiĂ©es pour la commande dans les [clĂ©s `commands` du fichier manifest.json](/fr/Add-ons/WebExtensions/manifest.json/commands). -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("commands.getAll")}}</dt> - <dd> - <p>Obtient toutes les commandes enregistrĂ©es pour cette extension.</p> - </dd> - <dt>{{WebExtAPIRef("commands.reset")}}</dt> - <dd> - <p>RĂ©initialiser la description de la commande donnĂ©e et le raccourci vers les valeurs donnĂ©es dans la clĂ© âmanifestâ.</p> - </dd> - <dt>{{WebExtAPIRef("commands.update")}}</dt> - <dd> - <p>Modifiez la description ou le raccourci de la commande donnĂ©e.</p> - </dd> -</dl> +- {{WebExtAPIRef("commands.getAll")}} + - : Obtient toutes les commandes enregistrĂ©es pour cette extension. +- {{WebExtAPIRef("commands.reset")}} + - : RĂ©initialiser la description de la commande donnĂ©e et le raccourci vers les valeurs donnĂ©es dans la clĂ© âmanifestâ. +- {{WebExtAPIRef("commands.update")}} + - : Modifiez la description ou le raccourci de la commande donnĂ©e. -<h2 id="ĂvĂ©nements">ĂvĂ©nements</h2> +## ĂvĂ©nements -<dl> - <dt>{{WebExtAPIRef("commands.onCommand")}}</dt> - <dd> - <div>ActivĂ© lorsqu'une commande est exĂ©cutĂ©e Ă l'aide du raccourci clavier associĂ©.</div> - </dd> -</dl> +- {{WebExtAPIRef("commands.onCommand")}} + - : ActivĂ© lorsqu'une commande est exĂ©cutĂ©e Ă l'aide du raccourci clavier associĂ©. -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> +## CompatibilitĂ© des navigateurs -<p>{{Compat("webextensions.api.commands")}} {{WebExtExamples("h2")}}</p> +{{Compat("webextensions.api.commands")}} {{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.commands`](https://developer.chrome.com/extensions/commands). +> +> 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/commands"><code>chrome.commands</code></a>.</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 @@ -87,5 +71,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/commands // 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/commands/oncommand/index.md b/files/fr/mozilla/add-ons/webextensions/api/commands/oncommand/index.md index 36e829fd95..9e249adf85 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/commands/oncommand/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/commands/oncommand/index.md @@ -13,74 +13,67 @@ tags: - onCommand translation_of: Mozilla/Add-ons/WebExtensions/API/commands/onCommand --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Lancer quand une commande est exĂ©cutĂ©e Ă l'aide de son raccourci clavier associĂ©.L'Ă©couteur reçoit le nom de la commande. Cela correspond au nom donnĂ©e Ă la commande dans une [entrĂ©e manifest.json](/fr/Add-ons/WebExtensions/manifest.json/commands). -<div>Lancer quand une commande est exĂ©cutĂ©e Ă l'aide de son raccourci clavier associĂ©.</div> +## Syntaxe -<div>L'Ă©couteur reçoit le nom de la commande. Cela correspond au nom donnĂ©e Ă la commande dans une <a href="/fr/Add-ons/WebExtensions/manifest.json/commands">entrĂ©e manifest.json</a>.</div> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">browser.commands.onCommand.addListener(listener) +```js +browser.commands.onCommand.addListener(listener) browser.commands.onCommand.removeListener(listener) browser.commands.onCommand.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>Ajoute un Ă©couteur Ă un Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘter d'Ă©couter un Ă©vĂ©nement. L'arguement <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement . Renvoie <code>true</code> s'il Ă©coute, <code>false</code> sinon.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă un Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘter d'Ă©couter un Ă©vĂ©nement. L'arguement `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement . Renvoie `true` s'il Ă©coute, `false` sinon. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštre">ParamĂštre</h3> +### ParamĂštre -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsqu'un utilisateur entre dans le raccourci de la commande. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>name</code></dt> - <dd><code>string</code>. Nom de la commande. Cela correspond au nom donnĂ© Ă la commande dans son <a href="/fr/Add-ons/WebExtensions/manifest.json/commands">entrĂ©e manifest.json</a>.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsqu'un utilisateur entre dans le raccourci de la commande. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `name` + - : `string`. Nom de la commande. Cela correspond au nom donnĂ© Ă la commande dans son [entrĂ©e manifest.json](/fr/Add-ons/WebExtensions/manifest.json/commands). -<p>{{Compat("webextensions.api.commands.onCommand")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.commands.onCommand")}} -<div>Etant donnĂ©e une entrĂ©e manifest.json comme ceci :</div> +## Exemples -<pre class="brush: json">"commands": { +Etant donnĂ©e une entrĂ©e manifest.json comme ceci : + +```json +"commands": { "toggle-feature": { "suggested_key": { "default": "Ctrl+Shift+Y" }, "description": "Send a 'toggle-feature' event" } -}</pre> +} +``` -<div>Vous pouvez Ă©couter cette commande particuliĂšre comme ceci :</div> +Vous pouvez Ă©couter cette commande particuliĂšre comme ceci : -<pre class="brush: js">browser.commands.onCommand.addListener(function(command) { +```js +browser.commands.onCommand.addListener(function(command) { if (command == "toggle-feature") { console.log("toggling the feature!"); } -});</pre> - -<p>{{WebExtExamples}}</p> +}); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/commands"><code>chrome.commands</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.commands`](https://developer.chrome.com/extensions/commands). diff --git a/files/fr/mozilla/add-ons/webextensions/api/commands/reset/index.md b/files/fr/mozilla/add-ons/webextensions/api/commands/reset/index.md index a1f61322da..1e5aa0a764 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/commands/reset/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/commands/reset/index.md @@ -12,46 +12,47 @@ tags: - reset translation_of: Mozilla/Add-ons/WebExtensions/API/commands/reset --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>RĂ©initialise la description de la commande donnĂ©e et le raccourci clavier aux valeurs indiquĂ©es dans <a href="/fr/Add-ons/WebExtensions/manifest.json/commands"><code>commands</code> de la clĂ© du manifest.json</a> de l'extension.</p> +RĂ©initialise la description de la commande donnĂ©e et le raccourci clavier aux valeurs indiquĂ©es dans [`commands` de la clĂ© du manifest.json](/fr/Add-ons/WebExtensions/manifest.json/commands) de l'extension. -<p>Cela annule efficacement les modifications apportĂ©es Ă la commande Ă l'aide de la fonction {{WEbExtAPIRef("commands.update()")}}.</p> +Cela annule efficacement les modifications apportĂ©es Ă la commande Ă l'aide de la fonction {{WEbExtAPIRef("commands.update()")}}. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">browser.commands.reset( +```js +browser.commands.reset( name // string ); -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>name</code></dt> - <dd><code>string</code>. Nom de la commande Ă rĂ©initialiser, comme indiquĂ© par la propriĂ©tĂ© <code>name</code> de l'objet {{WebExtAPIRef("commands.Command")}}.</dd> -</dl> +- `name` + - : `string`. Nom de la commande Ă rĂ©initialiser, comme indiquĂ© par la propriĂ©tĂ© `name` de l'objet {{WebExtAPIRef("commands.Command")}}. -<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 sans arguments lorsque le raccourci a Ă©tĂ© rĂ©initialisĂ©.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments lorsque le raccourci a Ă©tĂ© rĂ©initialisĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.commands.reset")}}</p> +{{Compat("webextensions.api.commands.reset")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>RĂ©initialise la commande "my-command" lorsque l'utilisateur clique sur le bouton "reset" :</p> +RĂ©initialise la commande "my-command" lorsque l'utilisateur clique sur le bouton "reset" : -<pre class="brush: js">const commandName = 'my-command'; +```js +const commandName = 'my-command'; function resetShortcut() { browser.commands.reset(commandName); } -document.querySelector('#reset').addEventListener('click', resetShortcut);</pre> +document.querySelector('#reset').addEventListener('click', resetShortcut); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/commands/update/index.md b/files/fr/mozilla/add-ons/webextensions/api/commands/update/index.md index 19475584cd..92ad752662 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/commands/update/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/commands/update/index.md @@ -12,48 +12,47 @@ tags: - commands translation_of: Mozilla/Add-ons/WebExtensions/API/commands/update --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Changez la description ou le raccourci clavier pour la commande donnĂ©e.</p> +Changez la description ou le raccourci clavier pour la commande donnĂ©e. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">browser.commands.update( +```js +browser.commands.update( details // object ); -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Un objet avec les propriĂ©tĂ©s suivantes:</p> - <dl> - <dt><code>name</code></dt> - <dd><code>string</code>. e nom de la commande Ă mettre Ă jour. Cela doit correspondre au nom d'une commande existante, comme indiquĂ© par exemple dans la propriĂ©tĂ© <code>name</code> de l'objet {{WebExtAPIRef("commands.Command")}}.</dd> - <dt><code>description</code>{{optional_inline}}</dt> - <dd><code>string</code>. Une nouvelle description Ă dĂ©finir pour la commande.</dd> - <dt><code>shortcut</code>{{optional_inline}}</dt> - <dd><code>string</code>. Un nouveau raccourci Ă dĂ©finir pour la commande. Cela doit correspondre au format donnĂ© dans la documentation pour les <a href="/fr/Add-ons/WebExtensions/manifest.json/commands"><code>commands</code> de la clĂ© manifest.json</a>. S'il ne correspond pas Ă ce format, la fonction va gĂ©nĂ©rer une erreur.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. Un objet avec les propriĂ©tĂ©s suivantes: -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans arguments lorsque le raccourci a Ă©tĂ© rĂ©initialisĂ©. La promesse sera rejetĂ©e avec une erreur si la commande n'a pas pu ĂȘtre trouvĂ©e.</p> + - `name` + - : `string`. e nom de la commande Ă mettre Ă jour. Cela doit correspondre au nom d'une commande existante, comme indiquĂ© par exemple dans la propriĂ©tĂ© `name` de l'objet {{WebExtAPIRef("commands.Command")}}. + - `description`{{optional_inline}} + - : `string`. Une nouvelle description Ă dĂ©finir pour la commande. + - `shortcut`{{optional_inline}} + - : `string`. Un nouveau raccourci Ă dĂ©finir pour la commande. Cela doit correspondre au format donnĂ© dans la documentation pour les [`commands` de la clĂ© manifest.json](/fr/Add-ons/WebExtensions/manifest.json/commands). S'il ne correspond pas Ă ce format, la fonction va gĂ©nĂ©rer une erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.commands.update")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments lorsque le raccourci a Ă©tĂ© rĂ©initialisĂ©. La promesse sera rejetĂ©e avec une erreur si la commande n'a pas pu ĂȘtre trouvĂ©e. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Met Ă jour la commande "my-command" avec la valeur de raccourci donnĂ©e, lorsque l'utilisateur clique sur "update" :</p> +{{Compat("webextensions.api.commands.update")}} -<pre class="brush: js">const commandName = 'my-command'; +## Exemples + +Met Ă jour la commande "my-command" avec la valeur de raccourci donnĂ©e, lorsque l'utilisateur clique sur "update" : + +```js +const commandName = 'my-command'; function updateShortcut() { browser.commands.update({ @@ -62,6 +61,7 @@ function updateShortcut() { }); } -document.querySelector('#update').addEventListener('click', updateShortcut);</pre> +document.querySelector('#update').addEventListener('click', updateShortcut); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/contentscripts/index.md b/files/fr/mozilla/add-ons/webextensions/api/contentscripts/index.md index f74668a67d..14ad5b9ea9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contentscripts/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contentscripts/index.md @@ -10,36 +10,30 @@ tags: - contentScripts translation_of: Mozilla/Add-ons/WebExtensions/API/contentScripts --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Utilisez cette API pour enregistrer des scripts de contenu. L'enregistrement d'un script de contenu demande au navigateur d'insĂ©rer les scripts de contenu donnĂ©s dans des pages correspondant aux modĂšles d'URL donnĂ©s.</p> +Utilisez cette API pour enregistrer des scripts de contenu. L'enregistrement d'un script de contenu demande au navigateur d'insĂ©rer les scripts de contenu donnĂ©s dans des pages correspondant aux modĂšles d'URL donnĂ©s. -<p>Cette API est trĂšs similaire Ă la clĂ© <code><a href="/fr/Add-ons/WebExtensions/manifest.json/content_scripts">"content_scripts"</a></code> du manifest.json, Ă l'exception de <code>"content_scripts"</code> , l'ensemble des scripts de contenu et des motifs associĂ©s est fixĂ© au moment de l'installation. Avec l'API <code>contentScripts</code>, une extension peut enregistrer et dĂ©senregistrer des scripts au moment de l'exĂ©cution.</p> +Cette API est trĂšs similaire Ă la clĂ© [`"content_scripts"`](/fr/Add-ons/WebExtensions/manifest.json/content_scripts) du manifest.json, Ă l'exception de `"content_scripts"` , l'ensemble des scripts de contenu et des motifs associĂ©s est fixĂ© au moment de l'installation. Avec l'API `contentScripts`, une extension peut enregistrer et dĂ©senregistrer des scripts au moment de l'exĂ©cution. -<p>Pour utiliser l'API, appelez {{WebExtAPIRef("contentScripts.register()")}} en passant dans un objet dĂ©finissant les scripts Ă enregistrer, les modĂšles d'URL, et d'autres options. Ceci retourne une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui est rĂ©solue avec un objet {{WebExtAPIRef("contentScripts.RegisteredContentScript")}}.</p> +Pour utiliser l'API, appelez {{WebExtAPIRef("contentScripts.register()")}} en passant dans un objet dĂ©finissant les scripts Ă enregistrer, les modĂšles d'URL, et d'autres options. Ceci retourne une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est rĂ©solue avec un objet {{WebExtAPIRef("contentScripts.RegisteredContentScript")}}. -<p>L'objet <code>RegisteredContentScript</code> reprĂ©sente les scripts enregistrĂ©s dans l'appel <code>register()</code> . Il dĂ©finit une mĂ©thode <code>unregister()</code> que vous pouvez utiliser pour annuler l'inscription des scripts de contenu. Les scripts de contenu sont Ă©galement dĂ©senregistrĂ©s automatiquement lorsque la page qui les a crĂ©Ă©s est dĂ©truite. Par exemple, s'ils sont enregistrĂ©s Ă partir de la page d'arriĂšre-plan, ils seront automatiquement dĂ©senregistrĂ©s lorsque la page d'arriĂšre-plan est dĂ©truite et s'ils sont enregistrĂ©s depuis une barre latĂ©rale ou une fenĂȘtre contextuelle, ils seront automatiquement dĂ©sinscrits.</p> +L'objet `RegisteredContentScript` reprĂ©sente les scripts enregistrĂ©s dans l'appel `register()` . Il dĂ©finit une mĂ©thode `unregister()` que vous pouvez utiliser pour annuler l'inscription des scripts de contenu. Les scripts de contenu sont Ă©galement dĂ©senregistrĂ©s automatiquement lorsque la page qui les a crĂ©Ă©s est dĂ©truite. Par exemple, s'ils sont enregistrĂ©s Ă partir de la page d'arriĂšre-plan, ils seront automatiquement dĂ©senregistrĂ©s lorsque la page d'arriĂšre-plan est dĂ©truite et s'ils sont enregistrĂ©s depuis une barre latĂ©rale ou une fenĂȘtre contextuelle, ils seront automatiquement dĂ©sinscrits. -<p>Il n'y a pas de permission de l'API <code>contentScripts</code>, mais une extension doit disposer des <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions d'hĂŽte</a> appropriĂ©es pour tous les modĂšles qu'elle transmet Ă <code>register()</code>.</p> +Il n'y a pas de permission de l'API `contentScripts`, mais une extension doit disposer des [permissions d'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) appropriĂ©es pour tous les modĂšles qu'elle transmet Ă `register()`. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("contentScripts.RegisteredContentScript")}}</dt> - <dd> - <p>Un objet de ce type est renvoyĂ© par la fonction {{WebExtAPIRef("contentScripts.register()")}}. Il reprĂ©sente les scripts de contenu enregistrĂ©s par cet appel et peut ĂȘtre utilisĂ© pour annuler l'enregistrement du script de contenu.</p> - </dd> -</dl> +- {{WebExtAPIRef("contentScripts.RegisteredContentScript")}} + - : Un objet de ce type est renvoyĂ© par la fonction {{WebExtAPIRef("contentScripts.register()")}}. Il reprĂ©sente les scripts de contenu enregistrĂ©s par cet appel et peut ĂȘtre utilisĂ© pour annuler l'enregistrement du script de contenu. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("contentScripts.register()")}}</dt> - <dd>Enregistre les scripts de contenu donnĂ©s.</dd> -</dl> +- {{WebExtAPIRef("contentScripts.register()")}} + - : Enregistre les scripts de contenu donnĂ©s. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.contentScripts", 10, 1)}}</p> +{{Compat("webextensions.api.contentScripts", 10, 1)}} -<p> {{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/contentscripts/register/index.md b/files/fr/mozilla/add-ons/webextensions/api/contentscripts/register/index.md index 43d9573646..4102732bdc 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contentscripts/register/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contentscripts/register/index.md @@ -10,74 +10,69 @@ tags: - register translation_of: Mozilla/Add-ons/WebExtensions/API/contentScripts/register --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Utilisez cette fonction pour enregistrer un ou plusieurs scripts de contenu.</p> +Utilisez cette fonction pour enregistrer un ou plusieurs scripts de contenu. -<p>Il accepte un paramĂštre, qui est un objet avec des propriĂ©tĂ©s similaires aux objets donnĂ©s dans la clĂ© du manifest <code><a href="/fr/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code> (mais notez que <code>content_scripts</code> est un tableau d'objets, tandis que l'argument de <code>register()</code> est un simple objet).</p> +Il accepte un paramĂštre, qui est un objet avec des propriĂ©tĂ©s similaires aux objets donnĂ©s dans la clĂ© du manifest [`content_scripts`](/fr/Add-ons/WebExtensions/manifest.json/content_scripts) (mais notez que `content_scripts` est un tableau d'objets, tandis que l'argument de `register()` est un simple objet). -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 registering = browser.contentScripts.register( +```js +var registering = browser.contentScripts.register( contentScriptOptions // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>contentScriptOptions</code></dt> - <dd> - <p><code>object</code>. Un objet <code>RegisteredContentScriptOptions</code> reprĂ©sentant les scripts de contenu Ă enregistrer. Sa syntaxe est similaire Ă celle des objets du tableau de clĂ©s de manifest <code><a href="/fr/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>. Les diffĂ©rences sont :</p> +- `contentScriptOptions` - <ul> - <li>les noms de propriĂ©tĂ© utilisent camelCase plutĂŽt que des traits de soulignement (par exemple, <code>excludeMatches</code>, pas <code>exclude_matches</code></li> - <li>les propriĂ©tĂ©s <code>js</code> et <code>css</code> vous permettent d'enregistrer des chaĂźnes ainsi que des URL, leur syntaxe doit donc distinguer ces types.</li> - </ul> + - : `object`. Un objet `RegisteredContentScriptOptions` reprĂ©sentant les scripts de contenu Ă enregistrer. Sa syntaxe est similaire Ă celle des objets du tableau de clĂ©s de manifest [`content_scripts`](/fr/Add-ons/WebExtensions/manifest.json/content_scripts). Les diffĂ©rences sont : - <p>L'objet <code>RegisteredContentScriptOptions</code> a les propriĂ©tĂ©s suivantes :</p> + - les noms de propriĂ©tĂ© utilisent camelCase plutĂŽt que des traits de soulignement (par exemple, `excludeMatches`, pas `exclude_matches` + - les propriĂ©tĂ©s `js` et `css` vous permettent d'enregistrer des chaĂźnes ainsi que des URL, leur syntaxe doit donc distinguer ces types. - <dl> - <dt><code>allFrames</code>{{optional_inline}}</dt> - <dd>Identique Ă <code>all_frames</code> dans la clĂ© <code><a href="/fr/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>css</code>{{optional_inline}}</dt> - <dd>Un tableau d'objets. Chaque objet possĂšde soit une propriĂ©tĂ© nommĂ©e <code>file</code>, qui est une URL commençant par manifest.json de l'extension et pointant vers un fichier CSS Ă enregistrer, soit une propriĂ©tĂ© nommĂ©e <code>code</code>, qui est un code CSS Ă enregistrer.</dd> - <dt><code>excludeGlobs</code>{{optional_inline}}</dt> - <dd>Identique Ă <code>exclude_globs</code> dans la clĂ© <code><a href="/fr/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>excludeMatches</code>{{optional_inline}}</dt> - <dd>Identique Ă <code>exclude_matches</code> dans la clĂ© <code><a href="/fr/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>includeGlobs</code>{{optional_inline}}</dt> - <dd>Identique Ă <code>include_globs</code> dans la clĂ© <code><a href="/fr/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>js</code>{{optional_inline}}</dt> - <dd>Un tableau d'objets. Chaque objet possĂšde soit une propriĂ©tĂ© nommĂ©e <code>file</code>, qui est une URL commençant par manifest.json de l'extension et pointant vers un fichier JavaScript Ă enregistrer, soit une propriĂ©tĂ© nommĂ©e <code>code</code>, qui est du code JavaScript Ă enregistrer.</dd> - <dt><code>matchAboutBlank</code>{{optional_inline}}</dt> - <dd>Identique Ă <code>match_about_blank</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>matches</code></dt> - <dd>Identique Ă <code>matches</code> dans la clĂ© <code><a href="/fr/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>runAt</code>{{optional_inline}}</dt> - <dd>Identique Ă <code>run_at</code> dans la clĂ© <code><a href="/fr/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - </dl> - </dd> -</dl> + L'objet `RegisteredContentScriptOptions` a les propriĂ©tĂ©s suivantes : -<h3 id="Return_value">Return value</h3> + - `allFrames`{{optional_inline}} + - : Identique Ă `all_frames` dans la clĂ© [`content_scripts`](/fr/Add-ons/WebExtensions/manifest.json/content_scripts). + - `css`{{optional_inline}} + - : Un tableau d'objets. Chaque objet possĂšde soit une propriĂ©tĂ© nommĂ©e `file`, qui est une URL commençant par manifest.json de l'extension et pointant vers un fichier CSS Ă enregistrer, soit une propriĂ©tĂ© nommĂ©e `code`, qui est un code CSS Ă enregistrer. + - `excludeGlobs`{{optional_inline}} + - : Identique Ă `exclude_globs` dans la clĂ© [`content_scripts`](/fr/Add-ons/WebExtensions/manifest.json/content_scripts). + - `excludeMatches`{{optional_inline}} + - : Identique Ă `exclude_matches` dans la clĂ© [`content_scripts`](/fr/Add-ons/WebExtensions/manifest.json/content_scripts). + - `includeGlobs`{{optional_inline}} + - : Identique Ă `include_globs` dans la clĂ© [`content_scripts`](/fr/Add-ons/WebExtensions/manifest.json/content_scripts). + - `js`{{optional_inline}} + - : Un tableau d'objets. Chaque objet possĂšde soit une propriĂ©tĂ© nommĂ©e `file`, qui est une URL commençant par manifest.json de l'extension et pointant vers un fichier JavaScript Ă enregistrer, soit une propriĂ©tĂ© nommĂ©e `code`, qui est du code JavaScript Ă enregistrer. + - `matchAboutBlank`{{optional_inline}} + - : Identique Ă `match_about_blank` dans la clĂ© [`content_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts). + - `matches` + - : Identique Ă `matches` dans la clĂ© [`content_scripts`](/fr/Add-ons/WebExtensions/manifest.json/content_scripts). + - `runAt`{{optional_inline}} + - : Identique Ă `run_at` dans la clĂ© [`content_scripts`](/fr/Add-ons/WebExtensions/manifest.json/content_scripts). -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet {{WebExtAPIRef("contentScripts.RegisteredContentScript")}} que vous pouvez utiliser pour annuler l'enregistrement des scripts de contenu.</p> +### Return value -<p>Actuellement, les scripts de contenu ne sont pas enregistrĂ©s lorsque la page d'extension correspondante (Ă partir de laquelle les scripts de contenu ont Ă©tĂ© enregistrĂ©s) est dĂ©chargĂ©e, vous devez donc enregistrer un script de contenu depuis une page d'extension qui persiste au moins aussi longtemps que vous voulez que les scripts de contenu restent enregistrĂ©s.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef("contentScripts.RegisteredContentScript")}} que vous pouvez utiliser pour annuler l'enregistrement des scripts de contenu. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +Actuellement, les scripts de contenu ne sont pas enregistrĂ©s lorsque la page d'extension correspondante (Ă partir de laquelle les scripts de contenu ont Ă©tĂ© enregistrĂ©s) est dĂ©chargĂ©e, vous devez donc enregistrer un script de contenu depuis une page d'extension qui persiste au moins aussi longtemps que vous voulez que les scripts de contenu restent enregistrĂ©s. -<p>{{Compat("webextensions.api.contentScripts.register", 10)}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.contentScripts.register", 10)}} -<p>Cet exemple enregistre le script de contenu <code>defaultCode</code> pour toutes les URL <code>.org</code> :</p> +## Exemples -<pre class="brush: js">const defaultHosts = "*://*.org/*"; -const defaultCode = "document.body.innerHTML = '<h1>This page has been eaten<h1>'"; +Cet exemple enregistre le script de contenu `defaultCode` pour toutes les URL `.org` : + +```js +const defaultHosts = "*://*.org/*"; +const defaultCode = "document.body.innerHTML = '<h1>This page has been eaten<h1>'"; async function register(hosts, code) { @@ -89,16 +84,18 @@ async function register(hosts, code) { } -var registered = register(defaultHosts, defaultCode);</pre> +var registered = register(defaultHosts, defaultCode); +``` -<p>Ce code enregistre le fichier JS Ă l'adresse content_scripts/example.js:</p> +Ce code enregistre le fichier JS Ă l'adresse content_scripts/example.js: -<pre class="brush: js">const scriptObj = await browser.contentScripts.register({ +```js +const scriptObj = await browser.contentScripts.register({ "js": [{file: "/content_scripts/example.js"}], - "matches": ["<all_urls>"], + "matches": ["<all_urls>"], "allFrames": true, "runAt": "document_start" }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/contentscripts/registeredcontentscript/index.md b/files/fr/mozilla/add-ons/webextensions/api/contentscripts/registeredcontentscript/index.md index 5539d80a6b..7fca953fa0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contentscripts/registeredcontentscript/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contentscripts/registeredcontentscript/index.md @@ -12,39 +12,36 @@ tags: - contentScripts translation_of: Mozilla/Add-ons/WebExtensions/API/contentScripts/RegisteredContentScript --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un <code>RegisteredContentScript</code> est renvoyĂ© par un appel Ă Â {{WebExtAPIRef("contentScripts.register()")}} et reprĂ©sente les scripts de contenu enregistrĂ©s dans cet appel.</p> +Un `RegisteredContentScript` est renvoyĂ© par un appel Ă Â {{WebExtAPIRef("contentScripts.register()")}} et reprĂ©sente les scripts de contenu enregistrĂ©s dans cet appel. -<p>Il dĂ©finit une seule fonction {{WebExtAPIRef("contentScripts.RegisteredContentScript.unregister()", "unregister()")}}, qui peut ĂȘtre utilisĂ©e pour annuler l'enregistrement des scripts de contenu.</p> +Il dĂ©finit une seule fonction {{WebExtAPIRef("contentScripts.RegisteredContentScript.unregister()", "unregister()")}}, qui peut ĂȘtre utilisĂ©e pour annuler l'enregistrement des scripts de contenu. -<div class="blockIndicator note"> -<p><strong>Note:</strong> Si cet objet est dĂ©truit (par exemple parce qu'il est hors de portĂ©e), les scripts de contenu seront automatiquement dĂ©sinscrits. Vous devriez donc garder une rĂ©fĂ©rence Ă cet objet aussi longtemps que vous voulez que les scripts de contenu restent enregistrĂ©s.</p> -</div> +> **Note :** Si cet objet est dĂ©truit (par exemple parce qu'il est hors de portĂ©e), les scripts de contenu seront automatiquement dĂ©sinscrits. Vous devriez donc garder une rĂ©fĂ©rence Ă cet objet aussi longtemps que vous voulez que les scripts de contenu restent enregistrĂ©s. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +## MĂ©thodes -<dl> - <dt>{{WebExtAPIRef("contentScripts.RegisteredContentScript.unregister","unregister()")}}</dt> - <dd>Annule l'inscription des scripts de contenu reprĂ©sentĂ©s par cet objet.</dd> -</dl> +- {{WebExtAPIRef("contentScripts.RegisteredContentScript.unregister","unregister()")}} + - : Annule l'inscription des scripts de contenu reprĂ©sentĂ©s par cet objet. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.contentScripts.RegisteredContentScript", 10)}}</p> +{{Compat("webextensions.api.contentScripts.RegisteredContentScript", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code permet de basculer un script de contenu enregistrĂ© sur un clic d'action du navigateur :</p> +Ce code permet de basculer un script de contenu enregistrĂ© sur un clic d'action du navigateur : -<pre class="brush: js">var registered = null; +```js +var registered = null; async function register() { registered = await browser.contentScripts.register({ matches: ["*://*.org/*"], js: [{ - code: "document.body.innerHTML = '<h1>This page has been eaten<h1>'" + code: "document.body.innerHTML = '<h1>This page has been eaten<h1>'" }], runAt: "document_idle" }); @@ -61,7 +58,6 @@ function toggle() { } browser.browserAction.onClicked.addListener(toggle); +``` -</pre> - -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/contentscripts/registeredcontentscript/unregister/index.md b/files/fr/mozilla/add-ons/webextensions/api/contentscripts/registeredcontentscript/unregister/index.md index 4f52e84f24..197ca7f70b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contentscripts/registeredcontentscript/unregister/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contentscripts/registeredcontentscript/unregister/index.md @@ -11,39 +11,39 @@ tags: translation_of: >- Mozilla/Add-ons/WebExtensions/API/contentScripts/RegisteredContentScript/unregister --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Annule l'inscription des scripts de contenu reprĂ©sentĂ©s par cet objet `RegisteredContentScript`. -<div>Annule l'inscription des scripts de contenu reprĂ©sentĂ©s par cet objet <code>RegisteredContentScript</code>.</div> +## Syntaxe -<h2 id="Syntaxe">Syntaxe</h2> +```js +registered.unregister() +``` -<pre class="brush: js">registered.unregister() -</pre> +### ParamĂštres -<h3 id="ParamĂštres">ParamĂštres</h3> +None. -<p>None.</p> +### Valeur retournĂ©e -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +None. -<p>None.</p> +## CompatibilitĂ© du navigateur -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{Compat("webextensions.api.contentScripts.RegisteredContentScript.unregister", 10)}} -<p>{{Compat("webextensions.api.contentScripts.RegisteredContentScript.unregister", 10)}}</p> +## Exemples -<h2 id="Exemples">Exemples</h2> +Ce code permet de basculer un script de contenu enregistrĂ© sur un clic d'action du navigateur : -<p>Ce code permet de basculer un script de contenu enregistrĂ© sur un clic d'action du navigateur :</p> - -<pre class="brush: js">var registered = null; +```js +var registered = null; async function register() { registered = await browser.contentScripts.register({ matches: ["*://*.org/*"], js: [{ - code: "document.body.innerHTML = '<h1>This page has been eaten<h1>'" + code: "document.body.innerHTML = '<h1>This page has been eaten<h1>'" }], runAt: "document_idle" }); @@ -60,6 +60,6 @@ function toggle() { } browser.browserAction.onClicked.addListener(toggle); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/contextualidentity/index.md b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/contextualidentity/index.md index af8db1a3f5..1502ea7b3d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/contextualidentity/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/contextualidentity/index.md @@ -12,63 +12,57 @@ tags: - contextalIdentities translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities/ContextualIdentity --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code><strong>contextualIdentities</strong></code><strong><code>.ContextualIdentity</code></strong> dĂ©crit une identitĂ© contextuelle unique.</p> +Le type **`contextualIdentities`\*\***`.ContextualIdentity`\*\* dĂ©crit une identitĂ© contextuelle unique. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>cookieStoreId</code></dt> - <dd><code>string</code>. L'ID du magasin de cookies pour l'identitĂ©. Puisque les identitĂ©s contextuelles ne partagent pas les banques de cookies, elles servent d'identificateur unique.</dd> - <dt><code>color</code></dt> - <dd> - <p><code>string</code>. La couleur pour l'identitĂ©. Cela sera montrĂ© dans les onglets appartenant Ă cette identitĂ©. Les valeurs suivantes sont valides :</p> +- `cookieStoreId` + - : `string`. L'ID du magasin de cookies pour l'identitĂ©. Puisque les identitĂ©s contextuelles ne partagent pas les banques de cookies, elles servent d'identificateur unique. +- `color` - <ul> - <li>"blue"</li> - <li>"turquoise"</li> - <li>"green"</li> - <li>"yellow"</li> - <li>"orange"</li> - <li>"red"</li> - <li>"pink"</li> - <li>"purple"</li> - <li>"toolbar"</li> - </ul> + - : `string`. La couleur pour l'identitĂ©. Cela sera montrĂ© dans les onglets appartenant Ă cette identitĂ©. Les valeurs suivantes sont valides : - <p>La valeur "toolbar" reprĂ©sente une couleur dĂ©pendant du thĂšme. Les identitĂ©s avec la couleur "toolbar" seront affichĂ©es dans la mĂȘme couleur que le texte de la barre d'outils (correspondant Ă la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/theme#colors">clĂ© thĂšme</a> <code>"toolbar_field_text"</code>).</p> - </dd> - <dt><code>colorCode</code></dt> - <dd><code>string</code>. Un code hexadĂ©cimal reprĂ©sentant la couleur exacte utilisĂ©e pour l'identitĂ©. Par exemple : <code>"#37adff"</code>. Dans le cas particulier de la couleur "toolbar", <code>colorCode</code> est toujours <code>"#7c7c7d"</code>, quelle que soit la couleur affichĂ©e.</dd> - <dt><code>icon</code></dt> - <dd> - <p><code>string</code>. Le nom d'une icĂŽne pour l'identitĂ©. Cela s'affichera dans la barre d'URL pour les onglets appartenant Ă cette identitĂ©. Les valeurs suivantes sont valides :</p> + - "blue" + - "turquoise" + - "green" + - "yellow" + - "orange" + - "red" + - "pink" + - "purple" + - "toolbar" - <ul> - <li>"fingerprint"</li> - <li>"briefcase"</li> - <li>"dollar"</li> - <li>"cart"</li> - <li>"circle"</li> - <li>"gift"</li> - <li>"vacation"</li> - <li>"food"</li> - <li>"fruit"</li> - <li>"pet"</li> - <li>"tree"</li> - <li>"chill"</li> - <li>"fence"</li> - </ul> - </dd> - <dt><code>iconUrl</code></dt> - <dd><code>string</code>. Une URL complĂšte resource:// pointant vers l'icĂŽne de l'identitĂ©. Par exemple : "resource://usercontext-content/fingerprint.svg".</dd> - <dt><code>name</code></dt> - <dd><code>string</code>. Nom de l'identitĂ©. Cela s'affichera dans la barre d'URL pour les onglets appartenant Ă cette identitĂ©. Notez que les noms ne doivent pas nĂ©cessairement ĂȘtre uniques .</dd> -</dl> + La valeur "toolbar" reprĂ©sente une couleur dĂ©pendant du thĂšme. Les identitĂ©s avec la couleur "toolbar" seront affichĂ©es dans la mĂȘme couleur que le texte de la barre d'outils (correspondant Ă la [clĂ© thĂšme](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/theme#colors) `"toolbar_field_text"`). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- `colorCode` + - : `string`. Un code hexadĂ©cimal reprĂ©sentant la couleur exacte utilisĂ©e pour l'identitĂ©. Par exemple : `"#37adff"`. Dans le cas particulier de la couleur "toolbar", `colorCode` est toujours `"#7c7c7d"`, quelle que soit la couleur affichĂ©e. +- `icon` -<p>{{Compat("webextensions.api.contextualIdentities.ContextualIdentity")}}</p> + - : `string`. Le nom d'une icĂŽne pour l'identitĂ©. Cela s'affichera dans la barre d'URL pour les onglets appartenant Ă cette identitĂ©. Les valeurs suivantes sont valides : + + - "fingerprint" + - "briefcase" + - "dollar" + - "cart" + - "circle" + - "gift" + - "vacation" + - "food" + - "fruit" + - "pet" + - "tree" + - "chill" + - "fence" + +- `iconUrl` + - : `string`. Une URL complĂšte resource:// pointant vers l'icĂŽne de l'identitĂ©. Par exemple : "resource://usercontext-content/fingerprint.svg". +- `name` + - : `string`. Nom de l'identitĂ©. Cela s'affichera dans la barre d'URL pour les onglets appartenant Ă cette identitĂ©. Notez que les noms ne doivent pas nĂ©cessairement ĂȘtre uniques . + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.contextualIdentities.ContextualIdentity")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/create/index.md b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/create/index.md index 26117936bb..9a6de4bf9c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/create/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/create/index.md @@ -12,84 +12,74 @@ tags: - contextualIdentities translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities/create --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>CrĂ©e une nouvelle identitĂ© contextuelle. Une fois crĂ©Ă©e, l'utilisateur pourra crĂ©er de nouveaux onglets appartenant Ă cette identitĂ© contextuelle, tout comme ils peuvent le faire avec les identitĂ©s intĂ©grĂ©es.</p> +CrĂ©e une nouvelle identitĂ© contextuelle. Une fois crĂ©Ă©e, l'utilisateur pourra crĂ©er de nouveaux onglets appartenant Ă cette identitĂ© contextuelle, tout comme ils peuvent le faire avec les identitĂ©s intĂ©grĂ©es. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 createContext = browser.contextualIdentities.create( +```js +var createContext = browser.contextualIdentities.create( details // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>details</code></dt> - <dd> - <p><code>object</code>. Un objet contenant des propriĂ©tĂ©s pour la nouvelle identitĂ© contextuelle. Cela contient les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>name</code></dt> - <dd> - <p><code>string</code>. Le nom de la nouvelle identitĂ©. Cela sera affichĂ© dans l'interface utilisateur du navigateur, leur permettant d'ouvrir un nouvel onglet appartenant Ă l'identitĂ©. Il sera Ă©galement affichĂ© dans la barre d'URL pour les onglets appartenant Ă cette identitĂ©.</p> - </dd> - <dt><code>color</code></dt> - <dd> - <p><code><code>string</code></code>. La couleur associĂ©e Ă la nouvelle identitĂ©. Cela sera utilisĂ© pour mettre en Ă©vidence les onglets appartenant Ă cette identitĂ©. Vous pouvez fournir l'une des valeurs suivantes ici :</p> - - <ul> - <li>"blue"</li> - <li>"turquoise"</li> - <li>"green"</li> - <li>"yellow"</li> - <li>"orange"</li> - <li>"red"</li> - <li>"pink"</li> - <li>"purple"</li> - <li>"toolbar"</li> - </ul> - </dd> - <dt><code>icon</code></dt> - <dd> - <p><code>string</code>. Le nom d'une icĂŽne Ă afficher dans la barre d'URL pour les onglets appartenant Ă cette identitĂ©. Vous pouvez fournir l'une des valeurs suivantes ici :</p> - - <ul> - <li>"fingerprint"</li> - <li>"briefcase"</li> - <li>"dollar"</li> - <li>"cart"</li> - <li>"circle"</li> - <li>"gift"</li> - <li>"vacation"</li> - <li>"food"</li> - <li>"fruit"</li> - <li>"pet"</li> - <li>"tree"</li> - <li>"chill"</li> - <li>"fence"</li> - </ul> - </dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un {{WebExtAPIRef('contextualIdentities.ContextualIdentity', 'ContextualIdentity')}} qui dĂ©crit la nouvelle identitĂ©. Si la fonctionnalitĂ© d'identitĂ©s contextuelles n'est pas activĂ©e, la promesse est rejetĂ©e.</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.contextualIdentities.create")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Cet exemple crĂ©e une nouvelle identitĂ© contextuelle et enregistre son ID de cookie :</p> - -<pre class="brush: js">function onCreated(context) { +``` + +### ParamĂštres + +- `details` + + - : `object`. Un objet contenant des propriĂ©tĂ©s pour la nouvelle identitĂ© contextuelle. Cela contient les propriĂ©tĂ©s suivantes : + + - `name` + - : `string`. Le nom de la nouvelle identitĂ©. Cela sera affichĂ© dans l'interface utilisateur du navigateur, leur permettant d'ouvrir un nouvel onglet appartenant Ă l'identitĂ©. Il sera Ă©galement affichĂ© dans la barre d'URL pour les onglets appartenant Ă cette identitĂ©. + - `color` + + - : `string`. La couleur associĂ©e Ă la nouvelle identitĂ©. Cela sera utilisĂ© pour mettre en Ă©vidence les onglets appartenant Ă cette identitĂ©. Vous pouvez fournir l'une des valeurs suivantes ici : + + - "blue" + - "turquoise" + - "green" + - "yellow" + - "orange" + - "red" + - "pink" + - "purple" + - "toolbar" + + - `icon` + + - : `string`. Le nom d'une icĂŽne Ă afficher dans la barre d'URL pour les onglets appartenant Ă cette identitĂ©. Vous pouvez fournir l'une des valeurs suivantes ici : + + - "fingerprint" + - "briefcase" + - "dollar" + - "cart" + - "circle" + - "gift" + - "vacation" + - "food" + - "fruit" + - "pet" + - "tree" + - "chill" + - "fence" + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un {{WebExtAPIRef('contextualIdentities.ContextualIdentity', 'ContextualIdentity')}} qui dĂ©crit la nouvelle identitĂ©. Si la fonctionnalitĂ© d'identitĂ©s contextuelles n'est pas activĂ©e, la promesse est rejetĂ©e. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.contextualIdentities.create")}} + +## Exemples + +Cet exemple crĂ©e une nouvelle identitĂ© contextuelle et enregistre son ID de cookie : + +```js +function onCreated(context) { console.log(`New identity's ID: ${context.cookieStoreId}.`); } @@ -101,6 +91,7 @@ browser.contextualIdentities.create({ name: "my-thing", color: "purple", icon: "briefcase" -}).then(onCreated, onError);</pre> +}).then(onCreated, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/get/index.md index acde9fb1e3..65a098bbbc 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/get/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/get/index.md @@ -12,41 +12,39 @@ tags: - get translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities/get --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient des informations sur une identitĂ© contextuelle, compte tenu de son ID de cookie.</p> +Obtient des informations sur une identitĂ© contextuelle, compte tenu de son ID de cookie. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 getContext = browser.contextualIdentities.get( +```js +var getContext = browser.contextualIdentities.get( cookieStoreId // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>cookieStoreId</code></dt> - <dd> - <p><code>string</code>. L'identifiant du cookie store de cette identitĂ© contextuelle. Ătant donnĂ© que les identitĂ©s contextuelles ont chacune leur propre magasin de cookies, cela sert d'identifiant pour l'identitĂ© contextuelle elle-mĂȘme.</p> - </dd> -</dl> +- `cookieStoreId` + - : `string`. L'identifiant du cookie store de cette identitĂ© contextuelle. Ătant donnĂ© que les identitĂ©s contextuelles ont chacune leur propre magasin de cookies, cela sert d'identifiant pour l'identitĂ© contextuelle elle-mĂȘme. -<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 {{WebExtAPIRef('contextualIdentities.ContextualIdentity', 'ContextualIdentity')}} qui dĂ©crit l'identitĂ©. Si l'identitĂ© n'a pas pu ĂȘtre trouvĂ©e ou si la fonctionnalitĂ© d'identitĂ©s contextuelles n'est pas activĂ©e, la promesse est rejetĂ©e.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un {{WebExtAPIRef('contextualIdentities.ContextualIdentity', 'ContextualIdentity')}} qui dĂ©crit l'identitĂ©. Si l'identitĂ© n'a pas pu ĂȘtre trouvĂ©e ou si la fonctionnalitĂ© d'identitĂ©s contextuelles n'est pas activĂ©e, la promesse est rejetĂ©e. -<h2 id="ComptatiblitĂ©_du_navigateur">ComptatiblitĂ© du navigateur</h2> +## ComptatiblitĂ© du navigateur -<p>{{Compat("webextensions.api.contextualIdentities.get")}}</p> +{{Compat("webextensions.api.contextualIdentities.get")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple tente de rĂ©cupĂ©rer l'identitĂ© contextuelle dont l'ID est "firefox-container-1":</p> +Cet exemple tente de rĂ©cupĂ©rer l'identitĂ© contextuelle dont l'ID est "firefox-container-1": -<pre class="brush: js">function onGot(context) { +```js +function onGot(context) { if (!context) { console.error("Context not found"); } else { @@ -58,6 +56,7 @@ function onError(e) { console.error(e); } -browser.contextualIdentities.get("firefox-container-1").then(onGot, onError);</pre> +browser.contextualIdentities.get("firefox-container-1").then(onGot, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/index.md b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/index.md index 670989656d..3c544d59b2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/index.md @@ -5,60 +5,55 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Travailler avec des identitĂ©s contextuelles : lister, crĂ©er, supprimer et mettre Ă jour des identitĂ©s contextuelles.</p> +Travailler avec des identitĂ©s contextuelles : lister, crĂ©er, supprimer et mettre Ă jour des identitĂ©s contextuelles. -<p>Les «âŻidentitĂ©s contextuelles », Ă©galement appelĂ©es « conteneurs », sont des fonctions de navigation qui rĂ©pondent Ă lâidĂ©e que les utilisateurs assument plusieurs identitĂ©s lorsquâils naviguent sur le web, et souhaitent maintenir une certaine sĂ©paration entre ces identitĂ©s. Par exemple, un utilisateur peut considĂ©rer que son « identitĂ© de travailâŻÂ» est distincte de son «âŻidentitĂ© personnelleâŻÂ» et ne veut pas partager les cookies entre ces deux contextes.</p> +Les «âŻidentitĂ©s contextuelles », Ă©galement appelĂ©es « conteneurs », sont des fonctions de navigation qui rĂ©pondent Ă lâidĂ©e que les utilisateurs assument plusieurs identitĂ©s lorsquâils naviguent sur le web, et souhaitent maintenir une certaine sĂ©paration entre ces identitĂ©s. Par exemple, un utilisateur peut considĂ©rer que son « identitĂ© de travailâŻÂ» est distincte de son «âŻidentitĂ© personnelleâŻÂ» et ne veut pas partager les cookies entre ces deux contextes. -<p>Avec la fonctionnalitĂ© dâidentitĂ©s contextuelles, chaque identitĂ© contextuelle a un nom, une couleur et une icĂŽne. De nouveaux onglets peuvent ĂȘtre assignĂ©s Ă une identitĂ© et le nom, lâicĂŽne et la couleur apparaĂźtront dans la barre dâadresse. En interne, chaque identitĂ© possĂšde son propre magasin de cookies qui nâest pas partagĂ© avec dâautres ongletsâŠ</p> +Avec la fonctionnalitĂ© dâidentitĂ©s contextuelles, chaque identitĂ© contextuelle a un nom, une couleur et une icĂŽne. De nouveaux onglets peuvent ĂȘtre assignĂ©s Ă une identitĂ© et le nom, lâicĂŽne et la couleur apparaĂźtront dans la barre dâadresse. En interne, chaque identitĂ© possĂšde son propre magasin de cookies qui nâest pas partagĂ© avec dâautres onglets⊠-<p><img alt="" src="containers.png">Les identitĂ©s contextuelles sont une fonctionnalitĂ© expĂ©rimentale de Firefox et ne sont activĂ©es par dĂ©faut dans Firefox Nightly. Pour activer dans dâautres versions de Firefox, dĂ©finissez la prĂ©fĂ©rence <code>privacy.userContext.enabled</code> sur <code>true</code>. Notez que bien que les identitĂ©s contextuelles soient disponibles dans Firefox pour Android, il n'y a pas dâinterface utilisateur pour travailler avec eux dans cette version pour travailler avec eux dans cette versiondu navigateur.</p> +![](containers.png)Les identitĂ©s contextuelles sont une fonctionnalitĂ© expĂ©rimentale de Firefox et ne sont activĂ©es par dĂ©faut dans Firefox Nightly. Pour activer dans dâautres versions de Firefox, dĂ©finissez la prĂ©fĂ©rence `privacy.userContext.enabled` sur `true`. Notez que bien que les identitĂ©s contextuelles soient disponibles dans Firefox pour Android, il n'y a pas dâinterface utilisateur pour travailler avec eux dans cette version pour travailler avec eux dans cette versiondu navigateur. -<p>Avant Firefox 57, lâAPI <code>contextualIdentities</code> nâĂ©tait disponible que si la fonctionnalitĂ© dâidentitĂ©s contextuelles Ă©tait activĂ©e. Si une extension essayait dâutiliser lâAPI <code>contextualIdentities</code> sans activer la fonctionnalitĂ©, les appels de mĂ©thode rĂ©solvaient leurs promesses avec <code>false</code>.</p> +Avant Firefox 57, lâAPI `contextualIdentities` nâĂ©tait disponible que si la fonctionnalitĂ© dâidentitĂ©s contextuelles Ă©tait activĂ©e. Si une extension essayait dâutiliser lâAPI `contextualIdentities` sans activer la fonctionnalitĂ©, les appels de mĂ©thode rĂ©solvaient leurs promesses avec `false`. -<p>Ă partir de Firefox 57, si une extension utilisant lâAPI <code>contextualIdentities</code> est installĂ©e, la fonctionnalitĂ© dâidentitĂ©s contextuelles est automatiquement activĂ©e. Notez cependant quâil est toujours possible pour lâutilisateur de dĂ©sactiver la fonctionnalitĂ© en utilisant la prĂ©fĂ©rence «âŻprivacy.userContext.enabledâŻÂ». Si cela se produit, les appels de mĂ©thode <code>contextualIdentities</code> rejetteront leurs promesses avec un message dâerreur.</p> +Ă partir de Firefox 57, si une extension utilisant lâAPI `contextualIdentities` est installĂ©e, la fonctionnalitĂ© dâidentitĂ©s contextuelles est automatiquement activĂ©e. Notez cependant quâil est toujours possible pour lâutilisateur de dĂ©sactiver la fonctionnalitĂ© en utilisant la prĂ©fĂ©rence «âŻprivacy.userContext.enabledâŻÂ». Si cela se produit, les appels de mĂ©thode `contextualIdentities` rejetteront leurs promesses avec un message dâerreur. -<p>Pour plus dâinformations sur les identitĂ©s contextuelles, consultez <a href="https://wiki.mozilla.org/Security/Contextual_Identity_Project/Containers">ce guide</a>.</p> +Pour plus dâinformations sur les identitĂ©s contextuelles, consultez [ce guide](https://wiki.mozilla.org/Security/Contextual_Identity_Project/Containers). -<p>Les identitĂ©s contextuelles ne sont actuellement pas supportes dans les autres navigateurs.</p> +Les identitĂ©s contextuelles ne sont actuellement pas supportes dans les autres navigateurs. -<p>Pour utiliser cette API, vous devez inclure la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> « contextualIdentities » dans votre fichier <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json">manifest.json</a>.</p> +Pour utiliser cette API, vous devez inclure la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) « contextualIdentities » dans votre fichier [manifest.json](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json). -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("contextualIdentities.ContextualIdentity")}}</dt> - <dd>Contient des informations sur une identitĂ© contextuelle.</dd> -</dl> +- {{WebExtAPIRef("contextualIdentities.ContextualIdentity")}} + - : Contient des informations sur une identitĂ© contextuelle. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("contextualIdentities.create()")}}</dt> - <dd>CrĂ©e une nouvelle identitĂ© contextuelle.</dd> - <dt>{{WebExtAPIRef("contextualIdentities.get()")}}</dt> - <dd>RĂ©cupĂšre une identitĂ© contextuelle unique, compte tenu de son ID de cookie.</dd> - <dt>{{WebExtAPIRef("contextualIdentities.query()")}}</dt> - <dd>RĂ©cupĂšre toutes les identitĂ©s contextuelles ou toutes les identitĂ©s contextuelles avec un nom particulier.</dd> - <dt>{{WebExtAPIRef("contextualIdentities.update()")}}</dt> - <dd>Met Ă jour les propriĂ©tĂ©s dâune identitĂ© contextuelle existante.</dd> - <dt>{{WebExtAPIRef("contextualIdentities.remove()")}}</dt> - <dd>Supprime une identitĂ© contextuelle.</dd> -</dl> +- {{WebExtAPIRef("contextualIdentities.create()")}} + - : CrĂ©e une nouvelle identitĂ© contextuelle. +- {{WebExtAPIRef("contextualIdentities.get()")}} + - : RĂ©cupĂšre une identitĂ© contextuelle unique, compte tenu de son ID de cookie. +- {{WebExtAPIRef("contextualIdentities.query()")}} + - : RĂ©cupĂšre toutes les identitĂ©s contextuelles ou toutes les identitĂ©s contextuelles avec un nom particulier. +- {{WebExtAPIRef("contextualIdentities.update()")}} + - : Met Ă jour les propriĂ©tĂ©s dâune identitĂ© contextuelle existante. +- {{WebExtAPIRef("contextualIdentities.remove()")}} + - : Supprime une identitĂ© contextuelle. -<h2 id="ĂvĂ©nements">ĂvĂ©nements</h2> -<dl> - <dt>{{WebExtAPIRef("contextualIdentities.onCreated")}}</dt> - <dd>LancĂ© lorsquâune identitĂ© contextuelle est crĂ©Ă©e</dd> - <dt>{{WebExtAPIRef("contextualIdentities.onRemoved")}}</dt> - <dd>LancĂ© lorsquâune identitĂ© contextuelle est supprimĂ©e</dd> - <dt>{{WebExtAPIRef("contextualIdentities.onUpdated")}}</dt> - <dd>LancĂ© lorsquâune ou plusieurs propriĂ©tĂ©s dâune identitĂ© contextuelle sont mises Ă jour</dd> -</dl> +## ĂvĂ©nements -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- {{WebExtAPIRef("contextualIdentities.onCreated")}} + - : LancĂ© lorsquâune identitĂ© contextuelle est crĂ©Ă©e +- {{WebExtAPIRef("contextualIdentities.onRemoved")}} + - : LancĂ© lorsquâune identitĂ© contextuelle est supprimĂ©e +- {{WebExtAPIRef("contextualIdentities.onUpdated")}} + - : LancĂ© lorsquâune ou plusieurs propriĂ©tĂ©s dâune identitĂ© contextuelle sont mises Ă jour -<p>{{Compat("webextensions.api.contextualIdentities")}}</p> +## CompatibilitĂ© du navigateur -<p>{{WebExtExamples("h2")}}</p> +{{Compat("webextensions.api.contextualIdentities")}} + +{{WebExtExamples("h2")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/oncreated/index.md b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/oncreated/index.md index e86795832a..abdfb58477 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/oncreated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/oncreated/index.md @@ -12,60 +12,55 @@ tags: - onCreated translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities/onCreated --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'une nouvelle identitĂ© contextuelle est crĂ©Ă©e. Les identitĂ©s contextuelles peuvent ĂȘtre crĂ©Ă©es par des extensions en utilisant l'API <code>contextualIdentities</code>, ou directement par l'utilisateur, en utilisant l'interface utilisateur du navigateur.</p> +LancĂ© lorsqu'une nouvelle identitĂ© contextuelle est crĂ©Ă©e. Les identitĂ©s contextuelles peuvent ĂȘtre crĂ©Ă©es par des extensions en utilisant l'API `contextualIdentities`, ou directement par l'utilisateur, en utilisant l'interface utilisateur du navigateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.contextualIdentities.onCreated.addListener(listener) +```js +browser.contextualIdentities.onCreated.addListener(listener) browser.contextualIdentities.onCreated.removeListener(listener) browser.contextualIdentities.onCreated.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>changeInfo</code></dt> - <dd><code>object</code>. Un objet contenant une seule propriĂ©tĂ©, <code>contextualIdentity</code>, qui est un objet {{WebExtAPIRef("contextualIdentities.ContextualIdentity")}} reprĂ©sentant l'identitĂ© crĂ©Ă©e.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `changeInfo` + - : `object`. Un objet contenant une seule propriĂ©tĂ©, `contextualIdentity`, qui est un objet {{WebExtAPIRef("contextualIdentities.ContextualIdentity")}} reprĂ©sentant l'identitĂ© crĂ©Ă©e. -<p>{{Compat("webextensions.api.contextualIdentities.onCreated")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Examples">Examples</h2> +{{Compat("webextensions.api.contextualIdentities.onCreated")}} -<pre class="brush: js">function handleCreated(changeInfo) { +## Examples + +```js +function handleCreated(changeInfo) { console.log(`Created: ${changeInfo.contextualIdentity.name}`); } -browser.contextualIdentities.onCreated.addListener(handleCreated);</pre> +browser.contextualIdentities.onCreated.addListener(handleCreated); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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 +87,4 @@ browser.contextualIdentities.onCreated.addListener(handleCreated);</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/contextualidentities/onremoved/index.md b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/onremoved/index.md index 71c04a6307..812cfe9f3a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/onremoved/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/onremoved/index.md @@ -12,60 +12,55 @@ tags: - onRemoved translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities/onRemoved --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'une nouvelle identitĂ© contextuelle est supprimĂ©e. Les identitĂ©s contextuelles peuvent ĂȘtre supprimĂ©es par des extensions en utilisant l'API <code>contextualIdentities</code>, ou directement par l'utilisateur, en utilisant l'interface utilisateur du navigateur.</p> +LancĂ© lorsqu'une nouvelle identitĂ© contextuelle est supprimĂ©e. Les identitĂ©s contextuelles peuvent ĂȘtre supprimĂ©es par des extensions en utilisant l'API `contextualIdentities`, ou directement par l'utilisateur, en utilisant l'interface utilisateur du navigateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.contextualIdentities.onRemoved.addListener(listener) +```js +browser.contextualIdentities.onRemoved.addListener(listener) browser.contextualIdentities.onRemoved.removeListener(listener) browser.contextualIdentities.onRemoved.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>changeInfo</code></dt> - <dd><code>object</code>. Un objet qui contient une seule propriĂ©tĂ©, <code>contextualIdentity</code>, qui est un objet {{WebExtAPIRef("contextualIdentities.ContextualIdentity")}} reprĂ©sentant l'identitĂ© qui a Ă©tĂ© supprimĂ©e.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `changeInfo` + - : `object`. Un objet qui contient une seule propriĂ©tĂ©, `contextualIdentity`, qui est un objet {{WebExtAPIRef("contextualIdentities.ContextualIdentity")}} reprĂ©sentant l'identitĂ© qui a Ă©tĂ© supprimĂ©e. -<p>{{Compat("webextensions.api.contextualIdentities.onRemoved")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.contextualIdentities.onRemoved")}} -<pre class="brush: js">function handleRemoved(changeInfo) { +## Exemples + +```js +function handleRemoved(changeInfo) { console.log(`Removed: ${changeInfo.contextualIdentity.name}`); } -browser.contextualIdentities.onRemoved.addListener(handleRemoved);</pre> +browser.contextualIdentities.onRemoved.addListener(handleRemoved); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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 +87,4 @@ browser.contextualIdentities.onRemoved.addListener(handleRemoved);</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/contextualidentities/onupdated/index.md b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/onupdated/index.md index b209dd3f9e..11f98528fb 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/onupdated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/onupdated/index.md @@ -12,60 +12,55 @@ tags: - onUpdated translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities/onUpdated --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque les propriĂ©tĂ©s d'une identitĂ© contextuelle, telles que son nom, son icĂŽne ou sa couleur, sont modifiĂ©es. Les identitĂ©s contextuelles peuvent ĂȘtre mises Ă jour par des extensions en utilisant l'API <code>contextualIdentities</code> , ou directement par l'utilisateur, en utilisant l'interface utilisateur du navigateur.</p> +LancĂ© lorsque les propriĂ©tĂ©s d'une identitĂ© contextuelle, telles que son nom, son icĂŽne ou sa couleur, sont modifiĂ©es. Les identitĂ©s contextuelles peuvent ĂȘtre mises Ă jour par des extensions en utilisant l'API `contextualIdentities` , ou directement par l'utilisateur, en utilisant l'interface utilisateur du navigateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.contextualIdentities.onUpdated.addListener(listener) +```js +browser.contextualIdentities.onUpdated.addListener(listener) browser.contextualIdentities.onUpdated.removeListener(listener) browser.contextualIdentities.onUpdated.hasListener(listener) -</pre> +``` -<p>Events have three functions:</p> +Events have three functions: -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si le <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code>s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si le `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true`s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>changeInfo</code></dt> - <dd><code>object</code>. Un objet qui contient une seule propriĂ©tĂ©, <code>contextualIdentity</code>, qui est un objet {{WebExtAPIRef("contextualIdentities.ContextualIdentity")}} reprĂ©sentant l'identitĂ© dont les propriĂ©tĂ©s ont Ă©tĂ© mises Ă jour.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `changeInfo` + - : `object`. Un objet qui contient une seule propriĂ©tĂ©, `contextualIdentity`, qui est un objet {{WebExtAPIRef("contextualIdentities.ContextualIdentity")}} reprĂ©sentant l'identitĂ© dont les propriĂ©tĂ©s ont Ă©tĂ© mises Ă jour. -<p>{{Compat("webextensions.api.contextualIdentities.onUpdated")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.contextualIdentities.onUpdated")}} -<pre class="brush: js">function handleUpdated(changeInfo) { +## Exemples + +```js +function handleUpdated(changeInfo) { console.log(`Updated: ${changeInfo.contextualIdentity.name}`); } -browser.contextualIdentities.onUpdated.addListener(handleUpdated);</pre> +browser.contextualIdentities.onUpdated.addListener(handleUpdated); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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 +87,4 @@ browser.contextualIdentities.onUpdated.addListener(handleUpdated);</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/contextualidentities/query/index.md b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/query/index.md index 510e9fa614..6589df93ab 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/query/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/query/index.md @@ -12,46 +12,43 @@ tags: - query translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities/query --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient des informations sur toutes les identitĂ©s contextuelles ou sur les identitĂ©s contextuelles correspondant Ă un argument de filtre donnĂ©.</p> +Obtient des informations sur toutes les identitĂ©s contextuelles ou sur les identitĂ©s contextuelles correspondant Ă un argument de filtre donnĂ©. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 getContext = browser.contextualIdentities.query( +```js +var getContext = browser.contextualIdentities.query( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd> - <p><code>object</code>. Un objet qui peut ĂȘtre utilisĂ© pour filtrer les identitĂ©s contextuelles renvoyĂ©es. Cela peut contenir l'une des propriĂ©tĂ©s suivantes :</p> +- `details` - <dl> - <dt><code>name</code> {{optional_inline}}</dt> - <dd><code>string</code>. Renvoie uniquement les identitĂ©s contextuelles avec ce nom.</dd> - </dl> - </dd> -</dl> + - : `object`. Un objet qui peut ĂȘtre utilisĂ© pour filtrer les identitĂ©s contextuelles renvoyĂ©es. Cela peut contenir l'une des propriĂ©tĂ©s suivantes : -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - `name` {{optional_inline}} + - : `string`. Renvoie uniquement les identitĂ©s contextuelles avec ce nom. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un tableau d'objets {{WebExtAPIRef('contextualIdentities.ContextualIdentity', 'ContextualIdentity')}} chacun dĂ©crivant une seule identitĂ©. Si la fonctionnalitĂ© d'identitĂ©s contextuelles n'est pas activĂ©e, la promesse est rejetĂ©e.</p> +### Valeur retournĂ©e -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un tableau d'objets {{WebExtAPIRef('contextualIdentities.ContextualIdentity', 'ContextualIdentity')}} chacun dĂ©crivant une seule identitĂ©. Si la fonctionnalitĂ© d'identitĂ©s contextuelles n'est pas activĂ©e, la promesse est rejetĂ©e. -<p>{{Compat("webextensions.api.contextualIdentities.query")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.contextualIdentities.query")}} -<p>Retrieve all contextual identities, and log their names :</p> +## Exemples -<pre class="brush: js">function onGot(contexts) { +Retrieve all contextual identities, and log their names : + +```js +function onGot(contexts) { for (let context of contexts) { console.log(`Name: ${context.name}`); } @@ -61,11 +58,13 @@ function onError(e) { console.error(e); } -browser.contextualIdentities.query({}).then(onGot, onError);</pre> +browser.contextualIdentities.query({}).then(onGot, onError); +``` -<p>RĂ©cupĂ©rez toutes les identitĂ©s contextuelles dont les noms sont "my-thing", et consignez leurs noms :</p> +RĂ©cupĂ©rez toutes les identitĂ©s contextuelles dont les noms sont "my-thing", et consignez leurs noms : -<pre class="brush: js">function onGot(contexts) { +```js +function onGot(contexts) { for (let context of contexts) { console.log(`Name: ${context.name}`); } @@ -78,6 +77,6 @@ function onError(e) { browser.contextualIdentities.query({ name: "my-thing" }).then(onGot, onError); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/remove/index.md b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/remove/index.md index 23ffcfbce8..237b320f46 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/remove/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/remove/index.md @@ -13,41 +13,39 @@ tags: - supprimer translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities/remove --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime une identitĂ© contextuelle, compte tenu de son ID de cookie.</p> +Supprime une identitĂ© contextuelle, compte tenu de son ID de cookie. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removeContext = browser.contextualIdentities.remove( +```js +var removeContext = browser.contextualIdentities.remove( cookieStoreId // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>cookieStoreId</code></dt> - <dd> - <p><code>string</code>. L'identifiant du cookie store de l'identitĂ© contextuelle. Ătant donnĂ© que les identitĂ©s contextuelles ont chacune leur propre magasin de cookies, cela sert d'identifiant pour l'identitĂ© contextuelle elle-mĂȘme.</p> - </dd> -</dl> +- `cookieStoreId` + - : `string`. L'identifiant du cookie store de l'identitĂ© contextuelle. Ătant donnĂ© que les identitĂ©s contextuelles ont chacune leur propre magasin de cookies, cela sert d'identifiant pour l'identitĂ© contextuelle elle-mĂȘme. -<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 {{WebExtAPIRef('contextualIdentities.ContextualIdentity', 'ContextualIdentity')}} dĂ©crivant l'identitĂ© qui a Ă©tĂ© supprimĂ©e. Si l'identitĂ© n'a pas pu ĂȘtre trouvĂ©e ou si la fonctionnalitĂ© d'identitĂ©s contextuelles n'est pas activĂ©e, la promesse est rejetĂ©e.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un {{WebExtAPIRef('contextualIdentities.ContextualIdentity', 'ContextualIdentity')}} dĂ©crivant l'identitĂ© qui a Ă©tĂ© supprimĂ©e. Si l'identitĂ© n'a pas pu ĂȘtre trouvĂ©e ou si la fonctionnalitĂ© d'identitĂ©s contextuelles n'est pas activĂ©e, la promesse est rejetĂ©e. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.contextualIdentities.remove")}}</p> +{{Compat("webextensions.api.contextualIdentities.remove")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple tente de supprimer l'identitĂ© contextuelle dont l'ID est "firefox-container-1" :</p> +Cet exemple tente de supprimer l'identitĂ© contextuelle dont l'ID est "firefox-container-1" : -<pre class="brush: js">function onRemoved(context) { +```js +function onRemoved(context) { if (!context) { console.error("Context not found"); } else { @@ -60,6 +58,7 @@ function onError(e) { } browser.contextualIdentities.remove("firefox-container-1"). - then(onRemoved, onError);</pre> + then(onRemoved, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/update/index.md b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/update/index.md index c9a6568712..19252e84f6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/update/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/update/index.md @@ -12,89 +12,77 @@ tags: - contextualIdentities translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities/update --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Met Ă jour les propriĂ©tĂ©s d'une identitĂ© contextuelle, compte tenu de son ID de cookie.</p> +Met Ă jour les propriĂ©tĂ©s d'une identitĂ© contextuelle, compte tenu de son ID de cookie. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 createContext = browser.contextualIdentities.update( +```js +var createContext = browser.contextualIdentities.update( cookieStoreId, // string details // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>cookieStoreId</code></dt> - <dd> - <p><code>string</code>. L'identifiant du cookie store de cette identitĂ© contextuelle. Ătant donnĂ© que les identitĂ©s contextuelles ont chacune leur propre magasin de cookies, cela sert d'identifiant pour l'identitĂ© contextuelle elle-mĂȘme.</p> - </dd> - <dt><code>details</code></dt> - <dd> - <p><code>object</code>. Un objet contenant de nouvelles valeurs pour les propriĂ©tĂ©s que vous souhaitez modifier. Cela peut contenir l'une des propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>name</code> {{optional_inline}}</dt> - <dd> - <p><code>string</code>. Un nouveau nom pour l'identitĂ©. Cela sera affichĂ© dans l'interface utilisateur du navigateur, leur permettant d'ouvrir un nouvel onglet dans l'identitĂ©. Il sera Ă©galement affichĂ© dans la barre d'URL pour les onglets appartenant Ă cette identitĂ©.</p> - </dd> - <dt><code>color</code> {{optional_inline}}</dt> - <dd> - <p><code><code>string</code></code>. Une nouvelle couleur pour l'identitĂ©. Cela sera utilisĂ© pour mettre en Ă©vidence les onglets appartenant Ă cette identitĂ©. Vous pouvez fournir l'une des valeurs suivantes ici :</p> - - <ul> - <li>"blue"</li> - <li>"turquoise"</li> - <li>"green"</li> - <li>"yellow"</li> - <li>"orange"</li> - <li>"red"</li> - <li>"pink"</li> - <li>"purple"</li> - <li>"toolbar"</li> - </ul> - </dd> - <dt><code>icon</code> {{optional_inline}}</dt> - <dd> - <p><code>string</code>. Une nouvelle icĂŽne pour l'identitĂ©. Vous pouvez fournir l'une des valeurs suivantes ici :</p> - - <ul> - <li>"fingerprint"</li> - <li>"briefcase"</li> - <li>"dollar"</li> - <li>"cart"</li> - <li>"circle"</li> - <li>"gift"</li> - <li>"vacation"</li> - <li>"food"</li> - <li>"fruit"</li> - <li>"pet"</li> - <li>"tree"</li> - <li>"chill"</li> - <li>"fence"</li> - </ul> - </dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un {{WebExtAPIRef('contextualIdentities.ContextualIdentity', 'ContextualIdentity')}} qui dĂ©crit l'identitĂ© mise Ă jour. Si l'identitĂ© n'a pas pu ĂȘtre trouvĂ©e ou si la fonctionnalitĂ© d'identitĂ©s contextuelles n'est pas activĂ©e, la promesse est rejetĂ©e.</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.contextualIdentities.update")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Cet exemple met Ă jour l'identitĂ© contextuelle dont l'ID est "firefox-container-1" pour avoir un nouveau nom, une nouvelle couleur et une nouvelle icĂŽne :</p> - -<pre class="brush: js">function onUpdated(context) { +``` + +### ParamĂštres + +- `cookieStoreId` + - : `string`. L'identifiant du cookie store de cette identitĂ© contextuelle. Ătant donnĂ© que les identitĂ©s contextuelles ont chacune leur propre magasin de cookies, cela sert d'identifiant pour l'identitĂ© contextuelle elle-mĂȘme. +- `details` + + - : `object`. Un objet contenant de nouvelles valeurs pour les propriĂ©tĂ©s que vous souhaitez modifier. Cela peut contenir l'une des propriĂ©tĂ©s suivantes : + + - `name` {{optional_inline}} + - : `string`. Un nouveau nom pour l'identitĂ©. Cela sera affichĂ© dans l'interface utilisateur du navigateur, leur permettant d'ouvrir un nouvel onglet dans l'identitĂ©. Il sera Ă©galement affichĂ© dans la barre d'URL pour les onglets appartenant Ă cette identitĂ©. + - `color` {{optional_inline}} + + - : `string`. Une nouvelle couleur pour l'identitĂ©. Cela sera utilisĂ© pour mettre en Ă©vidence les onglets appartenant Ă cette identitĂ©. Vous pouvez fournir l'une des valeurs suivantes ici : + + - "blue" + - "turquoise" + - "green" + - "yellow" + - "orange" + - "red" + - "pink" + - "purple" + - "toolbar" + + - `icon` {{optional_inline}} + + - : `string`. Une nouvelle icĂŽne pour l'identitĂ©. Vous pouvez fournir l'une des valeurs suivantes ici : + + - "fingerprint" + - "briefcase" + - "dollar" + - "cart" + - "circle" + - "gift" + - "vacation" + - "food" + - "fruit" + - "pet" + - "tree" + - "chill" + - "fence" + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un {{WebExtAPIRef('contextualIdentities.ContextualIdentity', 'ContextualIdentity')}} qui dĂ©crit l'identitĂ© mise Ă jour. Si l'identitĂ© n'a pas pu ĂȘtre trouvĂ©e ou si la fonctionnalitĂ© d'identitĂ©s contextuelles n'est pas activĂ©e, la promesse est rejetĂ©e. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.contextualIdentities.update")}} + +## Exemples + +Cet exemple met Ă jour l'identitĂ© contextuelle dont l'ID est "firefox-container-1" pour avoir un nouveau nom, une nouvelle couleur et une nouvelle icĂŽne : + +```js +function onUpdated(context) { console.log(`New identity's name: ${context.name}.`); } @@ -107,6 +95,7 @@ browser.contextualIdentities.update( name: "my-thing", color: "purple", icon: "briefcase" - }).then(onUpdated, onError);</pre> + }).then(onUpdated, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/cookies/cookie/index.md b/files/fr/mozilla/add-ons/webextensions/api/cookies/cookie/index.md index a0c5e31518..9fb9da9555 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/cookies/cookie/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/cookies/cookie/index.md @@ -13,52 +13,51 @@ tags: - cookie translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/Cookie --- -<div>{{AddonSidebar()}}</div> - -<p>Le type <code>Cookie</code> de l'API {{WebExtAPIRef("cookies")}} reprĂ©sente des informations sur un cookie HTTP.</p> - -<h2 id="Type">Type</h2> - -<p>Les valeurs de ce type sont des objets, qui peuvent contenir les propriĂ©tĂ©s suivantes :</p> - -<dl> - <dt><code>domain</code></dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le domaine auquel appartient le cookie (par exemple "www.google.com", "example.com").</dd> - <dt><code>expirationDate</code>{{optional_inline}}</dt> - <dd>Un <code>number</code> reprĂ©sentant la date d'expiration du cookie en tant que nombre de secondes depuis l'Ă©poque UNIX. Non fourni pour les cookies de session.</dd> - <dt><code>firstPartyDomain</code></dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le domaine de la premiĂšre partie associĂ© au cookie. Cela sera une chaine vide si le cookie a Ă©tĂ© dĂ©fini alors que l'isolation de la premiĂšre partie est dĂ©sactivĂ©e. Voir <a href="/fr/Add-ons/WebExtensions/API/cookies#Isolement_de_la_premiĂšre_partie">Isolement de la premiĂšre partie</a>.</dd> - <dt><code>hostOnly</code></dt> - <dd>Un <code>boolĂ©en</code>, <code>true</code> si le cookie est un cookie hĂŽte uniquement (c'est Ă dire que l'hĂŽte de la requĂȘte doit correspondre exactement au domaine du cookie), ou <code>false</code> dans la case contraire.</dd> - <dt><code>httpOnly</code></dt> - <dd>Un <code>boolĂ©en</code>, <code>true</code> si le cookie est marquĂ© comme HttpOnly (c'est Ă dire le cookie est inaccessible aux scripts cĂŽtĂ© client), ou <code>false</code> dans le cas contraire.</dd> - <dt><code>name</code></dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le nom du cookie.</dd> - <dt><code>path</code></dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le chemin du cookie.</dd> - <dt><code>secure</code></dt> - <dd>Un <code>boolĂ©en</code>, true si le cookie est marquĂ© comme sĂ©curisĂ© (c'est Ă dire que si sa portĂ©e est limitĂ©e aux canaux sĂ©curisĂ©s, gĂ©nĂ©ralement HTTPS), ou <code>false</code> dans le cas contraire.</dd> - <dt><code>session</code></dt> - <dd>Un <code>boolean</code>, <code>true</code> si le cookie est un cookie de session, ou <code>false</code> s'il s'agit d'un cookie persistant avec une date expiration.</dd> - <dt><code>sameSite</code></dt> - <dd>Une valeur {{WebExtAPIRef("cookies.SameSiteStatus")}} qui indique l'Ă©tat SameSite du cookie.</dd> - <dt><code>storeId</code></dt> - <dd>Une <code>chaine</code> reprĂ©sentant l'ID du cookie store contenant ce cookie, tel que fourni par {{WebExtAPIRef("cookies.getAllCookieStores()")}}.</dd> - <dt><code>value</code></dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant la valeur du cookie.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.cookies.Cookie")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>La plupart des mĂ©thodes de l'API cookies impliquent qu'un objet <code>Cookie</code>   soit utilisĂ© en tant que paramĂštre d'entrĂ©e ou en tant que partie de la valeur retournĂ©e. Par exemple, un appel Ă {{WebExtAPIRef("cookies.getAll()")}} retourne un tableau d'objets <code>Cookie</code>.</p> - -<p>Dans l'exemple ci-dessous, nous avons demandĂ© tous les cookies, puis enregistrĂ© quelque-unes des valeurs de chacun des objets <code>Cookie</code> :</p> - -<pre class="brush: js">function logCookies(cookies) { +{{AddonSidebar()}} + +Le type `Cookie` de l'API {{WebExtAPIRef("cookies")}} reprĂ©sente des informations sur un cookie HTTP. + +## Type + +Les valeurs de ce type sont des objets, qui peuvent contenir les propriĂ©tĂ©s suivantes : + +- `domain` + - : Une `chaĂźne` reprĂ©sentant le domaine auquel appartient le cookie (par exemple "www\.google.com", "example.com"). +- `expirationDate`{{optional_inline}} + - : Un `number` reprĂ©sentant la date d'expiration du cookie en tant que nombre de secondes depuis l'Ă©poque UNIX. Non fourni pour les cookies de session. +- `firstPartyDomain` + - : Une `chaĂźne` reprĂ©sentant le domaine de la premiĂšre partie associĂ© au cookie. Cela sera une chaine vide si le cookie a Ă©tĂ© dĂ©fini alors que l'isolation de la premiĂšre partie est dĂ©sactivĂ©e. Voir [Isolement de la premiĂšre partie](/fr/Add-ons/WebExtensions/API/cookies#Isolement_de_la_premiĂšre_partie). +- `hostOnly` + - : Un `boolĂ©en`, `true` si le cookie est un cookie hĂŽte uniquement (c'est Ă dire que l'hĂŽte de la requĂȘte doit correspondre exactement au domaine du cookie), ou `false` dans la case contraire. +- `httpOnly` + - : Un `boolĂ©en`, `true` si le cookie est marquĂ© comme HttpOnly (c'est Ă dire le cookie est inaccessible aux scripts cĂŽtĂ© client), ou `false` dans le cas contraire. +- `name` + - : Une `chaĂźne` reprĂ©sentant le nom du cookie. +- `path` + - : Une `chaĂźne` reprĂ©sentant le chemin du cookie. +- `secure` + - : Un `boolĂ©en`, true si le cookie est marquĂ© comme sĂ©curisĂ© (c'est Ă dire que si sa portĂ©e est limitĂ©e aux canaux sĂ©curisĂ©s, gĂ©nĂ©ralement HTTPS), ou `false` dans le cas contraire. +- `session` + - : Un `boolean`, `true` si le cookie est un cookie de session, ou `false` s'il s'agit d'un cookie persistant avec une date expiration. +- `sameSite` + - : Une valeur {{WebExtAPIRef("cookies.SameSiteStatus")}} qui indique l'Ă©tat SameSite du cookie. +- `storeId` + - : Une `chaine` reprĂ©sentant l'ID du cookie store contenant ce cookie, tel que fourni par {{WebExtAPIRef("cookies.getAllCookieStores()")}}. +- `value` + - : Une `chaĂźne` reprĂ©sentant la valeur du cookie. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.cookies.Cookie")}} + +## Exemples + +La plupart des mĂ©thodes de l'API cookies impliquent qu'un objet `Cookie`   soit utilisĂ© en tant que paramĂštre d'entrĂ©e ou en tant que partie de la valeur retournĂ©e. Par exemple, un appel Ă {{WebExtAPIRef("cookies.getAll()")}} retourne un tableau d'objets `Cookie`. + +Dans l'exemple ci-dessous, nous avons demandĂ© tous les cookies, puis enregistrĂ© quelque-unes des valeurs de chacun des objets `Cookie` : + +```js +function logCookies(cookies) { for (cookie of cookies) { console.log(`Domain: ${cookie.domain}`); console.log(`Name: ${cookie.name}`); @@ -68,19 +67,18 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/Cookie } var gettingAll = browser.cookies.getAll({}); -gettingAll.then(logCookies);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +gettingAll.then(logCookies); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/cookies"><code>chrome.cookies</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json"><code>cookies.json</code></a> dans le code Chromium.</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.cookies`](https://developer.chrome.com/extensions/cookies). Cette documentation est dĂ©rivĂ©e de [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -107,5 +105,4 @@ gettingAll.then(logCookies);</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/cookies/cookiestore/index.md b/files/fr/mozilla/add-ons/webextensions/api/cookies/cookiestore/index.md index f861ee501f..6376eab75c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/cookies/cookiestore/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/cookies/cookiestore/index.md @@ -13,60 +13,60 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/CookieStore --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>CookieStore</code> de l'API {{WebExtAPIRef("cookies")}} reprĂ©sente un cookie store dans le navigateur.</p> +Le type `CookieStore` de l'API {{WebExtAPIRef("cookies")}} reprĂ©sente un cookie store dans le navigateur. -<p>Les fenperes dans les diffĂ©rents mode de navigations peut utiliser diffĂ©rents magasins de cookies â Une fenĂȘtre de navigation privĂ©e/ mode navigation privĂ©e, par exemple utilisera un magasin de cookies sĂ©parĂ© d'une fenĂȘtre non-privĂ©e / privĂ©e.</p> +Les fenperes dans les diffĂ©rents mode de navigations peut utiliser diffĂ©rents magasins de cookies â Une fenĂȘtre de navigation privĂ©e/ mode navigation privĂ©e, par exemple utilisera un magasin de cookies sĂ©parĂ© d'une fenĂȘtre non-privĂ©e / privĂ©e. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets, qui peuvent contenir les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets, qui peuvent contenir les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>id</code></dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant l'identification unique pour le cookie store.***</dd> - <dt><code>incognito</code></dt> - <dd>Une valeur boolĂ©enne qui indique s'il s'agit d'un magasin de cookies incognito.</dd> - <dt><code>tabIds</code></dt> - <dd>Un <code>tableau</code> d'<code><code>entiers</code></code>, qui identifie tous les onglets du navigateur qui partagent ce cookie store.</dd> -</dl> +- `id` + - : Une `chaĂźne` reprĂ©sentant l'identification unique pour le cookie store.\*\*\* +- `incognito` + - : Une valeur boolĂ©enne qui indique s'il s'agit d'un magasin de cookies incognito. +- `tabIds` + - : Un `tableau` d'`entiers`, qui identifie tous les onglets du navigateur qui partagent ce cookie store. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.cookies.CookieStore")}}</p> +{{Compat("webextensions.api.cookies.CookieStore")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Dans l'extrait suivant, la mĂ©thode {{WebExtAPIRef("cookies.getAllCookieStores()")}} permet de rĂ©cupĂ©rer tous les magasins de cookies actuellement disponibles dans le navigateur et d'afficher chaque ID de cookie, ainsi que les onglets qui se partagent le cookie store.</p> +Dans l'extrait suivant, la mĂ©thode {{WebExtAPIRef("cookies.getAllCookieStores()")}} permet de rĂ©cupĂ©rer tous les magasins de cookies actuellement disponibles dans le navigateur et d'afficher chaque ID de cookie, ainsi que les onglets qui se partagent le cookie store. -<pre class="brush: js">function logStores(cookieStores) { +```js +function logStores(cookieStores) { for(store of cookieStores) { console.log(`Cookie store: ${store.id}\n Tab IDs: ${store.tabIds}`); } } var getting = browser.cookies.getAllCookieStores(); -getting.then(logStores);</pre> +getting.then(logStores); +``` -<p>L'extrait de code suivant obtient tous les cookies stockĂ©s et enregistre ensuite le nombre total stockĂ© et combien de ces cookies sont incognito.</p> +L'extrait de code suivant obtient tous les cookies stockĂ©s et enregistre ensuite le nombre total stockĂ© et combien de ces cookies sont incognito. -<pre class="brush: js">browser.cookies.getAllCookieStores().then((stores) => { - var incognitoStores = stores.map(store => store.incognito); +```js +browser.cookies.getAllCookieStores().then((stores) => { + var incognitoStores = stores.map(store => store.incognito); console.log(`Of ${stores.length} cookie stores, ${incognitoStores.length} are incognito.`); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.cookies`](https://developer.chrome.com/extensions/cookies). Cette documentation est dĂ©rivĂ©e de [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/cookies"><code>chrome.cookies</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json"><code>cookies.json</code></a> dans le code Chromium.</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 @@ -93,5 +93,4 @@ getting.then(logStores);</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/cookies/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/cookies/get/index.md index 2ced08d3b4..cb8596d8e2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/cookies/get/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/cookies/get/index.md @@ -13,52 +13,51 @@ tags: - get translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/get --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La mĂ©thode <strong><code>get()</code></strong> de l'API {{WebExtAPIRef("cookies")}} rĂ©cupĂšre les informations d'un seul cookie, par son nom et son URL.</p> +La mĂ©thode **`get()`** de l'API {{WebExtAPIRef("cookies")}} rĂ©cupĂšre les informations d'un seul cookie, par son nom et son URL. -<p>Si plus d'un cookie portant le mĂȘme nom existent pour une URL donnĂ©e, celui contenant le chemin le plus long sera retournĂ©. Pour les cookies ayant la mĂȘme longueur de chemin, le plus ancien cookie sera retournĂ©. Si aucun cookie ne correspond alors <code>null</code> est retournĂ©.</p> +Si plus d'un cookie portant le mĂȘme nom existent pour une URL donnĂ©e, celui contenant le chemin le plus long sera retournĂ©. Pour les cookies ayant la mĂȘme longueur de chemin, le plus ancien cookie sera retournĂ©. Si aucun cookie ne correspond alors `null` est retournĂ©. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 getting = browser.cookies.get( +```js +var getting = browser.cookies.get( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p>Un <code>objet</code> contenant les informations pouvant ĂȘtre utilisĂ©es pour rĂ©cupĂ©rer un cookie. Il peut inclure les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>firstPartyDomain</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le domaine de premiĂšre partie avec lequel le cookie Ă rĂ©cupĂ©rer est associĂ©. Cette propriĂ©tĂ© doit ĂȘtre fournie si l'isolation de la premiĂšre partie est activĂ©e sur le navigateur. Voir <a href="/fr/Add-ons/WebExtensions/API/cookies#Isolement_de_la_premiĂšre_partie">Isolement de la premiĂšre partie</a>.</dd> - <dt><code>name</code></dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le nom du cookie à rĂ©cupĂ©rer.</dd> - <dt><code>storeId</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant l'ID du {{WebExtAPIRef("cookies.CookieStore", "cookie store")}} dans lequel rechercher le cookie (tel que renvoyĂ© par {{WebExtAPIRef("cookies.getAllCookieStores()")}}). Par dĂ©fault, le cookie store du contexte d'exĂ©cution actuel sera utilisĂ©.</dd> - <dt><code>url</code></dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant l'URL avec laquelle le cookie Ă rĂ©cupĂ©rer est associĂ©. Cet argument peut ĂȘtre une URL complĂšte, auquel cas toute donnĂ©e suivant le chemin d'URL (par exemple la chaĂźne de requĂȘte) est simplement ignorĂ©e. Si les  <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions"> permissions d'hĂŽte</a> pour cette URL ne sont pas spĂ©cifiĂ©es dans le <a href="/fr/Add-ons/WebExtensions/manifest.json">fichier manifeste</a> de l'extension, l'appel de l'API Ă©chouera.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : Un `objet` contenant les informations pouvant ĂȘtre utilisĂ©es pour rĂ©cupĂ©rer un cookie. Il peut inclure les propriĂ©tĂ©s suivantes : -<p>Une <code><a href="fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet {{WebExtAPIRef('cookies.Cookie', 'Cookie')}} contenant des dĂ©tails sur le cookie, ou <code>null</code> si le cookie n'a pas Ă©tĂ© trouvĂ©.</p> + - `firstPartyDomain`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant le domaine de premiĂšre partie avec lequel le cookie Ă rĂ©cupĂ©rer est associĂ©. Cette propriĂ©tĂ© doit ĂȘtre fournie si l'isolation de la premiĂšre partie est activĂ©e sur le navigateur. Voir [Isolement de la premiĂšre partie](/fr/Add-ons/WebExtensions/API/cookies#Isolement_de_la_premiĂšre_partie). + - `name` + - : Une `chaĂźne` reprĂ©sentant le nom du cookie à rĂ©cupĂ©rer. + - `storeId`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant l'ID du {{WebExtAPIRef("cookies.CookieStore", "cookie store")}} dans lequel rechercher le cookie (tel que renvoyĂ© par {{WebExtAPIRef("cookies.getAllCookieStores()")}}). Par dĂ©fault, le cookie store du contexte d'exĂ©cution actuel sera utilisĂ©. + - `url` + - : Une `chaĂźne` reprĂ©sentant l'URL avec laquelle le cookie Ă rĂ©cupĂ©rer est associĂ©. Cet argument peut ĂȘtre une URL complĂšte, auquel cas toute donnĂ©e suivant le chemin d'URL (par exemple la chaĂźne de requĂȘte) est simplement ignorĂ©e. Si les  [ permissions d'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions) pour cette URL ne sont pas spĂ©cifiĂ©es dans le [fichier manifeste](/fr/Add-ons/WebExtensions/manifest.json) de l'extension, l'appel de l'API Ă©chouera. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.cookies.get")}}</p> +Une [`Promise`](fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef('cookies.Cookie', 'Cookie')}} contenant des dĂ©tails sur le cookie, ou `null` si le cookie n'a pas Ă©tĂ© trouvĂ©. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Cet exemple tente d'obtenir le cookie nommĂ© "favourite-colour", associĂ© Ă l'URL de l'onglet actuellement actif :</p> +{{Compat("webextensions.api.cookies.get")}} -<pre class="brush: js">function logCookie(cookie) { +## Exemples + +Cet exemple tente d'obtenir le cookie nommĂ© "favourite-colour", associĂ© Ă l'URL de l'onglet actuellement actif : + +```js +function logCookie(cookie) { if (cookie) { console.log(cookie.value); } @@ -76,19 +75,18 @@ var getActive = browser.tabs.query({ active: true, currentWindow: true }); -getActive.then(getCookie);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +getActive.then(getCookie); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/cookies"><code>chrome.cookies</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json"><code>cookies.json</code></a> dans le code Chromium.</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.cookies`](https://developer.chrome.com/extensions/cookies). Cette documentation est dĂ©rivĂ©e de [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -115,5 +113,4 @@ getActive.then(getCookie);</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/cookies/getall/index.md b/files/fr/mozilla/add-ons/webextensions/api/cookies/getall/index.md index f08e093055..5a4d31b363 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/cookies/getall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/cookies/getall/index.md @@ -13,58 +13,57 @@ tags: - getAll translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/getAll --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La mĂ©thode <strong><code>getAll()</code></strong> de l'API {{WebExtAPIRef("cookies")}} rĂ©cupĂšre tous les cookies d'un seul cookie store qui correspondent aux informations fournies.</p> +La mĂ©thode **`getAll()`** de l'API {{WebExtAPIRef("cookies")}} rĂ©cupĂšre tous les cookies d'un seul cookie store qui correspondent aux informations fournies. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 getting = browser.cookies.getAll( +```js +var getting = browser.cookies.getAll( details // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>details</code></dt> - <dd><p>Un <code>object</code> contenant des dĂ©tails pouvant ĂȘtre utilisĂ©s pour faire correspondre les cookies Ă extraire. Les propriĂ©tĂ©s incluses sont les suivantes (voir <a href="/fr/Add-ons/WebExtensions/API/cookies/Cookie#Type">type de cookie</a> pour plus d'informations sur celles-ci ) :</p> - <dl> - <dt><code>domain</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant un domaine auquel les cookies doivent ĂȘtre associĂ©s (ils peuvent ĂȘtre associĂ©s soit Ă ce domaine exact, soit Ă l'un de ses sous-domaines).</dd> - <dt><code>firstPartyDomain</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le domaine de premiĂšre partie avec lequel le cookie Ă rĂ©cupĂ©rer est associĂ©. Cette propriĂ©tĂ© doit ĂȘtre fournie si l'isolation de la premiĂšre partie est activĂ©e sur le navigateur. Vous pouvez cependant passer <code>null</code> dans cette situation. Si vous faites cela, alors les cookies avec n'importe quelle valeur pour <code>firstPartyDomain</code>, ainsi que les cookies qui n'ont pas de set <code>firstPartyDomain</code> , seront inclus dans les rĂ©sultats. Voir <a href="/fr/Add-ons/WebExtensions/API/cookies#Isolement_de_la_premiĂšre_partie">Isolement de la premiĂšre partie</a>.</dd> - <dt><code>name</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant un nom que les cookies devraient avoir.</dd> - <dt><code>path</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant un chemin - le chemin des cookies doit ĂȘtre identique Ă celui-ci.</dd> - <dt><code>secure</code>{{optional_inline}}</dt> - <dd>Un <code>boolĂ©en</code> â filtre les cookies par leur propriĂ©tĂ© <code>sĂ©curisĂ©e</code>, vous permettant de filtrer les cookies sĂ©curisĂ©s contre les cookies non sĂ©curisĂ©s.</dd> - <dt><code>session</code>{{optional_inline}}</dt> - <dd>Un <code>boolĂ©en</code>â filtre les cookies en fonction de leur propriĂ©tĂ© de <code>session</code>, ce qui vous permet de filtrer les cookies de session par rapport aux cookies persistants.</dd> - <dt><code>storeId</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le magasin de cookies pour rĂ©cupĂ©rer les cookies. S'il est omi, le cookie store du contexte d'exĂ©cution actuel sera utilisĂ©.</dd> - <dt><code>url</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant une URL Ă laquelle les cookies rĂ©cupĂ©rĂ©s doivent ĂȘtre associĂ©s.</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un tableau d'objets  <code>{{WebExtAPIRef('cookies.Cookie')}}</code> correspondant aux propriĂ©tĂ©s donnĂ©es dans le paramĂštre <code>details</code>. Seuls les cookies non expirĂ©s sont renvoyĂ©s. Les cookies retournĂ©s seront triĂ©s par longueur de chemin, du plus long au plus court. Si plusieurs cookies ont la mĂȘme longueur de chemin, ceux dont l'heure de crĂ©ation est la plus proche seront les premiers.</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.cookies.getAll")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Dans l'extrait suivant, nous appelons pour obtenir tous les cookies que le navigateur a actuellement stockĂ©s qui ont un nom de "favourite-colour". Lorsque le rĂ©sultat est renvoyĂ©, nous imprimons la valeur de chaque rĂ©sultat Ă la console.</p> - -<pre class="brush: js">function logCookies(cookies) { +``` + +### ParamĂštres + +- `details` + + - : Un `object` contenant des dĂ©tails pouvant ĂȘtre utilisĂ©s pour faire correspondre les cookies Ă extraire. Les propriĂ©tĂ©s incluses sont les suivantes (voir [type de cookie](/fr/Add-ons/WebExtensions/API/cookies/Cookie#Type) pour plus d'informations sur celles-ci ) : + + - `domain`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant un domaine auquel les cookies doivent ĂȘtre associĂ©s (ils peuvent ĂȘtre associĂ©s soit Ă ce domaine exact, soit Ă l'un de ses sous-domaines). + - `firstPartyDomain`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant le domaine de premiĂšre partie avec lequel le cookie Ă rĂ©cupĂ©rer est associĂ©. Cette propriĂ©tĂ© doit ĂȘtre fournie si l'isolation de la premiĂšre partie est activĂ©e sur le navigateur. Vous pouvez cependant passer `null` dans cette situation. Si vous faites cela, alors les cookies avec n'importe quelle valeur pour `firstPartyDomain`, ainsi que les cookies qui n'ont pas de set `firstPartyDomain` , seront inclus dans les rĂ©sultats. Voir [Isolement de la premiĂšre partie](/fr/Add-ons/WebExtensions/API/cookies#Isolement_de_la_premiĂšre_partie). + - `name`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant un nom que les cookies devraient avoir. + - `path`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant un chemin - le chemin des cookies doit ĂȘtre identique Ă celui-ci. + - `secure`{{optional_inline}} + - : Un `boolĂ©en` â filtre les cookies par leur propriĂ©tĂ© `sĂ©curisĂ©e`, vous permettant de filtrer les cookies sĂ©curisĂ©s contre les cookies non sĂ©curisĂ©s. + - `session`{{optional_inline}} + - : Un `boolĂ©en`â filtre les cookies en fonction de leur propriĂ©tĂ© de `session`, ce qui vous permet de filtrer les cookies de session par rapport aux cookies persistants. + - `storeId`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant le magasin de cookies pour rĂ©cupĂ©rer les cookies. S'il est omi, le cookie store du contexte d'exĂ©cution actuel sera utilisĂ©. + - `url`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant une URL Ă laquelle les cookies rĂ©cupĂ©rĂ©s doivent ĂȘtre associĂ©s. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un tableau d'objets  `{{WebExtAPIRef('cookies.Cookie')}}` correspondant aux propriĂ©tĂ©s donnĂ©es dans le paramĂštre `details`. Seuls les cookies non expirĂ©s sont renvoyĂ©s. Les cookies retournĂ©s seront triĂ©s par longueur de chemin, du plus long au plus court. Si plusieurs cookies ont la mĂȘme longueur de chemin, ceux dont l'heure de crĂ©ation est la plus proche seront les premiers. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.cookies.getAll")}} + +## Exemples + +Dans l'extrait suivant, nous appelons pour obtenir tous les cookies que le navigateur a actuellement stockĂ©s qui ont un nom de "favourite-colour". Lorsque le rĂ©sultat est renvoyĂ©, nous imprimons la valeur de chaque rĂ©sultat Ă la console. + +```js +function logCookies(cookies) { for (let cookie of cookies) { console.log(cookie.value); } @@ -73,19 +72,18 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/getAll var gettingAll = browser.cookies.getAll({ name: "favourite-colour" }); -gettingAll.then(logCookies);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +gettingAll.then(logCookies); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/cookies"><code>chrome.cookies</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json"><code>cookies.json</code></a> dans le code Chromium.</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.cookies`](https://developer.chrome.com/extensions/cookies). Cette documentation est dĂ©rivĂ©e de [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -112,5 +110,4 @@ gettingAll.then(logCookies);</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/cookies/getallcookiestores/index.md b/files/fr/mozilla/add-ons/webextensions/api/cookies/getallcookiestores/index.md index 17e7e1f510..11b7a7b761 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/cookies/getallcookiestores/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/cookies/getallcookiestores/index.md @@ -13,82 +13,80 @@ tags: - getAllCookieStores translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/getAllCookieStores --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La mĂ©thode <strong><code>getAllCookieStores()</code></strong> de l'API {{WebExtAPIRef("cookies")}} retourne une liste de tous les cookies stores.</p> +La mĂ©thode **`getAllCookieStores()`** de l'API {{WebExtAPIRef("cookies")}} retourne une liste de tous les cookies stores. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingStores = browser.cookies.getAllCookieStores() -</pre> +```js +var gettingStores = browser.cookies.getAllCookieStores() +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<p>Aucun.</p> +Aucun. +### Valeur renvoyĂ©e +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un `tableau` d'objets {{WebExtAPIRef('cookies.CookieStore')}} reprĂ©sentant tous les cookies stores existants. -<h3 id="Valeur_renvoyĂ©e">Valeur renvoyĂ©e</h3> +## CompatibibilitĂ© du navigateur -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un <code>tableau</code> d'objets {{WebExtAPIRef('cookies.CookieStore')}} reprĂ©sentant tous les cookies stores existants.</p> +{{Compat("webextensions.api.cookies.getAllCookieStores")}} -<h2 id="CompatibibilitĂ©_du_navigateur">CompatibibilitĂ© du navigateur</h2> +## Exemples -<p>{{Compat("webextensions.api.cookies.getAllCookieStores")}}</p> +Dans l'extrait suivant, la mĂ©thode `getAllCookieStores()` permet de rĂ©cupĂ©rer tous les cookies stores actuellement disponible dans le navigateur et d'afficher chaque ID de cookie et les onglets qui partagent actuellement chaque cookie store. -<h2 id="Exemples">Exemples</h2> - -<p>Dans l'extrait suivant, la mĂ©thode <code>getAllCookieStores()</code> permet de rĂ©cupĂ©rer tous les cookies stores actuellement disponible dans le navigateur et d'afficher chaque ID de cookie et les onglets qui partagent actuellement chaque cookie store.</p> - -<pre class="brush: js">function logStores(cookieStores) { +```js +function logStores(cookieStores) { for (let store of cookieStores) { console.log(`Cookie store: ${store.id}\n Tab IDs: ${store.tabIds}`); } } var getting = browser.cookies.getAllCookieStores(); -getting.then(logStores);</pre> - -<p>Chaque membre du tableau <code>cookieStores</code> est un objet {{WebExtAPIRef("cookies.CookieStore")}}.</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/cookies"><code>chrome.cookies</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json"><code>cookies.json</code></a> dans le code Chromium.</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> +getting.then(logStores); +``` + +Chaque membre du tableau `cookieStores` est un objet {{WebExtAPIRef("cookies.CookieStore")}}. + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.cookies`](https://developer.chrome.com/extensions/cookies). Cette documentation est dĂ©rivĂ©e de [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. +> +> <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/cookies/index.md b/files/fr/mozilla/add-ons/webextensions/api/cookies/index.md index c8f1493fb3..36bb8a2531 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/cookies/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/cookies/index.md @@ -12,133 +12,110 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/cookies --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Permet aux extensions d'obtenir et de dĂ©finir des cookies, et d'ĂȘtre averti quand ils changent.</p> - -<p>Pour utiliser cette API, vous devez inclure l'<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">API permission</a> "cookies" dans votre fichier <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a>, ainsi que les <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions d'hĂŽte</a> pour les sites dont vous devez accĂ©der aux cookies. Voir les <a href="/fr/Add-ons/WebExtensions/API/cookies#Permissions">permissions cookies</a>.</p> - -<h2 id="Permissions">Permissions</h2> - -<p>Pour utiliser cette API, un module complĂ©mentaire doit spĂ©cifier la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission d'API</a> "cookies" dans son manifest, ainsi que les <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions host</a> pour tous les sites pour lesquels il souhaite accĂ©der aux cookies. L'add-on peut lire ou Ă©crire des cookies qui pourraient ĂȘtre lus ou Ă©crits par une URL correspondant aux permissions de l'hĂŽte. Par exemple :</p> +Permet aux extensions d'obtenir et de dĂ©finir des cookies, et d'ĂȘtre averti quand ils changent. -<dl> - <dt><code>http://*.example.com/</code></dt> - <dd> - <p>Un module complĂ©mentaire avec cette autorisation d'hĂŽte peut :</p> +Pour utiliser cette API, vous devez inclure l'[API permission](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "cookies" dans votre fichier [manifest.json](/fr/Add-ons/WebExtensions/manifest.json), ainsi que les [permissions d'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) pour les sites dont vous devez accĂ©der aux cookies. Voir les [permissions cookies](/fr/Add-ons/WebExtensions/API/cookies#Permissions). - <ul> - <li>Lire un cookie non sĂ©curisĂ© pour <code>www.example.com</code>, avec n'importe quel chemin.</li> - <li>Ăcrire un cookie ou non sĂ©curisĂ© pour <code>www.example.com</code>, avec n'importe quel chemin.</li> - </ul> +## Permissions - <p>Il ne peut <em>pas</em> :</p> +Pour utiliser cette API, un module complĂ©mentaire doit spĂ©cifier la [permission d'API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "cookies" dans son manifest, ainsi que les [permissions host](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) pour tous les sites pour lesquels il souhaite accĂ©der aux cookies. L'add-on peut lire ou Ă©crire des cookies qui pourraient ĂȘtre lus ou Ă©crits par une URL correspondant aux permissions de l'hĂŽte. Par exemple : - <ul> - <li>Lire un cookie sĂ©curisĂ© pour <code>www.example.com</code>.</li> - </ul> - </dd> - <dt><code>http://www.example.com/</code></dt> - <dd> - <p>Un module complĂ©mentaire avec cette permission d'hĂŽte peut :</p> +- `http://*.example.com/` - <ul> - <li>Lire un cookie non sĂ©curisĂ© pour <code>www.example.com</code>, avec n'importe quel chemin.</li> - <li>Lire un cookie non sĂ©curisĂ© pour <code>.example.com</code>, avec n'importe quel chemin.</li> - <li>Ăcrire un cookie sĂ©curisĂ© ou non sĂ©curisĂ© pour <code>www.example.com</code> avec n'importe quel chemin.</li> - <li>Ăcrire un cookie sĂ©curisĂ© ou non sĂ©curisĂ© pour <code>.example.com</code> avec n'importe quel chemin.</li> - </ul> + - : Un module complĂ©mentaire avec cette autorisation d'hĂŽte peut : - <p>Il ne peut <em>pas</em> :</p> + - Lire un cookie non sĂ©curisĂ© pour `www.example.com`, avec n'importe quel chemin. + - Ăcrire un cookie ou non sĂ©curisĂ© pour `www.example.com`, avec n'importe quel chemin. - <ul> - <li>Lire ou Ă©crire un cookie pour <code>foo.example.com</code>.</li> - <li>Lire ou Ă©crire un cookie pour <code>foo.www.example.com</code>.</li> - </ul> - </dd> - <dt><code>*://*.example.com/</code></dt> - <dd> - <p>Un module complĂ©mentaire avec çà permission d'hĂŽtes n add-on with this host permission may:</p> + Il ne peut _pas_ : - <ul> - <li>Read or write a secure or non-secure cookie for <code>www.example.com</code> with any path.</li> - </ul> - </dd> -</dl> + - Lire un cookie sĂ©curisĂ© pour `www.example.com`. -<h2 id="Isolement_de_la_premiĂšre_partie">Isolement de la premiĂšre partie</h2> +- `http://www.example.com/` -<p>Les cookies tiers sont des cookies qui sont dĂ©finis par un site Web autre que celui sur lequel vous ĂȘtes actuellement. Par exemple :</p> + - : Un module complĂ©mentaire avec cette permission d'hĂŽte peut : -<ol> - <li>Vous visitez <a href="http://bbc.com">bbc.com</a>. Il contient une annonce de <a href="http://tracker.com">tracker.com</a> qui dĂ©finit un cookie associĂ© au domaine "<a href="http://tracker.com">tracker.com</a>".</li> - <li>Vous visitez <a href="http://cnn.com">cnn.com</a>. Il contient Ă©galement une annonce de <a href="http://tracker.com">tracker.com</a> qui dĂ©finit un cookie associĂ© au domaine "<a href="http://tracker.com">tracker.com</a>".</li> - <li>Finalement, les deux cookies peuvent ĂȘtre envoyĂ©s Ă <a href="http://tracker.com">tracker.com</a>. qui peut alors comprendre que le mĂȘme utilisateur a visitĂ© les deux sites.</li> -</ol> + - Lire un cookie non sĂ©curisĂ© pour `www.example.com`, avec n'importe quel chemin. + - Lire un cookie non sĂ©curisĂ© pour `.example.com`, avec n'importe quel chemin. + - Ăcrire un cookie sĂ©curisĂ© ou non sĂ©curisĂ© pour `www.example.com` avec n'importe quel chemin. + - Ăcrire un cookie sĂ©curisĂ© ou non sĂ©curisĂ© pour `.example.com` avec n'importe quel chemin. -<p>Lorsque l'isolement de la premiĂšre partie est activĂ©, les cookies sont en outre qualifiĂ©s par le domaine de la page d'origine visitĂ©e par l'utilisateur (essentiellement, le domaine montrĂ© Ă l'utilisateur dans la barre d'URL, Ă©galement appelĂ© "premiĂšre partie du domaine"). Cela signifie qu'un tracker ne peut pas corrĂ©ler son cookie de <a href="http://bbc.com">bbc.com</a> avec son cookie de <a href="http://cnn.com">cnn.com</a>, de sorte que le tracker ne peut pas suivre un seul utilisateur sur les deux sites.</p> + Il ne peut _pas_ : -<p>L'isolement de la premiĂšre partie peut ĂȘtre activĂ© directement par l'utilisateur en ajustant la configuration du navigateur et peut ĂȘtre dĂ©fini par des extensions Ă l'aide du paramĂštre <code><a href="/fr/Add-ons/WebExtensions/API/privacy/websites#Properties">firstPartyIsolate</a></code> de l'API de <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/privacy">privacy</a></code> Notez que l'isolation de premiĂšre partie est activĂ©e par dĂ©faut dans le <a href="https://www.torproject.org/">Tor Browser</a>.</p> + - Lire ou Ă©crire un cookie pour `foo.example.com`. + - Lire ou Ă©crire un cookie pour `foo.www.example.com`. -<p>Dans l'API <code>cookies</code>, le domaine de premiĂšre partie est reprĂ©sentĂ© Ă l'aide de l'attribut <code>firstPartyDomain</code>. Tous les cookies configurĂ©s pendant l'isolement de la premiĂšre partie ont cet attribut dĂ©fini sur le domaine de la page d'origine. Dans l'exemple ci-dessus, ce serait "<a href="http://bbc.com">bbc.com</a>" pour un cookie et "<a href="http://cnn.com">cnn.com</a>" pour l'autre. Tous les cookies dĂ©finis par les sites Web alors que l'isolation de premiĂšre partie est dĂ©sactivĂ©e auront cette propriĂ©tĂ© dĂ©finie sur une chaĂźne vide.<br> - <br> - Le {{WebExtAPIRef("cookies.get()")}}, {{WebExtAPIRef("cookies.getAll()")}}, {{WebExtAPIRef("cookies.set()")}} et {{WebExtAPIRef("cookies.remove()")}} Les API acceptent toutes une option <code>firstPartyDomain</code>.</p> +- `*://*.example.com/` -<p>Lorsque l'isolation de premiĂšre partie est activĂ©e, vous devez fournir cette option ou les appels de l'API Ă©choueront. Pour <code>get()</code>, <code>set()</code>, et <code>remove()</code>vous devez passer une valeur de chaĂźne de caractĂšres.</p> + - : Un module complĂ©mentaire avec çà permission d'hĂŽtes n add-on with this host permission may: -<p>Pour <code>getAll()</code>,  vous pouvez aussi passer <code>null</code> ici, et ceci obtiendra tous les cookies,<br> - qu'ils aient ou non une valeur non vide pour <code>firstPartyDomain.</code></p> + - Read or write a secure or non-secure cookie for `www.example.com` with any path. -<p>Lorsque l'isolation de la premiĂšre partie est dĂ©sactivĂ©e, le paramĂštre <code>firstPartyDomain</code> est optionnel et par dĂ©faut est une chaĂźne vide. Une chaĂźne non vide peut ĂȘtre utilisĂ©e pour rĂ©cupĂ©rer ou modifier les cookies d'isolation de premiĂšre partie. De mĂȘme, passer <code>null</code> comme <code>firstPartyDomain</code> pour <code>getAll()</code> retournera tous les cookies.</p> +## Isolement de la premiĂšre partie -<h2 id="Types">Types</h2> +Les cookies tiers sont des cookies qui sont dĂ©finis par un site Web autre que celui sur lequel vous ĂȘtes actuellement. Par exemple : -<dl> - <dt>{{WebExtAPIRef("cookies.Cookie")}}</dt> - <dd>ReprĂ©sente les informations sur un cookie HTTP.</dd> - <dt>{{WebExtAPIRef("cookies.CookieStore")}}</dt> - <dd>ReprĂ©sente un cookie store dans le navigateur.</dd> - <dt>{{WebExtAPIRef("cookies.OnChangedCause")}}</dt> - <dd>ReprĂ©sente la raison pour laquelle un cookie a Ă©tĂ© modifiĂ©.***</dd> - <dt>{{WebExtAPIRef("cookies.SameSiteStatus")}}</dt> - <dd>ReprĂ©sente le mĂȘme statut du cookie sur le site.</dd> -</dl> +1. Vous visitez [bbc.com](http://bbc.com). Il contient une annonce de [tracker.com](http://tracker.com) qui dĂ©finit un cookie associĂ© au domaine "[tracker.com](http://tracker.com)". +2. Vous visitez [cnn.com](http://cnn.com). Il contient Ă©galement une annonce de [tracker.com](http://tracker.com) qui dĂ©finit un cookie associĂ© au domaine "[tracker.com](http://tracker.com)". +3. Finalement, les deux cookies peuvent ĂȘtre envoyĂ©s Ă [tracker.com](http://tracker.com). qui peut alors comprendre que le mĂȘme utilisateur a visitĂ© les deux sites. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +Lorsque l'isolement de la premiĂšre partie est activĂ©, les cookies sont en outre qualifiĂ©s par le domaine de la page d'origine visitĂ©e par l'utilisateur (essentiellement, le domaine montrĂ© Ă l'utilisateur dans la barre d'URL, Ă©galement appelĂ© "premiĂšre partie du domaine"). Cela signifie qu'un tracker ne peut pas corrĂ©ler son cookie de [bbc.com](http://bbc.com) avec son cookie de [cnn.com](http://cnn.com), de sorte que le tracker ne peut pas suivre un seul utilisateur sur les deux sites. -<dl> - <dt>{{WebExtAPIRef("cookies.get()")}}</dt> - <dd>RĂ©cupĂšre les informations sur un cookie unique.</dd> - <dt>{{WebExtAPIRef("cookies.getAll()")}}</dt> - <dd>RĂ©cupĂšre tous les cookies correspondant Ă un ensemble de filtres donnĂ©es.</dd> - <dt>{{WebExtAPIRef("cookies.set()")}}</dt> - <dd>DĂ©finit un cookie avec les donnĂ©es d'un cookie donnĂ© ; peut remplacer les cookies Ă©quivalents s'ils existent.</dd> - <dt>{{WebExtAPIRef("cookies.remove()")}}</dt> - <dd>Supprime un cookie par son nom.</dd> - <dt>{{WebExtAPIRef("cookies.getAllCookieStores()")}}</dt> - <dd>Liste tous les cookies stores existants.</dd> -</dl> +L'isolement de la premiĂšre partie peut ĂȘtre activĂ© directement par l'utilisateur en ajustant la configuration du navigateur et peut ĂȘtre dĂ©fini par des extensions Ă l'aide du paramĂštre [`firstPartyIsolate`](/fr/Add-ons/WebExtensions/API/privacy/websites#Properties) de l'API de [`privacy`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/privacy) Notez que l'isolation de premiĂšre partie est activĂ©e par dĂ©faut dans le [Tor Browser](https://www.torproject.org/). -<h2 id="Gestionnaire_dĂ©vĂ©nements">Gestionnaire d'Ă©vĂ©nements</h2> +Dans l'API `cookies`, le domaine de premiĂšre partie est reprĂ©sentĂ© Ă l'aide de l'attribut `firstPartyDomain`. Tous les cookies configurĂ©s pendant l'isolement de la premiĂšre partie ont cet attribut dĂ©fini sur le domaine de la page d'origine. Dans l'exemple ci-dessus, ce serait "[bbc.com](http://bbc.com)" pour un cookie et "[cnn.com](http://cnn.com)" pour l'autre. Tous les cookies dĂ©finis par les sites Web alors que l'isolation de premiĂšre partie est dĂ©sactivĂ©e auront cette propriĂ©tĂ© dĂ©finie sur une chaĂźne vide. -<dl> - <dt>{{WebExtAPIRef("cookies.onChanged")}}</dt> - <dd>DĂ©tails quand un cookie est dĂ©fini ou supprimĂ©.</dd> -</dl> +Le {{WebExtAPIRef("cookies.get()")}}, {{WebExtAPIRef("cookies.getAll()")}}, {{WebExtAPIRef("cookies.set()")}} et {{WebExtAPIRef("cookies.remove()")}} Les API acceptent toutes une option `firstPartyDomain`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.cookies")}}</p> +Lorsque l'isolation de premiĂšre partie est activĂ©e, vous devez fournir cette option ou les appels de l'API Ă©choueront. Pour `get()`, `set()`, et `remove()`vous devez passer une valeur de chaĂźne de caractĂšres. -<p>{{WebExtExamples("h2")}}</p> +Pour `getAll()`,  vous pouvez aussi passer `null` ici, et ceci obtiendra tous les cookies, +qu'ils aient ou non une valeur non vide pour `firstPartyDomain.` -<div class="note"><p><strong>Note :</strong></p> +Lorsque l'isolation de la premiĂšre partie est dĂ©sactivĂ©e, le paramĂštre `firstPartyDomain` est optionnel et par dĂ©faut est une chaĂźne vide. Une chaĂźne non vide peut ĂȘtre utilisĂ©e pour rĂ©cupĂ©rer ou modifier les cookies d'isolation de premiĂšre partie. De mĂȘme, passer `null` comme `firstPartyDomain` pour `getAll()` retournera tous les cookies. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/cookies"><code>chrome.cookies</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json"><code>cookies.json</code></a> dans le code Chromium.</p> -</div> +## Types -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +- {{WebExtAPIRef("cookies.Cookie")}} + - : ReprĂ©sente les informations sur un cookie HTTP. +- {{WebExtAPIRef("cookies.CookieStore")}} + - : ReprĂ©sente un cookie store dans le navigateur. +- {{WebExtAPIRef("cookies.OnChangedCause")}} + - : ReprĂ©sente la raison pour laquelle un cookie a Ă©tĂ© modifiĂ©.\*\*\* +- {{WebExtAPIRef("cookies.SameSiteStatus")}} + - : ReprĂ©sente le mĂȘme statut du cookie sur le site. + +## MĂ©thodes + +- {{WebExtAPIRef("cookies.get()")}} + - : RĂ©cupĂšre les informations sur un cookie unique. +- {{WebExtAPIRef("cookies.getAll()")}} + - : RĂ©cupĂšre tous les cookies correspondant Ă un ensemble de filtres donnĂ©es. +- {{WebExtAPIRef("cookies.set()")}} + - : DĂ©finit un cookie avec les donnĂ©es d'un cookie donnĂ© ; peut remplacer les cookies Ă©quivalents s'ils existent. +- {{WebExtAPIRef("cookies.remove()")}} + - : Supprime un cookie par son nom. +- {{WebExtAPIRef("cookies.getAllCookieStores()")}} + - : Liste tous les cookies stores existants. + +## Gestionnaire d'Ă©vĂ©nements + +- {{WebExtAPIRef("cookies.onChanged")}} + - : DĂ©tails quand un cookie est dĂ©fini ou supprimĂ©. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.cookies")}} + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.cookies`](https://developer.chrome.com/extensions/cookies). Cette documentation est dĂ©rivĂ©e de [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) dans le code Chromium. + +<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 @@ -165,5 +142,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/cookies // 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/cookies/onchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/cookies/onchanged/index.md index a75958fd31..d320e749e4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/cookies/onchanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/cookies/onchanged/index.md @@ -13,88 +13,79 @@ tags: - onChanged translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/onChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'Ă©vĂ©nement <code>onChanged</code> de l'API {{WebExtAPIRef("cookies")}} est dĂ©clenchĂ© lorsqu'un cookie est dĂ©fini ou supprimĂ©.</p> +L'Ă©vĂ©nement `onChanged` de l'API {{WebExtAPIRef("cookies")}} est dĂ©clenchĂ© lorsqu'un cookie est dĂ©fini ou supprimĂ©. -<p>Notez que la mise Ă jour des propriĂ©tĂ©s d'un cookie est implĂ©mentĂ©e en deux Ă©tapes :</p> +Notez que la mise Ă jour des propriĂ©tĂ©s d'un cookie est implĂ©mentĂ©e en deux Ă©tapes : -<ol> - <li>Tout d'abord, le cookie Ă mettre Ă jour est tout d'abord entiĂ©rement supprimĂ©, gĂ©nĂ©ralement une notification avec un {{WebExtAPIRef("cookies.OnChangedCause")}} d'Ă©crasement.</li> - <li>Ensuite, un nouveau cookie est Ă©crit avec les valeurs mises Ă jour, gĂ©nĂ©ralement une seconde notification avec un {{WebExtAPIRef("cookies.OnChangedCause")}} <code>explicite</code>.</li> -</ol> +1. Tout d'abord, le cookie Ă mettre Ă jour est tout d'abord entiĂ©rement supprimĂ©, gĂ©nĂ©ralement une notification avec un {{WebExtAPIRef("cookies.OnChangedCause")}} d'Ă©crasement. +2. Ensuite, un nouveau cookie est Ă©crit avec les valeurs mises Ă jour, gĂ©nĂ©ralement une seconde notification avec un {{WebExtAPIRef("cookies.OnChangedCause")}} `explicite`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.cookies.onChanged.addListener(listener) +```js +browser.cookies.onChanged.addListener(listener) browser.cookies.onChanged.removeListener(listener) browser.cookies.onChanged.hasListener(listener) -</pre> +``` -<p>Cet API est Ă©galement disponible en tant que <code>browser.cookies.onChanged.*</code>.</p> +Cet API est Ă©galement disponible en tant que `browser.cookies.onChanged.*`. -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un Ă©couteur Ă l'Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si l'Ă©couteur est enregistrĂ© pour cet Ă©vĂ©nement. Retourne <code>true</code> s'il Ă©coute, <code>false</code> sinon.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă l'Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si l'Ă©couteur est enregistrĂ© pour cet Ă©vĂ©nement. Retourne `true` s'il Ă©coute, `false` sinon. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Une fonction de rappel qui sera appelĂ©e lorsque l'Ă©vĂ©nement se produira. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>changeInfo</code></dt> - <dd><p>Un <code>objet</code> contenant les dĂ©tails de la modification survenue. Ses propriĂ©tĂ©s sont les suivantes :</p> - <dl> - <dt><code>removed</code></dt> - <dd>Un <code>boolĂ©en</code> dĂ©fini sur <code>true</code> si un cookie a Ă©tĂ© supprimĂ© et sinon false.</dd> - <dt><code>cookie</code></dt> - <dd>Un objet {{WebExtAPIRef('cookies.Cookie')}} contenant les informations sur le cookie qui a Ă©tĂ© dĂ©fini ou supprimĂ©.</dd> - <dt><code>cause</code></dt> - <dd>Une valeur {{WebExtAPIRef('cookies.OnChangedCause')}} reprĂ©sentant la raison sous-jacente de la modification du cookie.</dd> - </dl> - </dd> - </dl> - </dd> -</dl> + - : Une fonction de rappel qui sera appelĂ©e lorsque l'Ă©vĂ©nement se produira. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `changeInfo` -<p>{{Compat("webextensions.api.cookies.onChanged")}}</p> + - : Un `objet` contenant les dĂ©tails de la modification survenue. Ses propriĂ©tĂ©s sont les suivantes : -<h2 id="Exemples">Exemples</h2> + - `removed` + - : Un `boolĂ©en` dĂ©fini sur `true` si un cookie a Ă©tĂ© supprimĂ© et sinon false. + - `cookie` + - : Un objet {{WebExtAPIRef('cookies.Cookie')}} contenant les informations sur le cookie qui a Ă©tĂ© dĂ©fini ou supprimĂ©. + - `cause` + - : Une valeur {{WebExtAPIRef('cookies.OnChangedCause')}} reprĂ©sentant la raison sous-jacente de la modification du cookie. -<p>Cet exemple Ă©coute les Ă©vĂ©nements <code>onChanged</code> et enregistre les dĂ©tails de l'argument <code>changeInfo</code> :</p> +## CompatibilitĂ© du navigateur -<pre class="brush: js">browser.cookies.onChanged.addListener(function(changeInfo) { +{{Compat("webextensions.api.cookies.onChanged")}} + +## Exemples + +Cet exemple Ă©coute les Ă©vĂ©nements `onChanged` et enregistre les dĂ©tails de l'argument `changeInfo` : + +```js +browser.cookies.onChanged.addListener(function(changeInfo) {  console.log('Cookie changed: ' +              '\n * Cookie: ' + JSON.stringify(changeInfo.cookie) +              '\n * Cause: ' + changeInfo.cause +              '\n * Removed: ' + changeInfo.removed); -});</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/cookies"><code>chrome.cookies</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json"><code>cookies.json</code></a> dans le code Chromium.</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.cookies`](https://developer.chrome.com/extensions/cookies). Cette documentation est dĂ©rivĂ©e de [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -121,5 +112,4 @@ browser.cookies.onChanged.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/cookies/onchangedcause/index.md b/files/fr/mozilla/add-ons/webextensions/api/cookies/onchangedcause/index.md index fbc9df1fe3..854e04acb1 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/cookies/onchangedcause/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/cookies/onchangedcause/index.md @@ -13,53 +13,51 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/OnChangedCause --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>OnChangedCause</code> de l'API {{WebExtAPIRef("cookies")}} reprĂ©sente la raison pour laquelle un cookie a Ă©tĂ© modifiĂ©.</p> +Le type `OnChangedCause` de l'API {{WebExtAPIRef("cookies")}} reprĂ©sente la raison pour laquelle un cookie a Ă©tĂ© modifiĂ©. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<dl> - <dt><code>evicted</code></dt> - <dd>Un cookie a Ă©tĂ© automatiquement supprimĂ© en raison d'un nettoyage de mĂ©moire.</dd> - <dt><code>expired</code></dt> - <dd>Un cookie a Ă©tĂ© automatiquement supprimĂ© en raison de l'expiration.</dd> - <dt><code>explicit</code></dt> - <dd>Un cookie a Ă©tĂ© insĂ©rĂ© ou supprimĂ© via un appel explicite Ă {{WebExtAPIRef("cookies.remove()")}}.</dd> - <dt><code>expired_overwrite</code></dt> - <dd>Un cookie a Ă©tĂ© remplacĂ© par un cookie dont la date d'expiration est dĂ©jĂ expirĂ©e.</dd> - <dt><code>overwrite</code></dt> - <dd>Un appel Ă {{WebExtAPIRef("cookies.set()")}} a remplacĂ© ce cookie par un autre.</dd> -</dl> +- `evicted` + - : Un cookie a Ă©tĂ© automatiquement supprimĂ© en raison d'un nettoyage de mĂ©moire. +- `expired` + - : Un cookie a Ă©tĂ© automatiquement supprimĂ© en raison de l'expiration. +- `explicit` + - : Un cookie a Ă©tĂ© insĂ©rĂ© ou supprimĂ© via un appel explicite Ă {{WebExtAPIRef("cookies.remove()")}}. +- `expired_overwrite` + - : Un cookie a Ă©tĂ© remplacĂ© par un cookie dont la date d'expiration est dĂ©jĂ expirĂ©e. +- `overwrite` + - : Un appel Ă {{WebExtAPIRef("cookies.set()")}} a remplacĂ© ce cookie par un autre. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.cookies.OnChangedCause")}}</p> +{{Compat("webextensions.api.cookies.OnChangedCause")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Vous pouvez Ă©couter l'Ă©vĂ©nement {{WebExtAPIRef("cookies.onChanged")}} pour ĂȘtre averti lorsque les cookies changent. L'Ă©couteur reçoit un objet <code>changeInfo</code> qui contient une propriĂ©tĂ© <code>cause</code>, dont la valeur est une chaĂźne <code>OnChangeCaused</code> :</p> +Vous pouvez Ă©couter l'Ă©vĂ©nement {{WebExtAPIRef("cookies.onChanged")}} pour ĂȘtre averti lorsque les cookies changent. L'Ă©couteur reçoit un objet `changeInfo` qui contient une propriĂ©tĂ© `cause`, dont la valeur est une chaĂźne `OnChangeCaused` : -<pre class="brush: js">browser.cookies.onChanged.addListener(function(changeInfo) { +```js +browser.cookies.onChanged.addListener(function(changeInfo) {  console.log('Cookie changed: ' +              '\n * Cookie: ' + JSON.stringify(changeInfo.cookie) +              '\n * Cause: ' + changeInfo.cause +              '\n * Removed: ' + changeInfo.removed); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.cookies`](https://developer.chrome.com/extensions/cookies). Cette documentation est dĂ©rivĂ©e de [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/cookies"><code>chrome.cookies</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json"><code>cookies.json</code></a> dans le code Chromium.</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 @@ -86,5 +84,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/OnChangedCause // 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/cookies/remove/index.md b/files/fr/mozilla/add-ons/webextensions/api/cookies/remove/index.md index 9127e08c1c..3b721356ca 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/cookies/remove/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/cookies/remove/index.md @@ -13,52 +13,51 @@ tags: - remove translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/remove --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La mĂ©thode <strong><code>remove()</code></strong> de l'API {{WebExtAPIRef("cookies")}} supprime un cookie, compte tenu de son nom et de son URL.</p> +La mĂ©thode **`remove()`** de l'API {{WebExtAPIRef("cookies")}} supprime un cookie, compte tenu de son nom et de son URL. -<p>L'appel rĂ©ussit uniquement si vous incluez la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission de l'API</a> "cookies" dans votre fichier <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a>, ainsi que les <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions d'hĂŽte</a> pour l'URL indiquĂ©e dans son manifest.</p> +L'appel rĂ©ussit uniquement si vous incluez la [permission de l'API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "cookies" dans votre fichier [manifest.json](/fr/Add-ons/WebExtensions/manifest.json), ainsi que les [permissions d'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) pour l'URL indiquĂ©e dans son manifest. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.cookies.remove( +```js +var removing = browser.cookies.remove( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p>Un <code>objet</code> contenant des informations permettant d'identifier le cookie Ă supprimer. Il contient les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>firstPartyDomain</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le domaine de premiĂšre partie avec lequel le cookie sera associĂ©. Cette propriĂ©tĂ© doit ĂȘtre fournie si l'isolation de la premiĂšre partie est activĂ©e sur le navigateur. Voir <a href="/fr/Add-ons/WebExtensions/API/cookies#Isolement_de_la_premiĂšre_partie">Isolement de la premiĂšre partie</a>.</dd> - <dt><code>name</code></dt> - <dd>Une <code>chaĂźne</code> reprĂ©senant le nom du cookie Ă supprimer.</dd> - <dt><code>storeId</code>{{optional_inline}}</dt> - <dd>Une<code> chaĂźne</code> reprĂ©sentant l'ID du cookie store pour trouver le cookie. Si elle n'est pas spĂ©cifiĂ©e, le cookie est recherchĂ© par dĂ©faut dans le cookie store du contexte d'exĂ©cution actuel.</dd> - <dt><code>url</code></dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant l'URL associĂ©e au cookie. Si l'extension n'a pas de <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions d'hĂŽte</a> pour cette URL, l'appel de l'API Ă©chouera.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : Un `objet` contenant des informations permettant d'identifier le cookie Ă supprimer. Il contient les propriĂ©tĂ©s suivantes : -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet {{WebExtAPIRef('cookies.Cookie')}} contenant des dĂ©tails sur le cookie qui a Ă©tĂ© supprimĂ©. Si un cookie correspondant au paramĂštre <code>details</code> n'a pas pu ĂȘtre trouvĂ©, la promesse est remplie avec <code>null</code>. Si l'appel Ă©choue pour une raison quelconque, la promesse sera rejetĂ©e avec un message d'erreur.</p> + - `firstPartyDomain`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant le domaine de premiĂšre partie avec lequel le cookie sera associĂ©. Cette propriĂ©tĂ© doit ĂȘtre fournie si l'isolation de la premiĂšre partie est activĂ©e sur le navigateur. Voir [Isolement de la premiĂšre partie](/fr/Add-ons/WebExtensions/API/cookies#Isolement_de_la_premiĂšre_partie). + - `name` + - : Une `chaĂźne` reprĂ©senant le nom du cookie Ă supprimer. + - `storeId`{{optional_inline}} + - : Une` chaĂźne` reprĂ©sentant l'ID du cookie store pour trouver le cookie. Si elle n'est pas spĂ©cifiĂ©e, le cookie est recherchĂ© par dĂ©faut dans le cookie store du contexte d'exĂ©cution actuel. + - `url` + - : Une `chaĂźne` reprĂ©sentant l'URL associĂ©e au cookie. Si l'extension n'a pas de [permissions d'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) pour cette URL, l'appel de l'API Ă©chouera. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.cookies.remove")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef('cookies.Cookie')}} contenant des dĂ©tails sur le cookie qui a Ă©tĂ© supprimĂ©. Si un cookie correspondant au paramĂštre `details` n'a pas pu ĂȘtre trouvĂ©, la promesse est remplie avec `null`. Si l'appel Ă©choue pour une raison quelconque, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Cet exemple tente de supprimer le cookie nommĂ© "favourite-colour", dont l'URL correspond Ă l'URL du document hĂ©bergĂ© par l'onglet actuellement actif :</p> +{{Compat("webextensions.api.cookies.remove")}} -<pre class="brush: js">function onRemoved(cookie) { +## Exemples + +Cet exemple tente de supprimer le cookie nommĂ© "favourite-colour", dont l'URL correspond Ă l'URL du document hĂ©bergĂ© par l'onglet actuellement actif : + +```js +function onRemoved(cookie) { console.log(`Removed: ${cookie}`); } @@ -75,19 +74,18 @@ function removeCookie(tabs) { } var getActive = browser.tabs.query({active: true, currentWindow: true}); -getActive.then(removeCookie);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +getActive.then(removeCookie); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/cookies"><code>chrome.cookies</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json"><code>cookies.json</code></a> dans le code Chromium.</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.cookies`](https://developer.chrome.com/extensions/cookies). Cette documentation est dĂ©rivĂ©e de [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -114,5 +112,4 @@ getActive.then(removeCookie);</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/cookies/samesitestatus/index.md b/files/fr/mozilla/add-ons/webextensions/api/cookies/samesitestatus/index.md index d52a8c54a5..a24d2d819a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/cookies/samesitestatus/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/cookies/samesitestatus/index.md @@ -13,23 +13,19 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/SameSiteStatus --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div></div> +Le type `SameSiteStatus` de l'API {{WebExtAPIRef("cookies")}} reprĂ©sente des informations sur l'Ă©tat `SameSite` d'un cookie. -<p>Le type <code>SameSiteStatus</code> de l'API {{WebExtAPIRef("cookies")}} reprĂ©sente des informations sur l'Ă©tat <code>SameSite</code> d'un cookie.</p> +## Type -<h2 id="Type">Type</h2> +Les valeurs de ce type sont des chaĂźnes de caractĂšres. Les valeurs possibles sont : -<p>Les valeurs de ce type sont des chaĂźnes de caractĂšres. Les valeurs possibles sont :</p> +- `no_restriction` + - : ReprĂ©sente un ensemble de cookies sans attribut `SameSite`. +- `lax` + - : Correspond au `SameSite=Lax` +- `strict` + - : Correspond Ă un ensemble de tĂ©moins avec `SameSite=Strict` -<dl> - <dt><code>no_restriction</code></dt> - <dd>ReprĂ©sente un ensemble de cookies sans attribut <code>SameSite</code>.</dd> - <dt><code>lax</code></dt> - <dd>Correspond au <code>SameSite=Lax</code></dd> - <dt><code>strict</code></dt> - <dd>Correspond Ă un ensemble de tĂ©moins avec <code>SameSite=Strict</code></dd> -</dl> - -<p>Voir les <a href="/fr/docs/Web/HTTP/Cookies">cookies HTTP</a> pour plus d'informations.</p> +Voir les [cookies HTTP](/fr/docs/Web/HTTP/Cookies) pour plus d'informations. diff --git a/files/fr/mozilla/add-ons/webextensions/api/cookies/set/index.md b/files/fr/mozilla/add-ons/webextensions/api/cookies/set/index.md index 1fbb895651..2b8b8351b3 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/cookies/set/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/cookies/set/index.md @@ -13,63 +13,63 @@ tags: - set translation_of: Mozilla/Add-ons/WebExtensions/API/cookies/set --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La mĂ©thode <strong><code>set()</code></strong> de l'API {{WebExtAPIRef("cookies")}} dĂ©finit un cookie contenant des donnĂ©es prĂ©cises de cookie. Cette mĂ©thode Ă©quivaut Ă l'Ă©mission d'un en-tĂȘte HTTP <code>Set-Cookie</code> lors d'une requĂȘte Ă une URL donnĂ©e.</p> +La mĂ©thode **`set()`** de l'API {{WebExtAPIRef("cookies")}} dĂ©finit un cookie contenant des donnĂ©es prĂ©cises de cookie. Cette mĂ©thode Ă©quivaut Ă l'Ă©mission d'un en-tĂȘte HTTP `Set-Cookie` lors d'une requĂȘte Ă une URL donnĂ©e. -<p>L'appel rĂ©ussit uniquement si vous incluez la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission de l'API</a> "cookies" dans votre fichier <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a>, ainsi que les <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions d'hĂŽte</a> pour l'URL indiquĂ©e dans son manifest. LâURL donnĂ©e a Ă©galement besoin des permissions nĂ©cessaires pour crĂ©er un cookie avec les paramĂštres donnĂ©s.</p> +L'appel rĂ©ussit uniquement si vous incluez la [permission de l'API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "cookies" dans votre fichier [manifest.json](/fr/Add-ons/WebExtensions/manifest.json), ainsi que les [permissions d'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) pour l'URL indiquĂ©e dans son manifest. LâURL donnĂ©e a Ă©galement besoin des permissions nĂ©cessaires pour crĂ©er un cookie avec les paramĂštres donnĂ©s. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 setting = browser.cookies.set( +```js +var setting = browser.cookies.set( details // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>details</code></dt> - <dd>Un <code>objet</code> contenant les dĂ©tails du cookie que vous souhaitez dĂ©finir. Il peut avoir les propriĂ©tĂ©s suivantes :</dd> - <dt><code>domain</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le domaine du cookie. Sâil est omis, le cookie devient un cookie hĂŽte uniquement.</dd> - <dt><code>expirationDate</code>{{optional_inline}}</dt> - <dd>Un <code>nombre</code> qui reprĂ©sente la date d'expiration du cookie en tant que nombre de secondes Ă©coulĂ©es depuis l'Ă©poque UNIX. Sâil est omis, le cookie devient un cookie de session.</dd> - <dt><code>firstPartyDomain</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le domaine de premiĂšre partie avec lequel le cookie sera associĂ©. Cette propriĂ©tĂ© doit ĂȘtre fournie si l'isolation de la premiĂšre partie est activĂ©e sur le navigateur. Voir <a href="/fr/Add-ons/WebExtensions/API/cookies#Isolement_de_la_premiĂšre_partie">Isolement de la premiĂšre partie</a>.</dd> - <dt><code>httpOnly</code>{{optional_inline}}</dt> - <dd>Un <code>boolĂ©en</code> qui spĂ©cifie si le cookie doit ĂȘtre marquĂ© comme HttpOnly (<code>true</code>), ou pas (false). Sâil est omis, la valeur par dĂ©faut est <code>false</code>.</dd> - <dt><code>name</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le nom du cookie. Sâil est omis, il est vide par dĂ©faut.</dd> - <dt><code>path</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant le chemin du cookie. Sâil est omis, la valeur par dĂ©faut est la partie du chemin du paramĂštre de l'URL.</dd> - <dt><code>sameSite{{optional_inline}}</code></dt> - <dd>Une valeur {{WebExtAPIRef("cookies.SameSiteStatus")}} qui indique lâĂ©tat SameSite du cookie. Si omis, la valeur par dĂ©faut 0, 'no_restriction'.</dd> - <dt><code>secure</code>{{optional_inline}}</dt> - <dd>Un <code>boolĂ©en</code> qui spĂ©cifie si le cookie doit ĂȘtre marquĂ© comme sĂ©curisĂ© (<code>true</code>), ou pas (false). Sâil est omis, la valeur par dĂ©faut est <code>false</code>.</dd> - <dt><code>storeId</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant lâID du cookie store dans lequel dĂ©fini le cookie. Sâil est omiS, le cookie est dĂ©fini par dĂ©faut dans le cookie store du contexte d'exĂ©cution actuel.</dd> - <dt><code>url</code></dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant l'URI de requĂȘte Ă associer au cookie. Cette valeur peut affecter les valeurs par dĂ©faut du cookie crĂ©Ă©. Si les autorisations d'hĂŽte pour cette URL ne sont pas spĂ©cifiĂ©es dans le fichier manifest, lâappel de la mĂ©thode Ă©chouera.</dd> - <dt><code>value</code>{{optional_inline}}</dt> - <dd>Une <code>chaĂźne</code> reprĂ©sentant la valeur du cookie. Sâil est omis, câest vide par dĂ©faut.</dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet {{WebExtAPIRef('cookies.Cookie')}} contenant les dĂ©tails sur le cookie qui a Ă©tĂ© dĂ©fini. Si l'appel Ă©choue pour une quelconque raison, la promesse sera rejetĂ©e avec un message dâerreur.</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.cookies.set")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Cet exemple dĂ©finit un cookie pour le document hĂ©bergĂ© par l'onglet actuellement actif :</p> - -<pre class="brush: js">var getActive = browser.tabs.query({active: true, currentWindow: true}); +``` + +### ParamĂštres + +- `details` + - : Un `objet` contenant les dĂ©tails du cookie que vous souhaitez dĂ©finir. Il peut avoir les propriĂ©tĂ©s suivantes : +- `domain`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant le domaine du cookie. Sâil est omis, le cookie devient un cookie hĂŽte uniquement. +- `expirationDate`{{optional_inline}} + - : Un `nombre` qui reprĂ©sente la date d'expiration du cookie en tant que nombre de secondes Ă©coulĂ©es depuis l'Ă©poque UNIX. Sâil est omis, le cookie devient un cookie de session. +- `firstPartyDomain`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant le domaine de premiĂšre partie avec lequel le cookie sera associĂ©. Cette propriĂ©tĂ© doit ĂȘtre fournie si l'isolation de la premiĂšre partie est activĂ©e sur le navigateur. Voir [Isolement de la premiĂšre partie](/fr/Add-ons/WebExtensions/API/cookies#Isolement_de_la_premiĂšre_partie). +- `httpOnly`{{optional_inline}} + - : Un `boolĂ©en` qui spĂ©cifie si le cookie doit ĂȘtre marquĂ© comme HttpOnly (`true`), ou pas (false). Sâil est omis, la valeur par dĂ©faut est `false`. +- `name`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant le nom du cookie. Sâil est omis, il est vide par dĂ©faut. +- `path`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant le chemin du cookie. Sâil est omis, la valeur par dĂ©faut est la partie du chemin du paramĂštre de l'URL. +- `sameSite{{optional_inline}}` + - : Une valeur {{WebExtAPIRef("cookies.SameSiteStatus")}} qui indique lâĂ©tat SameSite du cookie. Si omis, la valeur par dĂ©faut 0, 'no_restriction'. +- `secure`{{optional_inline}} + - : Un `boolĂ©en` qui spĂ©cifie si le cookie doit ĂȘtre marquĂ© comme sĂ©curisĂ© (`true`), ou pas (false). Sâil est omis, la valeur par dĂ©faut est `false`. +- `storeId`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant lâID du cookie store dans lequel dĂ©fini le cookie. Sâil est omiS, le cookie est dĂ©fini par dĂ©faut dans le cookie store du contexte d'exĂ©cution actuel. +- `url` + - : Une `chaĂźne` reprĂ©sentant l'URI de requĂȘte Ă associer au cookie. Cette valeur peut affecter les valeurs par dĂ©faut du cookie crĂ©Ă©. Si les autorisations d'hĂŽte pour cette URL ne sont pas spĂ©cifiĂ©es dans le fichier manifest, lâappel de la mĂ©thode Ă©chouera. +- `value`{{optional_inline}} + - : Une `chaĂźne` reprĂ©sentant la valeur du cookie. Sâil est omis, câest vide par dĂ©faut. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef('cookies.Cookie')}} contenant les dĂ©tails sur le cookie qui a Ă©tĂ© dĂ©fini. Si l'appel Ă©choue pour une quelconque raison, la promesse sera rejetĂ©e avec un message dâerreur. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.cookies.set")}} + +## Exemples + +Cet exemple dĂ©finit un cookie pour le document hĂ©bergĂ© par l'onglet actuellement actif : + +```js +var getActive = browser.tabs.query({active: true, currentWindow: true}); getActive.then(setCookie); function setCookie(tabs) { @@ -79,19 +79,17 @@ function setCookie(tabs) { value: "red" }); } -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.cookies`](https://developer.chrome.com/extensions/cookies). Cette documentation est dĂ©rivĂ©e de [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/cookies"><code>chrome.cookies</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json"><code>cookies.json</code></a> dans le code Chromium.</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 @@ -118,5 +116,4 @@ function setCookie(tabs) { // 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/devtools/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/index.md index 70c32fc4f4..c20574d11a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/index.md @@ -12,36 +12,32 @@ tags: - devtools.panels translation_of: Mozilla/Add-ons/WebExtensions/API/devtools --- -<p>{{AddonSidebar}}</p> +{{AddonSidebar}} -<p>Permet aux extensions d'interagir avec le {{Glossary("Developer Tools")}} du navigateur. Vous pouvez utiliser cette API pour crĂ©er des pages d'outils de dĂ©veloppement, interagir avec la fenĂȘtre qui est inspectĂ©e, inspecter l'utilisation du rĂ©seau de pages.</p> +Permet aux extensions d'interagir avec le {{Glossary("Developer Tools")}} du navigateur. Vous pouvez utiliser cette API pour crĂ©er des pages d'outils de dĂ©veloppement, interagir avec la fenĂȘtre qui est inspectĂ©e, inspecter l'utilisation du rĂ©seau de pages. -<p>Pour utiliser cette API, vous devez disposer de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission API</a> <code>"devtools"</code> spĂ©cifiĂ©e dans votre fichier <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json">manifest.json</a>. Cette permission ne peut pas ĂȘtre facultative.</p> +Pour utiliser cette API, vous devez disposer de la [permission API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) `"devtools"` spĂ©cifiĂ©e dans votre fichier [manifest.json](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json). Cette permission ne peut pas ĂȘtre facultative. -<h2 id="Interfaces">Interfaces</h2> +## Interfaces -<dl> - <dt>{{WebExtAPIRef("devtools.inspectedWindow")}}</dt> - <dd>Interagir avec la fenĂȘtre Ă laquelle les outils de dĂ©veloppement sont attachĂ©s (fenĂȘtre inspectĂ©e). Cela inclut l'obtention de l'onglet ID pour la page inspectĂ©e, l'Ă©valuation du code dans le contexte de la fenĂȘtre inspectĂ©e, le rechargement de la page ou l'obtention de la liste des ressources dans la page.</dd> - <dt>{{WebExtAPIRef("devtools.network")}}</dt> - <dd>Obtenir des informations sur les requĂȘtes de rĂ©seau associĂ©es Ă la fenĂȘtre Ă laquelle les outils de dĂ©veloppement sont attachĂ©s (la fenĂȘtre inspectĂ©e).</dd> - <dt>{{WebExtAPIRef("devtools.panels")}}</dt> - <dd>CrĂ©er des panneaux d'interface utilisateur qui seront affichĂ©s dans les outils de dĂ©veloppement de l'agent utilisateur.</dd> -</dl> +- {{WebExtAPIRef("devtools.inspectedWindow")}} + - : Interagir avec la fenĂȘtre Ă laquelle les outils de dĂ©veloppement sont attachĂ©s (fenĂȘtre inspectĂ©e). Cela inclut l'obtention de l'onglet ID pour la page inspectĂ©e, l'Ă©valuation du code dans le contexte de la fenĂȘtre inspectĂ©e, le rechargement de la page ou l'obtention de la liste des ressources dans la page. +- {{WebExtAPIRef("devtools.network")}} + - : Obtenir des informations sur les requĂȘtes de rĂ©seau associĂ©es Ă la fenĂȘtre Ă laquelle les outils de dĂ©veloppement sont attachĂ©s (la fenĂȘtre inspectĂ©e). +- {{WebExtAPIRef("devtools.panels")}} + - : CrĂ©er des panneaux d'interface utilisateur qui seront affichĂ©s dans les outils de dĂ©veloppement de l'agent utilisateur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools")}}</p> +{{Compat("webextensions.api.devtools")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ© sur l'API [`chrome.downloads`](https://developer.chrome.com/extensions/downloads) de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ© sur l'API <a href="https://developer.chrome.com/extensions/downloads"><code>chrome.downloads</code></a> de Chromium.</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 @@ -68,5 +64,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/devtools // 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/devtools/inspectedwindow/eval/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/eval/index.md index b0a63e7c22..e8b8329c9e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/eval/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/eval/index.md @@ -12,95 +12,87 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow/eval original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow/eval --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>ExĂ©cute JavaScript dans la fenĂȘtre Ă laquelle les devtools sont attachĂ©s.</p> +ExĂ©cute JavaScript dans la fenĂȘtre Ă laquelle les devtools sont attachĂ©s. -<p>C'est un peu comme utiliser {{WebExtAPIRef("tabs.executeScript()")}} pour joindre un script de contenu, mais avec deux diffĂ©rences principales:</p> +C'est un peu comme utiliser {{WebExtAPIRef("tabs.executeScript()")}} pour joindre un script de contenu, mais avec deux diffĂ©rences principales: -<p>Tout d'abord, le JavaScript peut utiliser un ensemble de <a href="#Helpers">commandes spĂ©ciales que les navigateurs fournissent gĂ©nĂ©ralement dans leur implĂ©mentation de console devtools </a>: par exemple, en utilisant "$0" pour designer l'Ă©lĂ©ment actuellement sĂ©lectionnĂ© dans l'inspecteur.</p> +Tout d'abord, le JavaScript peut utiliser un ensemble de [commandes spĂ©ciales que les navigateurs fournissent gĂ©nĂ©ralement dans leur implĂ©mentation de console devtools ](#Helpers): par exemple, en utilisant "$0" pour designer l'Ă©lĂ©ment actuellement sĂ©lectionnĂ© dans l'inspecteur. -<p>DeuxiĂšmement, le JavaScript que vous exĂ©cutez peut voir les modifications apportĂ©es Ă la page par des scripts que la page a chargĂ©s. Cela contraste avec les scripts de contenu, qui voient la page <a href="/fr/Add-ons/WebExtensions/Content_scripts#DOM_access">telle qu'elle existerait si aucun script de page n'Ă©tait pas chargĂ©</a>. Cependant, notez que l'isolement fourni par les scripts de contenu est une fonction de sĂ©curitĂ© dĂ©libĂ©rĂ©e, destinĂ©e Ă rendre plus difficile la confusion ou la subversion des WebExtensions par des pages web malveillantes ou simplement non coopĂ©ratives en redĂ©finissant les fonctions et les propriĂ©tĂ©s du DOM. Cela signifie que vous devez ĂȘtre trĂšs prudent si vous renoncez Ă cette protection en utilisant eval(), et devrait utiliser les scripts de contenu, sauf si vous devez utiliser eval().</p> +DeuxiĂšmement, le JavaScript que vous exĂ©cutez peut voir les modifications apportĂ©es Ă la page par des scripts que la page a chargĂ©s. Cela contraste avec les scripts de contenu, qui voient la page [telle qu'elle existerait si aucun script de page n'Ă©tait pas chargĂ©](/fr/Add-ons/WebExtensions/Content_scripts#DOM_access). Cependant, notez que l'isolement fourni par les scripts de contenu est une fonction de sĂ©curitĂ© dĂ©libĂ©rĂ©e, destinĂ©e Ă rendre plus difficile la confusion ou la subversion des WebExtensions par des pages web malveillantes ou simplement non coopĂ©ratives en redĂ©finissant les fonctions et les propriĂ©tĂ©s du DOM. Cela signifie que vous devez ĂȘtre trĂšs prudent si vous renoncez Ă cette protection en utilisant eval(), et devrait utiliser les scripts de contenu, sauf si vous devez utiliser eval(). -<p>Le script est Ă©valuĂ© par dĂ©faut dans le cadre principal de la page. Le script doit Ă©valuer une valeur qui peut ĂȘtre reprĂ©sentĂ©e comme JSON (ce qui signifie que, par exemple, il peut ne pas Ă©valuer une fonction ou un objet contenant des fonctions). Par dĂ©faut, le script ne voit pas les scripts de contenu attachĂ©s Ă la page.</p> +Le script est Ă©valuĂ© par dĂ©faut dans le cadre principal de la page. Le script doit Ă©valuer une valeur qui peut ĂȘtre reprĂ©sentĂ©e comme JSON (ce qui signifie que, par exemple, il peut ne pas Ă©valuer une fonction ou un objet contenant des fonctions). Par dĂ©faut, le script ne voit pas les scripts de contenu attachĂ©s Ă la page. -<p>Vous ne pouvez pas appeler eval() sur les fenĂȘtres de navigateur privilĂ©giĂ©es telles que "about: addons".</p> +Vous ne pouvez pas appeler eval() sur les fenĂȘtres de navigateur privilĂ©giĂ©es telles que "about: addons". -<p>Vous pouvez Ă©ventuellement fournir un paramĂštre d'options, qui comprend des options pour Ă©valuer le script dans une image diffĂ©rente ou dans le contexte des scripts de contenu attachĂ©s. Notez que Firefox ne supporte pas encore le paramĂštre d'options.</p> +Vous pouvez Ă©ventuellement fournir un paramĂštre d'options, qui comprend des options pour Ă©valuer le script dans une image diffĂ©rente ou dans le contexte des scripts de contenu attachĂ©s. Notez que Firefox ne supporte pas encore le paramĂštre d'options. -<p>La fonction eval() renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui rĂ©sout le rĂ©sultat Ă©valuĂ© du script ou une erreur.</p> +La fonction eval() renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui rĂ©sout le rĂ©sultat Ă©valuĂ© du script ou une erreur. -<h2 id="Aides">Aides</h2> +## Aides -<p>Le script accĂšde Ă un certain nombre d'objets qui aident le script injectĂ© Ă interagir avec les outils du dĂ©veloppeur. Les assistants suivants sont actuellement pris en charge:</p> +Le script accĂšde Ă un certain nombre d'objets qui aident le script injectĂ© Ă interagir avec les outils du dĂ©veloppeur. Les assistants suivants sont actuellement pris en charge: -<dl> - <dt><code>$0</code></dt> - <dd>Contient une rĂ©fĂ©rence Ă l'Ă©lĂ©ment actuellement sĂ©lectionnĂ© dans l'inspecteur Devtools.</dd> - <dt><code>inspect()</code></dt> - <dd>Etant donnĂ© un objet, s'il s'agit d'un Ă©lĂ©ment DOM dans la page, sĂ©lectionnez-le dans l'inspecteur devtools, sinon il crĂ©e un aperçu de l'objet dans la webconsole.</dd> -</dl> +- `$0` + - : Contient une rĂ©fĂ©rence Ă l'Ă©lĂ©ment actuellement sĂ©lectionnĂ© dans l'inspecteur Devtools. +- `inspect()` + - : Etant donnĂ© un objet, s'il s'agit d'un Ă©lĂ©ment DOM dans la page, sĂ©lectionnez-le dans l'inspecteur devtools, sinon il crĂ©e un aperçu de l'objet dans la webconsole. -<p><a href="#Examples">Voir quelques exemples.</a></p> +[Voir quelques exemples.](#Examples) -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var evaluating = browser.devtools.inspectedWindow.eval( +```js +var evaluating = browser.devtools.inspectedWindow.eval( expression, // string options // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>expression</code></dt> - <dd><code>string</code>. L'expression JavaScript Ă Ă©valuer. La chaĂźne doit Ă©valuer un objet qui peut ĂȘtre reprĂ©sentĂ© comme JSON, ou une exception sera lancĂ©e. Par exemple, l'expression ne doit pas Ă©valuer une fonction.</dd> - <dt><code>options</code>{{optional_inline}}</dt> - <dd><p><code>object</code>. Options pour la fonction  (Notez que Firefox ne supporte pas encore cette option), comme suit :</p> - <dl> - <dt><code>frameURL</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'URL du cadre dans lequel Ă Ă©valuer l'expression. Si cela est supprimĂ©, l'expression est Ă©valuĂ©e dans la trame principale de la fenĂȘtre.</dd> - <dt><code>useContentScriptContext</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si c'est vrai, Ă©valuez l'expression dans le contexte des scripts de contenu que cette extension a attachĂ©e Ă la page. Si vous dĂ©finissez cette option, vous devez d'abord attacher certains scripts de contenu Ă la page ou une erreur Devtools sera lancĂ©e.</dd> - <dt><code>contextSecurityOrigin</code> {{optional_inline}}</dt> - <dd><code>string</code>. Evaluez l'expression dans le contexte d'un script de contenu attachĂ© par une extension diffĂ©rente, dont l'origine correspond Ă la valeur donnĂ©e ici. Ces remplacements sont <code>useContentScriptContext</code>.</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un tableau contenant deux Ă©lĂ©ments.</p> - -<p>Si aucune erreur n'est survenue, l'Ă©lĂ©ment 0 contiendra le rĂ©sultat de l'Ă©valuation de l'expression et l'Ă©lĂ©ment 1 sera indĂ©fini.</p> - -<p>Si une erreur s'est produite, l'Ă©lĂ©ment 0 sera indĂ©fini et l'Ă©lĂ©ment 1 contiendra un objet donnant des dĂ©tails sur l'erreur. Deux types diffĂ©rents d'erreurs sont distinguĂ©s :</p> - -<ul> - <li>Des erreurs rencontrĂ©es lors de l'Ă©valuation du JavaScript (par exemple, des erreurs de syntaxe dans l'expression). Dans ce cas, l'Ă©lĂ©ment 1 contiendra : - <ul> - <li>Une propriĂ©tĂ© boolean isException, dĂ©finie sur true</li> - <li>Une valeur de propriĂ©tĂ© de chaĂźne, en donnant plus de dĂ©tails.</li> - </ul> - </li> - <li>D'autres erreurs (par exemple, une expression qui Ă©value sur un objet qui ne peut pas ĂȘtre reprĂ©sentĂ© comme JSON). Dans ce cas, l'Ă©lĂ©ment 1 contiendra: - <ul> - <li>Une propriĂ©tĂ© boolĂ©enne isError, dĂ©finie sur true</li> - <li>Un code de propriĂ©tĂ© de chaĂźne contenant un code d'erreur.</li> - </ul> - </li> -</ul> - -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> - -<p>{{Compat("webextensions.api.devtools.inspectedWindow.eval")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Ceci teste si jQuery est dĂ©fini dans la fenĂȘtre inspectĂ©e et enregistre le rĂ©sultat. Notez que cela ne fonctionnerait pas dans un script de contenu, car mĂȘme si jQuery Ă©tait dĂ©fini, le script de contenu ne le verrait pas.</p> - -<pre class="brush: js">function handleError(error) { +``` + +### ParamĂštres + +- `expression` + - : `string`. L'expression JavaScript Ă Ă©valuer. La chaĂźne doit Ă©valuer un objet qui peut ĂȘtre reprĂ©sentĂ© comme JSON, ou une exception sera lancĂ©e. Par exemple, l'expression ne doit pas Ă©valuer une fonction. +- `options`{{optional_inline}} + + - : `object`. Options pour la fonction  (Notez que Firefox ne supporte pas encore cette option), comme suit : + + - `frameURL`{{optional_inline}} + - : `string`. L'URL du cadre dans lequel Ă Ă©valuer l'expression. Si cela est supprimĂ©, l'expression est Ă©valuĂ©e dans la trame principale de la fenĂȘtre. + - `useContentScriptContext`{{optional_inline}} + - : `boolean`. Si c'est vrai, Ă©valuez l'expression dans le contexte des scripts de contenu que cette extension a attachĂ©e Ă la page. Si vous dĂ©finissez cette option, vous devez d'abord attacher certains scripts de contenu Ă la page ou une erreur Devtools sera lancĂ©e. + - `contextSecurityOrigin` {{optional_inline}} + - : `string`. Evaluez l'expression dans le contexte d'un script de contenu attachĂ© par une extension diffĂ©rente, dont l'origine correspond Ă la valeur donnĂ©e ici. Ces remplacements sont `useContentScriptContext`. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un tableau contenant deux Ă©lĂ©ments. + +Si aucune erreur n'est survenue, l'Ă©lĂ©ment 0 contiendra le rĂ©sultat de l'Ă©valuation de l'expression et l'Ă©lĂ©ment 1 sera indĂ©fini. + +Si une erreur s'est produite, l'Ă©lĂ©ment 0 sera indĂ©fini et l'Ă©lĂ©ment 1 contiendra un objet donnant des dĂ©tails sur l'erreur. Deux types diffĂ©rents d'erreurs sont distinguĂ©s : + +- Des erreurs rencontrĂ©es lors de l'Ă©valuation du JavaScript (par exemple, des erreurs de syntaxe dans l'expression). Dans ce cas, l'Ă©lĂ©ment 1 contiendra : + + - Une propriĂ©tĂ© boolean isException, dĂ©finie sur true + - Une valeur de propriĂ©tĂ© de chaĂźne, en donnant plus de dĂ©tails. + +- D'autres erreurs (par exemple, une expression qui Ă©value sur un objet qui ne peut pas ĂȘtre reprĂ©sentĂ© comme JSON). Dans ce cas, l'Ă©lĂ©ment 1 contiendra: + + - Une propriĂ©tĂ© boolĂ©enne isError, dĂ©finie sur true + - Un code de propriĂ©tĂ© de chaĂźne contenant un code d'erreur. + +## CompatibilitĂ© des navigateurs + +{{Compat("webextensions.api.devtools.inspectedWindow.eval")}} + +## Exemples + +Ceci teste si jQuery est dĂ©fini dans la fenĂȘtre inspectĂ©e et enregistre le rĂ©sultat. Notez que cela ne fonctionnerait pas dans un script de contenu, car mĂȘme si jQuery Ă©tait dĂ©fini, le script de contenu ne le verrait pas. + +```js +function handleError(error) { if (error.isError) { console.log(`Devtools error: ${error.code}`); } else { @@ -119,16 +111,18 @@ function handleResult(result) { const checkjQuery = "typeof jQuery != 'undefined'"; -evalButton.addEventListener("click", () => { +evalButton.addEventListener("click", () => { browser.devtools.inspectedWindow.eval(checkjQuery) .then(handleResult); -});</pre> +}); +``` -<h3 id="Exemples_d'aide">Exemples d'aide</h3> +### Exemples d'aide -<p>Cela utilise l'aide de <code>$0</code> pour dĂ©finir la couleur d'arriĂšre-plan de l'Ă©lĂ©ment, actuellement sĂ©lectionnĂ© dans l'inspecteur :</p> +Cela utilise l'aide de `$0` pour dĂ©finir la couleur d'arriĂšre-plan de l'Ă©lĂ©ment, actuellement sĂ©lectionnĂ© dans l'inspecteur : -<pre class="brush: js">const evalButton = document.querySelector("#reddinate"); +```js +const evalButton = document.querySelector("#reddinate"); const evalString = "$0.style.backgroundColor = 'red'"; function handleError(error) { @@ -145,15 +139,16 @@ function handleResult(result) { } } -evalButton.addEventListener("click", () => { +evalButton.addEventListener("click", () => { browser.devtools.inspectedWindow.eval(evalString) .then(handleResult); }); -</pre> +``` -<p>Cela utilise l'assistant l'inspection() pour sĂ©lectionner le premier Ă©lĂ©ment <h1> dans la page:</p> +Cela utilise l'assistant l'inspection() pour sĂ©lectionner le premier Ă©lĂ©ment \<h1> dans la page: -<pre class="brush: js">const inspectButton = document.querySelector("#inspect"); +```js +const inspectButton = document.querySelector("#inspect"); const inspectString = "inspect(document.querySelector('h1'))"; function handleError(error) { @@ -170,23 +165,21 @@ function handleResult(result) { } } -inspectButton.addEventListener("click", () => { +inspectButton.addEventListener("click", () => { browser.devtools.inspectedWindow.eval(inspectString) .then(handleResult); }); -</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/devtools"><code>chrome.devtools</code></a>.</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.devtools`](https://developer.chrome.com/extensions/devtools). +> +> 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 @@ -213,5 +206,4 @@ inspectButton.addEventListener("click", () => { // 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/devtools/inspectedwindow/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/index.md index ed589e5b7c..9109f49f92 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/index.md @@ -11,73 +11,36 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<div class="note"> -<p><strong>Note :</strong> Cette page dĂ©crit les API de dĂ©veloppement de WebExtensions telles qu'elles existent dans Firefox 54. Bien que les API soient basĂ©es sur les <a href="https://developer.chrome.com/extensions/devtools">APIs de devtools de Chrome</a>, il existe encore de nombreuses fonctionnalitĂ©s qui ne sont pas encore implĂ©mentĂ©es dans Firefox et ne sont donc pas documentĂ©es ici. Pour voir les fonctionnalitĂ©s actuellement manquantes, regarder <a href="/fr/Add-ons/WebExtensions/Using_the_devtools_APIs#Limitations_of_the_devtools_APIs">Limitations des APIs devtools</a>.</p> -</div> +> **Note :** Cette page dĂ©crit les API de dĂ©veloppement de WebExtensions telles qu'elles existent dans Firefox 54. Bien que les API soient basĂ©es sur les [APIs de devtools de Chrome](https://developer.chrome.com/extensions/devtools), il existe encore de nombreuses fonctionnalitĂ©s qui ne sont pas encore implĂ©mentĂ©es dans Firefox et ne sont donc pas documentĂ©es ici. Pour voir les fonctionnalitĂ©s actuellement manquantes, regarder [Limitations des APIs devtools](/fr/Add-ons/WebExtensions/Using_the_devtools_APIs#Limitations_of_the_devtools_APIs). -<p>L'API <code>devtools.inspectedWindow</code> permet Ă un extension de devtools d'interagir avec la fenĂȘtre sur laquelle les outils de dĂ©veloppement sont attachĂ©s.</p> +L'API `devtools.inspectedWindow` permet Ă un extension de devtools d'interagir avec la fenĂȘtre sur laquelle les outils de dĂ©veloppement sont attachĂ©s. -<p>Comme toutes les APIs de <code>devtools</code>, cette API n'est disponible que pour exĂ©cuter le code dans le document dĂ©fini dans la clĂ© <a href="/fr/Add-ons/WebExtensions/manifest.json/devtools_page">devtools_page</a> du manifest.json, oĂč dans d'autres documents devtools crĂ©Ă©s par l'extension (tels que le document hĂ©bergĂ© par un panneau, l'extension crĂ©Ă©e). Voir <a href="/fr/Add-ons/WebExtensions/Extending_the_developer_tools">Extension des outils de dĂ©veloppement </a> pour plus d'informations.</p> +Comme toutes les APIs de `devtools`, cette API n'est disponible que pour exĂ©cuter le code dans le document dĂ©fini dans la clĂ© [devtools_page](/fr/Add-ons/WebExtensions/manifest.json/devtools_page) du manifest.json, oĂč dans d'autres documents devtools crĂ©Ă©s par l'extension (tels que le document hĂ©bergĂ© par un panneau, l'extension crĂ©Ă©e). Voir [Extension des outils de dĂ©veloppement ](/fr/Add-ons/WebExtensions/Extending_the_developer_tools) pour plus d'informations. -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> +## PropriĂ©tĂ©s -<dl> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.inspectedWindow/tabId">devtools.inspectedWindow.tabId</a></code></dt> - <dd>L'ID de la fenĂȘtre sur laquelle sont attachĂ©s les outils du dĂ©veloppeur.</dd> -</dl> +- [`devtools.inspectedWindow.tabId`](/fr/Add-ons/WebExtensions/API/devtools.inspectedWindow/tabId) + - : L'ID de la fenĂȘtre sur laquelle sont attachĂ©s les outils du dĂ©veloppeur. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.inspectedWindow/eval">devtools.inspectedWindow.eval()</a></code></dt> - <dd>Evaluez certains JavaScript dans la fenĂȘtre de destination.</dd> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.inspectedWindow/reload">devtools.inspectedWindow.reload()</a></code></dt> - <dd>Rechargez le document de la fenĂȘtre destination.</dd> -</dl> +- [`devtools.inspectedWindow.eval()`](/fr/Add-ons/WebExtensions/API/devtools.inspectedWindow/eval) + - : Evaluez certains JavaScript dans la fenĂȘtre de destination. +- [`devtools.inspectedWindow.reload()`](/fr/Add-ons/WebExtensions/API/devtools.inspectedWindow/reload) + - : Rechargez le document de la fenĂȘtre destination. -<h2 id="ComptatibilitĂ©_navigateur">ComptatibilitĂ© navigateur</h2> +## ComptatibilitĂ© navigateur -<p>{{Compat("webextensions.api.devtools.inspectedWindow")}}</p> +{{Compat("webextensions.api.devtools.inspectedWindow")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.inspectedWindow`](https://developer.chrome.com/extensions/devtools_inspectedWindow). +> +> 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="note"><p><strong>Note :</strong></p> - -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/devtools_inspectedWindow"><code>chrome.devtools.inspectedWindow</code></a>.</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"> -<p>// Copyright 2015 The Chromium Authors. All rights reserved.<br> - //<br> - // Redistribution and use in source and binary forms, with or without<br> - // modification, are permitted provided that the following conditions are<br> - // met:<br> - //<br> - //   * Redistributions of source code must retain the above copyright<br> - // notice, this list of conditions and the following disclaimer.<br> - //   * Redistributions in binary form must reproduce the above<br> - // copyright notice, this list of conditions and the following disclaimer<br> - // in the documentation and/or other materials provided with the<br> - // distribution.<br> - //   * Neither the name of Google Inc. nor the names of its<br> - // contributors may be used to endorse or promote products derived from<br> - // this software without specific prior written permission.<br> - //<br> - // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS<br> - // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT<br> - // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR<br> - // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT<br> - // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,<br> - // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT<br> - // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,<br> - // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY<br> - // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT<br> - // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE<br> - // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p> -</div> +<div class="hidden"><p>// Copyright 2015 The Chromium Authors. All rights reserved.<br>//<br>// Redistribution and use in source and binary forms, with or without<br>// modification, are permitted provided that the following conditions are<br>// met:<br>//<br>//   * Redistributions of source code must retain the above copyright<br>// notice, this list of conditions and the following disclaimer.<br>//   * Redistributions in binary form must reproduce the above<br>// copyright notice, this list of conditions and the following disclaimer<br>// in the documentation and/or other materials provided with the<br>// distribution.<br>//   * Neither the name of Google Inc. nor the names of its<br>// contributors may be used to endorse or promote products derived from<br>// this software without specific prior written permission.<br>//<br>// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS<br>// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT<br>// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR<br>// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT<br>// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,<br>// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT<br>// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,<br>// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY<br>// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT<br>// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE<br>// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/reload/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/reload/index.md index ee1076553c..d615cc7ff6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/reload/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/reload/index.md @@ -12,62 +12,59 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow/reload original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow/reload --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Recharge la fenĂȘtre Ă laquelle les devtools sont attachĂ©s.</p> +Recharge la fenĂȘtre Ă laquelle les devtools sont attachĂ©s. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.devtools.inspectedWindow.reload( +```js +browser.devtools.inspectedWindow.reload( reloadOptions // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>reloadOptions</code>{{optional_inline}}</dt> - <dd><p><code>object</code>. Options pour la fonction, comme suit</p> - <dl> - <dt><code>ignoreCache</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. S'il est vrai, cela fait que le rechargement ignore le cache du navigateur (comme si l'utilisateur avait appuyĂ© sur Shift+Ctrl+R).</dd> - <dt><code>userAgent</code>{{optional_inline}}</dt> - <dd><code>string</code>. DĂ©finissez un agent utilisateur personnalisĂ© pour la page. Ici, la chaĂźne fournie sera envoyĂ©e dans l'en-tĂȘte de l'<a href="/fr/docs/Web/HTTP/Headers/User-Agent">Agent utilisateur</a>, et sera renvoyĂ©e par les appels Ă <code><a href="/fr/docs/Web/API/NavigatorID/userAgent">navigator.userAgent</a></code> rĂ©alisĂ© par des scripts s'exĂ©cutant sur la page.</dd> - <dt><code>injectedScript</code> {{optional_inline}}</dt> - <dd><code>string</code>. Injectez l'expression JavaScript donnĂ©e dans toutes les images de la page, avant tout autre script.</dd> - </dl> - </dd> -</dl> +- `reloadOptions`{{optional_inline}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : `object`. Options pour la fonction, comme suit -<p>{{Compat("webextensions.api.devtools.inspectedWindow.reload")}}</p> + - `ignoreCache`{{optional_inline}} + - : `boolean`. S'il est vrai, cela fait que le rechargement ignore le cache du navigateur (comme si l'utilisateur avait appuyĂ© sur Shift+Ctrl+R). + - `userAgent`{{optional_inline}} + - : `string`. DĂ©finissez un agent utilisateur personnalisĂ© pour la page. Ici, la chaĂźne fournie sera envoyĂ©e dans l'en-tĂȘte de l'[Agent utilisateur](/fr/docs/Web/HTTP/Headers/User-Agent), et sera renvoyĂ©e par les appels Ă [`navigator.userAgent`](/fr/docs/Web/API/NavigatorID/userAgent) rĂ©alisĂ© par des scripts s'exĂ©cutant sur la page. + - `injectedScript` {{optional_inline}} + - : `string`. Injectez l'expression JavaScript donnĂ©e dans toutes les images de la page, avant tout autre script. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Rechargez la fenĂȘtre inspectĂ©e, dĂ©finissez l'agent utilisateur et injectez un script</p> +{{Compat("webextensions.api.devtools.inspectedWindow.reload")}} -<pre class="brush: js">const reloadButton = document.querySelector("#reload-button"); +## Exemples -reloadButton.addEventListener("click", () => { +Rechargez la fenĂȘtre inspectĂ©e, dĂ©finissez l'agent utilisateur et injectez un script + +```js +const reloadButton = document.querySelector("#reload-button"); + +reloadButton.addEventListener("click", () => { browser.devtools.inspectedWindow.reload({ injectedScript:"alert(navigator.userAgent);", userAgent: "Not a real UA" }); }); -</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/devtools"><code>chrome.devtools</code></a>.</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.devtools`](https://developer.chrome.com/extensions/devtools). +> +> 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 @@ -94,5 +91,4 @@ reloadButton.addEventListener("click", () => { // 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/devtools/inspectedwindow/tabid/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/tabid/index.md index 74bd42ba3b..5e86e96419 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/tabid/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/inspectedwindow/tabid/index.md @@ -12,24 +12,27 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow/tabId original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.inspectedWindow/tabId --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'ID de {{WebExtAPIRef("tabs.Tab", "tab")}} est que cette instance des devtools est jointe, reprĂ©sentĂ© comme un nombre.</p> +L'ID de {{WebExtAPIRef("tabs.Tab", "tab")}} est que cette instance des devtools est jointe, reprĂ©sentĂ© comme un nombre. -<p>Cela peut ĂȘtre envoyĂ© Ă la page de fond de l'extension, de sorte que la page d'arriĂšre plan peut utiliser l'API {{WebExtAPIRef("tabs")}} pour interargir avec l'onglet :</p> +Cela peut ĂȘtre envoyĂ© Ă la page de fond de l'extension, de sorte que la page d'arriĂšre plan peut utiliser l'API {{WebExtAPIRef("tabs")}} pour interargir avec l'onglet : -<pre class="brush: js">// devtools-panel.js +```js +// devtools-panel.js const scriptToAttach = "document.body.innerHTML = 'Hi from the devtools';"; -attachContentScriptButton.addEventListener("click", () => { +attachContentScriptButton.addEventListener("click", () => { browser.runtime.sendMessage({ tabId: browser.devtools.inspectedWindow.tabId, script: scriptToAttach }); -});</pre> +}); +``` -<pre class="brush: js">// background.js +```js +// background.js function handleMessage(request, sender, sendResponse) { browser.tabs.executeScript(request.tabId, { @@ -37,23 +40,22 @@ function handleMessage(request, sender, sendResponse) { }); } -browser.runtime.onMessage.addListener(handleMessage);</pre> +browser.runtime.onMessage.addListener(handleMessage); +``` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.inspectedWindow.tabId")}}</p> +{{Compat("webextensions.api.devtools.inspectedWindow.tabId")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools`](https://developer.chrome.com/extensions/devtools). +> +> 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/devtools"><code>chrome.devtools</code></a>.</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 @@ -80,5 +82,4 @@ browser.runtime.onMessage.addListener(handleMessage);</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/devtools/network/gethar/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/network/gethar/index.md index 622856787a..467aa7612d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/network/gethar/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/network/gethar/index.md @@ -10,34 +10,36 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.network/getHAR original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.network/getHAR --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtenez un <a href="http://www.softwareishard.com/blog/har-12-spec/#log">journal HAR</a> pour la page chargĂ©e dans l'onglet en cours.</p> +Obtenez un [journal HAR](http://www.softwareishard.com/blog/har-12-spec/#log) pour la page chargĂ©e dans l'onglet en cours. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 getting = browser.devtools.network.getHAR() -</pre> +```js +var getting = browser.devtools.network.getHAR() +``` -<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 remplie avec un objet contenant le journal HAR pour l'onglet en cours. Pour plus de dĂ©tails sur ce que contient l'objet journal, reportez-vous Ă la <a href="http://www.softwareishard.com/blog/har-12-spec/#log">spĂ©cification HAR</a>.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet contenant le journal HAR pour l'onglet en cours. Pour plus de dĂ©tails sur ce que contient l'objet journal, reportez-vous Ă la [spĂ©cification HAR](http://www.softwareishard.com/blog/har-12-spec/#log). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.network.getHAR")}}</p> +{{Compat("webextensions.api.devtools.network.getHAR")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Consignez les URL des demandes contenues dans le journal HAR :</p> +Consignez les URL des demandes contenues dans le journal HAR : -<pre class="brush: js">async function logRequests() { +```js +async function logRequests() { let harLog = await browser.devtools.network.getHAR(); console.log(`HAR version: ${harLog.version}`); for (let entry of harLog.entries) { @@ -46,17 +48,15 @@ original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.network/getHAR } logRequestsButton.addEventListener("click", logRequests); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.network`](https://developer.chrome.com/extensions/devtools_network). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/devtools_network"><code>chrome.devtools.network</code></a>.</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 @@ -83,5 +83,4 @@ logRequestsButton.addEventListener("click", logRequests); // 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/devtools/network/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/network/index.md index 77b3bfa8a7..03e7356a3a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/network/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/network/index.md @@ -11,41 +11,35 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.network original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.network --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>L'API <code>devtools.network</code> permet Ă une extension devtools d'obtenir des informations sur les demandes de rĂ©seau associĂ©es Ă la fenĂȘtre Ă laquelle les devtools sont attachĂ©s (la fenĂȘtre inspectĂ©e).</p> +L'API `devtools.network` permet Ă une extension devtools d'obtenir des informations sur les demandes de rĂ©seau associĂ©es Ă la fenĂȘtre Ă laquelle les devtools sont attachĂ©s (la fenĂȘtre inspectĂ©e). -<p>Comme toutes les APIs de devtools, cette API est uniquement disponible pour le code exĂ©cutĂ© dans le document dĂ©fini dans la clĂ© <a href="/fr/Add-ons/WebExtensions/manifest.json/devtools_page">devtools_page</a> du manifest.json, ou dans d'autres documents de devtools crĂ©Ă©s par l'extension (tel que le document du panneau). Voir <a href="/fr/Add-ons/WebExtensions/Extending_the_developer_tools">Extension des outils de dĂ©veloppement</a> pour plus d'informations.</p> +Comme toutes les APIs de devtools, cette API est uniquement disponible pour le code exĂ©cutĂ© dans le document dĂ©fini dans la clĂ© [devtools_page](/fr/Add-ons/WebExtensions/manifest.json/devtools_page) du manifest.json, ou dans d'autres documents de devtools crĂ©Ă©s par l'extension (tel que le document du panneau). Voir [Extension des outils de dĂ©veloppement](/fr/Add-ons/WebExtensions/Extending_the_developer_tools) pour plus d'informations. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/devtools.network/getHAR">devtools.network.getHAR()</a></dt> - <dd>Obtenez le <a href="http://www.softwareishard.com/blog/har-12-spec/#log" rel="noopener">journal HAR</a> pour la page chargĂ©e dans l'onglet en cours..</dd> -</dl> +- [devtools.network.getHAR()](/fr/docs/Mozilla/Add-ons/WebExtensions/API/devtools.network/getHAR) + - : Obtenez le [journal HAR](http://www.softwareishard.com/blog/har-12-spec/#log) pour la page chargĂ©e dans l'onglet en cours.. -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.network/onNavigated">devtools.network.onNavigated</a></code></dt> - <dd>AttirĂ© lorsque l'utilisateur navigue dans la fenĂȘtre inspectĂ©e vers une nouvelle page.</dd> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.network/onRequestFinished">devtools.network.onRequestFinished</a></code></dt> - <dd>LancĂ© lorsque la demande rĂ©seau est terminĂ©e et que ses dĂ©tails sont disponibles pour l'extension.</dd> -</dl> +- [`devtools.network.onNavigated`](/fr/Add-ons/WebExtensions/API/devtools.network/onNavigated) + - : AttirĂ© lorsque l'utilisateur navigue dans la fenĂȘtre inspectĂ©e vers une nouvelle page. +- [`devtools.network.onRequestFinished`](/fr/Add-ons/WebExtensions/API/devtools.network/onRequestFinished) + - : LancĂ© lorsque la demande rĂ©seau est terminĂ©e et que ses dĂ©tails sont disponibles pour l'extension. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.network")}}</p> +{{Compat("webextensions.api.devtools.network")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.network`](https://developer.chrome.com/extensions/devtools_network). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/devtools_network"><code>chrome.devtools.network</code></a>.</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 @@ -72,5 +66,4 @@ original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.network // 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/devtools/network/onnavigated/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/network/onnavigated/index.md index bc75f0ecdd..eed26e56a7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/network/onnavigated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/network/onnavigated/index.md @@ -11,67 +11,61 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.network/onNavigated original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.network/onNavigated --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Mise en place lorsque l'utilisateur navigue dans la fenĂȘtre inspectĂ©e vers une nouvelle page</p> +Mise en place lorsque l'utilisateur navigue dans la fenĂȘtre inspectĂ©e vers une nouvelle page -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.devtools.network.onNavigated.addListener(listener) +```js +browser.devtools.network.onNavigated.addListener(listener) browser.devtools.network.onNavigated.removeListener(listener) browser.devtools.network.onNavigated.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajouter un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘter d'Ă©couter un Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si l'auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <strong>vrai</strong> si elle Ă©coute, sinon <strong>faux</strong>.</dd> -</dl> +- `addListener(listener)` + - : Ajouter un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘter d'Ă©couter un Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si l'auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie **vrai** si elle Ă©coute, sinon **faux**. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction passera les arguments suivants :</p> +- `callback` - <dl> - <dt><code>url</code></dt> - <dd><code>string</code>. La nouvelle URL pour la fenĂȘtre.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction passera les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `url` + - : `string`. La nouvelle URL pour la fenĂȘtre. -<p>{{Compat("webextensions.api.devtools.network.onNavigated")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.devtools.network.onNavigated")}} -<pre class="brush: js">function handleNavigated(url) { +## Exemples + +```js +function handleNavigated(url) { console.log(url); } -browser.devtools.network.onNavigated.addListener(handleNavigated);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.devtools.network.onNavigated.addListener(handleNavigated); +``` -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/devtools"><code>chrome.devtools</code></a> de Chromium.</p> +{{WebExtExamples}} -<p>Les donnĂ©es de compatibilitĂ© de Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.devtools`](https://developer.chrome.com/extensions/devtools) de Chromium. +> +> Les donnĂ©es de compatibilitĂ© de Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<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 @@ -98,5 +92,4 @@ browser.devtools.network.onNavigated.addListener(handleNavigated);</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/devtools/network/onrequestfinished/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/network/onrequestfinished/index.md index 10f287569b..badfae44b0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/network/onrequestfinished/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/network/onrequestfinished/index.md @@ -13,74 +13,68 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.network/onRequestFinished original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.network/onRequestFinished --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'une requĂȘte rĂ©seau est terminĂ©e et que ses dĂ©tails sont disponibles pour l'extension.</p> +LancĂ© lorsqu'une requĂȘte rĂ©seau est terminĂ©e et que ses dĂ©tails sont disponibles pour l'extension. -<p>La requĂȘte est donnĂ©e en tant qu'<a href="http://www.softwareishard.com/blog/har-12-spec/#entries">objet d'entrĂ©e HAR</a>, qui est Ă©galement dotĂ© d'une mĂ©thode <code>getContent()</code> asynchrone qui rĂ©cupĂšre le contenu du corps de la rĂ©ponse.</p> +La requĂȘte est donnĂ©e en tant qu'[objet d'entrĂ©e HAR](http://www.softwareishard.com/blog/har-12-spec/#entries), qui est Ă©galement dotĂ© d'une mĂ©thode `getContent()` asynchrone qui rĂ©cupĂšre le contenu du corps de la rĂ©ponse. -<p>Notez que bien que votre extension puisse ajouter un Ă©couteur Ă tout moment,elle commencera seulement Ă se dĂ©clencher aprĂšs que l'utilisateur a activĂ© le <a href="/fr/docs/Outils/Moniteur_rĂ©seau">moniteur rĂ©seau</a> du navigateur au moins une fois.</p> +Notez que bien que votre extension puisse ajouter un Ă©couteur Ă tout moment,elle commencera seulement Ă se dĂ©clencher aprĂšs que l'utilisateur a activĂ© le [moniteur rĂ©seau](/fr/docs/Outils/Moniteur_rĂ©seau) du navigateur au moins une fois. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.devtools.network.onRequestFinished.addListener(listener) +```js +browser.devtools.network.onRequestFinished.addListener(listener) browser.devtools.network.onRequestFinished.removeListener(listener) browser.devtools.network.onRequestFinished.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions</p> +Les Ă©vĂ©nements ont trois fonctions -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de <code>listener</code>  est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code>s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de `listener`  est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true`s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>request</code></dt> - <dd><code>object</code>. Un objet reprĂ©sentant la requĂȘte. Cet objet est un seul objet d'<a href="http://www.softwareishard.com/blog/har-12-spec/#entries">entrĂ©e HAR</a>. Il dĂ©finit Ă©galement une mĂ©thode <code>getContent()</code> asynchrone, qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui se rĂ©sout avec le corps de la rĂ©ponse.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `request` + - : `object`. Un objet reprĂ©sentant la requĂȘte. Cet objet est un seul objet d'[entrĂ©e HAR](http://www.softwareishard.com/blog/har-12-spec/#entries). Il dĂ©finit Ă©galement une mĂ©thode `getContent()` asynchrone, qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui se rĂ©sout avec le corps de la rĂ©ponse. -<p>{{Compat("webextensions.api.devtools.network.onRequestFinished")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Examples">Examples</h2> +{{Compat("webextensions.api.devtools.network.onRequestFinished")}} -<p>Ajoutez un Ă©couteur qui consigne l'adresse IP du serveur et le corps de la rĂ©ponse pour chaque requĂȘte rĂ©seau.</p> +## Examples -<pre class="brush: js">function handleRequestFinished(request) { +Ajoutez un Ă©couteur qui consigne l'adresse IP du serveur et le corps de la rĂ©ponse pour chaque requĂȘte rĂ©seau. + +```js +function handleRequestFinished(request) { console.log("Server IP: ", request.serverIPAddress); - request.getContent().then(content => { + request.getContent().then(content => { console.log("Content: ", content); }); } -browser.devtools.network.onRequestFinished.addListener(handleRequestFinished);</pre> - -<p>{{WebExtExamples}}</p> +browser.devtools.network.onRequestFinished.addListener(handleRequestFinished); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/devtools"><code>chrome.devtools</code></a> de Chromium.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.devtools`](https://developer.chrome.com/extensions/devtools) de Chromium. -<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 @@ -107,5 +101,4 @@ browser.devtools.network.onRequestFinished.addListener(handleRequestFinished);</ // 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/devtools/panels/create/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/create/index.md index 4ea3a37efb..0aef6cc3fa 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/create/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/create/index.md @@ -12,45 +12,45 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.panels/create original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/create --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ajoute un nouveau panneau aux devtools.</p> +Ajoute un nouveau panneau aux devtools. -<p>Cette fonction prend : un titre, une URL vers un fichier d'icĂŽne et une URL vers un fichier HTML. Il crĂ©e un nouveau panneau dans les devtools, dont le contenu est spĂ©cifiĂ© par le fichier HTML. Il renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui rĂ©sout un objet <code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionPanel">ExtensionPanel</a></code> reprĂ©sentant le nouveau panneau.</p> +Cette fonction prend : un titre, une URL vers un fichier d'icĂŽne et une URL vers un fichier HTML. Il crĂ©e un nouveau panneau dans les devtools, dont le contenu est spĂ©cifiĂ© par le fichier HTML. Il renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui rĂ©sout un objet [`ExtensionPanel`](/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionPanel) reprĂ©sentant le nouveau panneau. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var creating = browser.devtools.panels.create( +```js +var creating = browser.devtools.panels.create( title, // string iconPath, // string pagePath // string ) -</pre> +``` -<h3 id="ParametĂšres">ParametĂšres</h3> +### ParametĂšres -<dl> - <dt><code>title</code></dt> - <dd><code>string</code>. Le titre du panneau. Cela apparaitra dans la rangĂ©e des onglets le long du haut de la fenĂȘtre des devtools, et c'est la principale façon dont l'utilisateur pourra identifier votre panneau.</dd> - <dt><code>iconPath</code></dt> - <dd><code>string</code>. SpĂ©cifie une icĂŽne qui sera affichĂ©e Ă cĂŽtĂ© du titre. Il est fourni sous forme d'URL vers un fichier image qui a Ă©tĂ© fourni avec votre extension. L'URL est rĂ©solue par rapport Ă la page d'extension courante (sauf si elle est exprimĂ©e en url absolue, par exemple "/icons/panel.png").</dd> - <dt><code>pagePath</code></dt> - <dd>string. SpĂ©cifie un fichier HTML qui dĂ©finit le contenu rĂ©el du panneau. Il est fourni sous la forme d'une URL d'un fichier HTML qui a Ă©tĂ© regroupĂ© avec votre extension. L'URL est rĂ©solue par rapport Ă la page d'extension courante (sauf si elle est exprimĂ©e en url absolue, par exemple "/devtools/panel.html"). Le fichier HTML peut include des fichiers CSS et JavaScript, juste comme une page web normale. Le JavaScript en cours d'Ă©xĂ©cution dans le panneau pourra utiliser les API devtools. Voir <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Extending_the_developer_tools">Extention des outils de dĂ©veloppement</a>.</dd> -</dl> +- `title` + - : `string`. Le titre du panneau. Cela apparaitra dans la rangĂ©e des onglets le long du haut de la fenĂȘtre des devtools, et c'est la principale façon dont l'utilisateur pourra identifier votre panneau. +- `iconPath` + - : `string`. SpĂ©cifie une icĂŽne qui sera affichĂ©e Ă cĂŽtĂ© du titre. Il est fourni sous forme d'URL vers un fichier image qui a Ă©tĂ© fourni avec votre extension. L'URL est rĂ©solue par rapport Ă la page d'extension courante (sauf si elle est exprimĂ©e en url absolue, par exemple "/icons/panel.png"). +- `pagePath` + - : string. SpĂ©cifie un fichier HTML qui dĂ©finit le contenu rĂ©el du panneau. Il est fourni sous la forme d'une URL d'un fichier HTML qui a Ă©tĂ© regroupĂ© avec votre extension. L'URL est rĂ©solue par rapport Ă la page d'extension courante (sauf si elle est exprimĂ©e en url absolue, par exemple "/devtools/panel.html"). Le fichier HTML peut include des fichiers CSS et JavaScript, juste comme une page web normale. Le JavaScript en cours d'Ă©xĂ©cution dans le panneau pourra utiliser les API devtools. Voir [Extention des outils de dĂ©veloppement](/fr/docs/Mozilla/Add-ons/WebExtensions/Extending_the_developer_tools). -<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 <code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionPanel">ExtensionPanel</a></code> reprĂ©sentant le nouveau panneau.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet [`ExtensionPanel`](/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionPanel) reprĂ©sentant le nouveau panneau. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.create")}}</p> +{{Compat("webextensions.api.devtools.panels.create")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>CrĂ©er un nouveau panneau, et ajoute des auditeurs Ă ces Ă©vĂ©nements onShown et onHidden :</p> +CrĂ©er un nouveau panneau, et ajoute des auditeurs Ă ces Ă©vĂ©nements onShown et onHidden : -<pre class="brush: js">function handleShown() { +```js +function handleShown() { console.log("panel is being shown"); } @@ -62,23 +62,21 @@ browser.devtools.panels.create( "My Panel", // title "/icons/star.png", // icon "/devtools/panel/panel.html" // content -).then((newPanel) => { +).then((newPanel) => { newPanel.onShown.addListener(handleShown); newPanel.onHidden.addListener(handleHidden); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). +> +> 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/devtools_panels"><code>chrome.devtools.panels</code></a>.</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 @@ -105,5 +103,4 @@ browser.devtools.panels.create( // 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/devtools/panels/elements/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elements/index.md index 13429a0e32..2aa676946f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elements/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elements/index.md @@ -12,17 +12,16 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.panels/elements original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/elements --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet <code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel">ElementsPanel</a></code> qui reprĂ©sente l'inspecteur HTML/CSS du navigateur</p> +Un objet [`ElementsPanel`](/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel) qui reprĂ©sente l'inspecteur HTML/CSS du navigateur -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.elements", 10)}}</p> +{{Compat("webextensions.api.devtools.panels.elements", 10)}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/devtools_panels"><code>chrome.devtools.panels</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). diff --git a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elementspanel/createsidebarpane/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elementspanel/createsidebarpane/index.md index 5725db54ca..33a0c691e0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elementspanel/createsidebarpane/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elementspanel/createsidebarpane/index.md @@ -16,45 +16,45 @@ translation_of: >- original_slug: >- Mozilla/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel/createSidebarPane --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ajoute un nouveau volet Ă la barre latĂ©rale dans l'inspecteur HTML / CSS.</p> +Ajoute un nouveau volet Ă la barre latĂ©rale dans l'inspecteur HTML / CSS. -<p>L'inspecteur HTML / CSS, appelĂ© l'<a href="/fr/docs/Outils/Inspecteur">inspecteur de page</a> dans Firefox et le <a href="https://developers.google.com/web/tools/chrome-devtools/inspect-styles/">panneau Ă©lĂ©ments</a> dans Chrome, affiche la page DOM dans la partie principale de sa fenĂȘtre et possĂšde une barre latĂ©rale qui affiche divers autres aspects de la page HTML / CSS dans une interface Ă onglets. Par exemple, dans Firefox, la barre latĂ©rale peut afficher les rĂšgles CSS pour l'Ă©lĂ©ment sĂ©lectionnĂ©, ou ses polices, ou son modĂšle de boĂźte.</p> +L'inspecteur HTML / CSS, appelĂ© l'[inspecteur de page](/fr/docs/Outils/Inspecteur) dans Firefox et le [panneau Ă©lĂ©ments](https://developers.google.com/web/tools/chrome-devtools/inspect-styles/) dans Chrome, affiche la page DOM dans la partie principale de sa fenĂȘtre et possĂšde une barre latĂ©rale qui affiche divers autres aspects de la page HTML / CSS dans une interface Ă onglets. Par exemple, dans Firefox, la barre latĂ©rale peut afficher les rĂšgles CSS pour l'Ă©lĂ©ment sĂ©lectionnĂ©, ou ses polices, ou son modĂšle de boĂźte. -<p>La fonction <code>createSidebarPane()</code> ajoute un nouveau volet Ă la barre latĂ©rale. ar exemple, la capture d'Ă©cran ci-dessous montre un nouveau volet intitulĂ© "My pane", qui affiche un objet JSON :</p> +La fonction `createSidebarPane()` ajoute un nouveau volet Ă la barre latĂ©rale. ar exemple, la capture d'Ă©cran ci-dessous montre un nouveau volet intitulĂ© "My pane", qui affiche un objet JSON : -<p><img alt="" src="inspector-sidebar.png"></p> +![](inspector-sidebar.png) -<p>Cette fonction prend un argument, qui est une chaĂźne reprĂ©sentant le titre du volet. Il renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui se rĂ©sout en un objet <code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane">ExtensionSidebarPane</a></code> reprĂ©sentant le nouveau volet. Vous pouvez utiliser cet objet pour dĂ©finir le contenu et le comportement du volet.</p> +Cette fonction prend un argument, qui est une chaĂźne reprĂ©sentant le titre du volet. Il renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui se rĂ©sout en un objet [`ExtensionSidebarPane`](/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane) reprĂ©sentant le nouveau volet. Vous pouvez utiliser cet objet pour dĂ©finir le contenu et le comportement du volet. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var creating = browser.devtools.panels.elements.createSidebarPane( +```js +var creating = browser.devtools.panels.elements.createSidebarPane( title // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>title</code></dt> - <dd><code>string</code>. Cela apparaĂźtra dans la rangĂ©e d'onglets en haut de la barre latĂ©rale, et c'est la principale façon pour l'utilisateur d'identifier votre panneau.</dd> -</dl> +- `title` + - : `string`. Cela apparaĂźtra dans la rangĂ©e d'onglets en haut de la barre latĂ©rale, et c'est la principale façon pour l'utilisateur d'identifier votre panneau. -<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 <code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane">ExtensionSidebarPane</a></code> reprĂ©sentant le nouveau volet.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet [`ExtensionSidebarPane`](/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane) reprĂ©sentant le nouveau volet. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.ElementsPanel.createSidebarPane", 10)}}</p> +{{Compat("webextensions.api.devtools.panels.ElementsPanel.createSidebarPane", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>CrĂ©ez un nouveau volet et remplissez-le avec un objet JSON. Vous pouvez exĂ©cuter ce code dans un script chargĂ© par la <a href="/fr/Add-ons/WebExtensions/manifest.json/devtools_page">page devtools</a>.</p> +CrĂ©ez un nouveau volet et remplissez-le avec un objet JSON. Vous pouvez exĂ©cuter ce code dans un script chargĂ© par la [page devtools](/fr/Add-ons/WebExtensions/manifest.json/devtools_page). -<pre class="brush: js">function onCreated(sidebarPane) { +```js +function onCreated(sidebarPane) { sidebarPane.setObject({ someBool: true, someString: "hello there", @@ -66,17 +66,15 @@ original_slug: >- } browser.devtools.panels.elements.createSidebarPane("My pane").then(onCreated); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/devtools_panels"><code>chrome.devtools.panels</code></a>.</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 @@ -103,5 +101,4 @@ browser.devtools.panels.elements.createSidebarPane("My pane").then(onCreated); // 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/devtools/panels/elementspanel/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elementspanel/index.md index cb9b7b24be..f1a8550e2b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elementspanel/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elementspanel/index.md @@ -13,37 +13,31 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un <code>ElementsPanel</code> reprĂ©sente l'inspecteur HTML/CSS dans la devtools du navigateur. C'est ce qu'on appelle l'inspecteur de page dans Firefox et le panneau ĂlĂ©ments de Chrome.</p> +Un `ElementsPanel` reprĂ©sente l'inspecteur HTML/CSS dans la devtools du navigateur. C'est ce qu'on appelle l'inspecteur de page dans Firefox et le panneau ĂlĂ©ments de Chrome. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel/createSidebarPane">devtools.panels.ElementsPanel.createSidebarPane()</a></code></dt> - <dd>CrĂ©e un volet dans la barre latĂ©rale de l'inspecteur.</dd> -</dl> +- [`devtools.panels.ElementsPanel.createSidebarPane()`](/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel/createSidebarPane) + - : CrĂ©e un volet dans la barre latĂ©rale de l'inspecteur. -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel/onSelectionChanged">devtools.panels.ElementsPanel.onSelectionChanged</a></code></dt> - <dd>AppĂšle lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment diffĂ©rent dans la page, par exemple en utilisant l'Ă©lĂ©ment de menu contextuel "inspect Ă©lĂ©ment".</dd> -</dl> +- [`devtools.panels.ElementsPanel.onSelectionChanged`](/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel/onSelectionChanged) + - : AppĂšle lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment diffĂ©rent dans la page, par exemple en utilisant l'Ă©lĂ©ment de menu contextuel "inspect Ă©lĂ©ment". -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.ElementsPanel", 10)}}</p> +{{Compat("webextensions.api.devtools.panels.ElementsPanel", 10)}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/devtools_panels"><code>chrome.devtools.panels</code></a>.</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 @@ -70,5 +64,4 @@ original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel // 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/devtools/panels/elementspanel/onselectionchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elementspanel/onselectionchanged/index.md index d04a11bf65..facca729d4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elementspanel/onselectionchanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/elementspanel/onselectionchanged/index.md @@ -16,59 +16,55 @@ translation_of: >- original_slug: >- Mozilla/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel/onSelectionChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Appelles lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de page diffĂ©rent pour l'inspection avec les outils de dĂ©veloppement du navigateur, par exemple en sĂ©lectionnant l'Ă©lĂ©ment de menu contextuel "Inspect Element" dans Firefox.</p> +Appelles lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de page diffĂ©rent pour l'inspection avec les outils de dĂ©veloppement du navigateur, par exemple en sĂ©lectionnant l'Ă©lĂ©ment de menu contextuel "Inspect Element" dans Firefox. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.devtools.panels.elements.onSelectionChanged.addListener(listener) +```js +browser.devtools.panels.elements.onSelectionChanged.addListener(listener) browser.devtools.panels.elements.onSelectionChanged.removeListener(listener) browser.devtools.panels.elements.onSelectionChanged.hasListener(listener) -</pre> +``` -<p>L'Ă©vĂ©nement a trois fonctions :</p> +L'Ă©vĂ©nement a trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute une Ă©coute Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘte une Ă©coute Ă l'Ă©vĂ©nement. L'argument de l'auditeur est un auditeur supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si l'auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie la valeur Vrai si elle l'Ă©coute, sinon Faux.</dd> -</dl> +- `addListener(listener)` + - : Ajoute une Ă©coute Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘte une Ă©coute Ă l'Ă©vĂ©nement. L'argument de l'auditeur est un auditeur supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si l'auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie la valeur Vrai si elle l'Ă©coute, sinon Faux. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction ne passera pas d'arguments.</p> - </dd> -</dl> +- `callback` + - : Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction ne passera pas d'arguments. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.ElementsPanel.onSelectionChanged", 10)}}</p> +{{Compat("webextensions.api.devtools.panels.ElementsPanel.onSelectionChanged", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ecoutez la sĂ©lection des Ă©vĂ©nements modifiĂ©s, et enregistrez le contenu du texte de l'Ă©lĂ©ment nouvellement sĂ©lectionnĂ© :</p> +Ecoutez la sĂ©lection des Ă©vĂ©nements modifiĂ©s, et enregistrez le contenu du texte de l'Ă©lĂ©ment nouvellement sĂ©lectionnĂ© : -<pre class="brush: js">function handleSelectedElement() { +```js +function handleSelectedElement() { browser.devtools.inspectedWindow.eval("$0.textContent") - .then((result) => { + .then((result) => { console.log(result[0]); }); } -browser.devtools.panels.elements.onSelectionChanged.addListener(handleSelectedElement);</pre> +browser.devtools.panels.elements.onSelectionChanged.addListener(handleSelectedElement); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/devtools"><code>chrome.devtools</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools`](https://developer.chrome.com/extensions/devtools). diff --git a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionpanel/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionpanel/index.md index 8dc65df859..da15469158 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionpanel/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionpanel/index.md @@ -11,28 +11,27 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionPanel original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionPanel --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Une <code>ExtensionPanel</code> reprĂ©sente un panneau ajoutĂ© aux devtools. C'est la rĂ©solution de la <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> renvoyĂ© par <code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/create">browser.devtools.panels.create()</a></code>.</p> +Une `ExtensionPanel` reprĂ©sente un panneau ajoutĂ© aux devtools. C'est la rĂ©solution de la [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) renvoyĂ© par [`browser.devtools.panels.create()`](/fr/Add-ons/WebExtensions/API/devtools.panels/create). -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. DĂ©finissez deux Ă©vĂ©nements, <code>onShown</code> et <code>onHidden</code>.</p> +Les valeurs de ce type sont des objets. DĂ©finissez deux Ă©vĂ©nements, `onShown` et `onHidden`. -<ul> - <li><code>onShown</code> est Ă©mis lorsque le panneau est affichĂ© dans les devtools (par exemple, quand l'utilisateur a cliquĂ© sur le panneau dans la fenĂȘtre des devtools).</li> - <li><code>onHidden</code> est Ă©mis lorsque le panneau est cachĂ© (par exemple, quand l'utilisateur a basculĂ© sur un onglet diffĂ©rent dans la fenĂȘtre devtools).</li> -</ul> +- `onShown` est Ă©mis lorsque le panneau est affichĂ© dans les devtools (par exemple, quand l'utilisateur a cliquĂ© sur le panneau dans la fenĂȘtre des devtools). +- `onHidden` est Ă©mis lorsque le panneau est cachĂ© (par exemple, quand l'utilisateur a basculĂ© sur un onglet diffĂ©rent dans la fenĂȘtre devtools). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.ExtensionPanel")}}</p> +{{Compat("webextensions.api.devtools.panels.ExtensionPanel")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code crĂ©e un nouveau panneau, puis ajoute des gestionnaires pour ces Ă©vĂ©nements <code>onShown</code> et <code>onHidden</code>.</p> +Ce code crĂ©e un nouveau panneau, puis ajoute des gestionnaires pour ces Ă©vĂ©nements `onShown` et `onHidden`. -<pre class="brush: js">function handleShown(e) { +```js +function handleShown(e) { console.log(e); console.log("panel is being shown"); } @@ -46,22 +45,21 @@ browser.devtools.panels.create( "My Panel", // title "icons/star.png", // icon "devtools/panel/panel.html" // content -).then((newPanel) => { +).then((newPanel) => { newPanel.onShown.addListener(handleShown); newPanel.onHidden.addListener(handleHidden); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). +> +> 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/devtools_panels"><code>chrome.devtools.panels</code></a>.</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 @@ -88,5 +86,4 @@ browser.devtools.panels.create( // 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/devtools/panels/extensionsidebarpane/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/index.md index d56f4b58fc..8ce0d0abfb 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/index.md @@ -13,53 +13,41 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>L'objet <code>ExtensionSidebarPane</code> reprĂ©sente un volet qu'une extension a ajoutĂ© Ă la barre latĂ©rale dans l'inspecteur HTML/CSS du navigateur.</p> +L'objet `ExtensionSidebarPane` reprĂ©sente un volet qu'une extension a ajoutĂ© Ă la barre latĂ©rale dans l'inspecteur HTML/CSS du navigateur. -<p><img alt="" src="inspector-sidebar.png"></p> +![](inspector-sidebar.png) -<p>Pour crĂ©er un <code>ExtensionSidebarPane</code>, appelez la fonction <code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel/createSidebarPane">browser.devtools.panels.elements.createSidebarane()</a></code>.</p> +Pour crĂ©er un `ExtensionSidebarPane`, appelez la fonction [`browser.devtools.panels.elements.createSidebarane()`](/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel/createSidebarPane). -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/setExpression">devtools.panels.ExtensionSidebarPane.setExpression()</a></code></dt> - <dd> - <p>Ăvaluer une expression JavaScript dans la page Web inspectĂ©e par l'inspecteur. Le rĂ©sultat est affichĂ© dans le volet de la barre latĂ©rale.</p> - </dd> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/setObject">devtools.panels.ExtensionSidebarPane.setObject()</a></code></dt> - <dd> - <p>DĂ©finit un objet JSON qui sera affichĂ© dans le volet de la barre latĂ©rale.</p> - </dd> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/setPage">devtools.panels.ExtensionSidebarPane.setPage()</a></code></dt> - <dd> - <p>Charge la page pointĂ©e par l'URL fournie.</p> - </dd> -</dl> +- [`devtools.panels.ExtensionSidebarPane.setExpression()`](/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/setExpression) + - : Ăvaluer une expression JavaScript dans la page Web inspectĂ©e par l'inspecteur. Le rĂ©sultat est affichĂ© dans le volet de la barre latĂ©rale. +- [`devtools.panels.ExtensionSidebarPane.setObject()`](/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/setObject) + - : DĂ©finit un objet JSON qui sera affichĂ© dans le volet de la barre latĂ©rale. +- [`devtools.panels.ExtensionSidebarPane.setPage()`](/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/setPage) + - : Charge la page pointĂ©e par l'URL fournie. -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/onShown">devtools.panels.ExtensionSidebarPane.onShown</a></code></dt> - <dd>LancĂ© lorsque le volet latĂ©ral est affichĂ©.</dd> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/onHidden">devtools.panels.ExtensionSidebarPane.onHidden</a></code></dt> - <dd>LancĂ© lorsque le volet de la barre latĂ©rale est masquĂ©.</dd> -</dl> +- [`devtools.panels.ExtensionSidebarPane.onShown`](/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/onShown) + - : LancĂ© lorsque le volet latĂ©ral est affichĂ©. +- [`devtools.panels.ExtensionSidebarPane.onHidden`](/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/onHidden) + - : LancĂ© lorsque le volet de la barre latĂ©rale est masquĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane", 10)}}</p> +{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane", 10)}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/devtools_panels"><code>chrome.devtools.panels</code></a>.</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 @@ -86,5 +74,4 @@ original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionSideba // 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/devtools/panels/extensionsidebarpane/onhidden/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/onhidden/index.md index ac7d1e0aaa..07027a36f4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/onhidden/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/onhidden/index.md @@ -16,65 +16,60 @@ translation_of: >- original_slug: >- Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/onHidden --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>AppelĂ© lorsque le volet de la barre latĂ©rale est masquĂ©, suite Ă l'abandon de l'utilisateur.</p> +AppelĂ© lorsque le volet de la barre latĂ©rale est masquĂ©, suite Ă l'abandon de l'utilisateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.devtools.panels.onHidden.addListener(listener) +```js +browser.devtools.panels.onHidden.addListener(listener) browser.devtools.panels.onHidden.removeListener(listener) browser.devtools.panels.onHidden.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘte d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘte d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction appelĂ©e lorsque cet Ă©vĂ©nement se produit. Cette fonction sera passĂ©e sans arguments.</p> - </dd> -</dl> +- `callback` + - : Fonction appelĂ©e lorsque cet Ă©vĂ©nement se produit. Cette fonction sera passĂ©e sans arguments. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane.onHidden", 10)}}</p> +{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane.onHidden", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>CrĂ©ez un volet de barre latĂ©rale et journal afficher et masquer les Ă©vĂ©nements.</p> +CrĂ©ez un volet de barre latĂ©rale et journal afficher et masquer les Ă©vĂ©nements. -<pre class="brush: js">function onCreated(sidebarPane) { +```js +function onCreated(sidebarPane) { - sidebarPane.onShown.addListener(() => { + sidebarPane.onShown.addListener(() => { console.log("Shown"); }); - sidebarPane.onHidden.addListener(() => { + sidebarPane.onHidden.addListener(() => { console.log("Hidden"); }); } browser.devtools.panels.elements.createSidebarPane("My pane").then(onCreated); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/devtools_panels"><code>chrome.devtools.panels</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). diff --git a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/onshown/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/onshown/index.md index e1338a1d19..d04c2e7434 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/onshown/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/onshown/index.md @@ -13,65 +13,60 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/onShown original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/onShown --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque le volet latĂ©ral devient visible suite Ă un changement d'utilisateur.</p> +LancĂ© lorsque le volet latĂ©ral devient visible suite Ă un changement d'utilisateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.devtools.panels.onShown.addListener(listener) +```js +browser.devtools.panels.onShown.addListener(listener) browser.devtools.panels.onShown.removeListener(listener) browser.devtools.panels.onShown.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction sera passĂ©e sans arguments.</p> - </dd> -</dl> +- `callback` + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction sera passĂ©e sans arguments. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane.onShown", 10)}}</p> +{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane.onShown", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>CrĂ©ez un volet de barre latĂ©rale et journal afficher et masquer les Ă©vĂ©nements.</p> +CrĂ©ez un volet de barre latĂ©rale et journal afficher et masquer les Ă©vĂ©nements. -<pre class="brush: js">function onCreated(sidebarPane) { +```js +function onCreated(sidebarPane) { - sidebarPane.onShown.addListener(() => { + sidebarPane.onShown.addListener(() => { console.log("Shown"); }); - sidebarPane.onHidden.addListener(() => { + sidebarPane.onHidden.addListener(() => { console.log("Hidden"); }); } browser.devtools.panels.elements.createSidebarPane("My pane").then(onCreated); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/devtools_panels"><code>chrome.devtools.panels</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). diff --git a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setexpression/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setexpression/index.md index 0098ac9f7a..91d228de49 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setexpression/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setexpression/index.md @@ -15,49 +15,49 @@ translation_of: >- original_slug: >- Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/setExpression --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Evalue une expression dans le contexte de la page inspectĂ©e et affiche le rĂ©sultat dans le volet de la barre latĂ©rale d'extension.</p> +Evalue une expression dans le contexte de la page inspectĂ©e et affiche le rĂ©sultat dans le volet de la barre latĂ©rale d'extension. -<p>Le contexte d'exĂ©cution de l'expression est le mĂȘme que celui de <code><a href="/fr/Add-ons/WebExtensions/API/devtools.inspectedWindow/eval">inspectedWindow.eval()</a></code>.</p> +Le contexte d'exĂ©cution de l'expression est le mĂȘme que celui de [`inspectedWindow.eval()`](/fr/Add-ons/WebExtensions/API/devtools.inspectedWindow/eval). -<p> Les objets JSON et les noeuds DOM sont affichĂ©s en tant qu'arborescence extensible, comme dans la <a href="/fr/docs/Outils/JSON_viewer">visionneuse jSON</a> dans Firefox. Vous pouvez Ă©ventuellement spĂ©cifier une chaĂźne <code>rootTitle</code> : elle sera affichĂ©e comme le titre de la racine de l'arbre.</p> +Les objets JSON et les noeuds DOM sont affichĂ©s en tant qu'arborescence extensible, comme dans la [visionneuse jSON](/fr/docs/Outils/JSON_viewer) dans Firefox. Vous pouvez Ă©ventuellement spĂ©cifier une chaĂźne `rootTitle` : elle sera affichĂ©e comme le titre de la racine de l'arbre. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 evaluating = browser.devtools.panels.setExpression( +```js +var evaluating = browser.devtools.panels.setExpression( expression, // string rootTitle // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>expression</code></dt> - <dd><code>string</code>. L'expression Ă Ă©valuer.</dd> - <dt><code>rootTitle</code> {{optional_inline}}</dt> - <dd>string. Le titre de la racine de l'arbre dans lequel les rĂ©sultats sont affichĂ©s.</dd> -</dl> +- `expression` + - : `string`. L'expression Ă Ă©valuer. +- `rootTitle` {{optional_inline}} + - : string. Le titre de la racine de l'arbre dans lequel les rĂ©sultats sont affichĂ©s. -<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> sera remplie sans arguments, une fois l'expression Ă©valuĂ©e.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera remplie sans arguments, une fois l'expression Ă©valuĂ©e. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane.setExpression", 10)}}</p> +{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane.setExpression", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code crĂ©e un volet de barre latĂ©rale qui affiche le <code><a href="/fr/docs/Web/API/Element/tagName">tagName</a></code> de l'Ă©lĂ©ment actuellement sĂ©lectionnĂ© :</p> +Ce code crĂ©e un volet de barre latĂ©rale qui affiche le [`tagName`](/fr/docs/Web/API/Element/tagName) de l'Ă©lĂ©ment actuellement sĂ©lectionnĂ© : -<pre class="brush: js">function onCreated(sidebarPane) { +```js +function onCreated(sidebarPane) { - browser.devtools.panels.elements.onSelectionChanged.addListener(() => { - const exp = "$0 && $0.tagName"; + browser.devtools.panels.elements.onSelectionChanged.addListener(() => { + const exp = "$0 && $0.tagName"; const title = "Selected Element tagName"; sidebarPane.setExpression(exp, title); }); @@ -65,17 +65,15 @@ original_slug: >- } browser.devtools.panels.elements.createSidebarPane("My pane").then(onCreated); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/devtools_panels"><code>chrome.devtools.panels</code></a>.</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 @@ -102,5 +100,4 @@ browser.devtools.panels.elements.createSidebarPane("My pane").then(onCreated); // 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/devtools/panels/extensionsidebarpane/setobject/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setobject/index.md index dda73e1faa..24de71bf9c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setobject/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setobject/index.md @@ -15,44 +15,44 @@ translation_of: >- original_slug: >- Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/setObject --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Affiche un objet JSON dans le volet de la barre latĂ©rale de l'extension.</p> +Affiche un objet JSON dans le volet de la barre latĂ©rale de l'extension. -<p>L'objet est affichĂ© en tant qu'arborescence extensible, comme dans le <a href="/fr/docs/Outils/JSON_viewer">JSON viewer</a> dans Firefox. Vous pouvez Ă©ventuellement spĂ©cifier une chaĂźne <code>rootTitle</code> : elle sera affichĂ©e comme le titre de la racine de l'arbre.</p> +L'objet est affichĂ© en tant qu'arborescence extensible, comme dans le [JSON viewer](/fr/docs/Outils/JSON_viewer) dans Firefox. Vous pouvez Ă©ventuellement spĂ©cifier une chaĂźne `rootTitle` : elle sera affichĂ©e comme le titre de la racine de l'arbre. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 setting = browser.devtools.panels.setObject( +```js +var setting = browser.devtools.panels.setObject( jsonObject, // string, array, or JSON object rootTitle // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>jsonObject</code></dt> - <dd><code>String</code> ou <code>Array</code> ou <code>Object</code>. L'objet Ă afficher. S'il s'agit d'un objet JSON-serialized, donc les propriĂ©tĂ©s comme les fonctions seront omises.</dd> - <dt><code>rootTitle</code> {{optional_inline}}</dt> - <dd><code>String</code>. Le titre de la racine de l'arbre dans lequel l'objet est affichĂ©.</dd> -</dl> +- `jsonObject` + - : `String` ou `Array` ou `Object`. L'objet Ă afficher. S'il s'agit d'un objet JSON-serialized, donc les propriĂ©tĂ©s comme les fonctions seront omises. +- `rootTitle` {{optional_inline}} + - : `String`. Le titre de la racine de l'arbre dans lequel l'objet est affichĂ©. -<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 accomplie sans arguments, une fois l'objet dĂ©fini.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera accomplie sans arguments, une fois l'objet dĂ©fini. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane.setObject", 10)}}</p> +{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane.setObject", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>CrĂ©ez un nouveau volet et remplissez-le avec un objet JSON. Vous pouvez exĂ©cuter ce code dans un script chargĂ© par la <a href="/fr/Add-ons/WebExtensions/manifest.json/devtools_page">page devtools</a>. de votre extension</p> +CrĂ©ez un nouveau volet et remplissez-le avec un objet JSON. Vous pouvez exĂ©cuter ce code dans un script chargĂ© par la [page devtools](/fr/Add-ons/WebExtensions/manifest.json/devtools_page). de votre extension -<pre class="brush: js">function onCreated(sidebarPane) { +```js +function onCreated(sidebarPane) { sidebarPane.setObject({ someBool: true, someString: "hello there", @@ -63,17 +63,16 @@ original_slug: >- }); } -browser.devtools.panels.elements.createSidebarPane("My pane").then(onCreated);</pre> +browser.devtools.panels.elements.createSidebarPane("My pane").then(onCreated); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/devtools_panels"><code>chrome.devtools.panels</code></a>.</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 @@ -100,5 +99,4 @@ browser.devtools.panels.elements.createSidebarPane("My pane").then(onCreated);</ // 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/devtools/panels/extensionsidebarpane/setpage/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setpage/index.md index 7d3651cbeb..16cb4740c3 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setpage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setpage/index.md @@ -11,52 +11,50 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/setPage original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane/setPage --- -<p>DĂ©finit une page HTML Ă afficher dans le volet latĂ©ral.</p> +DĂ©finit une page HTML Ă afficher dans le volet latĂ©ral. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">browser.devtools.panels.setPage( +```js +browser.devtools.panels.setPage( path // string containing relative path to page ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt>extensionPageURL</dt> - <dd><code>string</code>. Le chemin relatif d'une page HTML Ă afficher dans la barre latĂ©rale.</dd> -</dl> +- extensionPageURL + - : `string`. Le chemin relatif d'une page HTML Ă afficher dans la barre latĂ©rale. -<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 tenue sans arguments, une fois l'URL dĂ©finie.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera tenue sans arguments, une fois l'URL dĂ©finie. -<p>La page sĂ©lectionnĂ©e ne sera pas chargĂ©e tant que l'utilisateur n'aura pas sĂ©lectionnĂ© la barre latĂ©rale devtools.</p> +La page sĂ©lectionnĂ©e ne sera pas chargĂ©e tant que l'utilisateur n'aura pas sĂ©lectionnĂ© la barre latĂ©rale devtools. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>CrĂ©ez un nouveau volet et remplissez-le d'une page HTML. Vous pouvez exĂ©cuter ce code dans un script chargĂ© par la <a href="/fr/Add-ons/WebExtensions/manifest.json/devtools_page">page devtools</a> de votre extension.</p> +CrĂ©ez un nouveau volet et remplissez-le d'une page HTML. Vous pouvez exĂ©cuter ce code dans un script chargĂ© par la [page devtools](/fr/Add-ons/WebExtensions/manifest.json/devtools_page) de votre extension. -<pre class="brush: js">function onCreated(sidebarPane) { +```js +function onCreated(sidebarPane) { sidebarPane.setPage('sidebar/sidebar.html'); } -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane.setPage", 10)}}</p> +{{Compat("webextensions.api.devtools.panels.ExtensionSidebarPane.setPage", 10)}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/devtools_panels"><code>chrome.devtools.panels</code></a>.</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 @@ -82,5 +80,4 @@ original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/ExtensionSideba // 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> +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/index.md index b144733c9b..76a93a2854 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/index.md @@ -11,69 +11,57 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.panels original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<div class="note"> -<p><strong>Note :</strong> Bien que les API soient basĂ©es sur les <a href="https://developer.chrome.com/extensions/devtools">APIs de devtools de Chrome</a>, il existe encore de nombreuses fonctionnalitĂ©s qui ne sont pas encore implĂ©mentĂ©es dans Firefox et ne sont donc pas documentĂ©es ici. Pour voir les fonctionnalitĂ©s actuellement manquantes, regarder <a href="/fr/Add-ons/WebExtensions/Using_the_devtools_APIs#Limitations_of_the_devtools_APIs">Limitations des APIs devtools</a>.</p> -</div> +> **Note :** Bien que les API soient basĂ©es sur les [APIs de devtools de Chrome](https://developer.chrome.com/extensions/devtools), il existe encore de nombreuses fonctionnalitĂ©s qui ne sont pas encore implĂ©mentĂ©es dans Firefox et ne sont donc pas documentĂ©es ici. Pour voir les fonctionnalitĂ©s actuellement manquantes, regarder [Limitations des APIs devtools](/fr/Add-ons/WebExtensions/Using_the_devtools_APIs#Limitations_of_the_devtools_APIs). -<p>L'API devtools.panels permet Ă une extension devtools de dĂ©finir son interface utilisateur Ă l'intĂ©rieur de la fenĂȘtre devtools.</p> +L'API devtools.panels permet Ă une extension devtools de dĂ©finir son interface utilisateur Ă l'intĂ©rieur de la fenĂȘtre devtools. -<p>La fenĂȘtre devtools hĂ©berge un certain nombre d'outils distincts - le dĂ©bogueur JavaScript, le moniteur rĂ©seau, etc. Une rangĂ©e d'onglets sur le haut permet Ă l'utilisateur de basculer entre les diffĂ©rents outils. La fenĂȘtre hĂ©bergeant l'interface utilisateur de chaque outil s'appelle un "panneau".</p> +La fenĂȘtre devtools hĂ©berge un certain nombre d'outils distincts - le dĂ©bogueur JavaScript, le moniteur rĂ©seau, etc. Une rangĂ©e d'onglets sur le haut permet Ă l'utilisateur de basculer entre les diffĂ©rents outils. La fenĂȘtre hĂ©bergeant l'interface utilisateur de chaque outil s'appelle un "panneau". -<p>Avec l'API devtools.panels, vous pouvez crĂ©er de nouveaux panneaux dans la fenĂȘtre des devtools.</p> +Avec l'API devtools.panels, vous pouvez crĂ©er de nouveaux panneaux dans la fenĂȘtre des devtools. -<p>Comme toutes les API de devtools, cette API est uniquement disponible pour le code exĂ©cutĂ© dans le document dĂ©fini dans la clĂ© <a href="/fr/Add-ons/WebExtensions/manifest.json/devtools_page">devtools_page</a> du manifest.json, ou dans d'autres documents de dĂ©ploiement crĂ©Ă©s par une extension (tel que le document du panneau). Voir <a href="/fr/Add-ons/WebExtensions/Extending_the_developer_tools">Extension des outils de dĂ©veloppement</a> pour plus for d'informations.</p> +Comme toutes les API de devtools, cette API est uniquement disponible pour le code exĂ©cutĂ© dans le document dĂ©fini dans la clĂ© [devtools_page](/fr/Add-ons/WebExtensions/manifest.json/devtools_page) du manifest.json, ou dans d'autres documents de dĂ©ploiement crĂ©Ă©s par une extension (tel que le document du panneau). Voir [Extension des outils de dĂ©veloppement](/fr/Add-ons/WebExtensions/Extending_the_developer_tools) pour plus for d'informations. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel">devtools.panels.ElementsPanel</a></code></dt> - <dd>ReprĂ©sente l'inspecteur HTML/CSS dans le devtools du navigateur</dd> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionPanel">devtools.panels.ExtensionPanel</a></code></dt> - <dd>ReprĂ©sente un panneau de dĂ©ploiement crĂ©Ă© par l'extension.</dd> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane">devtools.panels.ExtensionSidebarPane</a></code></dt> - <dd>ReprĂ©sente un volet ajoutĂ© par une extension Ă l'inspecteur HTML/CC dans les devtools du navigateur.</dd> -</dl> +- [`devtools.panels.ElementsPanel`](/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel) + - : ReprĂ©sente l'inspecteur HTML/CSS dans le devtools du navigateur +- [`devtools.panels.ExtensionPanel`](/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionPanel) + - : ReprĂ©sente un panneau de dĂ©ploiement crĂ©Ă© par l'extension. +- [`devtools.panels.ExtensionSidebarPane`](/fr/Add-ons/WebExtensions/API/devtools.panels/ExtensionSidebarPane) + - : ReprĂ©sente un volet ajoutĂ© par une extension Ă l'inspecteur HTML/CC dans les devtools du navigateur. -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> +## PropriĂ©tĂ©s -<dl> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/elements">devtools.panels.elements</a></code></dt> - <dd>Une rĂ©fĂ©rence Ă un objet <code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel">ElementsPanel</a></code>.</dd> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/themeName">devtools.panels.themeName</a></code></dt> - <dd>Le nom du thĂšme actuel des devtools.</dd> -</dl> +- [`devtools.panels.elements`](/fr/Add-ons/WebExtensions/API/devtools.panels/elements) + - : Une rĂ©fĂ©rence Ă un objet [`ElementsPanel`](/fr/Add-ons/WebExtensions/API/devtools.panels/ElementsPanel). +- [`devtools.panels.themeName`](/fr/Add-ons/WebExtensions/API/devtools.panels/themeName) + - : Le nom du thĂšme actuel des devtools. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/create">devtools.panels.create()</a></code></dt> - <dd>CrĂ©Ă© un nouveau panneau de dĂ©veloppement</dd> -</dl> +- [`devtools.panels.create()`](/fr/Add-ons/WebExtensions/API/devtools.panels/create) + - : CrĂ©Ă© un nouveau panneau de dĂ©veloppement -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt><code><a href="/fr/Add-ons/WebExtensions/API/devtools.panels/onThemeChanged">devtools.panels.onThemeChanged</a></code></dt> - <dd>Mise en place lorsque le thĂšme Devtools change.</dd> -</dl> +- [`devtools.panels.onThemeChanged`](/fr/Add-ons/WebExtensions/API/devtools.panels/onThemeChanged) + - : Mise en place lorsque le thĂšme Devtools change. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels", 2)}}</p> +{{Compat("webextensions.api.devtools.panels", 2)}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). +> +> 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/devtools_panels"><code>chrome.devtools.panels</code></a>.</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 @@ -100,5 +88,4 @@ original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels // 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/devtools/panels/onthemechanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/onthemechanged/index.md index 757f74684b..2c4351f95d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/onthemechanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/onthemechanged/index.md @@ -12,60 +12,54 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.panels/onThemeChanged original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/onThemeChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Remplacement quand le thĂšme de devtools change</p> +Remplacement quand le thĂšme de devtools change -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.devtools.panels.onThemeChanged.addListener(listener) +```js +browser.devtools.panels.onThemeChanged.addListener(listener) browser.devtools.panels.onThemeChanged.removeListener(listener) browser.devtools.panels.onThemeChanged.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>Ajoute un auditeur Ă cet Ă©vĂ©nement</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si l'auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie Vrai si elle Ă©coute, sinon Faux.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un auditeur Ă cet Ă©vĂ©nement +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si l'auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie Vrai si elle Ă©coute, sinon Faux. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Function qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction passera les arguments suivants :</p> +- `callback` - <dl> - <dt><code>themeName</code></dt> - <dd><code>string</code>. Nom du nouveau thĂšme : ce sera l'une des valeurs autorisĂ©es pour <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/devtools.panels/themeName">devtools.panels.themeName</a></code>.</dd> - </dl> - </dd> -</dl> + - : Function qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction passera les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `themeName` + - : `string`. Nom du nouveau thĂšme : ce sera l'une des valeurs autorisĂ©es pour [`devtools.panels.themeName`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/devtools.panels/themeName). -<p>{{Compat("webextensions.api.devtools.panels.onThemeChanged")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.devtools.panels.onThemeChanged")}} -<pre class="brush: js">browser.devtools.panels.onThemeChanged.addListener((newThemeName) => { +## Exemples + +```js +browser.devtools.panels.onThemeChanged.addListener((newThemeName) => { console.log(`New theme: ${newThemeName}`); }); -</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/devtools_panels"><code>chrome.devtools.panels</code></a>.</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.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/themename/index.md b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/themename/index.md index 12aab2c1b1..6f03f1c16a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/themename/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/devtools/panels/themename/index.md @@ -12,27 +12,24 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/devtools.panels/themeName original_slug: Mozilla/Add-ons/WebExtensions/API/devtools.panels/themeName --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le nom du thĂšme de <strong>devtools</strong> actuellement sĂ©lectionnĂ©.</p> +Le nom du thĂšme de **devtools** actuellement sĂ©lectionnĂ©. -<p>Il s'agit d'une chaĂźne dont les valeurs possibles sont :</p> +Il s'agit d'une chaĂźne dont les valeurs possibles sont : -<ul> - <li>"lumiĂšre"</li> - <li>"foncĂ©"</li> - <li>"firebug"</li> -</ul> +- "lumiĂšre" +- "foncĂ©" +- "firebug" -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.devtools.panels.themeName")}}</p> +{{Compat("webextensions.api.devtools.panels.themeName")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/devtools_panels"><code>chrome.devtools.panels</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.devtools.panels`](https://developer.chrome.com/extensions/devtools_panels). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/dns/index.md b/files/fr/mozilla/add-ons/webextensions/api/dns/index.md index aaac9b867d..9278baf37e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/dns/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/dns/index.md @@ -9,23 +9,15 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/dns --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}}Active une extension pour rĂ©soudre les noms de domaine.Pour utiliser cette API, une extension doit demander la permission "dns" [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) dans son fichier [`manifest.json`](/fr/Add-ons/WebExtensions/manifest.json) . -<div>Active une extension pour rĂ©soudre les noms de domaine.</div> +## Fonctions -<div></div> +- {{WebExtAPIRef("dns.resolve()")}} + - : RĂ©sout le nom d'hĂŽte donnĂ© en un enregistrement DNS -<div>Pour utiliser cette API, une extension doit demander la permission "dns" <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> dans son fichier <code><a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a></code> .</div> +## CompatibilitĂ© du navigateur -<h2 id="Fonctions">Fonctions</h2> +{{Compat("webextensions.api.dns")}} -<dl> - <dt>{{WebExtAPIRef("dns.resolve()")}}</dt> - <dd>RĂ©sout le nom d'hĂŽte donnĂ© en un enregistrement DNS</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.dns")}}</p> - -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/dns/resolve/index.md b/files/fr/mozilla/add-ons/webextensions/api/dns/resolve/index.md index 55a746e426..da34727324 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/dns/resolve/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/dns/resolve/index.md @@ -12,70 +12,68 @@ tags: - resolve translation_of: Mozilla/Add-ons/WebExtensions/API/dns/resolve --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>RĂ©sout le nom d'hĂŽte donnĂ© en un enregistrement DNS.</p> +RĂ©sout le nom d'hĂŽte donnĂ© en un enregistrement DNS. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 resolving = browser.dns.resolve( +```js +var resolving = browser.dns.resolve( hostname, // string flags // array of string ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>hostname</code></dt> - <dd><code><code>string</code></code>. Le nom d'hĂŽte Ă rĂ©soudre.</dd> - <dt><code>flags</code> {{optional_inline}}</dt> - <dd><p><code>array</code> de <code>string</code>. Drapeaux pour modifier la façon dont le nom d'hĂŽte est rĂ©solu. Tous les indicateurs omis sont par dĂ©faut Ă <code>false</code>. Vous pouvez passer zĂ©ro ou plusieurs des indicateurs suivants :</p> - <ul> - <li><code>"allow_name_collisions"</code>: autorise les rĂ©sultats de collision de noms qui sont normalement filtrĂ©s.</li> - <li><code>"bypass_cache"</code>: Supprime le cache de recherche DNS interne.</li> - <li><code>"canonical_name"</code>: Le nom canonique de l'hĂŽte spĂ©cifiĂ© sera interrogĂ©.</li> - <li><code>"disable_ipv4"</code>: Seules les adresses IPv6 seront renvoyĂ©es.</li> - <li><code>"disable_ipv6"</code>: Seules les adresses IPv4 seront renvoyĂ©es.</li> - <li><code>"disable_trr"</code>: n'utilisez pas le TRR (Trusted Recursive Resolver) pour rĂ©soudre le nom d'hĂŽte. Un TRR permet la rĂ©solution des noms d'hĂŽtes Ă l'aide d'un serveur <a href="https://tools.ietf.org/html/draft-ietf-doh-dns-over-https-02">DNS-over-HTTPS</a> dĂ©diĂ©.</li> - <li><code>"offline"</code>: seuls les littĂ©raux et les entrĂ©es mises en cache seront renvoyĂ©s.</li> - <li><code>"priority_low"</code>: La prioritĂ© est donnĂ©e Ă la requĂȘte. Si "priority_medium" est Ă©galement donnĂ©, la requĂȘte est prioritaire.</li> - <li><code>"priority_medium"</code>: La prioritĂ© est donnĂ©e Ă la requĂȘte. Si "priority_low" est Ă©galement donnĂ©, la requĂȘte est prioritaire</li> - <li><code>"speculate"</code>: Indique que la requĂȘte est spĂ©culative. Les demandes spĂ©culatives renvoient des erreurs si la prĂ©lecture est dĂ©sactivĂ©e par la configuration du navigateur.</li> - </ul> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>A <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promisee">Promise</a></code> qui sera remplie avec un objet <code>DNSRecord</code> object. Cet objet peut contenir les propriĂ©tĂ©s suivantes :</p> - -<dl> - <dt><code>addresses</code></dt> - <dd><code>array</code> of <code>string</code>. Les adresses IP associĂ©es Ă cet enregistrement DNS.</dd> - <dt><code>canonicalName</code></dt> - <dd><code>string</code>. Le nom canonique de cet enregistrement. Ceci n'est inclus dans la rĂ©ponse que si le drapeau <code>"canonical_name"</code>a Ă©tĂ© passĂ© Ă Â <code>resolve()</code>.</dd> - <dt><code>isTRR</code></dt> - <dd><code>boolean</code>: <code>true</code> si l'enregistrement a Ă©tĂ© rĂ©cupĂ©rĂ© Ă l'aide d'un TRR (Trusted Recursive Resolver).</dd> -</dl> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">function resolved(record) { +``` + +### ParamĂštres + +- `hostname` + - : `string`. Le nom d'hĂŽte Ă rĂ©soudre. +- `flags` {{optional_inline}} + + - : `array` de `string`. Drapeaux pour modifier la façon dont le nom d'hĂŽte est rĂ©solu. Tous les indicateurs omis sont par dĂ©faut Ă `false`. Vous pouvez passer zĂ©ro ou plusieurs des indicateurs suivants : + + - `"allow_name_collisions"`: autorise les rĂ©sultats de collision de noms qui sont normalement filtrĂ©s. + - `"bypass_cache"`: Supprime le cache de recherche DNS interne. + - `"canonical_name"`: Le nom canonique de l'hĂŽte spĂ©cifiĂ© sera interrogĂ©. + - `"disable_ipv4"`: Seules les adresses IPv6 seront renvoyĂ©es. + - `"disable_ipv6"`: Seules les adresses IPv4 seront renvoyĂ©es. + - `"disable_trr"`: n'utilisez pas le TRR (Trusted Recursive Resolver) pour rĂ©soudre le nom d'hĂŽte. Un TRR permet la rĂ©solution des noms d'hĂŽtes Ă l'aide d'un serveur [DNS-over-HTTPS](https://tools.ietf.org/html/draft-ietf-doh-dns-over-https-02) dĂ©diĂ©. + - `"offline"`: seuls les littĂ©raux et les entrĂ©es mises en cache seront renvoyĂ©s. + - `"priority_low"`: La prioritĂ© est donnĂ©e Ă la requĂȘte. Si "priority_medium" est Ă©galement donnĂ©, la requĂȘte est prioritaire. + - `"priority_medium"`: La prioritĂ© est donnĂ©e Ă la requĂȘte. Si "priority_low" est Ă©galement donnĂ©, la requĂȘte est prioritaire + - `"speculate"`: Indique que la requĂȘte est spĂ©culative. Les demandes spĂ©culatives renvoient des erreurs si la prĂ©lecture est dĂ©sactivĂ©e par la configuration du navigateur. + +### Valeur retournĂ©e + +A [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promisee) qui sera remplie avec un objet `DNSRecord` object. Cet objet peut contenir les propriĂ©tĂ©s suivantes : + +- `addresses` + - : `array` of `string`. Les adresses IP associĂ©es Ă cet enregistrement DNS. +- `canonicalName` + - : `string`. Le nom canonique de cet enregistrement. Ceci n'est inclus dans la rĂ©ponse que si le drapeau `"canonical_name"`a Ă©tĂ© passĂ© Ă Â `resolve()`. +- `isTRR` + - : `boolean`: `true` si l'enregistrement a Ă©tĂ© rĂ©cupĂ©rĂ© Ă l'aide d'un TRR (Trusted Recursive Resolver). + +## Exemples + +```js +function resolved(record) { console.log(record.addresses); } let resolving = browser.dns.resolve("example.com"); resolving.then(resolved); -// > e.g. Array [ "73.284.240.12" ] -</pre> +// > e.g. Array [ "73.284.240.12" ] +``` -<p>Contournez le cache et demandez le nom canonique:</p> +Contournez le cache et demandez le nom canonique: -<pre class="brush: js">function resolved(record) { +```js +function resolved(record) { console.log(record.canonicalName); console.log(record.addresses); } @@ -84,11 +82,12 @@ let resolving = browser.dns.resolve("developer.mozilla.org", ["bypass_cache", "canonical_name"]); resolving.then(resolved); -// > e.g. xyz.us-west-2.elb.amazonaws.com -// > e.g. Array [ "78.18.187.134", "34.79.135.234" ]</pre> +// > e.g. xyz.us-west-2.elb.amazonaws.com +// > e.g. Array [ "78.18.187.134", "34.79.135.234" ] +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.dns.resolve")}}</p> +{{Compat("webextensions.api.dns.resolve")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md index fe7a263f39..8a913b26b7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md @@ -13,47 +13,44 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/acceptDanger --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <code><strong>acceptDanger</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} invite l'utilisateur Ă accepter ou Ă annuler un tĂ©lĂ©chargement potentiellement dangereux.</p> +La fonction **`acceptDanger`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} invite l'utilisateur Ă accepter ou Ă annuler un tĂ©lĂ©chargement potentiellement dangereux. -<p>Cette fonction ne peut pas ĂȘtre appelĂ©e Ă partir de scripts d'arriĂšre-plan, uniquement dans les scripts qui s'exĂ©cutent dans une fenĂȘtre visible (par exemple un navigateur ou une fenĂȘtre d'action de page).</p> +Cette fonction ne peut pas ĂȘtre appelĂ©e Ă partir de scripts d'arriĂšre-plan, uniquement dans les scripts qui s'exĂ©cutent dans une fenĂȘtre visible (par exemple un navigateur ou une fenĂȘtre d'action de page). -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 prompting = browser.downloads.acceptDanger( +```js +var prompting = browser.downloads.acceptDanger( downloadId // integer ) -</pre> +``` -<h3 id="Parameters">Parameters</h3> +### Parameters -<dl> - <dt><code>downloadId</code></dt> - <dd>Un <code>integer</code> reprĂ©sentant l'<code>id</code> de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} en question.</dd> -</dl> +- `downloadId` + - : Un `integer` reprĂ©sentant l'`id` de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} en question. -<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>. Lorsque la boĂźte de dialogue se ferme, la promesse sera remplie sans arguments.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Lorsque la boĂźte de dialogue se ferme, la promesse sera remplie sans arguments. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.acceptDanger")}}</p> +{{Compat("webextensions.api.downloads.acceptDanger")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -80,5 +77,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/acceptDanger // 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/downloads/booleandelta/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.md index 43edabfce3..a19cbd5971 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.md @@ -13,36 +13,32 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/BooleanDelta --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>BooleanDelta</code> de l'API {{WebExtAPIRef("downloads")}} reprĂ©sente la diffĂ©rence entre deux boolĂ©ens.</p> +Le type `BooleanDelta` de l'API {{WebExtAPIRef("downloads")}} reprĂ©sente la diffĂ©rence entre deux boolĂ©ens. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>current</code>{{optional_inline}}</dt> - <dd>Un <code>boolean</code> reprĂ©sentant la valeur boolĂ©enne actuelle.</dd> - <dt><code>previous</code>{{optional_inline}}</dt> - <dd>Un <code>boolean</code> reprĂ©sentant la valeur boolĂ©enne prĂ©cĂ©dente.</dd> -</dl> +- `current`{{optional_inline}} + - : Un `boolean` reprĂ©sentant la valeur boolĂ©enne actuelle. +- `previous`{{optional_inline}} + - : Un `boolean` reprĂ©sentant la valeur boolĂ©enne prĂ©cĂ©dente. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.BooleanDelta")}}</p> +{{Compat("webextensions.api.downloads.BooleanDelta")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 Les auteurs de chrome. Tous les droits sont rĂ©servĂ©s. +<div class="hidden"><pre> // Copyright 2015 Les auteurs de chrome. Tous les droits sont rĂ©servĂ©s. // // Redistribution et utilisation sous forme source et binaire, avec ou sans // modification, sont autorisĂ©es Ă condition que les conditions suivantes soient @@ -68,5 +64,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/BooleanDelta // THĂORIE DE LA RESPONSABILITĂ, QU'IL SOIT UN CONTRAT, UNE RESPONSABILITĂ STRICTE OU UN TORT // (INCLUANT LA NĂGLIGENCE OU AUTREMENT) SURVENANT DE TOUTE MANIĂRE DE L'UTILISER // DE CE LOGICIEL, MĂME SI AVISĂ DE LA POSSIBILITĂ D'UN TEL DOMMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.md index 5a2bb1d7e9..40e8e525c4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.md @@ -15,37 +15,37 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/cancel --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <code><strong>cancel</strong></code><strong><code>()</code></strong> de l'API de {{WebExtAPIRef("downloads")}} annule un tĂ©lĂ©chargement. L'appel Ă©chouera si le tĂ©lĂ©chargement n'est pas actif : par exemple, parce qu'il a terminĂ© le tĂ©lĂ©chargement..</p> +La fonction **`cancel`\*\***`()`\*\* de l'API de {{WebExtAPIRef("downloads")}} annule un tĂ©lĂ©chargement. L'appel Ă©chouera si le tĂ©lĂ©chargement n'est pas actif : par exemple, parce qu'il a terminĂ© le tĂ©lĂ©chargement.. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 canceling = browser.downloads.cancel( +```js +var canceling = browser.downloads.cancel( downloadId // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>downloadId</code></dt> - <dd><code>integer</code>. L'identifiant du tĂ©lĂ©chargement Ă annuler.</dd> -</dl> +- `downloadId` + - : `integer`. L'identifiant du tĂ©lĂ©chargement Ă annuler. -<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>. Si la demande a Ă©tĂ© acceptĂ©e, la promesse sera remplie sans arguments. Si la demande a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si la demande a Ă©tĂ© acceptĂ©e, la promesse sera remplie sans arguments. Si la demande a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.cancel")}}</p> +{{Compat("webextensions.api.downloads.cancel")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">var downloadId = 13; +```js +var downloadId = 13; function onCanceled() { console.log(`Canceled download`); @@ -56,19 +56,18 @@ function onError(error) { } var canceling = browser.downloads.cancel(downloadId); -canceling.then(onCanceled, onError);</pre> +canceling.then(onCanceled, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -95,5 +94,4 @@ canceling.then(onCanceled, onError);</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/downloads/dangertype/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.md index 7f96700ba8..4d11d5cef9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.md @@ -13,54 +13,48 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DangerType --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>Le type <code>DangerType</code> de l'API {{WebExtAPIRef("downloads")}} dĂ©finit un ensemble de raisons possibles pour lesquelles un fichier tĂ©lĂ©chargeable peut ĂȘtre considĂ©rĂ© comme dangereux..</p> +Le type `DangerType` de l'API {{WebExtAPIRef("downloads")}} dĂ©finit un ensemble de raisons possibles pour lesquelles un fichier tĂ©lĂ©chargeable peut ĂȘtre considĂ©rĂ© comme dangereux.. -<p>Une propriĂ©tĂ© de <code>danger</code> {{WebExtAPIRef('downloads.DownloadItem')}} contiendra une chaĂźne tirĂ©e des valeurs dĂ©finies dans ce type.</p> +Une propriĂ©tĂ© de `danger` {{WebExtAPIRef('downloads.DownloadItem')}} contiendra une chaĂźne tirĂ©e des valeurs dĂ©finies dans ce type. -<div class="note"> -<p><strong>Note :</strong> Ces constantes de chaĂźne ne changeront jamais, mais l'ensemble de DangerTypes peut changer.</p> -</div> +> **Note :** Ces constantes de chaĂźne ne changeront jamais, mais l'ensemble de DangerTypes peut changer. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<dl> - <dt><code>file</code></dt> - <dd>Le nom de fichier du tĂ©lĂ©chargement est suspect.</dd> - <dt><code>url</code></dt> - <dd>L'URL du tĂ©lĂ©chargement est connue pour ĂȘtre malveillante.</dd> - <dt><code>content</code></dt> - <dd>Le fichier tĂ©lĂ©chargĂ© est connu pour ĂȘtre malveillant.</dd> - <dt><code>uncommon</code></dt> - <dd>L'URL du tĂ©lĂ©chargement n'est pas gĂ©nĂ©ralement tĂ©lĂ©chargĂ©e.</dd> - <dt><code>host</code></dt> - <dd>Le tĂ©lĂ©chargement provenait d'un hĂŽte connu pour distribuer des binaires malveillants.</dd> - <dt><code>unwanted</code></dt> - <dd>Le tĂ©lĂ©chargement est potentiellement indĂ©sirable ou dangereux..</dd> - <dt><code>safe</code></dt> - <dd>Le tĂ©lĂ©chargement ne prĂ©sente aucun danger connu pour l'ordinateur de l'utilisateur.</dd> - <dt><code>accepted</code></dt> - <dd>L'utilisateur a acceptĂ© le tĂ©lĂ©chargement dangereux.</dd> -</dl> +- `file` + - : Le nom de fichier du tĂ©lĂ©chargement est suspect. +- `url` + - : L'URL du tĂ©lĂ©chargement est connue pour ĂȘtre malveillante. +- `content` + - : Le fichier tĂ©lĂ©chargĂ© est connu pour ĂȘtre malveillant. +- `uncommon` + - : L'URL du tĂ©lĂ©chargement n'est pas gĂ©nĂ©ralement tĂ©lĂ©chargĂ©e. +- `host` + - : Le tĂ©lĂ©chargement provenait d'un hĂŽte connu pour distribuer des binaires malveillants. +- `unwanted` + - : Le tĂ©lĂ©chargement est potentiellement indĂ©sirable ou dangereux.. +- `safe` + - : Le tĂ©lĂ©chargement ne prĂ©sente aucun danger connu pour l'ordinateur de l'utilisateur. +- `accepted` + - : L'utilisateur a acceptĂ© le tĂ©lĂ©chargement dangereux. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.DangerType")}}</p> +{{Compat("webextensions.api.downloads.DangerType")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -87,5 +81,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DangerType // 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/downloads/doubledelta/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.md index 6dde623ac5..fa53d48233 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.md @@ -13,36 +13,32 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DoubleDelta --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>DoubleDelta</code> de l'API {{WebExtAPIRef("downloads")}} reprĂ©sente la diffĂ©rence entre deux doubles.</p> +Le type `DoubleDelta` de l'API {{WebExtAPIRef("downloads")}} reprĂ©sente la diffĂ©rence entre deux doubles. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>current</code>{{optional_inline}}</dt> - <dd>Un <code>number</code> reprĂ©sentant la double valeur actuelle.</dd> - <dt><code>previous</code>{{optional_inline}}</dt> - <dd>Un <code>number</code> reprĂ©sentant la valeur double prĂ©cĂ©dente.</dd> -</dl> +- `current`{{optional_inline}} + - : Un `number` reprĂ©sentant la double valeur actuelle. +- `previous`{{optional_inline}} + - : Un `number` reprĂ©sentant la valeur double prĂ©cĂ©dente. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.DoubleDelta")}}</p> +{{Compat("webextensions.api.downloads.DoubleDelta")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -69,5 +65,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DoubleDelta // 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/downloads/download/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.md index ff6364769b..2450697eb6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.md @@ -13,80 +13,75 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/download --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <strong><code>download()</code></strong> de l'API {{WebExtAPIRef("downloads")}} tĂ©lĂ©charge le fichier, compte tenu de son URL et d'autres prĂ©fĂ©rences optionnelles.</p> +La fonction **`download()`** de l'API {{WebExtAPIRef("downloads")}} tĂ©lĂ©charge le fichier, compte tenu de son URL et d'autres prĂ©fĂ©rences optionnelles. -<ul> - <li>Si l'<code>url</code> spĂ©cifiĂ©e utilise le protocole HTTP ou HTTPS, la requĂȘte inclura tous les cookies actuellement dĂ©finis pour son nom d'hĂŽte.</li> - <li>Si Ă la fois le <code>nom de fichier</code> et <code>saveAs</code> sont spĂ©cifiĂ©s, la boĂźte de dialogue Enregistrer sous s'affiche, prĂ©-remplie avec le <code>nom du fichier</code> spĂ©cifiĂ©.</li> -</ul> +- Si l'`url` spĂ©cifiĂ©e utilise le protocole HTTP ou HTTPS, la requĂȘte inclura tous les cookies actuellement dĂ©finis pour son nom d'hĂŽte. +- Si Ă la fois le `nom de fichier` et `saveAs` sont spĂ©cifiĂ©s, la boĂźte de dialogue Enregistrer sous s'affiche, prĂ©-remplie avec le `nom du fichier` spĂ©cifiĂ©. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 downloading = browser.downloads.download( +```js +var downloading = browser.downloads.download( options // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>options</code></dt> - <dd><p>Un <code>object</code> spĂ©cifiant le fichier que vous souhaitez tĂ©lĂ©charger et toutes les autres prĂ©fĂ©rences que vous souhaitez dĂ©finir concernant le tĂ©lĂ©chargement. Il peut contenir les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>allowHttpErrors</code>{{optional_inline}}</dt> - <dd><p>Un tag <code>boolĂ©en</code> qui permet de poursuivre les tĂ©lĂ©chargements mĂȘme s'ils rencontrent des erreurs HTTP. L'utilisation de ce drapeau, par exemple, permet le tĂ©lĂ©chargement des pages d'erreur du serveur. La valeur par dĂ©faut est <code>false</code>. Lorsqu'il est dĂ©fini Ă :</p> - <ul> - <li><code>false</code>, le tĂ©lĂ©chargement est annulĂ© lorsqu'il rencontre une erreur HTTP.</li> - <li><code>true</code>, le tĂ©lĂ©chargement se poursuit lorsqu'une erreur HTTP est rencontrĂ©e et que l'erreur du serveur HTTP n'est pas signalĂ©e. Toutefois, si le tĂ©lĂ©chargement Ă©choue en raison d'une erreur liĂ©e au fichier, au rĂ©seau, Ă l'utilisateur ou autre, cette erreur est signalĂ©e.</li> - </ul> - </dd> - <dt><code>body</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant le corps du message de la requĂȘte.</dd> - <dt><code>conflictAction</code>{{optional_inline}}</dt> - <dd>Une chaĂźne reprĂ©sentant l'action que vous voulez effectuer s'il y a un conflit de nom de fichier, tel que dĂ©fini dans le {{WebExtAPIRef('downloads.FilenameConflictAction')}} type (par dĂ©faut "uniquify" quand il n'est pas spĂ©cifiĂ©).</dd> - <dt><code>filename</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> eprĂ©sentant un chemin d'accĂšs au fichier par rapport au rĂ©pertoire de tĂ©lĂ©chargement par dĂ©faut,  qui indique l'emplacement oĂč vous souhaitez enregistrer le fichier et le nom de fichier que vous souhaitez utiliser. Les chemins absolus, les chemins vides et les chemins contenant des rĂ©fĂ©rences arriĂšres (<code>../</code>) provoqueront une erreur. Si elle est omise, cette valeur sera par dĂ©faut le nom de fichier dĂ©jĂ donnĂ© au fichier de tĂ©lĂ©chargement, et un emplacement immĂ©diatement dans le rĂ©pertoire de tĂ©lĂ©chargement.</dd> - <dt><code>headers</code>{{optional_inline}}</dt> - <dd>Si l'URL utilise les protocoles HTTP ou HTTPS, un <code>array</code> d'<code>objects</code> reprĂ©sentant des en-tĂȘtes HTTP supplĂ©mentaires Ă envoyer avec la requĂȘte. Chaque en-tĂȘte est reprĂ©sentĂ© sous la forme d'un objet dictionnaire contenant le <code>name</code> des clĂ©s et soit la <code>value</code>, soit la valeur <code>binaryValue</code>. Les en-tĂȘtes interdits par <code>XMLHttpRequest</code> et <code>fetch</code> ne peuvent pas ĂȘtre spĂ©cifiĂ©s, cependant, Firefox 70 et les versions ultĂ©rieures permettent d'utiliser l'en-tĂȘte <code>Referer</code>. Tenter d'utiliser un en-tĂȘte interdit provoque une erreur.</dd> - <dt><code>incognito</code>{{optional_inline}}</dt> - <dd>Un <code>boolean</code>: s'il est prĂ©sent et dĂ©fini sur true, associez ce tĂ©lĂ©chargement Ă une session de navigation privĂ©e. Cela signifie qu'il n'apparaĂźtra dans le gestionnaire de tĂ©lĂ©chargement que pour les fenĂȘtres privĂ©es actuellement ouvertes.</dd> - <dt><code>method</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant la mĂ©thode HTTP Ă utiliser si l'<code>url</code> utilise le protocole HTTP[S]. Cela peut ĂȘtre "GET" ou "POST".</dd> - <dt><code>saveAs</code>{{optional_inline}}</dt> - <dd> - <p>Un <code>boolean</code> qui spĂ©cifie s'il faut fournir une boĂźte de dialogue de sĂ©lection de fichier pour permettre Ă l'utilisateur de sĂ©lectionner un nom de fichier (<code>true</code>), ou non (<code>false</code>).</p> - - <p>Si cette option est omise, le navigateur affichera le sĂ©lecteur de fichier ou non en fonction de la prĂ©fĂ©rence gĂ©nĂ©rale de l'utilisateur pour ce comportement (dans Firefox cette prĂ©fĂ©rence est intitulĂ©e "Toujours vous demander oĂč enregistrer les fichiers" dans about:preferences, ou <code>browser.download.useDownloadDir</code> dans about:config).</p> - - <div class="note"> - <p><strong>Note :</strong> Firefox pour Android provoque une erreur si <code>saveAs</code> est Ă Â <code>true</code>. Le paramĂštre est ignorĂ© lorsque <code>saveAs</code> est <code>false</code> ou non inclus.</p> - </div> - </dd> - <dt><code>url</code></dt> - <dd>Un <code>string</code> reprĂ©sentant l'URL Ă tĂ©lĂ©charger.</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>. Si le tĂ©lĂ©chargement a dĂ©marrĂ© avec succĂšs, la promesse sera remplie avec l'<code>id</code> de la nouvelle {{WebExtAPIRef("downloads.DownloadItem")}}. Sinon, la promesse sera rejetĂ©e avec un message d'erreur venant de {{WebExtAPIRef("downloads.InterruptReason")}}.</p> - -<p>Si vous utilisez <a href="/fr/docs/Web/API/URL/createObjectURL">URL.createObjectURL()</a> pour tĂ©lĂ©charger des donnĂ©es crĂ©Ă©es en JavaScript et que vous voulez rĂ©voquer l'URL de l'objet (avec <a href="/fr/docs/Web/API/URL/revokeObjectURL">revokeObjectURL</a>) plus tard (comme il est fortement recommandĂ©), vous devez le faire aprĂšs le tĂ©lĂ©chargement. Pour ce faire, Ă©coutez l'Ă©vĂ©nement <a href="/fr/Add-ons/WebExtensions/API/downloads/onChanged">downloads.onChanged</a>.</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.downloads.download")}}</p> - -<h2 id="Examples">Examples</h2> - -<p>Le fragment suivant tente de tĂ©lĂ©charger un exemple de fichier, en spĂ©cifiant Ă©galement un nom de fichier et un emplacement pour l'enregistrer, ainsi que l'option <code>uniquify</code> <code>conflictAction</code>.</p> - -<pre class="brush: js">function onStartedDownload(id) { +``` + +### ParamĂštres + +- `options` + + - : Un `object` spĂ©cifiant le fichier que vous souhaitez tĂ©lĂ©charger et toutes les autres prĂ©fĂ©rences que vous souhaitez dĂ©finir concernant le tĂ©lĂ©chargement. Il peut contenir les propriĂ©tĂ©s suivantes : + + - `allowHttpErrors`{{optional_inline}} + + - : Un tag `boolĂ©en` qui permet de poursuivre les tĂ©lĂ©chargements mĂȘme s'ils rencontrent des erreurs HTTP. L'utilisation de ce drapeau, par exemple, permet le tĂ©lĂ©chargement des pages d'erreur du serveur. La valeur par dĂ©faut est `false`. Lorsqu'il est dĂ©fini Ă : + + - `false`, le tĂ©lĂ©chargement est annulĂ© lorsqu'il rencontre une erreur HTTP. + - `true`, le tĂ©lĂ©chargement se poursuit lorsqu'une erreur HTTP est rencontrĂ©e et que l'erreur du serveur HTTP n'est pas signalĂ©e. Toutefois, si le tĂ©lĂ©chargement Ă©choue en raison d'une erreur liĂ©e au fichier, au rĂ©seau, Ă l'utilisateur ou autre, cette erreur est signalĂ©e. + + - `body`{{optional_inline}} + - : Un `string` reprĂ©sentant le corps du message de la requĂȘte. + - `conflictAction`{{optional_inline}} + - : Une chaĂźne reprĂ©sentant l'action que vous voulez effectuer s'il y a un conflit de nom de fichier, tel que dĂ©fini dans le {{WebExtAPIRef('downloads.FilenameConflictAction')}} type (par dĂ©faut "uniquify" quand il n'est pas spĂ©cifiĂ©). + - `filename`{{optional_inline}} + - : Un `string` eprĂ©sentant un chemin d'accĂšs au fichier par rapport au rĂ©pertoire de tĂ©lĂ©chargement par dĂ©faut,  qui indique l'emplacement oĂč vous souhaitez enregistrer le fichier et le nom de fichier que vous souhaitez utiliser. Les chemins absolus, les chemins vides et les chemins contenant des rĂ©fĂ©rences arriĂšres (`../`) provoqueront une erreur. Si elle est omise, cette valeur sera par dĂ©faut le nom de fichier dĂ©jĂ donnĂ© au fichier de tĂ©lĂ©chargement, et un emplacement immĂ©diatement dans le rĂ©pertoire de tĂ©lĂ©chargement. + - `headers`{{optional_inline}} + - : Si l'URL utilise les protocoles HTTP ou HTTPS, un `array` d'`objects` reprĂ©sentant des en-tĂȘtes HTTP supplĂ©mentaires Ă envoyer avec la requĂȘte. Chaque en-tĂȘte est reprĂ©sentĂ© sous la forme d'un objet dictionnaire contenant le `name` des clĂ©s et soit la `value`, soit la valeur `binaryValue`. Les en-tĂȘtes interdits par `XMLHttpRequest` et `fetch` ne peuvent pas ĂȘtre spĂ©cifiĂ©s, cependant, Firefox 70 et les versions ultĂ©rieures permettent d'utiliser l'en-tĂȘte `Referer`. Tenter d'utiliser un en-tĂȘte interdit provoque une erreur. + - `incognito`{{optional_inline}} + - : Un `boolean`: s'il est prĂ©sent et dĂ©fini sur true, associez ce tĂ©lĂ©chargement Ă une session de navigation privĂ©e. Cela signifie qu'il n'apparaĂźtra dans le gestionnaire de tĂ©lĂ©chargement que pour les fenĂȘtres privĂ©es actuellement ouvertes. + - `method`{{optional_inline}} + - : Un `string` reprĂ©sentant la mĂ©thode HTTP Ă utiliser si l'`url` utilise le protocole HTTP\[S]. Cela peut ĂȘtre "GET" ou "POST". + - `saveAs`{{optional_inline}} + + - : Un `boolean` qui spĂ©cifie s'il faut fournir une boĂźte de dialogue de sĂ©lection de fichier pour permettre Ă l'utilisateur de sĂ©lectionner un nom de fichier (`true`), ou non (`false`). + + Si cette option est omise, le navigateur affichera le sĂ©lecteur de fichier ou non en fonction de la prĂ©fĂ©rence gĂ©nĂ©rale de l'utilisateur pour ce comportement (dans Firefox cette prĂ©fĂ©rence est intitulĂ©e "Toujours vous demander oĂč enregistrer les fichiers" dans about:preferences, ou `browser.download.useDownloadDir` dans about:config). + + > **Note :** Firefox pour Android provoque une erreur si `saveAs` est Ă Â `true`. Le paramĂštre est ignorĂ© lorsque `saveAs` est `false` ou non inclus. + + - `url` + - : Un `string` reprĂ©sentant l'URL Ă tĂ©lĂ©charger. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si le tĂ©lĂ©chargement a dĂ©marrĂ© avec succĂšs, la promesse sera remplie avec l'`id` de la nouvelle {{WebExtAPIRef("downloads.DownloadItem")}}. Sinon, la promesse sera rejetĂ©e avec un message d'erreur venant de {{WebExtAPIRef("downloads.InterruptReason")}}. + +Si vous utilisez [URL.createObjectURL()](/fr/docs/Web/API/URL/createObjectURL) pour tĂ©lĂ©charger des donnĂ©es crĂ©Ă©es en JavaScript et que vous voulez rĂ©voquer l'URL de l'objet (avec [revokeObjectURL](/fr/docs/Web/API/URL/revokeObjectURL)) plus tard (comme il est fortement recommandĂ©), vous devez le faire aprĂšs le tĂ©lĂ©chargement. Pour ce faire, Ă©coutez l'Ă©vĂ©nement [downloads.onChanged](/fr/Add-ons/WebExtensions/API/downloads/onChanged). + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.downloads.download")}} + +## Examples + +Le fragment suivant tente de tĂ©lĂ©charger un exemple de fichier, en spĂ©cifiant Ă©galement un nom de fichier et un emplacement pour l'enregistrer, ainsi que l'option `uniquify` `conflictAction`. + +```js +function onStartedDownload(id) { console.log(`Started downloading: ${id}`); } @@ -102,17 +97,16 @@ var downloading = browser.downloads.download({ conflictAction : 'uniquify' }); -downloading.then(onStartedDownload, onFailed);</pre> - -<p>{{WebExtExamples}}</p> +downloading.then(onStartedDownload, onFailed); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/downloads"><code>chrome.downloads</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). -<div class="hidden"> -<pre> // Copyright 2015 Les auteurs de chrome. Tous les droits sont rĂ©servĂ©s. +<div class="hidden"><pre> // Copyright 2015 Les auteurs de chrome. Tous les droits sont rĂ©servĂ©s. // // Redistribution et utilisation sous forme source et binaire, avec ou sans // modification, sont autorisĂ©es Ă condition que les conditions suivantes soient @@ -138,5 +132,4 @@ downloading.then(onStartedDownload, onFailed);</pre> // THĂORIE DE LA RESPONSABILITĂ, QU'IL SOIT UN CONTRAT, UNE RESPONSABILITĂ STRICTE OU UN TORT // (INCLUANT LA NĂGLIGENCE OU AUTREMENT) SURVENANT DE TOUTE MANIĂRE DE L'UTILISER // DE CE LOGICIEL, MĂME SI AVISĂ DE LA POSSIBILITĂ D'UN TEL DOMMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.md index 98fcbe438f..4d81c6642d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.md @@ -13,72 +13,68 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadItem --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>DownloadItem</code> de l'API {{WebExtAPIRef("downloads")}} reprĂ©sente un fichier tĂ©lĂ©chargĂ©.</p> +Le type `DownloadItem` de l'API {{WebExtAPIRef("downloads")}} reprĂ©sente un fichier tĂ©lĂ©chargĂ©. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>byExtensionId</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant l'ID de l'extension qui a dĂ©clenchĂ© le tĂ©lĂ©chargement (si elle a Ă©tĂ© dĂ©clenchĂ©e par une extension). Cela ne change pas une fois rĂ©glĂ©. Si le tĂ©lĂ©chargement n'a pas Ă©tĂ© dĂ©clenchĂ© par une extension, ceci n'est pas dĂ©fini.</dd> - <dt><code>byExtensionName</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant le nom de l'extension qui a dĂ©clenchĂ© le tĂ©lĂ©chargement (si elle a Ă©tĂ© dĂ©clenchĂ©e par une extension). Cela peut changer si l'extension change de nom ou si l'utilisateur change ses paramĂštres rĂ©gionaux. Si le tĂ©lĂ©chargement n'a pas Ă©tĂ© dĂ©clenchĂ© par une extension, ceci n'est pas dĂ©fini.</dd> - <dt><code>bytesReceived</code></dt> - <dd>Un <code>number</code> reprĂ©sentant le nombre d'octets reçus jusqu'ici de l'hĂŽte pendant le tĂ©lĂ©chargement ; cela ne prend pas en compte la compression de fichier.</dd> - <dt><code>canResume</code></dt> - <dd>Un <code>boolean</code> indiquant si un tĂ©lĂ©chargement actuellement interrompu (par exemple en pause) peut ĂȘtre repris Ă partir du point oĂč il a Ă©tĂ© interrompu (<code>true</code>), ou non (<code>false</code>).</dd> - <dt><code>danger</code></dt> - <dd>Une chaĂźne indiquant si ce tĂ©lĂ©chargement est considĂ©rĂ© comme sĂ»r ou suspect. Ses valeurs possibles sont dĂ©finies dans le type {{WebExtAPIRef('downloads.DangerType')}}.</dd> - <dt><code>endTime</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> (au format <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601</a>) reprĂ©sentant le nombre de millisecondes entre l'Ă©poque UNIX et la fin de ce tĂ©lĂ©chargement. Ceci n'est pas dĂ©fini si le tĂ©lĂ©chargement n'est pas encore terminĂ©.</dd> - <dt><code>error</code>{{optional_inline}}</dt> - <dd>Une chaĂźne indiquant pourquoi un tĂ©lĂ©chargement a Ă©tĂ© interrompu. Les valeurs possibles sont dĂ©finies dans le type {{WebExtAPIRef('downloads.InterruptReason')}}. Ceci n'est pas dĂ©fini si une erreur ne s'est pas produite.</dd> - <dt><code>estimatedEndTime</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> (au format <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601</a>) reprĂ©sentant le nombre estimĂ© de millisecondes entre l'Ă©poque UNIX et la date Ă laquelle ce tĂ©lĂ©chargement est estimĂ© terminĂ©. Ceci est indĂ©fini s'il n'est pas connu (en particulier, il n'est pas dĂ©fini dans le <code>DownloadItem</code> qui est passĂ© dans {{WebExtAPIRef("downloads.onCreated")}}).</dd> - <dt><code>exists</code></dt> - <dd>Un <code>boolean</code> indiquant si un fichier tĂ©lĂ©chargĂ© existe toujours (<code>true</code>) ou non (<code>false</code>). Ces informations peuvent ĂȘtre pĂ©rimĂ©es, car les navigateurs ne surveillent pas automatiquement la suppression des fichiers. Pour vĂ©rifier si un fichier existe, appelez la mĂ©thode {{WebExtAPIRef('downloads.search()')}}, en filtrant le fichier question.</dd> - <dt><code>filename</code></dt> - <dd>Un <code>string</code> reprĂ©sentant le chemin local absolu du fichier.</dd> - <dt><code>fileSize</code></dt> - <dd>Un <code>number</code> indiquant le nombre total d'octets dans le fichier entier, aprĂšs dĂ©compression. La valeur -1 signifie que la taille totale du fichier est inconnue.</dd> - <dt><code>id</code></dt> - <dd>Un <code>integer</code> reprĂ©sentant un identifiant unique pour le fichier tĂ©lĂ©chargĂ© qui est persistant entre les sessions du navigateur.</dd> - <dt><code>incognito</code></dt> - <dd>Un <code>boolean</code> qui indique si le tĂ©lĂ©chargement est enregistrĂ© dans l'historique du navigateur (<code>false</code>), ou non (<code>true</code>).</dd> - <dt><code>mime</code></dt> - <dd>Un <code>string</code> reprĂ©sentant le type MIME du fichier tĂ©lĂ©chargĂ©.</dd> - <dt><code>paused</code></dt> - <dd>Un <code>boolean</code> indiquant si le tĂ©lĂ©chargement est en pause, c'est-Ă -dire si le tĂ©lĂ©chargement a cessĂ© de lire les donnĂ©es de l'hĂŽte mais a maintenu la connexion ouverte. Si c'est le cas, la valeur est <code>true</code>, sinon <code>false</code>.</dd> - <dt><code>referrer</code></dt> - <dd>Un <code>string</code> reprĂ©sentant le rĂ©fĂ©rent du fichier tĂ©lĂ©chargĂ©.</dd> - <dt><code>startTime</code></dt> - <dd>Un <code>string</code> (au format <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601</a>) reprĂ©sentant le nombre de millisecondes entre l'Ă©poque UNIX et le dĂ©but du tĂ©lĂ©chargement.</dd> - <dt><code>state</code></dt> - <dd>Un <code>string</code> Indique si le tĂ©lĂ©chargement progresse, est interrompu ou terminĂ©. Les valeurs possibles sont dĂ©finies dans le type {{WebExtAPIRef('downloads.State')}}.</dd> - <dt><code>totalBytes</code></dt> - <dd>Un <code>number</code> indiquant le nombre total d'octets dans le fichier en cours de tĂ©lĂ©chargement. Cela ne prend pas en compte la compression de fichier. Une valeur de -1 signifie que le nombre total d'octets est inconnu..</dd> - <dt><code>url</code></dt> - <dd>Un <code>string</code> reprĂ©sentant l'URL absolue Ă partir de laquelle le fichier a Ă©tĂ© tĂ©lĂ©chargĂ©.</dd> -</dl> +- `byExtensionId`{{optional_inline}} + - : Un `string` reprĂ©sentant l'ID de l'extension qui a dĂ©clenchĂ© le tĂ©lĂ©chargement (si elle a Ă©tĂ© dĂ©clenchĂ©e par une extension). Cela ne change pas une fois rĂ©glĂ©. Si le tĂ©lĂ©chargement n'a pas Ă©tĂ© dĂ©clenchĂ© par une extension, ceci n'est pas dĂ©fini. +- `byExtensionName`{{optional_inline}} + - : Un `string` reprĂ©sentant le nom de l'extension qui a dĂ©clenchĂ© le tĂ©lĂ©chargement (si elle a Ă©tĂ© dĂ©clenchĂ©e par une extension). Cela peut changer si l'extension change de nom ou si l'utilisateur change ses paramĂštres rĂ©gionaux. Si le tĂ©lĂ©chargement n'a pas Ă©tĂ© dĂ©clenchĂ© par une extension, ceci n'est pas dĂ©fini. +- `bytesReceived` + - : Un `number` reprĂ©sentant le nombre d'octets reçus jusqu'ici de l'hĂŽte pendant le tĂ©lĂ©chargement ; cela ne prend pas en compte la compression de fichier. +- `canResume` + - : Un `boolean` indiquant si un tĂ©lĂ©chargement actuellement interrompu (par exemple en pause) peut ĂȘtre repris Ă partir du point oĂč il a Ă©tĂ© interrompu (`true`), ou non (`false`). +- `danger` + - : Une chaĂźne indiquant si ce tĂ©lĂ©chargement est considĂ©rĂ© comme sĂ»r ou suspect. Ses valeurs possibles sont dĂ©finies dans le type {{WebExtAPIRef('downloads.DangerType')}}. +- `endTime`{{optional_inline}} + - : Un `string` (au format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) reprĂ©sentant le nombre de millisecondes entre l'Ă©poque UNIX et la fin de ce tĂ©lĂ©chargement. Ceci n'est pas dĂ©fini si le tĂ©lĂ©chargement n'est pas encore terminĂ©. +- `error`{{optional_inline}} + - : Une chaĂźne indiquant pourquoi un tĂ©lĂ©chargement a Ă©tĂ© interrompu. Les valeurs possibles sont dĂ©finies dans le type {{WebExtAPIRef('downloads.InterruptReason')}}. Ceci n'est pas dĂ©fini si une erreur ne s'est pas produite. +- `estimatedEndTime`{{optional_inline}} + - : Un `string` (au format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) reprĂ©sentant le nombre estimĂ© de millisecondes entre l'Ă©poque UNIX et la date Ă laquelle ce tĂ©lĂ©chargement est estimĂ© terminĂ©. Ceci est indĂ©fini s'il n'est pas connu (en particulier, il n'est pas dĂ©fini dans le `DownloadItem` qui est passĂ© dans {{WebExtAPIRef("downloads.onCreated")}}). +- `exists` + - : Un `boolean` indiquant si un fichier tĂ©lĂ©chargĂ© existe toujours (`true`) ou non (`false`). Ces informations peuvent ĂȘtre pĂ©rimĂ©es, car les navigateurs ne surveillent pas automatiquement la suppression des fichiers. Pour vĂ©rifier si un fichier existe, appelez la mĂ©thode {{WebExtAPIRef('downloads.search()')}}, en filtrant le fichier question. +- `filename` + - : Un `string` reprĂ©sentant le chemin local absolu du fichier. +- `fileSize` + - : Un `number` indiquant le nombre total d'octets dans le fichier entier, aprĂšs dĂ©compression. La valeur -1 signifie que la taille totale du fichier est inconnue. +- `id` + - : Un `integer` reprĂ©sentant un identifiant unique pour le fichier tĂ©lĂ©chargĂ© qui est persistant entre les sessions du navigateur. +- `incognito` + - : Un `boolean` qui indique si le tĂ©lĂ©chargement est enregistrĂ© dans l'historique du navigateur (`false`), ou non (`true`). +- `mime` + - : Un `string` reprĂ©sentant le type MIME du fichier tĂ©lĂ©chargĂ©. +- `paused` + - : Un `boolean` indiquant si le tĂ©lĂ©chargement est en pause, c'est-Ă -dire si le tĂ©lĂ©chargement a cessĂ© de lire les donnĂ©es de l'hĂŽte mais a maintenu la connexion ouverte. Si c'est le cas, la valeur est `true`, sinon `false`. +- `referrer` + - : Un `string` reprĂ©sentant le rĂ©fĂ©rent du fichier tĂ©lĂ©chargĂ©. +- `startTime` + - : Un `string` (au format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) reprĂ©sentant le nombre de millisecondes entre l'Ă©poque UNIX et le dĂ©but du tĂ©lĂ©chargement. +- `state` + - : Un `string` Indique si le tĂ©lĂ©chargement progresse, est interrompu ou terminĂ©. Les valeurs possibles sont dĂ©finies dans le type {{WebExtAPIRef('downloads.State')}}. +- `totalBytes` + - : Un `number` indiquant le nombre total d'octets dans le fichier en cours de tĂ©lĂ©chargement. Cela ne prend pas en compte la compression de fichier. Une valeur de -1 signifie que le nombre total d'octets est inconnu.. +- `url` + - : Un `string` reprĂ©sentant l'URL absolue Ă partir de laquelle le fichier a Ă©tĂ© tĂ©lĂ©chargĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.DownloadItem")}}</p> +{{Compat("webextensions.api.downloads.DownloadItem")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -105,5 +101,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadItem // 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/downloads/downloadquery/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.md index 8e3071fb70..3f671d1cec 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.md @@ -12,84 +12,80 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadQuery --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>DownloadQuery</code> de l'API {{WebExtAPIRef("downloads")}} dĂ©finit un ensemble de paramĂštres pouvant ĂȘtre utilisĂ©s pour rechercher dans le gestionnaire de tĂ©lĂ©chargements un ensemble spĂ©cifique de tĂ©lĂ©chargements.</p> +Le type `DownloadQuery` de l'API {{WebExtAPIRef("downloads")}} dĂ©finit un ensemble de paramĂštres pouvant ĂȘtre utilisĂ©s pour rechercher dans le gestionnaire de tĂ©lĂ©chargements un ensemble spĂ©cifique de tĂ©lĂ©chargements. -<p>Ce type est utilisĂ© par exemple dans {{WebExtAPIRef("downloads.search()")}} et {{WebExtAPIRef("downloads.erase()")}}, en tant qu'objet de requĂȘte pour filtrer l'ensemble de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} pour retourner ou effacer.</p> +Ce type est utilisĂ© par exemple dans {{WebExtAPIRef("downloads.search()")}} et {{WebExtAPIRef("downloads.erase()")}}, en tant qu'objet de requĂȘte pour filtrer l'ensemble de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} pour retourner ou effacer. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>query</code>{{optional_inline}}</dt> - <dd>Un <code>tableau</code> de<code><code>chaines</code></code>. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le <code>nom de fichier</code> ou l'<code>URL</code> contient toutes les chaĂźnes donnĂ©es. Vous pouvez Ă©galement inclure des termes commençant par un titet (-) â ces termes <strong>ne doivent pas</strong> figurer dans le <code>nom du fichier</code> ou l'<code>url</code> de l'Ă©lĂ©ment Ă inclure.</dd> - <dt><code>startedBefore</code>{{optional_inline}}</dt> - <dd>Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui a dĂ©marrĂ© avant l'heure indiquĂ©e.</dd> - <dt><code>startedAfter</code>{{optional_inline}}</dt> - <dd>Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui a dĂ©marrĂ© aprĂšs l'heure indiquĂ©e.</dd> - <dt><code>endedBefore</code>{{optional_inline}}</dt> - <dd>Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui s'est terminĂ© avant l'heure indiquĂ©e.</dd> - <dt><code>endedAfter</code>{{optional_inline}}</dt> - <dd>Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui s'est terminĂ© aprĂšs l'heure indiquĂ©e.</dd> - <dt><code>totalBytesGreater</code>{{optional_inline}}</dt> - <dd>Un <code>number</code> reprĂ©sentant un nombre d'octets. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le <code>totalBytes</code> est supĂ©rieur au nombre donnĂ©.</dd> - <dt><code>totalBytesLess</code>{{optional_inline}}</dt> - <dd>Un <code>number</code> reprĂ©sentant un nombre d'octets. Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le <code>totalBytes</code> est infĂ©rieur au nombre donnĂ©.</dd> - <dt><code>filenameRegex</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant une expression rĂ©guliĂšre. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le <code>nom du fichier</code> correspond Ă l'expression rĂ©guliĂšre donnĂ©e..</dd> - <dt><code>urlRegex</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant une expression rĂ©guliĂšre. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont la valeur d'<code>url</code> correspond Ă l'expression rĂ©guliĂšre donnĂ©e..</dd> - <dt><code>limit</code>{{optional_inline}}</dt> - <dd>Un <code>integer</code> reprĂ©sentant un nombre de rĂ©sultats. Incluez uniquement le nombre spĂ©cifiĂ© de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}}.</dd> - <dt><code>orderBy</code>{{optional_inline}}</dt> - <dd>Un <code>tableau</code>de <code><code>chaĂźnes</code></code> reprĂ©sentant les propriĂ©tĂ©s {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} les rĂ©sultats de la recherche doivent ĂȘtre tirĂ©s par exemple, en incluant <code>startTime</code> puis <code>totalBytes</code> dans le tableau trierait {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} par leur heure de dĂ©but, puis le total des octets â dans l'ordre croissant. Pour spĂ©cifier le tri par une propriĂ©tĂ© dans l'ordre dĂ©croissant, prĂ©fixez-le avec un trait d'union, par exemple <code>-startTime</code>.</dd> - <dt><code>id</code>{{optional_inline}}</dt> - <dd>Un <code>integer</code> reprĂ©sentant l'ID du {{WebExtAPIRef("downloads.DownloadItem")}} que vous souhaitez interroger.</dd> - <dt><code>url</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant l'URL absolue Ă partir de laquelle le tĂ©lĂ©chargement a Ă©tĂ© initiĂ©, avant toute redirection.</dd> - <dt><code>filename</code>{{optional_inline}}</dt> - <dd>Un string reprĂ©sentant le chemin local absolu du fichier tĂ©lĂ©chargĂ© que vous souhaitez interroger.</dd> - <dt><code>danger</code>{{optional_inline}}</dt> - <dd>Une chaĂźne reprĂ©sentant un {{WebExtAPIRef('downloads.DangerType')}} â inclut uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur de <code>danger</code> .</dd> - <dt><code>mime</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant un type MIME. Incluez uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur <code>mime</code>.</dd> - <dt><code>startTime</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant une heure au format <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601</a>. Incluez seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur <code>startTime</code>.</dd> - <dt><code>endTime</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant une heure au format <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601</a>. Inclure uniquement sera limitĂ© Ă {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur <code>endTime</code>.</dd> - <dt><code>state</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant un tĂ©lĂ©chargement {{WebExtAPIRef('downloads.State')}} (<code>in_progress</code>, <code>interrupted</code>, or <code>complete</code>). Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur d' <code>Ă©tat</code>.</dd> - <dt><code>paused</code>{{optional_inline}}</dt> - <dd>Un <code>boolean</code> qui indique si un tĂ©lĂ©chargement est en pause â c'est-Ă -dire qui a cessĂ© de lire les donnĂ©es de l'hĂŽte, mais qui a conservĂ© la connexion ouverte (<code>true</code>), ou non (<code>false</code>). inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur de <code>pause</code>.</dd> - <dt><code>error</code>{{optional_inline}}</dt> - <dd>Une chaĂźne reprĂ©sentant un {{WebExtAPIRef('downloads.InterruptReason')}} â une raison pour laquelle un tĂ©lĂ©chargement a Ă©tĂ© interrompu. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur d' <code>erreur</code> .</dd> - <dt><code>bytesReceived</code>{{optional_inline}}</dt> - <dd>Un <code>number</code> reprĂ©sentant le nombre d'octets reçus jusqu'ici de l'hĂŽte, sans tenir compte de la compression de fichier. Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur <code>bytesReceived</code>.</dd> - <dt><code>totalBytes</code>{{optional_inline}}</dt> - <dd>Un <code>number</code> reprĂ©sentant le nombre total d'octets dans le fichier tĂ©lĂ©chargĂ©, sans tenir compte de la compression de fichier. Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur <code>totalBytes</code>.</dd> - <dt><code>fileSize</code>{{optional_inline}}</dt> - <dd><code>number</code>. Nombre d'octets dans le fichier entier aprĂšs la dĂ©compression, ou -1 si inconnu. Un <code>nombre</code> reprĂ©sentant le nombre total d'octets dans le fichier aprĂšs la dĂ©compression. Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur <code>fileSize</code>.</dd> - <dt><code>exists</code>{{optional_inline}}</dt> - <dd>Un <code>boolean</code> si un fichier tĂ©lĂ©chargĂ© existe toujours (<code>true</code>) ou non (<code>false</code>). Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur <code>existe</code>.</dd> -</dl> +- `query`{{optional_inline}} + - : Un `tableau` de`chaines`. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le `nom de fichier` ou l'`URL` contient toutes les chaĂźnes donnĂ©es. Vous pouvez Ă©galement inclure des termes commençant par un titet (-) â ces termes **ne doivent pas** figurer dans le `nom du fichier` ou l'`url` de l'Ă©lĂ©ment Ă inclure. +- `startedBefore`{{optional_inline}} + - : Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui a dĂ©marrĂ© avant l'heure indiquĂ©e. +- `startedAfter`{{optional_inline}} + - : Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui a dĂ©marrĂ© aprĂšs l'heure indiquĂ©e. +- `endedBefore`{{optional_inline}} + - : Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui s'est terminĂ© avant l'heure indiquĂ©e. +- `endedAfter`{{optional_inline}} + - : Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui s'est terminĂ© aprĂšs l'heure indiquĂ©e. +- `totalBytesGreater`{{optional_inline}} + - : Un `number` reprĂ©sentant un nombre d'octets. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le `totalBytes` est supĂ©rieur au nombre donnĂ©. +- `totalBytesLess`{{optional_inline}} + - : Un `number` reprĂ©sentant un nombre d'octets. Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le `totalBytes` est infĂ©rieur au nombre donnĂ©. +- `filenameRegex`{{optional_inline}} + - : Un `string` reprĂ©sentant une expression rĂ©guliĂšre. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le `nom du fichier` correspond Ă l'expression rĂ©guliĂšre donnĂ©e.. +- `urlRegex`{{optional_inline}} + - : Un `string` reprĂ©sentant une expression rĂ©guliĂšre. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont la valeur d'`url` correspond Ă l'expression rĂ©guliĂšre donnĂ©e.. +- `limit`{{optional_inline}} + - : Un `integer` reprĂ©sentant un nombre de rĂ©sultats. Incluez uniquement le nombre spĂ©cifiĂ© de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}}. +- `orderBy`{{optional_inline}} + - : Un `tableau`de `chaĂźnes` reprĂ©sentant les propriĂ©tĂ©s {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} les rĂ©sultats de la recherche doivent ĂȘtre tirĂ©s par exemple, en incluant `startTime` puis `totalBytes` dans le tableau trierait {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} par leur heure de dĂ©but, puis le total des octets â dans l'ordre croissant. Pour spĂ©cifier le tri par une propriĂ©tĂ© dans l'ordre dĂ©croissant, prĂ©fixez-le avec un trait d'union, par exemple `-startTime`. +- `id`{{optional_inline}} + - : Un `integer` reprĂ©sentant l'ID du {{WebExtAPIRef("downloads.DownloadItem")}} que vous souhaitez interroger. +- `url`{{optional_inline}} + - : Un `string` reprĂ©sentant l'URL absolue Ă partir de laquelle le tĂ©lĂ©chargement a Ă©tĂ© initiĂ©, avant toute redirection. +- `filename`{{optional_inline}} + - : Un string reprĂ©sentant le chemin local absolu du fichier tĂ©lĂ©chargĂ© que vous souhaitez interroger. +- `danger`{{optional_inline}} + - : Une chaĂźne reprĂ©sentant un {{WebExtAPIRef('downloads.DangerType')}} â inclut uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur de `danger` . +- `mime`{{optional_inline}} + - : Un `string` reprĂ©sentant un type MIME. Incluez uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur `mime`. +- `startTime`{{optional_inline}} + - : Un `string` reprĂ©sentant une heure au format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Incluez seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur `startTime`. +- `endTime`{{optional_inline}} + - : Un `string` reprĂ©sentant une heure au format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Inclure uniquement sera limitĂ© Ă {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur `endTime`. +- `state`{{optional_inline}} + - : Un `string` reprĂ©sentant un tĂ©lĂ©chargement {{WebExtAPIRef('downloads.State')}} (`in_progress`, `interrupted`, or `complete`). Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur d' `Ă©tat`. +- `paused`{{optional_inline}} + - : Un `boolean` qui indique si un tĂ©lĂ©chargement est en pause â c'est-Ă -dire qui a cessĂ© de lire les donnĂ©es de l'hĂŽte, mais qui a conservĂ© la connexion ouverte (`true`), ou non (`false`). inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur de `pause`. +- `error`{{optional_inline}} + - : Une chaĂźne reprĂ©sentant un {{WebExtAPIRef('downloads.InterruptReason')}} â une raison pour laquelle un tĂ©lĂ©chargement a Ă©tĂ© interrompu. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur d' `erreur` . +- `bytesReceived`{{optional_inline}} + - : Un `number` reprĂ©sentant le nombre d'octets reçus jusqu'ici de l'hĂŽte, sans tenir compte de la compression de fichier. Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur `bytesReceived`. +- `totalBytes`{{optional_inline}} + - : Un `number` reprĂ©sentant le nombre total d'octets dans le fichier tĂ©lĂ©chargĂ©, sans tenir compte de la compression de fichier. Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur `totalBytes`. +- `fileSize`{{optional_inline}} + - : `number`. Nombre d'octets dans le fichier entier aprĂšs la dĂ©compression, ou -1 si inconnu. Un `nombre` reprĂ©sentant le nombre total d'octets dans le fichier aprĂšs la dĂ©compression. Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur `fileSize`. +- `exists`{{optional_inline}} + - : Un `boolean` si un fichier tĂ©lĂ©chargĂ© existe toujours (`true`) ou non (`false`). Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur `existe`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.DownloadQuery")}}</p> +{{Compat("webextensions.api.downloads.DownloadQuery")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -116,5 +112,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadQuery // 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/downloads/downloadtime/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.md index a956cd5a93..358723fe58 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.md @@ -13,40 +13,35 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadTime --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>DownloadTime</code> de l'API {{WebExtAPIRef("downloads")}} reprĂ©sente le temps nĂ©cessaire au tĂ©lĂ©chargement.</p> +Le type `DownloadTime` de l'API {{WebExtAPIRef("downloads")}} reprĂ©sente le temps nĂ©cessaire au tĂ©lĂ©chargement. -<h2 id="Type">Type</h2> +## Type -<p>Un <code>DownloadTime</code> peut ĂȘtre l'un de trois types diffĂ©rents :</p> +Un `DownloadTime` peut ĂȘtre l'un de trois types diffĂ©rents : -<ul> - <li>Un objet JavaScript <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code>.</li> - <li>a string: - <ul> - <li>Si cela ne contient que des chiffres, il est interprĂ©tĂ© comme le nombre de millisecondes Ă©coulĂ©es depuis l'Ă©poque UNI.</li> - <li>inon, il est interprĂ©tĂ© comme une chaĂźne <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601</a>.</li> - </ul> - </li> - <li>un nombre : ceci est interprĂ©tĂ© comme le nombre de millisecondes Ă©coulĂ©es depuis l'Ă©poque UNIX.</li> -</ul> +- Un objet JavaScript [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date). +- a string: -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - Si cela ne contient que des chiffres, il est interprĂ©tĂ© comme le nombre de millisecondes Ă©coulĂ©es depuis l'Ă©poque UNI. + - inon, il est interprĂ©tĂ© comme une chaĂźne [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). -<p>{{Compat("webextensions.api.downloads.DownloadTime")}}</p> +- un nombre : ceci est interprĂ©tĂ© comme le nombre de millisecondes Ă©coulĂ©es depuis l'Ă©poque UNIX. -<p>{{WebExtExamples}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.downloads.DownloadTime")}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/downloads"><code>chrome.downloads</code></a>.</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.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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 @@ -73,5 +68,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadTime // 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/downloads/drag/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.md index 353f70f26a..deaa5eff4e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.md @@ -13,41 +13,38 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/drag --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <code><strong>drag</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} initie le glissement du fichier tĂ©lĂ©chargĂ© vers une autre application.</p> +La fonction **`drag`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} initie le glissement du fichier tĂ©lĂ©chargĂ© vers une autre application. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">chrome.downloads.drag( +```js +chrome.downloads.drag( downloadId // integer ) -</pre> +``` -<p>Cette API est Ă©galement disponible en tant que <code>browser.downloads.drag()</code>.</p> +Cette API est Ă©galement disponible en tant que `browser.downloads.drag()`. -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>downloadId</code></dt> - <dd>Un <code>integer</code> reprĂ©sentant l'<code>id</code> du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} ein question.</dd> -</dl> +- `downloadId` + - : Un `integer` reprĂ©sentant l'`id` du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} ein question. -<h2 id="Browser_compatibility">Browser compatibility</h2> +## Browser compatibility -<p>{{Compat("webextensions.api.downloads.drag")}}</p> +{{Compat("webextensions.api.downloads.drag")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -74,5 +71,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/drag // 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/downloads/erase/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md index 44d9d1fe46..65e1a1cd10 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md @@ -14,45 +14,43 @@ tags: - erase translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/erase --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <code><strong>erase</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} efface la correspondance {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} de l'historique de tĂ©lĂ©chargement du navigateur sans supprimer les fichiers tĂ©lĂ©chargĂ©s du disque.</p> +La fonction **`erase`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} efface la correspondance {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} de l'historique de tĂ©lĂ©chargement du navigateur sans supprimer les fichiers tĂ©lĂ©chargĂ©s du disque. -<p>Pour supprimer les fichiers du disque, vous devez utiliser {{WebExtAPIRef("downloads.removeFile()")}}.</p> +Pour supprimer les fichiers du disque, vous devez utiliser {{WebExtAPIRef("downloads.removeFile()")}}. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<div class="note"> -<p><strong>Note :</strong> Si vous souhaitez supprimer un fichier tĂ©lĂ©chargĂ© du disque et l'effacer de l'historique, vous devez appeler {{WebExtAPIRef("downloads.removeFile()")}} before you call <code>erase()</code>. Si vous l'essayez dans l'autre sens, vous obtiendrez une erreur lors de l'appel de {{WebExtAPIRef("downloads.removeFile()")}}, car il n'existe plus selon le navigateur.</p> -</div> +> **Note :** Si vous souhaitez supprimer un fichier tĂ©lĂ©chargĂ© du disque et l'effacer de l'historique, vous devez appeler {{WebExtAPIRef("downloads.removeFile()")}} before you call `erase()`. Si vous l'essayez dans l'autre sens, vous obtiendrez une erreur lors de l'appel de {{WebExtAPIRef("downloads.removeFile()")}}, car il n'existe plus selon le navigateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var erasing = browser.downloads.erase( +```js +var erasing = browser.downloads.erase( query // DownloadQuery ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>query</code></dt> - <dd>Un objet {{WebExtAPIRef('downloads.DownloadQuery')}}.</dd> -</dl> +- `query` + - : Un objet {{WebExtAPIRef('downloads.DownloadQuery')}}. -<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>. Si l'appel a rĂ©ussi, la promesse sera remplie avec un tableau d'entiers reprĂ©sentant les identifiants des {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} effacĂ©s. Si aucun Ă©lĂ©ment correspondant au paramĂštre de requĂȘte n'a pu ĂȘtre trouvĂ©, le tableau sera vide. Si l'appel a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si l'appel a rĂ©ussi, la promesse sera remplie avec un tableau d'entiers reprĂ©sentant les identifiants des {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} effacĂ©s. Si aucun Ă©lĂ©ment correspondant au paramĂštre de requĂȘte n'a pu ĂȘtre trouvĂ©, le tableau sera vide. Si l'appel a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.erase")}}</p> +{{Compat("webextensions.api.downloads.erase")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Effacer le tĂ©lĂ©chargement le plus rĂ©cent :</p> +Effacer le tĂ©lĂ©chargement le plus rĂ©cent : -<pre class="brush: js">function onErased(ids) { +```js +function onErased(ids) { console.log(`Erased: ${ids}`); } @@ -65,11 +63,13 @@ var erasing = browser.downloads.erase({ orderBy: ["-startTime"] }); -erasing.then(onErased, onError);</pre> +erasing.then(onErased, onError); +``` -<p>Tout effacer :</p> +Tout effacer : -<pre class="brush: js">function onErased(ids) { +```js +function onErased(ids) { console.log(`Erased: ${ids}`); } @@ -78,19 +78,18 @@ function onError(error) { } var erasing = browser.downloads.erase({}); -erasing.then(onErased, onError);</pre> +erasing.then(onErased, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -117,5 +116,4 @@ erasing.then(onErased, onError);</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/downloads/filenameconflictaction/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.md index 6d1c4c0709..e6ec407f0d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.md @@ -13,40 +13,36 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/FilenameConflictAction --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>FilenameConflictAction</code> de l'API {{WebExtAPIRef("downloads")}} spĂ©cifie que faire si le nom d'un fichier tĂ©lĂ©chargĂ© est en conflit avec un fichier existant.</p> +Le type `FilenameConflictAction` de l'API {{WebExtAPIRef("downloads")}} spĂ©cifie que faire si le nom d'un fichier tĂ©lĂ©chargĂ© est en conflit avec un fichier existant. -<p>Ce type dĂ©finit les valeurs pouvant ĂȘtre utilisĂ©es pour la propriĂ©tĂ© <code>conflictAction</code> du paramĂštre d'<code>options</code> {{WebExtAPIRef("downloads.download")}}.</p> +Ce type dĂ©finit les valeurs pouvant ĂȘtre utilisĂ©es pour la propriĂ©tĂ© `conflictAction` du paramĂštre d'`options` {{WebExtAPIRef("downloads.download")}}. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<dl> - <dt><code>"uniquify"</code></dt> - <dd>Le navigateur modifiera le nom de fichier pour le rendre unique.</dd> - <dt><code>"overwrite"</code></dt> - <dd>Le navigateur Ă©crase l'ancien fichier avec le fichier nouvellement tĂ©lĂ©chargĂ©.</dd> - <dt><code>"prompt"</code></dt> - <dd>Le navigateur invitera l'utilisateur, lui demandant de choisir s'il souhaite l'uniquifier ou l'Ă©craser.</dd> -</dl> +- `"uniquify"` + - : Le navigateur modifiera le nom de fichier pour le rendre unique. +- `"overwrite"` + - : Le navigateur Ă©crase l'ancien fichier avec le fichier nouvellement tĂ©lĂ©chargĂ©. +- `"prompt"` + - : Le navigateur invitera l'utilisateur, lui demandant de choisir s'il souhaite l'uniquifier ou l'Ă©craser. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.FilenameConflictAction")}}</p> +{{Compat("webextensions.api.downloads.FilenameConflictAction")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -73,5 +69,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/FilenameConflictActi // 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/downloads/getfileicon/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.md index 7fb93c5494..dda5a74a86 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.md @@ -13,51 +13,50 @@ tags: - getFileIcon translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/getFileIcon --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <code><strong>getFileIcon</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} rĂ©cupĂšre une icĂŽne pour le tĂ©lĂ©chargement spĂ©cifiĂ©.</p> +La fonction **`getFileIcon`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} rĂ©cupĂšre une icĂŽne pour le tĂ©lĂ©chargement spĂ©cifiĂ©. -<p>Pour les nouveaux tĂ©lĂ©chargements, les icĂŽnes de fichiers sont disponibles aprĂšs la rĂ©ception de l'Ă©vĂ©nement {{WebExtAPIRef("downloads.onCreated")}}. L'image renvoyĂ©e par cette fonction pendant le tĂ©lĂ©chargement peut ĂȘtre diffĂ©rente de l'image renvoyĂ©e une fois le tĂ©lĂ©chargement terminĂ©.</p> +Pour les nouveaux tĂ©lĂ©chargements, les icĂŽnes de fichiers sont disponibles aprĂšs la rĂ©ception de l'Ă©vĂ©nement {{WebExtAPIRef("downloads.onCreated")}}. L'image renvoyĂ©e par cette fonction pendant le tĂ©lĂ©chargement peut ĂȘtre diffĂ©rente de l'image renvoyĂ©e une fois le tĂ©lĂ©chargement terminĂ©. -<p>La rĂ©cupĂ©ration d'icĂŽnes s'effectue en interrogeant la plateforme sous-jacente. L'icĂŽne renvoyĂ©e dĂ©pendra donc d'un certain nombre de facteurs, notamment l'Ă©tat du tĂ©lĂ©chargement, la plate-forme, les types de fichiers enregistrĂ©s et le thĂšme visuel.</p> +La rĂ©cupĂ©ration d'icĂŽnes s'effectue en interrogeant la plateforme sous-jacente. L'icĂŽne renvoyĂ©e dĂ©pendra donc d'un certain nombre de facteurs, notamment l'Ă©tat du tĂ©lĂ©chargement, la plate-forme, les types de fichiers enregistrĂ©s et le thĂšme visuel. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingIcon = browser.downloads.getFileIcon( +```js +var gettingIcon = browser.downloads.getFileIcon( downloadId, // integer options // optional object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>downloadId</code></dt> - <dd>Un <code>integer</code> eprĂ©sentant l'ID du tĂ©lĂ©chargement.</dd> - <dt><code>options</code>{{optional_inline}}</dt> - <dd><p>Un <code>object</code> d'options reprĂ©sentant les prĂ©fĂ©rences pour l'icĂŽne Ă extraire. Il peut prendre les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>size</code>{{optional_inline}}</dt> - <dd>Un <code>integer</code> reprĂ©sentant la taille de l'icĂŽne. La taille de l'icĂŽne retournĂ©e sera la taille fournie au carrĂ© (en pixels). Si elle est omise, la taille par dĂ©faut de l'icĂŽne est 32x32 pixels.</dd> - </dl> - </dd> -</dl> +- `downloadId` + - : Un `integer` eprĂ©sentant l'ID du tĂ©lĂ©chargement. +- `options`{{optional_inline}} -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : Un `object` d'options reprĂ©sentant les prĂ©fĂ©rences pour l'icĂŽne Ă extraire. Il peut prendre les propriĂ©tĂ©s suivantes : -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>. Si la requĂȘte rĂ©ussit, la promesse sera remplie avec une chaĂźne reprĂ©sentant l'URL absolue de l'icĂŽne. Si la requĂȘte Ă©choue, la promesse sera rejetĂ©e avec un message d'erreur.</p> + - `size`{{optional_inline}} + - : Un `integer` reprĂ©sentant la taille de l'icĂŽne. La taille de l'icĂŽne retournĂ©e sera la taille fournie au carrĂ© (en pixels). Si elle est omise, la taille par dĂ©faut de l'icĂŽne est 32x32 pixels. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.downloads.getFileIcon")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si la requĂȘte rĂ©ussit, la promesse sera remplie avec une chaĂźne reprĂ©sentant l'URL absolue de l'icĂŽne. Si la requĂȘte Ă©choue, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Cet exemple enregistre l'URL de l'icĂŽne pour le tĂ©lĂ©chargement le plus rĂ©cent :</p> +{{Compat("webextensions.api.downloads.getFileIcon")}} -<pre class="brush: js">function gotIcon(iconUrl) { +## Exemples + +Cet exemple enregistre l'URL de l'icĂŽne pour le tĂ©lĂ©chargement le plus rĂ©cent : + +```js +function gotIcon(iconUrl) { console.log(iconUrl); } @@ -66,7 +65,7 @@ function onError(error) { } function getIcon(downloadItems) { - if (downloadItems.length > 0) { + if (downloadItems.length > 0) { latestDownloadId = downloadItems[0].id; var gettingIcon = browser.downloads.getFileIcon(latestDownloadId); gettingIcon.then(gotIcon, onError); @@ -78,19 +77,18 @@ var searching = browser.downloads.search({ orderBy: ["-startTime"] }); -searching.then(getIcon, onError);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +searching.then(getIcon, onError); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/downloads"><code>chrome.downloads</code></a>.</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.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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 @@ -117,5 +115,4 @@ searching.then(getIcon, onError);</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/downloads/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/index.md index 3a5af5f188..1729e6029d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/index.md @@ -12,96 +12,88 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Permet aux extensions d'interagir avec le gestionnaire de tĂ©lĂ©chargement du navigateur. Vous pouvez utiliser ce module API pour tĂ©lĂ©charger des fichiers, annuler, suspendre, reprendre des tĂ©lĂ©chargements et afficher les fichiers tĂ©lĂ©chargĂ©s dans le gestionnaire de fichiers.</p> +Permet aux extensions d'interagir avec le gestionnaire de tĂ©lĂ©chargement du navigateur. Vous pouvez utiliser ce module API pour tĂ©lĂ©charger des fichiers, annuler, suspendre, reprendre des tĂ©lĂ©chargements et afficher les fichiers tĂ©lĂ©chargĂ©s dans le gestionnaire de fichiers. -<p>Pour utiliser cette API, vous devez disposer de l' <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">API permission</a> "downloads" spĂ©cifiĂ©e dans votre fichier <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a>.</p> +Pour utiliser cette API, vous devez disposer de l' [API permission](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "downloads" spĂ©cifiĂ©e dans votre fichier [manifest.json](/fr/Add-ons/WebExtensions/manifest.json). -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("downloads.FilenameConflictAction")}}</dt> - <dd>DĂ©finit les options pour ce qu'il faut faire si le nom d'un fichier tĂ©lĂ©chargĂ© est en conflit avec un fichier existant.</dd> - <dt>{{WebExtAPIRef("downloads.InterruptReason")}}</dt> - <dd>DĂ©finit un ensemble de raisons possibles pour lesquelles un tĂ©lĂ©chargement a Ă©tĂ© interrompu.</dd> - <dt>{{WebExtAPIRef("downloads.DangerType")}}</dt> - <dd>DĂ©finit un ensemble d'avertissements communs des dangers possibles associĂ©s aux fichiers tĂ©lĂ©chargeables.</dd> - <dt>{{WebExtAPIRef("downloads.State")}}</dt> - <dd>DĂ©finit diffĂ©rents Ă©tats dans lesquels un tĂ©lĂ©chargement en cours peut ĂȘtre.</dd> - <dt>{{WebExtAPIRef("downloads.DownloadItem")}}</dt> - <dd>ReprĂ©sente un fichier tĂ©lĂ©chargĂ©.</dd> - <dt>{{WebExtAPIRef("downloads.StringDelta")}}</dt> - <dd>ReprĂ©sente la diffĂ©rence entre deux chaĂźnes.</dd> - <dt>{{WebExtAPIRef("downloads.DoubleDelta")}}</dt> - <dd>ReprĂ©sente la diffĂ©rence entre deux doubles.</dd> - <dt>{{WebExtAPIRef("downloads.BooleanDelta")}}</dt> - <dd>ReprĂ©sente la diffĂ©rence entre deux boolĂ©ens.</dd> - <dt>{{WebExtAPIRef("downloads.DownloadTime")}}</dt> - <dd>ReprĂ©sente le temps nĂ©cessaire au tĂ©lĂ©chargement pour terminer.</dd> - <dt>{{WebExtAPIRef("downloads.DownloadQuery")}}</dt> - <dd>DĂ©finit un ensemble de paramĂštres pouvant ĂȘtre utilisĂ©s pour rechercher dans le gestionnaire de tĂ©lĂ©chargements un ensemble de tĂ©lĂ©chargements spĂ©cifique.</dd> -</dl> +- {{WebExtAPIRef("downloads.FilenameConflictAction")}} + - : DĂ©finit les options pour ce qu'il faut faire si le nom d'un fichier tĂ©lĂ©chargĂ© est en conflit avec un fichier existant. +- {{WebExtAPIRef("downloads.InterruptReason")}} + - : DĂ©finit un ensemble de raisons possibles pour lesquelles un tĂ©lĂ©chargement a Ă©tĂ© interrompu. +- {{WebExtAPIRef("downloads.DangerType")}} + - : DĂ©finit un ensemble d'avertissements communs des dangers possibles associĂ©s aux fichiers tĂ©lĂ©chargeables. +- {{WebExtAPIRef("downloads.State")}} + - : DĂ©finit diffĂ©rents Ă©tats dans lesquels un tĂ©lĂ©chargement en cours peut ĂȘtre. +- {{WebExtAPIRef("downloads.DownloadItem")}} + - : ReprĂ©sente un fichier tĂ©lĂ©chargĂ©. +- {{WebExtAPIRef("downloads.StringDelta")}} + - : ReprĂ©sente la diffĂ©rence entre deux chaĂźnes. +- {{WebExtAPIRef("downloads.DoubleDelta")}} + - : ReprĂ©sente la diffĂ©rence entre deux doubles. +- {{WebExtAPIRef("downloads.BooleanDelta")}} + - : ReprĂ©sente la diffĂ©rence entre deux boolĂ©ens. +- {{WebExtAPIRef("downloads.DownloadTime")}} + - : ReprĂ©sente le temps nĂ©cessaire au tĂ©lĂ©chargement pour terminer. +- {{WebExtAPIRef("downloads.DownloadQuery")}} + - : DĂ©finit un ensemble de paramĂštres pouvant ĂȘtre utilisĂ©s pour rechercher dans le gestionnaire de tĂ©lĂ©chargements un ensemble de tĂ©lĂ©chargements spĂ©cifique. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("downloads.download()")}}</dt> - <dd>TĂ©lĂ©charge un fichier, compte tenu de son URL et d'autres prĂ©fĂ©rences optionnelles.</dd> - <dt>{{WebExtAPIRef("downloads.search()")}}</dt> - <dd>Interroge le {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} disponible dans le gestionnaire de tĂ©lĂ©chargements du navigateur et renvoie ceux qui correspondent aux critĂšres de recherche spĂ©cifiĂ©s.</dd> - <dt>{{WebExtAPIRef("downloads.pause()")}}</dt> - <dd>Suspend un tĂ©lĂ©chargement.</dd> - <dt>{{WebExtAPIRef("downloads.resume()")}}</dt> - <dd>Reprend un tĂ©lĂ©chargement suspendu.</dd> - <dt>{{WebExtAPIRef("downloads.cancel()")}}</dt> - <dd>Annule un tĂ©lĂ©chargement.</dd> - <dt>{{WebExtAPIRef("downloads.getFileIcon()")}}</dt> - <dd>RĂ©cupĂšre une icĂŽne pour le tĂ©lĂ©chargement spĂ©cifiĂ©.</dd> - <dt>{{WebExtAPIRef("downloads.open()")}}</dt> - <dd>Ouvre le fichier tĂ©lĂ©chargĂ© avec son application associĂ©e.</dd> - <dt>{{WebExtAPIRef("downloads.show()")}}</dt> - <dd>Ouvre l'application du gestionnaire de fichiers de la plateforme pour afficher le fichier tĂ©lĂ©chargĂ© dans son dossier conteneur.</dd> - <dt>{{WebExtAPIRef("downloads.showDefaultFolder()")}}</dt> - <dd>Ouvre l'application du gestionnaire de fichiers de la plateforme pour afficher le dossier de tĂ©lĂ©chargements par dĂ©faut.</dd> - <dt>{{WebExtAPIRef("downloads.erase()")}}</dt> - <dd>Efface la correspondance {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} de l'historique de tĂ©lĂ©chargement du navigateur, sans supprimer les fichiers tĂ©lĂ©chargĂ©s du disque.</dd> - <dt>{{WebExtAPIRef("downloads.removeFile()")}}</dt> - <dd>Supprime un fichier tĂ©lĂ©chargĂ© du disque, mais pas de l'historique de tĂ©lĂ©chargement du navigateur.</dd> - <dt>{{WebExtAPIRef("downloads.acceptDanger()")}}</dt> - <dd>Invite l'utilisateur Ă accepter ou annuler un tĂ©lĂ©chargement dangereux.</dd> - <dt>{{WebExtAPIRef("downloads.drag()")}}</dt> - <dd>Lance le glissement du fichier tĂ©lĂ©chargĂ© vers une autre application.</dd> - <dt>{{WebExtAPIRef("downloads.setShelfEnabled()")}}</dt> - <dd>Active ou dĂ©sactive l'Ă©tagĂšre grise en bas de chaque fenĂȘtre associĂ©e au profil de navigateur actuel. L'Ă©tagĂšre sera dĂ©sactivĂ©e si au moins une extension l'a dĂ©sactivĂ©e.</dd> -</dl> +- {{WebExtAPIRef("downloads.download()")}} + - : TĂ©lĂ©charge un fichier, compte tenu de son URL et d'autres prĂ©fĂ©rences optionnelles. +- {{WebExtAPIRef("downloads.search()")}} + - : Interroge le {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} disponible dans le gestionnaire de tĂ©lĂ©chargements du navigateur et renvoie ceux qui correspondent aux critĂšres de recherche spĂ©cifiĂ©s. +- {{WebExtAPIRef("downloads.pause()")}} + - : Suspend un tĂ©lĂ©chargement. +- {{WebExtAPIRef("downloads.resume()")}} + - : Reprend un tĂ©lĂ©chargement suspendu. +- {{WebExtAPIRef("downloads.cancel()")}} + - : Annule un tĂ©lĂ©chargement. +- {{WebExtAPIRef("downloads.getFileIcon()")}} + - : RĂ©cupĂšre une icĂŽne pour le tĂ©lĂ©chargement spĂ©cifiĂ©. +- {{WebExtAPIRef("downloads.open()")}} + - : Ouvre le fichier tĂ©lĂ©chargĂ© avec son application associĂ©e. +- {{WebExtAPIRef("downloads.show()")}} + - : Ouvre l'application du gestionnaire de fichiers de la plateforme pour afficher le fichier tĂ©lĂ©chargĂ© dans son dossier conteneur. +- {{WebExtAPIRef("downloads.showDefaultFolder()")}} + - : Ouvre l'application du gestionnaire de fichiers de la plateforme pour afficher le dossier de tĂ©lĂ©chargements par dĂ©faut. +- {{WebExtAPIRef("downloads.erase()")}} + - : Efface la correspondance {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} de l'historique de tĂ©lĂ©chargement du navigateur, sans supprimer les fichiers tĂ©lĂ©chargĂ©s du disque. +- {{WebExtAPIRef("downloads.removeFile()")}} + - : Supprime un fichier tĂ©lĂ©chargĂ© du disque, mais pas de l'historique de tĂ©lĂ©chargement du navigateur. +- {{WebExtAPIRef("downloads.acceptDanger()")}} + - : Invite l'utilisateur Ă accepter ou annuler un tĂ©lĂ©chargement dangereux. +- {{WebExtAPIRef("downloads.drag()")}} + - : Lance le glissement du fichier tĂ©lĂ©chargĂ© vers une autre application. +- {{WebExtAPIRef("downloads.setShelfEnabled()")}} + - : Active ou dĂ©sactive l'Ă©tagĂšre grise en bas de chaque fenĂȘtre associĂ©e au profil de navigateur actuel. L'Ă©tagĂšre sera dĂ©sactivĂ©e si au moins une extension l'a dĂ©sactivĂ©e. -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt>{{WebExtAPIRef("downloads.onCreated")}}</dt> - <dd>Se dĂ©clenche avec l'objet {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} lorsqu'un tĂ©lĂ©chargement commence.</dd> - <dt>{{WebExtAPIRef("downloads.onErased")}}</dt> - <dd>Se dĂ©clenche avec <code>downloadId</code> lorsqu'un tĂ©lĂ©chargement est effacĂ© de l'historique.</dd> - <dt>{{WebExtAPIRef("downloads.onChanged")}}</dt> - <dd>Lorsque l'une des propriĂ©tĂ©s de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} sauf les changements <code>bytesReceived</code>, cet Ă©vĂ©nement se dĂ©clenche avec le <code>downloadId</code> et un objet contenant les propriĂ©tĂ©s qui ont changĂ©.</dd> -</dl> +- {{WebExtAPIRef("downloads.onCreated")}} + - : Se dĂ©clenche avec l'objet {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} lorsqu'un tĂ©lĂ©chargement commence. +- {{WebExtAPIRef("downloads.onErased")}} + - : Se dĂ©clenche avec `downloadId` lorsqu'un tĂ©lĂ©chargement est effacĂ© de l'historique. +- {{WebExtAPIRef("downloads.onChanged")}} + - : Lorsque l'une des propriĂ©tĂ©s de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} sauf les changements `bytesReceived`, cet Ă©vĂ©nement se dĂ©clenche avec le `downloadId` et un objet contenant les propriĂ©tĂ©s qui ont changĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads")}}</p> +{{Compat("webextensions.api.downloads")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -128,5 +120,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads // 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/downloads/interruptreason/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.md index fa29a664f6..989176a3f8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.md @@ -13,80 +13,68 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/InterruptReason --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>InteruptReason</code> de l'API {{WebExtAPIRef("downloads")}} dĂ©finit un ensemble de raisons possibles pour lesquelles un tĂ©lĂ©chargement a Ă©tĂ© interrompu.</p> +Le type `InteruptReason` de l'API {{WebExtAPIRef("downloads")}} dĂ©finit un ensemble de raisons possibles pour lesquelles un tĂ©lĂ©chargement a Ă©tĂ© interrompu. -<p>Une propriĂ©tĂ© {{WebExtAPIRef('downloads.DownloadItem')}} d'<code>erreur</code> contiendra une chaĂźne tirĂ©e des valeurs dĂ©finies dans ce type.</p> +Une propriĂ©tĂ© {{WebExtAPIRef('downloads.DownloadItem')}} d'`erreur` contiendra une chaĂźne tirĂ©e des valeurs dĂ©finies dans ce type. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont divisĂ©es en catĂ©gories, chaque ensemble ayant la mĂȘme sous-chaĂźne au dĂ©but:</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont divisĂ©es en catĂ©gories, chaque ensemble ayant la mĂȘme sous-chaĂźne au dĂ©but: -<p>Erreurs liĂ©es au fichier :</p> +Erreurs liĂ©es au fichier : -<ul> - <li><code>"FILE_FAILED"</code></li> - <li><code>"FILE_ACCESS_DENIED"</code></li> - <li><code>"FILE_NO_SPACE"</code></li> - <li><code>"FILE_NAME_TOO_LONG"</code></li> - <li><code>"FILE_TOO_LARGE"</code></li> - <li><code>"FILE_VIRUS_INFECTED"</code></li> - <li><code>"FILE_TRANSIENT_ERROR"</code></li> - <li><code>"FILE_BLOCKED"</code></li> - <li><code>"FILE_SECURITY_CHECK_FAILED"</code></li> - <li><code>"FILE_TOO_SHORT"</code></li> -</ul> +- `"FILE_FAILED"` +- `"FILE_ACCESS_DENIED"` +- `"FILE_NO_SPACE"` +- `"FILE_NAME_TOO_LONG"` +- `"FILE_TOO_LARGE"` +- `"FILE_VIRUS_INFECTED"` +- `"FILE_TRANSIENT_ERROR"` +- `"FILE_BLOCKED"` +- `"FILE_SECURITY_CHECK_FAILED"` +- `"FILE_TOO_SHORT"` -<p>Erreurs liĂ©es au rĂ©seau :</p> +Erreurs liĂ©es au rĂ©seau : -<ul> - <li><code>"NETWORK_FAILED"</code></li> - <li><code>"NETWORK_TIMEOUT"</code></li> - <li><code>"NETWORK_DISCONNECTED"</code></li> - <li><code>"NETWORK_SERVER_DOWN"</code></li> - <li><code>"NETWORK_INVALID_REQUEST"</code></li> -</ul> +- `"NETWORK_FAILED"` +- `"NETWORK_TIMEOUT"` +- `"NETWORK_DISCONNECTED"` +- `"NETWORK_SERVER_DOWN"` +- `"NETWORK_INVALID_REQUEST"` -<p>Erreurs liĂ©es au serveur :</p> +Erreurs liĂ©es au serveur : -<ul> - <li><code>"SERVER_FAILED"</code></li> - <li><code>"SERVER_NO_RANGE"</code></li> - <li><code>"SERVER_BAD_CONTENT"</code></li> - <li><code>"SERVER_UNAUTHORIZED"</code></li> - <li><code>"SERVER_CERT_PROBLEM"</code></li> - <li><code>"SERVER_FORBIDDEN"</code></li> -</ul> +- `"SERVER_FAILED"` +- `"SERVER_NO_RANGE"` +- `"SERVER_BAD_CONTENT"` +- `"SERVER_UNAUTHORIZED"` +- `"SERVER_CERT_PROBLEM"` +- `"SERVER_FORBIDDEN"` -<p>Erreurs liĂ©es Ă l'utilisateur :</p> +Erreurs liĂ©es Ă l'utilisateur : -<ul> - <li><code>"USER_CANCELED"</code></li> - <li><code>"USER_SHUTDOWN"</code></li> -</ul> +- `"USER_CANCELED"` +- `"USER_SHUTDOWN"` -<p>Divers :</p> +Divers : -<ul> - <li><code>"CRASH"</code></li> -</ul> +- `"CRASH"` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.InterruptReason")}}</p> +{{Compat("webextensions.api.downloads.InterruptReason")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -113,5 +101,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/InterruptReason // 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/downloads/onchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.md index 5637ace775..5e1f262aac 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.md @@ -14,110 +14,102 @@ tags: - onChanged translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'Ă©vĂ©nement <code><strong>onChanged</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} est dĂ©clenchĂ© lorsque l'une des propriĂ©tĂ©s de {{WebExtAPIRef('downloads.DownloadItem')}} change (Ă l'exception de <code>bytesReceived</code>).</p> +L'Ă©vĂ©nement **`onChanged`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} est dĂ©clenchĂ© lorsque l'une des propriĂ©tĂ©s de {{WebExtAPIRef('downloads.DownloadItem')}} change (Ă l'exception de `bytesReceived`). -<p>L'Ă©couteur reçoit un fichier <code>downloadDelta</code> en tant que paramĂštre â un objet contenant le <code>downloadId</code> de l'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question, plus le statut de toutes les propriĂ©tĂ©s qui ont changĂ©.</p> +L'Ă©couteur reçoit un fichier `downloadDelta` en tant que paramĂštre â un objet contenant le `downloadId` de l'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question, plus le statut de toutes les propriĂ©tĂ©s qui ont changĂ©. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.downloads.onChanged.addListener(listener) +```js +browser.downloads.onChanged.addListener(listener) browser.downloads.onChanged.removeListener(listener) browser.downloads.onChanged.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si un <code>listener</code> donnĂ© est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="Parameters">Parameters</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. Cette fonction recevra les arguments suivants :</p> - - <dl> - <dt><code>downloadDelta</code></dt> - <dd>Un <a href="#downloadDelta"><code>objet</code></a> reprĂ©sentant l'objet {{WebExtAPIRef('downloads.DownloadItem')}} qui a Ă©tĂ© modifiĂ©, ainsi que l'Ă©tat de toutes les propriĂ©tĂ©s qui y ont Ă©tĂ© modifiĂ©es.</dd> - </dl> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="downloadDelta">downloadDelta</h3> - -<p>L'objet <code>downloadDelta</code> a les propriĂ©tĂ©s suivantes disponibles :</p> - -<dl> - <dt><code>id</code></dt> - <dd>Un <code>integer</code> reprĂ©sentant l'identifiant de l'<code>id</code> {{WebExtAPIRef('downloads.DownloadItem')}} qui a changĂ©.</dd> - <dt><code>url</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant une modification d'une  <code>url</code> {{WebExtAPIRef('downloads.DownloadItem')}}.</dd> - <dt><code>filename</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un <code>filename</code> {{WebExtAPIRef('downloads.DownloadItem')}}</dd> - <dt><code>danger</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un <code>danger</code> {{WebExtAPIRef('downloads.DownloadItem')}}.</dd> - <dt><code>mime</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un <code>mime</code> {{WebExtAPIRef('downloads.DownloadItem')}}</dd> - <dt><code>startTime</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un <code>startTime</code> {{WebExtAPIRef('downloads.DownloadItem')}}.</dd> - <dt><code>endTime</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un <code>endTime</code> {{WebExtAPIRef('downloads.DownloadItem')}}.</dd> - <dt><code>state</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un <code>Ă©tat</code> {{WebExtAPIRef('downloads.DownloadItem')}}</dd> - <dt><code>canResume</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} dĂ©crivant un changement dans un Ă©tat {{WebExtAPIRef('downloads.DownloadItem')}} <code>canResume</code>.</dd> - <dt><code>paused</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} dĂ©crivant un changement dans un Ă©tat en <code>pause</code> {{WebExtAPIRef('downloads.DownloadItem')}}.</dd> - <dt><code>error</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un Ă©tat d'<code>erreur</code> {{WebExtAPIRef('downloads.DownloadItem')}}.</dd> - <dt><code>totalBytes</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.DoubleDelta')}} dĂ©crivant un changement dans un <code>totalBytes</code> {{WebExtAPIRef('downloads.DownloadItem')}}.</dd> - <dt><code>fileSize</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.DoubleDelta')}} dĂ©crivant une modification d'un <code>fileSize</code> {{WebExtAPIRef('downloads.DownloadItem')}}.</dd> - <dt><code>exists</code>{{optional_inline}}</dt> - <dd>Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} dĂ©crivant un changement dans un Ă©tat {{WebExtAPIRef('downloads.DownloadItem')}}.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.downloads.onChanged")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Enregistrez un message lorsque les tĂ©lĂ©chargements sont terminĂ©s :</p> - -<pre class="brush: js">function handleChanged(delta) { - if (delta.state && delta.state.current === "complete") { +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si un `listener` donnĂ© est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. + +## Syntaxe addListener + +### Parameters + +- `callback` + + - : Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. Cette fonction recevra les arguments suivants : + + - `downloadDelta` + - : Un [`objet`](#downloadDelta) reprĂ©sentant l'objet {{WebExtAPIRef('downloads.DownloadItem')}} qui a Ă©tĂ© modifiĂ©, ainsi que l'Ă©tat de toutes les propriĂ©tĂ©s qui y ont Ă©tĂ© modifiĂ©es. + +## Objets supplĂ©mentaires + +### downloadDelta + +L'objet `downloadDelta` a les propriĂ©tĂ©s suivantes disponibles : + +- `id` + - : Un `integer` reprĂ©sentant l'identifiant de l'`id` {{WebExtAPIRef('downloads.DownloadItem')}} qui a changĂ©. +- `url`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant une modification d'une  `url` {{WebExtAPIRef('downloads.DownloadItem')}}. +- `filename`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un `filename` {{WebExtAPIRef('downloads.DownloadItem')}} +- `danger`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un `danger` {{WebExtAPIRef('downloads.DownloadItem')}}. +- `mime`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un `mime` {{WebExtAPIRef('downloads.DownloadItem')}} +- `startTime`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un `startTime` {{WebExtAPIRef('downloads.DownloadItem')}}. +- `endTime`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un `endTime` {{WebExtAPIRef('downloads.DownloadItem')}}. +- `state`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un `Ă©tat` {{WebExtAPIRef('downloads.DownloadItem')}} +- `canResume`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} dĂ©crivant un changement dans un Ă©tat {{WebExtAPIRef('downloads.DownloadItem')}} `canResume`. +- `paused`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} dĂ©crivant un changement dans un Ă©tat en `pause` {{WebExtAPIRef('downloads.DownloadItem')}}. +- `error`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.StringDelta')}} dĂ©crivant un changement dans un Ă©tat d'`erreur` {{WebExtAPIRef('downloads.DownloadItem')}}. +- `totalBytes`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.DoubleDelta')}} dĂ©crivant un changement dans un `totalBytes` {{WebExtAPIRef('downloads.DownloadItem')}}. +- `fileSize`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.DoubleDelta')}} dĂ©crivant une modification d'un `fileSize` {{WebExtAPIRef('downloads.DownloadItem')}}. +- `exists`{{optional_inline}} + - : Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} dĂ©crivant un changement dans un Ă©tat {{WebExtAPIRef('downloads.DownloadItem')}}. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.downloads.onChanged")}} + +## Exemples + +Enregistrez un message lorsque les tĂ©lĂ©chargements sont terminĂ©s : + +```js +function handleChanged(delta) { + if (delta.state && delta.state.current === "complete") { console.log(`Download ${delta.id} has completed.`); } } -browser.downloads.onChanged.addListener(handleChanged);</pre> +browser.downloads.onChanged.addListener(handleChanged); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> This API is based on Chromium's [`chrome.downloads`](https://developer.chrome.com/extensions/downloads#event-onChanged) API. +> +> Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License. -<p>This API is based on Chromium's <a href="https://developer.chrome.com/extensions/downloads#event-onChanged"><code>chrome.downloads</code></a> API.</p> - -<p>Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.</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 @@ -144,5 +136,4 @@ browser.downloads.onChanged.addListener(handleChanged);</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/downloads/oncreated/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.md index 5039805f8c..7b4740451d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.md @@ -13,71 +13,65 @@ tags: - onCreated translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onCreated --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'Ă©vĂ©nement <code><strong>onCreated</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} se dĂ©clenche lorsqu'un tĂ©lĂ©chargement commence, c'est Ă dire lorsque quand {{WebExtAPIRef("downloads.download()")}} est appelĂ© avec succĂšs.</p> +L'Ă©vĂ©nement **`onCreated`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} se dĂ©clenche lorsqu'un tĂ©lĂ©chargement commence, c'est Ă dire lorsque quand {{WebExtAPIRef("downloads.download()")}} est appelĂ© avec succĂšs. -<p>L'Ă©couteur reçoit l'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question en tant que paramĂštre.</p> +L'Ă©couteur reçoit l'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question en tant que paramĂštre. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.downloads.onCreated.addListener(listener) +```js +browser.downloads.onCreated.addListener(listener) browser.downloads.onCreated.removeListener(listener) browser.downloads.onCreated.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si un <code>listener</code> donnĂ© est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si un `listener` donnĂ© est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>function</code></dt> - <dd> - <p>Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. Cette fonction recevra les arguments suivants :</p> +- `function` - <dl> - <dt><code>downloadItem</code></dt> - <dd>L'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question.</dd> - </dl> - </dd> -</dl> + - : Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. Cette fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `downloadItem` + - : L'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question. -<p>{{Compat("webextensions.api.downloads.onCreated")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.downloads.onCreated")}} -<p>Consignez l'URL des Ă©lĂ©ments au fur et Ă mesure qu'ils sont tĂ©lĂ©chargĂ©s :</p> +## Exemples -<pre class="brush: js">function handleCreated(item) { +Consignez l'URL des Ă©lĂ©ments au fur et Ă mesure qu'ils sont tĂ©lĂ©chargĂ©s : + +```js +function handleCreated(item) { console.log(item.url); } -browser.downloads.onCreated.addListener(handleCreated);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.downloads.onCreated.addListener(handleCreated); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/downloads"><code>chrome.downloads</code></a>.</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.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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 @@ -104,5 +98,4 @@ browser.downloads.onCreated.addListener(handleCreated);</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/downloads/onerased/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.md index dd6619721b..a9405d0c89 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.md @@ -13,55 +13,50 @@ tags: - onErased translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onErased --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'Ă©vĂ©nement <code><strong>onErased</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} se dĂ©clenche lorsqu'un tĂ©lĂ©chargement est effacĂ© de l'historique du navigateur.</p> +L'Ă©vĂ©nement **`onErased`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} se dĂ©clenche lorsqu'un tĂ©lĂ©chargement est effacĂ© de l'historique du navigateur. -<p>L'Ă©couteur reçoit le paramĂštre <code>downloadId</code> de l'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question en tant que paramĂštre.</p> +L'Ă©couteur reçoit le paramĂštre `downloadId` de l'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question en tant que paramĂštre. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.downloads.onErased.addListener(listener) +```js +browser.downloads.onErased.addListener(listener) browser.downloads.onErased.removeListener(listener) browser.downloads.onErased.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer..</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>listener</code> donnĂ© est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer.. +- `hasListener(listener)` + - : VĂ©rifie si un `listener` donnĂ© est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="syntaxe_addListener">syntaxe addListener</h2> +## syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. Cette fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>downloadId</code></dt> - <dd>Un <code>integer</code> reprĂ©sentant l'<code>id</code> du {{WebExtAPIRef('downloads.DownloadItem')}} qui a Ă©tĂ© effacĂ©.</dd> - </dl> - </dd> -</dl> + - : Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. Cette fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `downloadId` + - : Un `integer` reprĂ©sentant l'`id` du {{WebExtAPIRef('downloads.DownloadItem')}} qui a Ă©tĂ© effacĂ©. -<p>{{Compat("webextensions.api.downloads.onErased")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.downloads.onErased")}} -<p>Ajoute un Ă©couteur pour les Ă©vĂ©nements <code>onErased</code> , puis effacez le tĂ©lĂ©chargement le plus rĂ©cent :</p> +## Exemples -<pre class="brush: js">function handleErased(item) { +Ajoute un Ă©couteur pour les Ă©vĂ©nements `onErased` , puis effacez le tĂ©lĂ©chargement le plus rĂ©cent : + +```js +function handleErased(item) { console.log(`Erased: ${item}`); } @@ -70,19 +65,18 @@ browser.downloads.onErased.addListener(handleErased); var erasing = browser.downloads.erase({ limit: 1, orderBy: ["-startTime"] -});</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/downloads"><code>chrome.downloads</code></a>.</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.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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 @@ -109,5 +103,4 @@ var erasing = browser.downloads.erase({ // 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/downloads/open/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.md index 336cacc837..bc3000bdef 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.md @@ -13,41 +13,41 @@ tags: - open translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/open --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <code><strong>open()</strong></code> de l'API {{WebExtAPIRef("downloads")}} ouvre le fichier tĂ©lĂ©chargĂ© avec son application associĂ©e. Un Ă©vĂ©nement {{WebExtAPIRef("downloads.onChanged")}} se dĂ©clenche lorsque l'Ă©lĂ©ment est ouvert pour la premiĂšre fois.</p> +La fonction **`open()`** de l'API {{WebExtAPIRef("downloads")}} ouvre le fichier tĂ©lĂ©chargĂ© avec son application associĂ©e. Un Ă©vĂ©nement {{WebExtAPIRef("downloads.onChanged")}} se dĂ©clenche lorsque l'Ă©lĂ©ment est ouvert pour la premiĂšre fois. -<p>Pour utiliser cette fonction dans votre extension, vous devez demander la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission manifest</a> "downloads.open", ainsi que la permission "downloads". En outre, vous pouvez uniquement appeler cette fonction Ă l'intĂ©rieur du gestionnaire pour une <a href="/fr/Add-ons/WebExtensions/User_actions">action utilisateur</a>.</p> +Pour utiliser cette fonction dans votre extension, vous devez demander la [permission manifest](/fr/Add-ons/WebExtensions/manifest.json/permissions) "downloads.open", ainsi que la permission "downloads". En outre, vous pouvez uniquement appeler cette fonction Ă l'intĂ©rieur du gestionnaire pour une [action utilisateur](/fr/Add-ons/WebExtensions/User_actions). -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 opening = browser.downloads.open( +```js +var opening = browser.downloads.open( downloadId // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>downloadId</code></dt> - <dd>Un <code>integer</code> reprĂ©sentant l'<code>id</code> du {{WebExtAPIRef("downloads.DownloadItem")}} que vous voulez ouvrir.</dd> -</dl> +- `downloadId` + - : Un `integer` reprĂ©sentant l'`id` du {{WebExtAPIRef("downloads.DownloadItem")}} que vous voulez ouvrir. -<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>. Si la demande a Ă©tĂ© acceptĂ©e, la promesse sera remplie sans arguments. Si la demande a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si la demande a Ă©tĂ© acceptĂ©e, la promesse sera remplie sans arguments. Si la demande a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.open")}}</p> +{{Compat("webextensions.api.downloads.open")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple ouvre l'Ă©lĂ©ment le plus rĂ©cemment tĂ©lĂ©chargĂ© :</p> +Cet exemple ouvre l'Ă©lĂ©ment le plus rĂ©cemment tĂ©lĂ©chargĂ© : -<pre class="brush: js">function onOpened() { +```js +function onOpened() { console.log(`Opened download item`); } @@ -56,7 +56,7 @@ function onError(error) { } function openDownload(downloadItems) { - if (downloadItems.length > 0) { + if (downloadItems.length > 0) { var opening = browser.downloads.open(downloadItems[0].id); opening.then(onOpened, onError); } @@ -67,19 +67,18 @@ var searching = browser.downloads.search({ orderBy: ["-startTime"] }); -searching.then(openDownload, onError);</pre> +searching.then(openDownload, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -106,5 +105,4 @@ searching.then(openDownload, onError);</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/downloads/pause/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.md index 2a72e562eb..5e6b50dc4b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.md @@ -13,37 +13,37 @@ tags: - pause translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/pause --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <code><strong>pause</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} interrompt un tĂ©lĂ©chargement.</p> +La fonction **`pause`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} interrompt un tĂ©lĂ©chargement. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 pausing = browser.downloads.pause( +```js +var pausing = browser.downloads.pause( downloadId // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>downloadId</code></dt> - <dd>Un <code>integer</code> reprĂ©setant l'<code>id</code> du tĂ©lĂ©chargement Ă mettre en pause.</dd> -</dl> +- `downloadId` + - : Un `integer` reprĂ©setant l'`id` du tĂ©lĂ©chargement Ă mettre en pause. -<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>. Si l'appel a rĂ©ussi, le tĂ©lĂ©chargement sera mis en pause et la promesse sera satisfaite sans aucun argument. Si l'appel Ă©choue, la promesse sera rejetĂ©e avec un message d'erreur. L'appel Ă©chouera si le tĂ©lĂ©chargement n'est pas actif: par exemple, parce qu'il a fini le tĂ©lĂ©chargement.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si l'appel a rĂ©ussi, le tĂ©lĂ©chargement sera mis en pause et la promesse sera satisfaite sans aucun argument. Si l'appel Ă©choue, la promesse sera rejetĂ©e avec un message d'erreur. L'appel Ă©chouera si le tĂ©lĂ©chargement n'est pas actif: par exemple, parce qu'il a fini le tĂ©lĂ©chargement. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.pause")}}</p> +{{Compat("webextensions.api.downloads.pause")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function onPaused() { +```js +function onPaused() { console.log(`Paused download`); } @@ -52,19 +52,18 @@ function onError(error) { } var pausing = browser.downloads.pause(downloadId); -pausing.then(onPaused, onError);</pre> +pausing.then(onPaused, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 Les auteurs de chrome. Tous les droits sont rĂ©servĂ©s. +<div class="hidden"><pre>// Copyright 2015 Les auteurs de chrome. Tous les droits sont rĂ©servĂ©s. // // Redistribution et utilisation sous forme source et binaire, avec ou sans // modification, sont autorisĂ©es Ă condition que les conditions suivantes soient @@ -90,5 +89,4 @@ pausing.then(onPaused, onError);</pre> // THĂORIE DE LA RESPONSABILITĂ, QU'IL SOIT UN CONTRAT, UNE RESPONSABILITĂ STRICTE OU UN TORT // (INCLUANT LA NĂGLIGENCE OU AUTREMENT) SURVENANT DE TOUTE MANIĂRE DE L'UTILISER // DE CE LOGICIEL, MĂME SI AVISĂ DE LA POSSIBILITĂ D'UN TEL DOMMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md index 4bc3a2a440..877b2e17e7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md @@ -13,47 +13,45 @@ tags: - removeFile translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/removeFile --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <code><strong>removeFile</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} supprime un fichier tĂ©lĂ©chargĂ© du disque.</p> +La fonction **`removeFile`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} supprime un fichier tĂ©lĂ©chargĂ© du disque. -<p>Cette API supprime le fichier du disque, mais ne le supprime pas de l'historique des tĂ©lĂ©chargements du navigateur, donc un appel {{WebExtAPIRef("downloads.search()")}} renvoie toujours l'Ă©lĂ©ment comme {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}}, mais son attribut <code>exists</code> sera <code>false</code>.</p> +Cette API supprime le fichier du disque, mais ne le supprime pas de l'historique des tĂ©lĂ©chargements du navigateur, donc un appel {{WebExtAPIRef("downloads.search()")}} renvoie toujours l'Ă©lĂ©ment comme {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}}, mais son attribut `exists` sera `false`. -<p>Pour supprimer un fichier de l'historique des tĂ©lĂ©chargements, vous devez utiliser {{WebExtAPIRef("downloads.erase()")}}.</p> +Pour supprimer un fichier de l'historique des tĂ©lĂ©chargements, vous devez utiliser {{WebExtAPIRef("downloads.erase()")}}. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<div class="note"> -<p><strong>Note :</strong> Si vous souhaitez supprimer un fichier tĂ©lĂ©chargĂ© du disque et l'effacer de l'historique, vous devez appeler <code>removeFile()</code> avant d'appeler {{WebExtAPIRef("downloads.erase()")}}. Si vous l'essayez dans l'autre sens, vous obtiendrez une erreur lors de l'appel de <code>removeFile()</code>, car le navigateur n'aura plus d'enregistrement du tĂ©lĂ©chargement.</p> -</div> +> **Note :** Si vous souhaitez supprimer un fichier tĂ©lĂ©chargĂ© du disque et l'effacer de l'historique, vous devez appeler `removeFile()` avant d'appeler {{WebExtAPIRef("downloads.erase()")}}. Si vous l'essayez dans l'autre sens, vous obtiendrez une erreur lors de l'appel de `removeFile()`, car le navigateur n'aura plus d'enregistrement du tĂ©lĂ©chargement. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var removing = browser.downloads.removeFile( +```js +var removing = browser.downloads.removeFile( downloadId // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>downloadId</code></dt> - <dd>Un <code>integer</code> reprĂ©sentant l'identifiant de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} que vous souhaitez supprimer du disque.</dd> -</dl> +- `downloadId` + - : Un `integer` reprĂ©sentant l'identifiant de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} que vous souhaitez supprimer du disque. -<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>. Si la demande a Ă©tĂ© acceptĂ©e, la promesse sera remplie sans arguments. Si la demande a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si la demande a Ă©tĂ© acceptĂ©e, la promesse sera remplie sans arguments. Si la demande a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.removeFile")}}</p> +{{Compat("webextensions.api.downloads.removeFile")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprimer le dernier fichier tĂ©lĂ©chargĂ© :</p> +Supprimer le dernier fichier tĂ©lĂ©chargĂ© : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log(`Removed item`); } @@ -62,7 +60,7 @@ function onError(error) { } function remove(downloadItems) { - if (downloadItems.length > 0) { + if (downloadItems.length > 0) { var removing = browser.downloads.removeFile(downloadItems[0].id); removing.then(onRemoved, onError); } @@ -73,19 +71,18 @@ var searching = browser.downloads.search({ orderBy: ["-startTime"] }); -searching.then(remove, onError);</pre> +searching.then(remove, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -112,5 +109,4 @@ searching.then(remove, onError);</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/downloads/resume/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.md index 61ff022edf..74b430a332 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.md @@ -13,37 +13,37 @@ tags: - resume translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/resume --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <code><strong>resume</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} reprend un tĂ©lĂ©chargement suspendu. Si la demande a abouti, le tĂ©lĂ©chargement ne sera pas interrompu et la progression reprendra. L'appel <code>resume()</code> Ă©chouera si le tĂ©lĂ©chargement n'est pas actif: par exemple, parce qu'il a fini le tĂ©lĂ©chargement.</p> +La fonction **`resume`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} reprend un tĂ©lĂ©chargement suspendu. Si la demande a abouti, le tĂ©lĂ©chargement ne sera pas interrompu et la progression reprendra. L'appel `resume()` Ă©chouera si le tĂ©lĂ©chargement n'est pas actif: par exemple, parce qu'il a fini le tĂ©lĂ©chargement. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 resuming = browser.downloads.resume( +```js +var resuming = browser.downloads.resume( downloadId // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>downloadId</code></dt> - <dd>Un <code>integer</code> reprĂ©sentant l'<code>id</code> du tĂ©lĂ©chargement Ă reprendre.</dd> -</dl> +- `downloadId` + - : Un `integer` reprĂ©sentant l'`id` du tĂ©lĂ©chargement Ă reprendre. -<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>. Si la demande a Ă©tĂ© acceptĂ©e, la promesse sera remplie sans arguments. Si la demande a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si la demande a Ă©tĂ© acceptĂ©e, la promesse sera remplie sans arguments. Si la demande a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.resume")}}</p> +{{Compat("webextensions.api.downloads.resume")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">var downloadId = 2; +```js +var downloadId = 2; function onResumed() { console.log(`Resumed download`); @@ -54,19 +54,18 @@ function onError(error) { } var resuming = browser.downloads.resume(downloadId); -resuming.then(onResumed, onError);</pre> +resuming.then(onResumed, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -93,5 +92,4 @@ resuming.then(onResumed, onError);</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/downloads/search/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.md index 5f7fa9d84c..75fba0b484 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.md @@ -14,39 +14,39 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/search --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <strong><code>search()</code></strong> de l'API {{WebExtAPIRef("downloads")}} interroge les {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} disponibles dans le gestionnaire de tĂ©lĂ©chargements du navigateur, et renvoie celles qui correspondent aux spĂ©cifications critĂšres de recherche.</p> +La fonction **`search()`** de l'API {{WebExtAPIRef("downloads")}} interroge les {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} disponibles dans le gestionnaire de tĂ©lĂ©chargements du navigateur, et renvoie celles qui correspondent aux spĂ©cifications critĂšres de recherche. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 searching = browser.downloads.search(query); -</pre> +```js +var searching = browser.downloads.search(query); +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>query</code></dt> - <dd>Un objet {{WebExtAPIRef('downloads.DownloadQuery')}}.</dd> -</dl> +- `query` + - : Un objet {{WebExtAPIRef('downloads.DownloadQuery')}}. -<h3 id="Return_value">Return value</h3> +### Return value -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>. La promise est remplie avec un <code>tableau d'objets</code> <code>{{WebExtAPIRef('downloads.DownloadItem')}}</code> qui correspondent aux critĂšres donnĂ©s.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). La promise est remplie avec un `tableau d'objets` `{{WebExtAPIRef('downloads.DownloadItem')}}` qui correspondent aux critĂšres donnĂ©s. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.search")}}</p> +{{Compat("webextensions.api.downloads.search")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>En gĂ©nĂ©ral, vous restreignez les Ă©lĂ©ments rĂ©cupĂ©rĂ©s Ă l'aide du paramĂštre de <code>requĂȘte</code>.</p> +En gĂ©nĂ©ral, vous restreignez les Ă©lĂ©ments rĂ©cupĂ©rĂ©s Ă l'aide du paramĂštre de `requĂȘte`. -<h3 id="Obtenez_les_tĂ©lĂ©chargements_correspondant_Ă _query">Obtenez les tĂ©lĂ©chargements correspondant Ă "query"</h3> +### Obtenez les tĂ©lĂ©chargements correspondant Ă "query" -<pre class="brush: js">function logDownloads(downloads) { +```js +function logDownloads(downloads) { for (let download of downloads) { console.log(download.id); console.log(download.url); @@ -61,13 +61,15 @@ var searching = browser.downloads.search({ query:["imgur"] }); -searching.then(logDownloads, onError);</pre> +searching.then(logDownloads, onError); +``` -<h3 id="Obtenez_un_article_spĂ©cifique">Obtenez un article spĂ©cifique</h3> +### Obtenez un article spĂ©cifique -<p>Pour obtenir un {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}}, la mĂ©thode la plus simple consiste Ă dĂ©finir uniquement le champ <code>id</code>, comme indiquĂ© dans l'extrait ci-dessous :</p> +Pour obtenir un {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}}, la mĂ©thode la plus simple consiste Ă dĂ©finir uniquement le champ `id`, comme indiquĂ© dans l'extrait ci-dessous : -<pre class="brush: js">function logDownloads(downloads) { +```js +function logDownloads(downloads) { for (let download of downloads) { console.log(download.id); console.log(download.url); @@ -82,13 +84,14 @@ var id = 13; var searching = browser.downloads.search({id}); searching.then(logDownloads, onError); -</pre> +``` -<h3 id="Obtenez_tous_les_tĂ©lĂ©chargements">Obtenez tous les tĂ©lĂ©chargements</h3> +### Obtenez tous les tĂ©lĂ©chargements -<p>Si vous voulez renvoyer tout {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}}, dĂ©finissez la <code>query</code> sur un objet vide.</p> +Si vous voulez renvoyer tout {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}}, dĂ©finissez la `query` sur un objet vide. -<pre class="brush: js">function logDownloads(downloads) { +```js +function logDownloads(downloads) { for (let download of downloads) { console.log(download.id); console.log(download.url); @@ -100,13 +103,15 @@ function onError(error) { } var searching = browser.downloads.search({}); -searching.then(logDownloads, onError);</pre> +searching.then(logDownloads, onError); +``` -<h3 id="Obtenez_le_tĂ©lĂ©chargement_le_plus_rĂ©cent">Obtenez le tĂ©lĂ©chargement le plus rĂ©cent</h3> +### Obtenez le tĂ©lĂ©chargement le plus rĂ©cent -<p>Vous pouvez obtenir le tĂ©lĂ©chargement le plus rĂ©cent en spĂ©cifiant les paramĂštres de recherche suivants :</p> +Vous pouvez obtenir le tĂ©lĂ©chargement le plus rĂ©cent en spĂ©cifiant les paramĂštres de recherche suivants : -<pre class="brush: js">function logDownloads(downloads) { +```js +function logDownloads(downloads) { for (let download of downloads) { console.log(download.id); console.log(download.url); @@ -121,21 +126,20 @@ var searching = browser.downloads.search({ limit: 1, orderBy: ["-startTime"] }); -searching.then(logDownloads, onError);</pre> - -<p>Vous pouvez voir ce code en action par exemple dans notre <a href="https://github.com/mdn/webextensions-examples/blob/master/latest-download/popup/latest_download.js">dernier tĂ©lĂ©chargement</a>.</p> - -<p>{{WebExtExamples}}</p> +searching.then(logDownloads, onError); +``` -<div class="note"><p><strong>Note :</strong></p> +Vous pouvez voir ce code en action par exemple dans notre [dernier tĂ©lĂ©chargement](https://github.com/mdn/webextensions-examples/blob/master/latest-download/popup/latest_download.js). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/downloads"><code>chrome.downloads</code></a>.</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.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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 @@ -162,5 +166,4 @@ searching.then(logDownloads, onError);</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/downloads/setshelfenabled/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.md index e3a1a60755..87ccc4f8c7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.md @@ -13,45 +13,40 @@ tags: - setShelfEnabled translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/setShelfEnabled --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>La fonction <code><strong>setShelfEnabled</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} active ou dĂ©sactive l'Ă©tagĂšre grise situĂ©e en bas de chaque fenĂȘtre associĂ©e au profil de navigateur actuel. L'Ă©tagĂšre sera dĂ©sactivĂ©e si au moins une extension l'a dĂ©sactivĂ©e.</p> +La fonction **`setShelfEnabled`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} active ou dĂ©sactive l'Ă©tagĂšre grise situĂ©e en bas de chaque fenĂȘtre associĂ©e au profil de navigateur actuel. L'Ă©tagĂšre sera dĂ©sactivĂ©e si au moins une extension l'a dĂ©sactivĂ©e. -<p>Si vous essayez d'activer l'Ă©tagĂšre lorsqu'au moins une autre extension l'a dĂ©jĂ dĂ©sactivĂ©, l'appel Ă©chouera et {{WebExtAPIRef("runtime.lastError")}} sera dĂ©fini avec un message d'erreur appropriĂ©.</p> +Si vous essayez d'activer l'Ă©tagĂšre lorsqu'au moins une autre extension l'a dĂ©jĂ dĂ©sactivĂ©, l'appel Ă©chouera et {{WebExtAPIRef("runtime.lastError")}} sera dĂ©fini avec un message d'erreur appropriĂ©. -<div class="note"> -<p><strong>Note :</strong> Pour utiliser cette fonction dans votre extension, vous devez demander la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission manifest</a>, <code>"downloads.shelf"</code>, ainsi que la permission <code>"downloads"</code>.</p> -</div> +> **Note :** Pour utiliser cette fonction dans votre extension, vous devez demander la [permission manifest](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions), `"downloads.shelf"`, ainsi que la permission `"downloads"`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">chrome.downloads.setShelfEnabled(enabled); -</pre> +```js +chrome.downloads.setShelfEnabled(enabled); +``` -<p>Cette API est Ă©galement disponible en tant que <code>browser.downloads.setShelfEnabled()</code>.</p> +Cette API est Ă©galement disponible en tant que `browser.downloads.setShelfEnabled()`. -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>enabled</code></dt> - <dd>Un <code>boolean</code> l'Ă©tat que vous souhaitez dĂ©finir <code>setShelfEnabled()</code> Ă â <code>true</code> pour activer et <code>false</code> pour dĂ©sactiver.</dd> -</dl> +- `enabled` + - : Un `boolean` l'Ă©tat que vous souhaitez dĂ©finir `setShelfEnabled()` Ă â `true` pour activer et `false` pour dĂ©sactiver. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.setShelfEnabled")}}</p> +{{Compat("webextensions.api.downloads.setShelfEnabled")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -78,5 +73,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/setShelfEnabled // 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/downloads/show/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.md index 6e995496ef..e04f4c4b52 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.md @@ -13,39 +13,39 @@ tags: - show translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/show --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <code><strong>show</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} affiche le fichier tĂ©lĂ©chargĂ© dans son dossier contenant dans le gestionnaire de fichiers de la plate-forme sous-jacente.</p> +La fonction **`show`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} affiche le fichier tĂ©lĂ©chargĂ© dans son dossier contenant dans le gestionnaire de fichiers de la plate-forme sous-jacente. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 showing = browser.downloads.show( +```js +var showing = browser.downloads.show( downloadId // integer ) -</pre> +``` -<h3 id="ParamĂštes">ParamĂštes</h3> +### ParamĂštes -<dl> - <dt><code>downloadId</code></dt> - <dd>Un <code>integer</code> reprĂ©sentant l'ID du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} Ă afficher.</dd> -</dl> +- `downloadId` + - : Un `integer` reprĂ©sentant l'ID du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} Ă afficher. -<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>. Si la demande est acceptĂ©e, la promise sera remplie avec un boolĂ©en indiquant si la demande a Ă©tĂ© acceptĂ©e. Si la demande Ă©choue, la promise sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si la demande est acceptĂ©e, la promise sera remplie avec un boolĂ©en indiquant si la demande a Ă©tĂ© acceptĂ©e. Si la demande Ă©choue, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.show")}}</p> +{{Compat("webextensions.api.downloads.show")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple montre l'Ă©lĂ©ment le plus rĂ©cemment tĂ©lĂ©chargĂ© :</p> +Cet exemple montre l'Ă©lĂ©ment le plus rĂ©cemment tĂ©lĂ©chargĂ© : -<pre class="brush: js">function onShowing(success) { +```js +function onShowing(success) {  console.log(`Showing download item: ${success}`); } @@ -54,7 +54,7 @@ function onError(error) { } function openDownload(downloadItems) { - if (downloadItems.length > 0) { + if (downloadItems.length > 0) { latestDownloadId = downloadItems[0].id; var showing = browser.downloads.show(latestDownloadId); showing.then(onShowing, onError); @@ -66,19 +66,18 @@ var searching = browser.downloads.search({ orderBy: ["-startTime"] }); -searching.then(openDownload, onError);</pre> +searching.then(openDownload, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -105,5 +104,4 @@ searching.then(openDownload, onError);</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/downloads/showdefaultfolder/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.md index 110f2e13a7..2d64ffe7cf 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.md @@ -14,43 +14,45 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/showDefaultFolder --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La fonction <code><strong>showDefaultFolder</strong></code><strong><code>()</code></strong> de l'API {{WebExtAPIRef("downloads")}} ouvre le dossier de tĂ©lĂ©chargement par dĂ©faut dans le gestionnaire de fichiers de la plateforme.</p> +La fonction **`showDefaultFolder`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} ouvre le dossier de tĂ©lĂ©chargement par dĂ©faut dans le gestionnaire de fichiers de la plateforme. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.downloads.showDefaultFolder(); -</pre> +```js +browser.downloads.showDefaultFolder(); +``` -<h3 id="ParamĂštres">ParamĂštres</h3> -<p>Aucun</p> +### ParamĂštres -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +Aucun -<p>{{Compat("webextensions.api.downloads.showDefaultFolder")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.downloads.showDefaultFolder")}} -<p>L'extrait suivant contient un bouton d'affichage qui, lorsqu'il est cliquĂ©, appelle <code>showDefaultFolder()</code> pour ouvrir le dossier de tĂ©lĂ©chargement par dĂ©faut dans le gestionnaire de fichiers de la plateforme :</p> +## Exemples -<pre class="brush: js">var showBtn = document.querySelector('.show'); +L'extrait suivant contient un bouton d'affichage qui, lorsqu'il est cliquĂ©, appelle `showDefaultFolder()` pour ouvrir le dossier de tĂ©lĂ©chargement par dĂ©faut dans le gestionnaire de fichiers de la plateforme : + +```js +var showBtn = document.querySelector('.show'); showBtn.onclick = function() { browser.downloads.showDefaultFolder(); -}</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/downloads"><code>chrome.downloads</code></a>.</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.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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 @@ -77,5 +79,4 @@ showBtn.onclick = function() { // 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/downloads/state/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.md index e266b1a584..c99d21a9fd 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.md @@ -13,44 +13,38 @@ tags: - state translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/State --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>Le type d'<code>Ă©tat</code> de l'API {{WebExtAPIRef("downloads")}} dĂ©finit diffĂ©rents Ă©tats dans lesquels un tĂ©lĂ©chargement en cours peut se trouver.</p> +Le type d'`Ă©tat` de l'API {{WebExtAPIRef("downloads")}} dĂ©finit diffĂ©rents Ă©tats dans lesquels un tĂ©lĂ©chargement en cours peut se trouver. -<p>Une propriĂ©tĂ© d'<code>state</code> {{WebExtAPIRef('downloads.DownloadItem')}}  contiendra une chaĂźne tirĂ©e des valeurs dĂ©finies dans ce type.</p> +Une propriĂ©tĂ© d'`state` {{WebExtAPIRef('downloads.DownloadItem')}}  contiendra une chaĂźne tirĂ©e des valeurs dĂ©finies dans ce type. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<dl> - <dt><code>in_progress</code></dt> - <dd>Le navigateur reçoit actuellement les donnĂ©es de tĂ©lĂ©chargement du serveur .</dd> - <dt><code>interrupted</code></dt> - <dd>Une erreur a rompu la connexion avec le serveur.</dd> - <dt><code>complete</code></dt> - <dd>Le tĂ©lĂ©chargement s'est terminĂ© avec succĂšs.</dd> -</dl> +- `in_progress` + - : Le navigateur reçoit actuellement les donnĂ©es de tĂ©lĂ©chargement du serveur . +- `interrupted` + - : Une erreur a rompu la connexion avec le serveur. +- `complete` + - : Le tĂ©lĂ©chargement s'est terminĂ© avec succĂšs. -<div class="note"> -<p><strong>Note :</strong> Ces constantes de chaĂźne ne changeront jamais, mais de nouvelles constantes peuvent ĂȘtre ajoutĂ©es.</p> -</div> +> **Note :** Ces constantes de chaĂźne ne changeront jamais, mais de nouvelles constantes peuvent ĂȘtre ajoutĂ©es. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.State")}}</p> +{{Compat("webextensions.api.downloads.State")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -77,5 +71,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/State // 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/downloads/stringdelta/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.md index 793fcafab1..a1528c00f4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.md @@ -13,36 +13,32 @@ tags: - download translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/StringDelta --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>StringDelta</code> de l'API {{WebExtAPIRef("downloads")}} reprĂ©sente la diffĂ©rence entre deux chaĂźnes.</p> +Le type `StringDelta` de l'API {{WebExtAPIRef("downloads")}} reprĂ©sente la diffĂ©rence entre deux chaĂźnes. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes:</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes: -<dl> - <dt><code>current</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant la valeur de chaĂźne actuelle.</dd> - <dt><code>previous</code>{{optional_inline}}</dt> - <dd>Un <code>string</code> reprĂ©sentant la valeur de chaĂźne prĂ©cĂ©dente.</dd> -</dl> +- `current`{{optional_inline}} + - : Un `string` reprĂ©sentant la valeur de chaĂźne actuelle. +- `previous`{{optional_inline}} + - : Un `string` reprĂ©sentant la valeur de chaĂźne prĂ©cĂ©dente. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.downloads.StringDelta")}}</p> +{{Compat("webextensions.api.downloads.StringDelta")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> 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/downloads"><code>chrome.downloads</code></a>.</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 @@ -69,5 +65,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/StringDelta // 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/events/event/index.md b/files/fr/mozilla/add-ons/webextensions/api/events/event/index.md index 3f54172b95..dacae549cc 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/events/event/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/events/event/index.md @@ -13,48 +13,44 @@ tags: - events translation_of: Mozilla/Add-ons/WebExtensions/API/events/Event --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet qui permet l'ajout et la suppression d'Ă©couteurs pour un Ă©vĂ©nement de navigateur.</p> +Un objet qui permet l'ajout et la suppression d'Ă©couteurs pour un Ă©vĂ©nement de navigateur. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets.</p> +Les valeurs de ce type sont des objets. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +## MĂ©thodes -<dl> - <dt>{{WebExtAPIRef("events.Event.addListener()")}}</dt> - <dd>Enregistre un rappel d'Ă©couteur d'Ă©vĂ©nement sur un Ă©vĂ©nement.</dd> - <dt>{{WebExtAPIRef("events.Event.removeListener()")}}</dt> - <dd>DĂ©sinscrit un rappel d'Ă©couteur d'Ă©vĂ©nement d'un Ă©vĂ©nement.</dd> - <dt>{{WebExtAPIRef("events.Event.hasListener()")}}</dt> - <dd>Teste l'Ă©tat d'enregistrement d'un Ă©couteur.</dd> - <dt>{{WebExtAPIRef("events.Event.hasListeners()")}}</dt> - <dd>Teste si des Ă©couteurs sont enregistrĂ©s pour l'Ă©vĂ©nement.</dd> - <dt>{{WebExtAPIRef("events.Event.addRules()")}}</dt> - <dd>Enregistre les rĂšgles pour gĂ©rer les Ă©vĂ©nements.</dd> - <dt>{{WebExtAPIRef("events.Event.getRules()")}}</dt> - <dd>Renvoie les rĂšgles actuellement enregistrĂ©es.</dd> - <dt>{{WebExtAPIRef("events.Event.removeRules()")}}</dt> - <dd>Annule l'inscription des rĂšgles actuellement enregistrĂ©es.</dd> -</dl> +- {{WebExtAPIRef("events.Event.addListener()")}} + - : Enregistre un rappel d'Ă©couteur d'Ă©vĂ©nement sur un Ă©vĂ©nement. +- {{WebExtAPIRef("events.Event.removeListener()")}} + - : DĂ©sinscrit un rappel d'Ă©couteur d'Ă©vĂ©nement d'un Ă©vĂ©nement. +- {{WebExtAPIRef("events.Event.hasListener()")}} + - : Teste l'Ă©tat d'enregistrement d'un Ă©couteur. +- {{WebExtAPIRef("events.Event.hasListeners()")}} + - : Teste si des Ă©couteurs sont enregistrĂ©s pour l'Ă©vĂ©nement. +- {{WebExtAPIRef("events.Event.addRules()")}} + - : Enregistre les rĂšgles pour gĂ©rer les Ă©vĂ©nements. +- {{WebExtAPIRef("events.Event.getRules()")}} + - : Renvoie les rĂšgles actuellement enregistrĂ©es. +- {{WebExtAPIRef("events.Event.removeRules()")}} + - : Annule l'inscription des rĂšgles actuellement enregistrĂ©es. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.events.Event")}}</p> +{{Compat("webextensions.api.events.Event")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.events`](https://developer.chrome.com/extensions/events). Cette documentation est dĂ©rivĂ©e de [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/events"><code>chrome.events</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json"><code>events.json</code></a> dans le code Chromium.</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 @@ -81,5 +77,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/events/Event // 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/events/index.md b/files/fr/mozilla/add-ons/webextensions/api/events/index.md index 92ea678ab3..0ac3f21214 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/events/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/events/index.md @@ -12,36 +12,32 @@ tags: - events translation_of: Mozilla/Add-ons/WebExtensions/API/events --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Types communs utilisĂ©s par les API qui distribuent les Ă©vĂ©nements.</p> +Types communs utilisĂ©s par les API qui distribuent les Ă©vĂ©nements. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("events.Rule")}}</dt> - <dd>Description d'une rĂšgle dĂ©clarative pour gĂ©rer les Ă©vĂ©nements.</dd> - <dt>{{WebExtAPIRef("events.Event")}}</dt> - <dd>Un objet qui permet l'ajout et la suppression d'Ă©couteurs pour un Ă©vĂ©nement Chrome.</dd> - <dt>{{WebExtAPIRef("events.UrlFilter")}}</dt> - <dd>Filtre les URL pour diffĂ©rents critĂšres. Si un critĂšre donnĂ© correspond, alors tout le filtre correspond.</dd> -</dl> +- {{WebExtAPIRef("events.Rule")}} + - : Description d'une rĂšgle dĂ©clarative pour gĂ©rer les Ă©vĂ©nements. +- {{WebExtAPIRef("events.Event")}} + - : Un objet qui permet l'ajout et la suppression d'Ă©couteurs pour un Ă©vĂ©nement Chrome. +- {{WebExtAPIRef("events.UrlFilter")}} + - : Filtre les URL pour diffĂ©rents critĂšres. Si un critĂšre donnĂ© correspond, alors tout le filtre correspond. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.events")}}</p> +{{Compat("webextensions.api.events")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.events`](https://developer.chrome.com/extensions/events). Cette documentation est dĂ©rivĂ©e de [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/events"><code>chrome.events</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json"><code>events.json</code></a> dans le code Chromium.</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 @@ -68,5 +64,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/events // 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/events/rule/index.md b/files/fr/mozilla/add-ons/webextensions/api/events/rule/index.md index cda840f67f..f3ce2c13e4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/events/rule/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/events/rule/index.md @@ -13,42 +13,38 @@ tags: - events translation_of: Mozilla/Add-ons/WebExtensions/API/events/Rule --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>Description d'une rĂšgle dĂ©clarative pour la gestion des Ă©vĂ©nements.</p> +Description d'une rĂšgle dĂ©clarative pour la gestion des Ă©vĂ©nements. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>id</code>{{optional_inline}}</dt> - <dd><code>string</code>. Identifiant facultatif permettant de rĂ©fĂ©rencer cette rĂšgle.</dd> - <dt><code>tags</code>{{optional_inline}}</dt> - <dd><code>array</code> of <code><code>string</code></code>. Les balises peuvent ĂȘtre utilisĂ©es pour annoter des rĂšgles et effectuer des opĂ©rations sur des ensembles de rĂšgles.</dd> - <dt><code>conditions</code></dt> - <dd><code>array</code> de <code><code>any</code></code>. Liste des conditions qui peuvent dĂ©clencher les actions.</dd> - <dt><code>actions</code></dt> - <dd><code>array</code> de <code><code>any</code></code>. Liste des actions qui sont dĂ©clenchĂ©es si l'une des conditions est remplie.</dd> - <dt><code>priority</code>{{optional_inline}}</dt> - <dd><code>integer</code>. PrioritĂ© optionnelle de cette rĂšgle. Par dĂ©faut Ă 100.</dd> -</dl> +- `id`{{optional_inline}} + - : `string`. Identifiant facultatif permettant de rĂ©fĂ©rencer cette rĂšgle. +- `tags`{{optional_inline}} + - : `array` of `string`. Les balises peuvent ĂȘtre utilisĂ©es pour annoter des rĂšgles et effectuer des opĂ©rations sur des ensembles de rĂšgles. +- `conditions` + - : `array` de `any`. Liste des conditions qui peuvent dĂ©clencher les actions. +- `actions` + - : `array` de `any`. Liste des actions qui sont dĂ©clenchĂ©es si l'une des conditions est remplie. +- `priority`{{optional_inline}} + - : `integer`. PrioritĂ© optionnelle de cette rĂšgle. Par dĂ©faut Ă 100. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.events.Rule")}}</p> +{{Compat("webextensions.api.events.Rule")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.events`](https://developer.chrome.com/extensions/events). Cette documentation est dĂ©rivĂ©e de [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/events"><code>chrome.events</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json"><code>events.json</code></a> dans le code Chromium.</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 @@ -75,5 +71,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/events/Rule // 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/events/urlfilter/index.md b/files/fr/mozilla/add-ons/webextensions/api/events/urlfilter/index.md index 0b1cb82297..0e1bd90db9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/events/urlfilter/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/events/urlfilter/index.md @@ -13,103 +13,98 @@ tags: - events translation_of: Mozilla/Add-ons/WebExtensions/API/events/UrlFilter --- -<div>{{AddonSidebar()}}</div> - -<p>DĂ©crit diffĂ©rents critĂšres de filtrage des URL. Si tous les critĂšres spĂ©cifiĂ©s dans les propriĂ©tĂ©s du filtre correspondent Ă l'URL, le filtre correspond. Les filtres sont souvent fournis aux mĂ©thodes API dans un <a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a> d'UrlFilters. Par exemple, les Ă©couteurs <a href="/fr/Add-ons/WebExtensions/API/webNavigation">webNavigation</a> peuvent ĂȘtre ajoutĂ©s avec un filtre qui est un objet avec une seule propriĂ©tĂ© url qui est un <a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a> de UrlFilters, par exemple <code>{url:[UrlFilter,UrlFilter,...]}</code>. Si un filtre dans le tableau de UrlFilters correspond, il est considĂ©rĂ© comme une correspondance pour le tableau. En effet, les critĂšres spĂ©cifiĂ©s dans un seul filtre sont associĂ©s ensemble, alors que tous les filtres individuels dans un tableau sont oĂč.</p> - -<p>Tous les critĂšres sont sensibles Ă la casse.</p> - -<h2 id="Type">Type</h2> - -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes:</p> - -<p>Toutefois, notez que ces deux derniers modĂšles ne correspondent pas au dernier composant du nom d'hĂŽte, car aucun point implicite n'est ajoutĂ© Ă la fin du nom d'hĂŽte. Ainsi, par exemple, <code>"org."</code> correspondra Ă "https://borg.com" mais pas "https://example.org". Pour faire correspondre ces modĂšles, utilisez <code>hostSuffix</code>.</p> - -<dl> - <dt><code>hostContains</code>{{optional_inline}}</dt> - <dd><p><code>string</code>. Correspond si le <a href="/fr/docs/Web/API/HTMLHyperlinkElementUtils/hostname">hostname</a> de l'URL contient la chaĂźne donnĂ©e.</p> - <ul> - <li>Pour tester si un composant de nom d'hĂŽte commence par "foo", utilisez <code>".foo"</code>. Cela correspond Ă "www.foobar.com" et "foo.com", car un point implicite est ajoutĂ© au dĂ©but du nom d'hĂŽte.</li> - <li>Pour tester si un composant de nom d'hĂŽte se termine par "foo", utilisez <code>"foo."</code>.</li> - <li>Pour tester si un composant de nom d'hĂŽte correspond exactement Ă "foo", utilisez <code>".foo."</code>.</li> - </ul> - </dd> - <dt><code>hostEquals</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si le nom d'hĂŽte de l'URL est Ă©gal Ă une chaĂźne spĂ©cifiĂ©e.</dd> - <dt><code>hostPrefix</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si le nom d'hĂŽte de l'URL commence par une chaĂźne spĂ©cifiĂ©e.</dd> - <dt><code>hostSuffix</code>{{optional_inline}}</dt> - <dd><p><code>string</code>. Correspond si le nom d'hĂŽte de l'URL se termine par une chaĂźne spĂ©cifiĂ©e.</p> - <ul> - <li>Exemple: <code>".example.com"</code> correspond Ă "http://www.example.com/", mais pas Ă "http://example.com/".</li> - <li>Exemple: <code>"example.com"</code> correspond Ă "http://www.example.com/", et "http://fakeexample.com/".</li> - </ul> - </dd> - <dt><code>pathContains</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si le segment de chemin de l'URL contient une chaĂźne spĂ©cifiĂ©e.</dd> - <dt><code>pathEquals</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si le segment de chemin de l'URL est Ă©gal Ă une chaĂźne spĂ©cifiĂ©e.</dd> - <dt><code>pathPrefix</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si le segment de chemin de l'URL commence par une chaĂźne spĂ©cifiĂ©e.</dd> - <dt><code>pathSuffix</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si le segment de chemin de l'URL se termine par une chaĂźne spĂ©cifiĂ©e.</dd> - <dt><code>queryContains</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si le segment de requĂȘte de l'URL contient une chaĂźne spĂ©cifiĂ©e.</dd> - <dt><code>queryEquals</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si le segment de requĂȘte de l'URL est Ă©gal Ă une chaĂźne spĂ©cifiĂ©e.</dd> - <dt><code>queryPrefix</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si le segment de requĂȘte de l'URL commence par une chaĂźne spĂ©cifiĂ©e.</dd> - <dt><code>querySuffix</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si le segment de requĂȘte de l'URL se termine par une chaĂźne spĂ©cifiĂ©e.</dd> - <dt><code>urlContains</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si l'URL (sans identificateur de fragment) contient une chaĂźne spĂ©cifiĂ©e. Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut.</dd> - <dt><code>urlEquals</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si l'URL (sans l'identificateur de fragment) est Ă©gale Ă une chaĂźne spĂ©cifiĂ©e. Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut.</dd> - <dt><code>urlMatches</code>{{optional_inline}}</dt> - <dd><p><code>string</code>. Correspond si l'URL (sans l'identificateur de fragment) correspond Ă une <a href="/fr/docs/Web/JavaScript/Guide/Regular_Expressions">expression rĂ©guliĂšre</a>. Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut.</p> - <ul> - <li>Par exemple : <code>urlMatches: "^[^:]*:(?://)?(?:[^/]*\\.)?mozilla\\.org/.*$"</code> correspond "http://mozilla.org/", "https://developer.mozilla.org/", "ftp://foo.mozilla.org/", mais pas "https://developer.fakemozilla.org/".</li> - </ul> - </dd> - <dt><code>originAndPathMatches</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si l'URL sans segment de requĂȘte et l'identificateur de fragment correspondent Ă une <a href="/fr/docs/Web/JavaScript/Guide/Regular_Expressions">expression rĂ©guliĂšre</a> spĂ©cifiĂ©e. Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut.</dd> - <dt><code>urlPrefix</code>{{optional_inline}}</dt> - <dd><p><code>string</code>. Correspond si l'URL (sans l'identificateur de fragment) commence par une chaĂźne spĂ©cifiĂ©e. Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut.</p> - <ul> - <li>Exemple: <code>"https://developer"</code> correspond "https://developer.mozilla.org/" et "https://developers.facebook.com/".</li> - </ul> - </dd> - <dt><code>urlSuffix</code>{{optional_inline}}</dt> - <dd><code>string</code>. Correspond si l'URL (sans l'identificateur de fragment) se termine par une chaĂźne spĂ©cifiĂ©e. Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut. Notez qu'un slash "/" implicite est ajoutĂ©e aprĂšs l'hĂŽte, donc <code>"com/"</code> correspond "https://example.com", mais pas <code>"com"</code>.</dd> - <dt><code>schemas</code>{{optional_inline}}</dt> - <dd><p><code>array</code> of <code><code>string</code></code>. Correspond si le schĂ©ma de l'URL est identique Ă l'un des schĂ©mas spĂ©cifiĂ©s dans le tableau. Comme les schĂ©mas sont toujours convertis en minuscules, ils doivent toujours ĂȘtre en minuscules ou ne correspondent jamais.</p> - <ul> - <li>Exemple: <code>["https"]</code> correspond uniquement aux URL HTTPS.</li> - </ul> - </dd> - <dt><code>ports</code>{{optional_inline}}</dt> - <dd><p><code>array</code> de <code><code><code>(integer</code></code> </code>ou<code> <code><code>array</code> of <code><code>integer</code></code></code></code>). Un tableau qui peut contenir des entiers et des tableaux d'entiers. Les entiers sont interprĂ©tĂ©s comme des numĂ©ros de port, tandis que les tableaux d'entiers sont interprĂ©tĂ©s comme des plages de ports. Correspond si le port de l'URL correspond Ă un numĂ©ro de port ou est contenu dans des plages.</p> - <ul> - <li>Par exemple: <code>[80, 443, [1000, 1200]]</code> correspond Ă toutes les demandes sur les ports 80, 443, et dans la plage 1000-1200.</li> - </ul> - </dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.events.UrlFilter")}}</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/events"><code>chrome.events</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json"><code>events.json</code></a> dans le code Chromium.</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()}} + +DĂ©crit diffĂ©rents critĂšres de filtrage des URL. Si tous les critĂšres spĂ©cifiĂ©s dans les propriĂ©tĂ©s du filtre correspondent Ă l'URL, le filtre correspond. Les filtres sont souvent fournis aux mĂ©thodes API dans un [Array](/fr/docs/Web/JavaScript/Reference/Global_Objects/Array) d'UrlFilters. Par exemple, les Ă©couteurs [webNavigation](/fr/Add-ons/WebExtensions/API/webNavigation) peuvent ĂȘtre ajoutĂ©s avec un filtre qui est un objet avec une seule propriĂ©tĂ© url qui est un [Array](/fr/docs/Web/JavaScript/Reference/Global_Objects/Array) de UrlFilters, par exemple `{url:[UrlFilter,UrlFilter,...]}`. Si un filtre dans le tableau de UrlFilters correspond, il est considĂ©rĂ© comme une correspondance pour le tableau. En effet, les critĂšres spĂ©cifiĂ©s dans un seul filtre sont associĂ©s ensemble, alors que tous les filtres individuels dans un tableau sont oĂč. + +Tous les critĂšres sont sensibles Ă la casse. + +## Type + +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes: + +Toutefois, notez que ces deux derniers modĂšles ne correspondent pas au dernier composant du nom d'hĂŽte, car aucun point implicite n'est ajoutĂ© Ă la fin du nom d'hĂŽte. Ainsi, par exemple, `"org."` correspondra Ă "https\://borg.com" mais pas "https\://example.org". Pour faire correspondre ces modĂšles, utilisez `hostSuffix`. + +- `hostContains`{{optional_inline}} + + - : `string`. Correspond si le [hostname](/fr/docs/Web/API/HTMLHyperlinkElementUtils/hostname) de l'URL contient la chaĂźne donnĂ©e. + + - Pour tester si un composant de nom d'hĂŽte commence par "foo", utilisez `".foo"`. Cela correspond Ă "www\.foobar.com" et "foo.com", car un point implicite est ajoutĂ© au dĂ©but du nom d'hĂŽte. + - Pour tester si un composant de nom d'hĂŽte se termine par "foo", utilisez `"foo."`. + - Pour tester si un composant de nom d'hĂŽte correspond exactement Ă "foo", utilisez `".foo."`. + +- `hostEquals`{{optional_inline}} + - : `string`. Correspond si le nom d'hĂŽte de l'URL est Ă©gal Ă une chaĂźne spĂ©cifiĂ©e. +- `hostPrefix`{{optional_inline}} + - : `string`. Correspond si le nom d'hĂŽte de l'URL commence par une chaĂźne spĂ©cifiĂ©e. +- `hostSuffix`{{optional_inline}} + + - : `string`. Correspond si le nom d'hĂŽte de l'URL se termine par une chaĂźne spĂ©cifiĂ©e. + + - Exemple: `".example.com"` correspond Ă "http\://www\.example.com/", mais pas Ă "http\://example.com/". + - Exemple: `"example.com"` correspond Ă "http\://www\.example.com/", et "http\://fakeexample.com/". + +- `pathContains`{{optional_inline}} + - : `string`. Correspond si le segment de chemin de l'URL contient une chaĂźne spĂ©cifiĂ©e. +- `pathEquals`{{optional_inline}} + - : `string`. Correspond si le segment de chemin de l'URL est Ă©gal Ă une chaĂźne spĂ©cifiĂ©e. +- `pathPrefix`{{optional_inline}} + - : `string`. Correspond si le segment de chemin de l'URL commence par une chaĂźne spĂ©cifiĂ©e. +- `pathSuffix`{{optional_inline}} + - : `string`. Correspond si le segment de chemin de l'URL se termine par une chaĂźne spĂ©cifiĂ©e. +- `queryContains`{{optional_inline}} + - : `string`. Correspond si le segment de requĂȘte de l'URL contient une chaĂźne spĂ©cifiĂ©e. +- `queryEquals`{{optional_inline}} + - : `string`. Correspond si le segment de requĂȘte de l'URL est Ă©gal Ă une chaĂźne spĂ©cifiĂ©e. +- `queryPrefix`{{optional_inline}} + - : `string`. Correspond si le segment de requĂȘte de l'URL commence par une chaĂźne spĂ©cifiĂ©e. +- `querySuffix`{{optional_inline}} + - : `string`. Correspond si le segment de requĂȘte de l'URL se termine par une chaĂźne spĂ©cifiĂ©e. +- `urlContains`{{optional_inline}} + - : `string`. Correspond si l'URL (sans identificateur de fragment) contient une chaĂźne spĂ©cifiĂ©e. Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut. +- `urlEquals`{{optional_inline}} + - : `string`. Correspond si l'URL (sans l'identificateur de fragment) est Ă©gale Ă une chaĂźne spĂ©cifiĂ©e. Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut. +- `urlMatches`{{optional_inline}} + + - : `string`. Correspond si l'URL (sans l'identificateur de fragment) correspond Ă une [expression rĂ©guliĂšre](/fr/docs/Web/JavaScript/Guide/Regular_Expressions). Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut. + + - Par exemple : `urlMatches: "^[^:]*:(?://)?(?:[^/]*\\.)?mozilla\\.org/.*$"` correspond "http\://mozilla.org/", "https\://developer.mozilla.org/", "ftp\://foo.mozilla.org/", mais pas "https\://developer.fakemozilla.org/". + +- `originAndPathMatches`{{optional_inline}} + - : `string`. Correspond si l'URL sans segment de requĂȘte et l'identificateur de fragment correspondent Ă une [expression rĂ©guliĂšre](/fr/docs/Web/JavaScript/Guide/Regular_Expressions) spĂ©cifiĂ©e. Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut. +- `urlPrefix`{{optional_inline}} + + - : `string`. Correspond si l'URL (sans l'identificateur de fragment) commence par une chaĂźne spĂ©cifiĂ©e. Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut. + + - Exemple: `"https://developer"` correspond "https\://developer.mozilla.org/" et "https\://developers.facebook.com/". + +- `urlSuffix`{{optional_inline}} + - : `string`. Correspond si l'URL (sans l'identificateur de fragment) se termine par une chaĂźne spĂ©cifiĂ©e. Les numĂ©ros de port sont supprimĂ©s de l'URL s'ils correspondent au numĂ©ro de port par dĂ©faut. Notez qu'un slash "/" implicite est ajoutĂ©e aprĂšs l'hĂŽte, donc `"com/"` correspond "https\://example.com", mais pas `"com"`. +- `schemas`{{optional_inline}} + + - : `array` of `string`. Correspond si le schĂ©ma de l'URL est identique Ă l'un des schĂ©mas spĂ©cifiĂ©s dans le tableau. Comme les schĂ©mas sont toujours convertis en minuscules, ils doivent toujours ĂȘtre en minuscules ou ne correspondent jamais. + + - Exemple: `["https"]` correspond uniquement aux URL HTTPS. + +- `ports`{{optional_inline}} + + - : `array` de `(integer `ou` array of integer`). Un tableau qui peut contenir des entiers et des tableaux d'entiers. Les entiers sont interprĂ©tĂ©s comme des numĂ©ros de port, tandis que les tableaux d'entiers sont interprĂ©tĂ©s comme des plages de ports. Correspond si le port de l'URL correspond Ă un numĂ©ro de port ou est contenu dans des plages. + + - Par exemple: `[80, 443, [1000, 1200]]` correspond Ă toutes les demandes sur les ports 80, 443, et dans la plage 1000-1200. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.events.UrlFilter")}} + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.events`](https://developer.chrome.com/extensions/events). Cette documentation est dĂ©rivĂ©e de [`events.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/events.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. + +<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 @@ -136,5 +131,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/events/UrlFilter // 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/extension/getbackgroundpage/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.md index 3553786765..8764c1326a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.md @@ -13,59 +13,60 @@ tags: - getBackgroundPage translation_of: Mozilla/Add-ons/WebExtensions/API/extension/getBackgroundPage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Alias de {{WebExtAPIRef("runtime.getBackgroundPage()")}}.</p> +Alias de {{WebExtAPIRef("runtime.getBackgroundPage()")}}. -<div class="note"> -<p><strong>Note :</strong> Cette mĂ©thode ne peut pas ĂȘtre utilisĂ©e en mode Navigation privĂ©e - elle renvoie toujours un tableau vide. Pour plus d'informations, voir {{bug(1329304)}}.</p> -</div> +> **Note :** Cette mĂ©thode ne peut pas ĂȘtre utilisĂ©e en mode Navigation privĂ©e - elle renvoie toujours un tableau vide. Pour plus d'informations, voir {{bug(1329304)}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var page = browser.extension.getBackgroundPage() -</pre> +```js +var page = browser.extension.getBackgroundPage() +``` -<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><code>object</code>. <a href="/fr/docs/Web/API/Window">Window</a> de la page d'arriĂšre plan.</p> +`object`. [Window](/fr/docs/Web/API/Window) de la page d'arriĂšre plan. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.extension.getBackgroundPage")}}</p> +{{Compat("webextensions.api.extension.getBackgroundPage")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supposons un <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts">script d'arriĂšre plan</a> dĂ©finisse une fonction <code>foo()</code>:</p> +Supposons un [script d'arriĂšre plan](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts) dĂ©finisse une fonction `foo()`: -<pre class="brush: js">// background.js +```js +// background.js function foo() { console.log("I'm defined in background.js"); -}</pre> +} +``` -<p>Un script exĂ©cutĂ© dans un <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2">popup</a> peut appeler cette fonction directement comme ceci :</p> +Un script exĂ©cutĂ© dans un [popup](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2) peut appeler cette fonction directement comme ceci : -<pre class="brush: js">// popup.js +```js +// popup.js var page = browser.extension.getBackgroundPage(); -page.foo(); // -> "I'm defined in background.js"</pre> +page.foo(); // -> "I'm defined in background.js" +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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 +93,4 @@ page.foo(); // -> "I'm defined in background.js"</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/extension/getextensiontabs/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/getextensiontabs/index.md index ba0457a170..8678d7923a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/getextensiontabs/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/getextensiontabs/index.md @@ -13,49 +13,44 @@ tags: - getExtensionTabs translation_of: Mozilla/Add-ons/WebExtensions/API/extension/getExtensionTabs --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div class="warning"> -<p><strong>Attention :</strong> Cette mĂ©thode a Ă©tĂ© dĂ©prĂ©ciĂ©e. Utilisez {{WebExtAPIRef("extension.getViews()")}} Ă la place.</p> -</div> +> **Attention :** Cette mĂ©thode a Ă©tĂ© dĂ©prĂ©ciĂ©e. Utilisez {{WebExtAPIRef("extension.getViews()")}} Ă la place. -<p>Renvoie un tableau des objets de la <a href="/fr/docs/Web/API/Window">Window</a> JavaScriptpour chacun des onglets qui s'exĂ©cutent dans l'extension actuelle. Si <code>windowId</code> est spĂ©cifiĂ©, renvoie uniquement les objets Window des onglets attachĂ©s Ă la fenĂȘtre spĂ©cifiĂ©e.</p> +Renvoie un tableau des objets de la [Window](/fr/docs/Web/API/Window) JavaScriptpour chacun des onglets qui s'exĂ©cutent dans l'extension actuelle. Si `windowId` est spĂ©cifiĂ©, renvoie uniquement les objets Window des onglets attachĂ©s Ă la fenĂȘtre spĂ©cifiĂ©e. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">chrome.extension.getExtensionTabs( +```js +chrome.extension.getExtensionTabs( windowId // optional integer ) -</pre> +``` -<p>Cette API est Ă©galement disponible en tant que <code>browser.extension.getExtensionTabs()</code>.</p> +Cette API est Ă©galement disponible en tant que `browser.extension.getExtensionTabs()`. -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>.</dd> -</dl> +- `windowId`{{optional_inline}} + - : `integer`. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p><code>array</code> of <code>object</code>. Tableau d'objets de fenĂȘtre globaux</p> +`array` of `object`. Tableau d'objets de fenĂȘtre globaux -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.extension.getExtensionTabs")}}</p> +{{Compat("webextensions.api.extension.getExtensionTabs")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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 @@ -82,5 +77,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extension/getExtensionTabs // 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/extension/geturl/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/geturl/index.md index f6193a83d2..ba66a8721d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/geturl/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/geturl/index.md @@ -12,56 +12,53 @@ tags: - getURL translation_of: Mozilla/Add-ons/WebExtensions/API/extension/getURL --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<div class="warning"> -<p><strong>Attention :</strong> Cette fonction est obsolĂšte. Veuillez utiliser <a href="/fr/Add-ons/WebExtensions/API/runtime/getURL"><code>runtime.getURL</code></a>.</p> -</div> +> **Attention :** Cette fonction est obsolĂšte. Veuillez utiliser [`runtime.getURL`](/fr/Add-ons/WebExtensions/API/runtime/getURL). -<p>Convertit un chemin relatif dans le rĂ©pertoire d'installation d'une extension en une URL complĂšte.</p> +Convertit un chemin relatif dans le rĂ©pertoire d'installation d'une extension en une URL complĂšte. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.extension.getURL( +```js +browser.extension.getURL( path // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>path</code></dt> - <dd><code>string</code>. Un chemin vers une ressource dans une extension exprimĂ©e par rapport Ă son rĂ©pertoire d'installation.</dd> -</dl> +- `path` + - : `string`. Un chemin vers une ressource dans une extension exprimĂ©e par rapport Ă son rĂ©pertoire d'installation. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p><code>string</code>. The fully-qualified URL to the resource.</p> +`string`. The fully-qualified URL to the resource. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.extension.getURL")}}</p> +{{Compat("webextensions.api.extension.getURL")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DonnĂ© un fichier empaquetĂ© avec l'add-on Ă "beasts/frog.html", obtenez l'URL complĂšte comme ceci :</p> +DonnĂ© un fichier empaquetĂ© avec l'add-on Ă "beasts/frog.html", obtenez l'URL complĂšte comme ceci : -<pre class="brush: js">var fullURL = browser.extension.getURL("beasts/frog.html"); +```js +var fullURL = browser.extension.getURL("beasts/frog.html"); -// -> something like: -// moz-extension://2c127fa4-62c7-7e4f-90e5-472b45eecfdc/beasts/frog.html</pre> +// -> something like: +// moz-extension://2c127fa4-62c7-7e4f-90e5-472b45eecfdc/beasts/frog.html +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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 @@ -88,5 +85,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extension/getURL // 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/extension/getviews/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/getviews/index.md index ce895776ea..925d4bba1c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/getviews/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/getviews/index.md @@ -13,77 +13,77 @@ tags: - getViews translation_of: Mozilla/Add-ons/WebExtensions/API/extension/getViews --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Renvoie un tableau des objets <a href="/fr/docs/Web/API/Window">Window</a> pour chacune des pages exĂ©cutĂ©es dans l'extension en cours. Cela inclut, par exemple :</p> +Renvoie un tableau des objets [Window](/fr/docs/Web/API/Window) pour chacune des pages exĂ©cutĂ©es dans l'extension en cours. Cela inclut, par exemple : -<ul> - <li>la page d'arriĂšre-plan, si une est dĂ©finie</li> - <li>toutes les pages contextuelles, si dĂ©finies et chargĂ©es</li> - <li>toutes les pages d'options, si dĂ©finies et chargĂ©es</li> - <li>les onglets du navigateur hĂ©bergeant le contenu fourni avec l'extension</li> -</ul> +- la page d'arriĂšre-plan, si une est dĂ©finie +- toutes les pages contextuelles, si dĂ©finies et chargĂ©es +- toutes les pages d'options, si dĂ©finies et chargĂ©es +- les onglets du navigateur hĂ©bergeant le contenu fourni avec l'extension -<p>Dans Firefox, si cette mĂ©thode est appelĂ©e Ă partir d'une page faisant partie d'une fenĂȘtre de navigation privĂ©e, telle qu'une barre latĂ©rale dans une fenĂȘtre privĂ©e ou une fenĂȘtre ouverte Ă partir d'une fenĂȘtre privĂ©e, sa valeur de retour n'inclut pas la page d'arriĂšre-plan de l'extension.</p> +Dans Firefox, si cette mĂ©thode est appelĂ©e Ă partir d'une page faisant partie d'une fenĂȘtre de navigation privĂ©e, telle qu'une barre latĂ©rale dans une fenĂȘtre privĂ©e ou une fenĂȘtre ouverte Ă partir d'une fenĂȘtre privĂ©e, sa valeur de retour n'inclut pas la page d'arriĂšre-plan de l'extension. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var windows = browser.extension.getViews( +```js +var windows = browser.extension.getViews( fetchProperties // optional object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>fetchProperties</code>{{optional_inline}}</dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>type</code>{{optional_inline}}</dt> - <dd><code>string</code>. Un {{WebExtAPIRef('extension.ViewType')}} indiquant le type de vue Ă obtenir. Si omis, cette fonction renvoie toutes les vues.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. La fenĂȘtre pour restreindre la recherche. Si omis, cette fonction renvoie toutes les vues.</dd> - </dl> - </dd> -</dl> +- `fetchProperties`{{optional_inline}} -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. -<p><code>array</code> of <code>object</code>. Un tableau d'objets <a href="/fr/docs/Web/API/Window">Window</a>.</p> + - `type`{{optional_inline}} + - : `string`. Un {{WebExtAPIRef('extension.ViewType')}} indiquant le type de vue Ă obtenir. Si omis, cette fonction renvoie toutes les vues. + - `windowId`{{optional_inline}} + - : `integer`. La fenĂȘtre pour restreindre la recherche. Si omis, cette fonction renvoie toutes les vues. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.extension.getViews")}}</p> +`array` of `object`. Un tableau d'objets [Window](/fr/docs/Web/API/Window). -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Obtenez toutes les fenĂȘtres appartenant Ă cette extension et consignez leurs URL :</p> +{{Compat("webextensions.api.extension.getViews")}} -<pre class="brush: js">var windows = browser.extension.getViews(); +## Exemples -for (var extensionWindow of windows) { - console.log(extensionWindow.location.href); -}</pre> +Obtenez toutes les fenĂȘtres appartenant Ă cette extension et consignez leurs URL : -<p>Obtenez uniquement des fenĂȘtres dans les onglets du navigateur hĂ©bergeant du contenu fourni avec l'extension :</p> +```js +var windows = browser.extension.getViews(); -<pre class="brush: js">var windows = browser.extension.getViews({type: "tab"});</pre> +for (var extensionWindow of windows) { + console.log(extensionWindow.location.href); +} +``` -<p>Obtenir seulement des fenĂȘtres dans les popups :</p> +Obtenez uniquement des fenĂȘtres dans les onglets du navigateur hĂ©bergeant du contenu fourni avec l'extension : -<pre class="brush: js">var windows = browser.extension.getViews({type: "popup"});</pre> +```js +var windows = browser.extension.getViews({type: "tab"}); +``` -<p>{{WebExtExamples}}</p> +Obtenir seulement des fenĂȘtres dans les popups : -<div class="note"><p><strong>Note :</strong></p> +```js +var windows = browser.extension.getViews({type: "popup"}); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -110,5 +110,4 @@ for (var extensionWindow of windows) { // 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/extension/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/index.md index d395507242..10e82e86b2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/index.md @@ -12,73 +12,61 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/extension --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Utilitaires liĂ©s Ă votre extension. Obtenez des URL vers des packages de ressources avec votre extension, rĂ©cupĂ©rez l'objet <code><a href="/fr/docs/Web/API/Window">Window</a></code> pour les pages de votre extension, rĂ©cupĂ©rez les valeurs pour diffĂ©rents paramĂštres. Notez que les API de messagerie de ce module sont dĂ©conseillĂ©es au profit des API Ă©quivalentes dans le module <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime">runtime</a></code>.</p> +Utilitaires liĂ©s Ă votre extension. Obtenez des URL vers des packages de ressources avec votre extension, rĂ©cupĂ©rez l'objet [`Window`](/fr/docs/Web/API/Window) pour les pages de votre extension, rĂ©cupĂ©rez les valeurs pour diffĂ©rents paramĂštres. Notez que les API de messagerie de ce module sont dĂ©conseillĂ©es au profit des API Ă©quivalentes dans le module [`runtime`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime). -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("extension.ViewType")}}</dt> - <dd>Le type de vue d'extension.</dd> -</dl> +- {{WebExtAPIRef("extension.ViewType")}} + - : Le type de vue d'extension. -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> +## PropriĂ©tĂ©s -<dl> - <dt>{{WebExtAPIRef("extension.lastError")}}</dt> - <dd>DĂ©fini pour la durĂ©e de vie d'un rappel si une extension ansychronique a gĂ©nĂ©rĂ© une erreur. Si aucune erreur n'est survenue, lastError sera <em>indĂ©fini</em>.</dd> - <dt>{{WebExtAPIRef("extension.inIncognitoContext")}}</dt> - <dd>True pour les scripts de contenu s'exĂ©cutant dans les onglets de navigation privĂ©e et pour les pages d'extension exĂ©cutĂ©es dans un processus de navigation privĂ©e. Ce dernier ne s'applique qu'aux extensions avec 'incognito_behavior'.</dd> -</dl> +- {{WebExtAPIRef("extension.lastError")}} + - : DĂ©fini pour la durĂ©e de vie d'un rappel si une extension ansychronique a gĂ©nĂ©rĂ© une erreur. Si aucune erreur n'est survenue, lastError sera _indĂ©fini_. +- {{WebExtAPIRef("extension.inIncognitoContext")}} + - : True pour les scripts de contenu s'exĂ©cutant dans les onglets de navigation privĂ©e et pour les pages d'extension exĂ©cutĂ©es dans un processus de navigation privĂ©e. Ce dernier ne s'applique qu'aux extensions avec 'incognito_behavior'. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("extension.getBackgroundPage()")}}</dt> - <dd>Renvoie l'objet <code><a href="/fr/docs/Web/API/Window">Window</a></code> pour la page d'arriĂšre-plan qui s'exĂ©cute dans l'extension en cours. Renvoie null si l'extension n'a pas de page d'arriĂšre-plan.</dd> - <dt>{{WebExtAPIRef("extension.getExtensionTabs()")}} {{deprecated_inline}}</dt> - <dd>Renvoie un tableau des objets de la <a href="/fr/docs/Web/API/Window">Window</a> JavaScript pour chacun des onglets qui s'exĂ©cutent dans l'extension actuelle.</dd> - <dt>{{WebExtAPIRef("extension.getURL()")}} {{deprecated_inline}}</dt> - <dd>Convertit un chemin relatif dans un rĂ©pertoire d'installation d'extension en une URL complĂšte.</dd> - <dt>{{WebExtAPIRef("extension.getViews()")}}</dt> - <dd>Renvoie un tableau des objets <code><a href="/fr/docs/Web/API/Window">Window</a></code> pour chacune des pages exĂ©cutĂ©es dans l'extension en cours.</dd> - <dt>{{WebExtAPIRef("extension.isAllowedIncognitoAccess()")}}</dt> - <dd>RĂ©cupĂšre l'Ă©tat de l'accĂšs de l'extension en mode navigation privĂ©e (dĂ©terminĂ© par la case Ă cocher "AutorisĂ© dans navigation privĂ©e").</dd> - <dt>{{WebExtAPIRef("extension.isAllowedFileSchemeAccess()")}}</dt> - <dd>RĂ©cupĂšre l'Ă©tat de l'accĂšs de l'extension au schĂ©ma 'file://' (dĂ©terminĂ© par la case Ă cocher 'Autoriser l'accĂšs aux URL des fichiers').***</dd> - <dt>{{WebExtAPIRef("extension.sendRequest()")}} {{deprecated_inline}}</dt> - <dd>Envoie une seule requĂȘte aux autres Ă©couteurs de l'extension.</dd> - <dt>{{WebExtAPIRef("extension.setUpdateUrlData()")}}</dt> - <dd>DĂ©finit la valeur du paramĂštre CGI AP utilisĂ© dans l'URL de mise Ă jour de l'extension. Cette valeur est ignorĂ©e pour les extensions hĂ©bergĂ©es dans le magasin du fournisseur du navigateur.</dd> -</dl> +- {{WebExtAPIRef("extension.getBackgroundPage()")}} + - : Renvoie l'objet [`Window`](/fr/docs/Web/API/Window) pour la page d'arriĂšre-plan qui s'exĂ©cute dans l'extension en cours. Renvoie null si l'extension n'a pas de page d'arriĂšre-plan. +- {{WebExtAPIRef("extension.getExtensionTabs()")}} {{deprecated_inline}} + - : Renvoie un tableau des objets de la [Window](/fr/docs/Web/API/Window) JavaScript pour chacun des onglets qui s'exĂ©cutent dans l'extension actuelle. +- {{WebExtAPIRef("extension.getURL()")}} {{deprecated_inline}} + - : Convertit un chemin relatif dans un rĂ©pertoire d'installation d'extension en une URL complĂšte. +- {{WebExtAPIRef("extension.getViews()")}} + - : Renvoie un tableau des objets [`Window`](/fr/docs/Web/API/Window) pour chacune des pages exĂ©cutĂ©es dans l'extension en cours. +- {{WebExtAPIRef("extension.isAllowedIncognitoAccess()")}} + - : RĂ©cupĂšre l'Ă©tat de l'accĂšs de l'extension en mode navigation privĂ©e (dĂ©terminĂ© par la case Ă cocher "AutorisĂ© dans navigation privĂ©e"). +- {{WebExtAPIRef("extension.isAllowedFileSchemeAccess()")}} + - : RĂ©cupĂšre l'Ă©tat de l'accĂšs de l'extension au schĂ©ma 'file://' (dĂ©terminĂ© par la case Ă cocher 'Autoriser l'accĂšs aux URL des fichiers').\*\*\* +- {{WebExtAPIRef("extension.sendRequest()")}} {{deprecated_inline}} + - : Envoie une seule requĂȘte aux autres Ă©couteurs de l'extension. +- {{WebExtAPIRef("extension.setUpdateUrlData()")}} + - : DĂ©finit la valeur du paramĂštre CGI AP utilisĂ© dans l'URL de mise Ă jour de l'extension. Cette valeur est ignorĂ©e pour les extensions hĂ©bergĂ©es dans le magasin du fournisseur du navigateur. -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt>{{WebExtAPIRef("extension.onRequest")}} {{deprecated_inline}}</dt> - <dd>LancĂ© lorsqu'une requĂȘte est envoyĂ©e par un processus d'extension ou un script de contenu.</dd> - <dt>{{WebExtAPIRef("extension.onRequestExternal")}} {{deprecated_inline}}</dt> - <dd>LancĂ© lorsqu'une requĂȘte est envoyĂ©e depuis une autre extension.</dd> -</dl> +- {{WebExtAPIRef("extension.onRequest")}} {{deprecated_inline}} + - : LancĂ© lorsqu'une requĂȘte est envoyĂ©e par un processus d'extension ou un script de contenu. +- {{WebExtAPIRef("extension.onRequestExternal")}} {{deprecated_inline}} + - : LancĂ© lorsqu'une requĂȘte est envoyĂ©e depuis une autre extension. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.extension")}} +{{WebExtExamples("h2")}} -<p>{{Compat("webextensions.api.extension")}}</p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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 @@ -105,5 +93,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extension // 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/extension/inincognitocontext/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/inincognitocontext/index.md index 51ed61c055..9fbadbecb7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/inincognitocontext/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/inincognitocontext/index.md @@ -13,25 +13,23 @@ tags: - inIncognitoContext translation_of: Mozilla/Add-ons/WebExtensions/API/extension/inIncognitoContext --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Valeur boolĂ©enne, <code>true</code> pour les scripts de contenu s'exĂ©cutant dans les onglets de navigation privĂ©e et pour les pages d'extension exĂ©cutĂ©es dans un processus de navigation privĂ©..</p> +Valeur boolĂ©enne, `true` pour les scripts de contenu s'exĂ©cutant dans les onglets de navigation privĂ©e et pour les pages d'extension exĂ©cutĂ©es dans un processus de navigation privĂ©.. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.extension.inIncognitoContext")}}</p> +{{Compat("webextensions.api.extension.inIncognitoContext")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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 @@ -58,5 +56,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extension/inIncognitoContext // 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/extension/isallowedfileschemeaccess/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedfileschemeaccess/index.md index 2d809c86ca..d3445f3900 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedfileschemeaccess/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedfileschemeaccess/index.md @@ -13,55 +13,50 @@ tags: - isAllowedFileSchemeAccess translation_of: Mozilla/Add-ons/WebExtensions/API/extension/isAllowedFileSchemeAccess --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Renvoie `true` si l'extension peut accĂ©der au schĂ©ma "file://", sinon `false`. -<div>Renvoie <code>true</code> si l'extension peut accĂ©der au schĂ©ma "file://", sinon <code>false</code>.</div> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<div></div> +## Syntaxe -<div> -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> -</div> +```js +var isAllowed = browser.extension.isAllowedFileSchemeAccess() +``` -<h2 id="Syntaxe">Syntaxe</h2> +### ParamĂštres -<pre class="brush: js">var isAllowed = browser.extension.isAllowedFileSchemeAccess() -</pre> +None. -<h3 id="ParamĂštres">ParamĂštres</h3> +### Valeur retournĂ©e -<p>None.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un boolĂ©en : `true` si l'extension est autorisĂ©e Ă accĂ©der aux URLs "file://", sinon `false`. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +Firefox retournera toujours `false`. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un boolĂ©en : <code>true</code> si l'extension est autorisĂ©e Ă accĂ©der aux URLs "file://", sinon <code>false</code>.</p> +## CompatibilitĂ© du navigateur -<p>Firefox retournera toujours <code>false</code>.</p> +{{Compat("webextensions.api.extension.isAllowedFileSchemeAccess")}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## Exemples -<p>{{Compat("webextensions.api.extension.isAllowedFileSchemeAccess")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">function logIsAllowed(answer) { +```js +function logIsAllowed(answer) { console.log(`Is allowed: ${answer}`); } var isAllowed = browser.extension.isAllowedFileSchemeAccess(); -isAllowed.then(logIsAllowed);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +isAllowed.then(logIsAllowed); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -88,5 +83,4 @@ isAllowed.then(logIsAllowed);</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/extension/isallowedincognitoaccess/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedincognitoaccess/index.md index f39e1f60f5..ff267387cd 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedincognitoaccess/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/isallowedincognitoaccess/index.md @@ -13,49 +13,50 @@ tags: - isAllowedIncognitoAccess translation_of: Mozilla/Add-ons/WebExtensions/API/extension/isAllowedIncognitoAccess --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>VĂ©rifiez si l'extension est autorisĂ©e Ă accĂ©der aux onglets ouverts en mode "navigation privĂ©e".</p> +VĂ©rifiez si l'extension est autorisĂ©e Ă accĂ©der aux onglets ouverts en mode "navigation privĂ©e". -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 isAllowed = browser.extension.isAllowedIncognitoAccess() -</pre> +```js +var isAllowed = browser.extension.isAllowedIncognitoAccess() +``` -<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 remplie avec un boolĂ©en : <code>true</code> si l'extension est autorisĂ©e Ă accĂ©der aux onglets privĂ©s, sinon <code>false</code>.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un boolĂ©en : `true` si l'extension est autorisĂ©e Ă accĂ©der aux onglets privĂ©s, sinon `false`. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function logIsAllowed(answer) { +```js +function logIsAllowed(answer) { console.log(`Is allowed: ${answer}`); } var isAllowed = browser.extension.isAllowedIncognitoAccess(); -isAllowed.then(logIsAllowed);</pre> +isAllowed.then(logIsAllowed); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.extension.isAllowedIncognitoAccess")}}</p> +{{Compat("webextensions.api.extension.isAllowedIncognitoAccess")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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 @@ -82,5 +83,4 @@ isAllowed.then(logIsAllowed);</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/extension/lasterror/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/lasterror/index.md index b82a280082..2213e3404c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/lasterror/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/lasterror/index.md @@ -13,25 +13,23 @@ tags: - lastError translation_of: Mozilla/Add-ons/WebExtensions/API/extension/lastError --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un alias de {{WebExtAPIRef("runtime.lastError")}}.</p> +Un alias de {{WebExtAPIRef("runtime.lastError")}}. -<h2 id="CompatibilitĂ©_du_navoigateur">CompatibilitĂ© du navoigateur</h2> +## CompatibilitĂ© du navoigateur -<p>{{Compat("webextensions.api.extension.lastError")}}</p> +{{Compat("webextensions.api.extension.lastError")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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 @@ -58,5 +56,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extension/lastError // 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/extension/onrequest/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/onrequest/index.md index 0c086700e6..7626a13fe7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/onrequest/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/onrequest/index.md @@ -12,79 +12,67 @@ tags: - onRequest translation_of: Mozilla/Add-ons/WebExtensions/API/extension/onRequest --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div class="warning"> -<p><strong>Attention :</strong> Ceci n'est pas implĂ©mentĂ© dans Firefox car il est obsolĂšte depuis Chrome 33. Veuillez utiliser <a href="/fr/Add-ons/WebExtensions/API/runtime/onMessageExternal">runtime.onMessageExternal</a> Ă la place.</p> -</div> +> **Attention :** Ceci n'est pas implĂ©mentĂ© dans Firefox car il est obsolĂšte depuis Chrome 33. Veuillez utiliser [runtime.onMessageExternal](/fr/Add-ons/WebExtensions/API/runtime/onMessageExternal) Ă la place. -<p>LancĂ© lorsqu'une requĂȘte est envoyĂ©e par un processus d'extension ou un script de contenu.</p> +LancĂ© lorsqu'une requĂȘte est envoyĂ©e par un processus d'extension ou un script de contenu. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">chrome.extension.onRequest.addListener(function( +```js +chrome.extension.onRequest.addListener(function( request, // optional any sender, // runtime.MessageSender function() {...} // function ) {...}) chrome.extension.onRequest.removeListener(listener) chrome.extension.onRequest.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. +## Syntaxe addListener +### ParamĂštres -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +- `callback` -<h3 id="ParamĂštres">ParamĂštres</h3> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> + - `request` + - : `any`. La requĂȘte envoyĂ©e par le script appelant. - <dl> - <dt><code>request</code></dt> - <dd><code>any</code>. La requĂȘte envoyĂ©e par le script appelant.</dd> - </dl> + <!----> - <dl> - <dt><code>sender</code></dt> - <dd>{{WebExtAPIRef('runtime.MessageSender')}}.</dd> - </dl> + - `sender` + - : {{WebExtAPIRef('runtime.MessageSender')}}. - <dl> - <dt><code>sendResponse</code></dt> - <dd><code>function</code>. Fonction Ă appeler (au plus une fois) lorsque vous avez une rĂ©ponse. L'argument doit ĂȘtre n'importe quel objet JSON-ifiable, ou undefined s'il n'y a pas de rĂ©ponse. Si vous avez plus d'un Ă©couteur <code>onRequest</code> dans le mĂȘme document, un seul peut envoyer une rĂ©ponse.</dd> - </dl> - </dd> -</dl> + <!----> -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `sendResponse` + - : `function`. Fonction Ă appeler (au plus une fois) lorsque vous avez une rĂ©ponse. L'argument doit ĂȘtre n'importe quel objet JSON-ifiable, ou undefined s'il n'y a pas de rĂ©ponse. Si vous avez plus d'un Ă©couteur `onRequest` dans le mĂȘme document, un seul peut envoyer une rĂ©ponse. -<p>{{Compat("webextensions.api.extension.onRequest")}}</p> +## CompatibilitĂ© du navigateur -<p>{{WebExtExamples}}</p> +{{Compat("webextensions.api.extension.onRequest")}} -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -111,5 +99,4 @@ chrome.extension.onRequest.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/extension/onrequestexternal/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/onrequestexternal/index.md index 2831227760..e161fa796b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/onrequestexternal/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/onrequestexternal/index.md @@ -13,77 +13,67 @@ tags: - onRequestExternal translation_of: Mozilla/Add-ons/WebExtensions/API/extension/onRequestExternal --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div class="warning"> -<p><strong>Attention :</strong> Ceci n'est pas implĂ©mentĂ© dans Firefox car il est obsolĂšte depuis Chrome 33. Veuillez utiliser <a href="/fr/Add-ons/WebExtensions/API/runtime/onMessageExternal">runtime.onMessageExternal</a> Ă la place.</p> -</div> +> **Attention :** Ceci n'est pas implĂ©mentĂ© dans Firefox car il est obsolĂšte depuis Chrome 33. Veuillez utiliser [runtime.onMessageExternal](/fr/Add-ons/WebExtensions/API/runtime/onMessageExternal) Ă la place. -<p>LancĂ© lorsqu'une requĂȘte est envoyĂ©e depuis une autre extension.</p> +LancĂ© lorsqu'une requĂȘte est envoyĂ©e depuis une autre extension. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">chrome.extension.onRequestExternal.addListener(function( +```js +chrome.extension.onRequestExternal.addListener(function( request, // optional any sender, // runtime.MessageSender function() {...} // function ) {...}) chrome.extension.onRequestExternal.removeListener(listener) chrome.extension.onRequestExternal.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>request</code></dt> - <dd><code>any</code>. La requĂȘte envoyĂ©e par le script appelant.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>sender</code></dt> - <dd>{{WebExtAPIRef('runtime.MessageSender')}}.</dd> - </dl> + - `request` + - : `any`. La requĂȘte envoyĂ©e par le script appelant. - <dl> - <dt><code>sendResponse</code></dt> - <dd><code>function</code>. Fonction Ă appeler lorsque vous avez une rĂ©ponse. L'argument doit ĂȘtre n'importe quel objet JSON-ifiable, ou undefined s'il n'y a pas de rĂ©ponse.</dd> - </dl> - </dd> -</dl> + <!----> -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `sender` + - : {{WebExtAPIRef('runtime.MessageSender')}}. -<p>{{Compat("webextensions.api.extension.onRequestExternal")}}</p> + <!----> -<p>{{WebExtExamples}}</p> + - `sendResponse` + - : `function`. Fonction Ă appeler lorsque vous avez une rĂ©ponse. L'argument doit ĂȘtre n'importe quel objet JSON-ifiable, ou undefined s'il n'y a pas de rĂ©ponse. -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</p> +{{Compat("webextensions.api.extension.onRequestExternal")}} -<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> +{{WebExtExamples}} -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. + +<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 @@ -110,5 +100,4 @@ chrome.extension.onRequestExternal.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/extension/sendrequest/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md index 192237b73d..6700df4dea 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md @@ -13,56 +13,50 @@ tags: - sendRequest translation_of: Mozilla/Add-ons/WebExtensions/API/extension/sendRequest --- -<div>{{AddonSidebar}}{{Deprecated_Header}} -<div class="warning"> -<p><strong>Attention :</strong> Cette mĂ©thode est dĂ©prĂ©ciĂ©e. utilisez {{WebExtAPIRef("runtime.sendMessage")}} Ă la place.</p> -</div> -</div> +{{AddonSidebar}}{{Deprecated_Header}} -<p>Envoie une seule requĂȘte aux autres Ă©couteurs de l'extension. Similaire Ă {{WebExtAPIRef('runtime.connect')}},mais envoie seulement une seule requĂȘte avec une rĂ©ponse optionnelle. L'Ă©vĂ©nement {{WebExtAPIRef('extension.onRequest')}} est dĂ©clenchĂ© dans chaque page de l'extension</p> +> **Attention :** Cette mĂ©thode est dĂ©prĂ©ciĂ©e. utilisez {{WebExtAPIRef("runtime.sendMessage")}} Ă la place. -<h2 id="Syntaxe">Syntaxe</h2> +Envoie une seule requĂȘte aux autres Ă©couteurs de l'extension. Similaire Ă {{WebExtAPIRef('runtime.connect')}},mais envoie seulement une seule requĂȘte avec une rĂ©ponse optionnelle. L'Ă©vĂ©nement {{WebExtAPIRef('extension.onRequest')}} est dĂ©clenchĂ© dans chaque page de l'extension -<pre class="brush: js">chrome.extension.sendRequest( +## Syntaxe + +```js +chrome.extension.sendRequest( extensionId, // optional string request, // any function(response) {...} // optional function ) -</pre> +``` -<p>Cette API est Ă©galement disponible en tant que <code>browser.extension.sendRequest()</code> dans une <a href="/fr/Add-ons/WebExtensions/API#Callbacks_and_promises">version qui renvoie une promise</a>.</p> +Cette API est Ă©galement disponible en tant que `browser.extension.sendRequest()` dans une [version qui renvoie une promise](/fr/Add-ons/WebExtensions/API#Callbacks_and_promises). -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>extensionId</code>{{Optional_Inline}}</dt> - <dd><code>string</code>. L'ID d'extension de l'extension Ă laquelle vous souhaitez vous connecter. Si omis, la valeur par dĂ©faut est votre propre extension.</dd> - <dt><code>request</code></dt> - <dd><code>any</code>.</dd> - <dt><code>responseCallback</code>{{Optional_Inline}}</dt> - <dd><p><code>function</code>. La fonction est passĂ©e les arguments suivants :</p> - <dl> - <dt><code>response</code></dt> - <dd><code>any</code>. Objet de rĂ©ponse JSON envoyĂ© par le gestionnaire de la requĂȘte. Si une erreur survient lors de la connexion Ă l'extension, le rappel sera appelĂ© sans arguments et {{WebExtAPIRef('runtime.lastError')}} sera dĂ©fini sur le message d'erreur.</dd> - </dl> - </dd> -</dl> +- `extensionId`{{Optional_Inline}} + - : `string`. L'ID d'extension de l'extension Ă laquelle vous souhaitez vous connecter. Si omis, la valeur par dĂ©faut est votre propre extension. +- `request` + - : `any`. +- `responseCallback`{{Optional_Inline}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : `function`. La fonction est passĂ©e les arguments suivants : -<p>{{Compat("webextensions.api.extension.sendRequest")}}</p> + - `response` + - : `any`. Objet de rĂ©ponse JSON envoyĂ© par le gestionnaire de la requĂȘte. Si une erreur survient lors de la connexion Ă l'extension, le rappel sera appelĂ© sans arguments et {{WebExtAPIRef('runtime.lastError')}} sera dĂ©fini sur le message d'erreur. -<p>{{WebExtExamples}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.extension.sendRequest")}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -89,5 +83,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extension/sendRequest // 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/extension/setupdateurldata/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/setupdateurldata/index.md index da7624dbfb..abfc45cc5e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/setupdateurldata/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/setupdateurldata/index.md @@ -13,41 +13,38 @@ tags: - setUpdateUrlData translation_of: Mozilla/Add-ons/WebExtensions/API/extension/setUpdateUrlData --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit les paramĂštres de l'URL de mise Ă jour de l'extension. Cette valeur est ignorĂ©e pour les extensions hĂ©bergĂ©es dans le magasin du fournisseur du navigateur.</p> +DĂ©finit les paramĂštres de l'URL de mise Ă jour de l'extension. Cette valeur est ignorĂ©e pour les extensions hĂ©bergĂ©es dans le magasin du fournisseur du navigateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.extension.setUpdateUrlData( +```js +browser.extension.setUpdateUrlData( data // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>data</code></dt> - <dd><code>string</code>.</dd> -</dl> +- `data` + - : `string`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.extension.setUpdateUrlData")}}</p> +{{Compat("webextensions.api.extension.setUpdateUrlData")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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 @@ -74,5 +71,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extension/setUpdateUrlData // 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/extension/viewtype/index.md b/files/fr/mozilla/add-ons/webextensions/api/extension/viewtype/index.md index 71bbc2a589..aa7ac51fdc 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extension/viewtype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extension/viewtype/index.md @@ -13,29 +13,27 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/extension/ViewType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type de vue de l'extension.</p> +Le type de vue de l'extension. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : <code>"tab"</code>, <code>"popup"</code>, <code>"sidebar"</code>.</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : `"tab"`, `"popup"`, `"sidebar"`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.extension.ViewType")}}</p> +{{Compat("webextensions.api.extension.ViewType")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.extension`](https://developer.chrome.com/extensions/extension). Cette documentation est dĂ©rivĂ©e de [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/extension"><code>chrome.extension</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json"><code>extension.json</code></a> dans le code Chromium.</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 @@ -62,5 +60,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extension/ViewType // 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/extensiontypes/imagedetails/index.md b/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md index b2833df7f7..570c6136a6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md @@ -13,36 +13,32 @@ tags: - extensionType translation_of: Mozilla/Add-ons/WebExtensions/API/extensionTypes/ImageDetails --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Details sur le format et la qualitĂ© de l'image.</p> +Details sur le format et la qualitĂ© de l'image. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>format</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('extensionTypes.ImageFormat')}}. Le format du rĂ©sultat de l'image. Par dĂ©faut est <code>"png"</code>.</dd> - <dt><code>quality</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Quand le format est <code>"jpeg"</code>, cela controle la qualitĂ© du rĂ©sultat de l'image. C'est un nombre compris entre 0 et 100, qui est converti en une valeur entre 0 et 1 puis utilisĂ© comme argument <code>encoderOptions</code> sur <code><a href="/fr/docs/Web/API/HTMLCanvasElement/toDataURL">HTMLCanvasElement.toDataURL()</a></code>. Si c'est choisi, 92 est utilisĂ©. A mesure que la qualitĂ© baisse, le rĂ©sultat de l'image aura plus d'artefacts visuel, et le nombre d'octets nĂ©cessaires pour le stocker diminuera. Cette valeur est ignorĂ©e pour les images PNG.</dd> -</dl> +- `format`{{optional_inline}} + - : {{WebExtAPIRef('extensionTypes.ImageFormat')}}. Le format du rĂ©sultat de l'image. Par dĂ©faut est `"png"`. +- `quality`{{optional_inline}} + - : `integer`. Quand le format est `"jpeg"`, cela controle la qualitĂ© du rĂ©sultat de l'image. C'est un nombre compris entre 0 et 100, qui est converti en une valeur entre 0 et 1 puis utilisĂ© comme argument `encoderOptions` sur [`HTMLCanvasElement.toDataURL()`](/fr/docs/Web/API/HTMLCanvasElement/toDataURL). Si c'est choisi, 92 est utilisĂ©. A mesure que la qualitĂ© baisse, le rĂ©sultat de l'image aura plus d'artefacts visuel, et le nombre d'octets nĂ©cessaires pour le stocker diminuera. Cette valeur est ignorĂ©e pour les images PNG. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.extensionTypes.ImageDetails")}}</p> +{{Compat("webextensions.api.extensionTypes.ImageDetails")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ© sur l'API Chromium [`chrome.extensionTypes`](https://developer.chrome.com/extensions/extensionTypes) . Cette documentation provient de [`extension_types.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<p>Cette API est basĂ© sur l'API Chromium <a href="https://developer.chrome.com/extensions/extensionTypes"><code>chrome.extensionTypes</code></a> . Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json"><code>extension_types.json</code></a> dans le code de Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</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 @@ -69,5 +65,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extensionTypes/ImageDetails // 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/extensiontypes/imageformat/index.md b/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/imageformat/index.md index 865a1392a5..cc245b6c9a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/imageformat/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/imageformat/index.md @@ -13,29 +13,27 @@ tags: - extensionTypes translation_of: Mozilla/Add-ons/WebExtensions/API/extensionTypes/ImageFormat --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Les valeurs de ce type sont des chaĂźnes de caractĂšres. Les valeurs possibles sont : <code>"jpeg"</code>, <code>"png"</code>.</p> +Les valeurs de ce type sont des chaĂźnes de caractĂšres. Les valeurs possibles sont : `"jpeg"`, `"png"`. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaines. Les valeurs possibles sont : <code>"jpeg"</code>, <code>"png"</code>.</p> +Les valeurs de ce type sont des chaines. Les valeurs possibles sont : `"jpeg"`, `"png"`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.extensionTypes.ImageFormat")}}</p> +{{Compat("webextensions.api.extensionTypes.ImageFormat")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ© sur l'API Chromium [`chrome.extensionTypes`](https://developer.chrome.com/extensions/extensionTypes) . Cette documentation provient de [`extension_types.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<p>Cette API est basĂ© sur l'API Chromium <a href="https://developer.chrome.com/extensions/extensionTypes"><code>chrome.extensionTypes</code></a> . Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json"><code>extension_types.json</code></a> dans le code de Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</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 @@ -62,5 +60,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extensionTypes/ImageFormat // 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/extensiontypes/index.md b/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/index.md index 9f9ed5e250..846f46225f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/index.md @@ -12,40 +12,36 @@ tags: - extensionType translation_of: Mozilla/Add-ons/WebExtensions/API/extensionTypes --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Certains types communs utilisĂ©s dans d'autres APIs WebExtensions.</p> +Certains types communs utilisĂ©s dans d'autres APIs WebExtensions. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("extensionTypes.ImageDetails")}}</dt> - <dd>DĂ©tails sur le format et la qualitĂ© de l'image.</dd> - <dt>{{WebExtAPIRef("extensionTypes.ImageFormat")}}</dt> - <dd>Le format d'une image.</dd> - <dt>{{WebExtAPIRef("extensionTypes.ImageDetails")}}</dt> - <dd>Injecte des dĂ©tails dans une page</dd> - <dt>{{WebExtAPIRef("extensionTypes.RunAt")}}</dt> - <dd>Le plus tot que le Javascript ou le CSS est injectĂ© dans l'onglet.</dd> - <dt><code>extensionTypes.CSSOrigin</code></dt> - <dd>Indique si une feuille de style CSS injectĂ©e par <code><a href="/fr/Add-ons/WebExtensions/API/tabs/insertCSS">tabs.insertCSS</a></code> doit ĂȘtre traitĂ©e comme une feuille de style "auteur" ou "utilisateur".</dd> -</dl> +- {{WebExtAPIRef("extensionTypes.ImageDetails")}} + - : DĂ©tails sur le format et la qualitĂ© de l'image. +- {{WebExtAPIRef("extensionTypes.ImageFormat")}} + - : Le format d'une image. +- {{WebExtAPIRef("extensionTypes.ImageDetails")}} + - : Injecte des dĂ©tails dans une page +- {{WebExtAPIRef("extensionTypes.RunAt")}} + - : Le plus tot que le Javascript ou le CSS est injectĂ© dans l'onglet. +- `extensionTypes.CSSOrigin` + - : Indique si une feuille de style CSS injectĂ©e par [`tabs.insertCSS`](/fr/Add-ons/WebExtensions/API/tabs/insertCSS) doit ĂȘtre traitĂ©e comme une feuille de style "auteur" ou "utilisateur". -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.extensionTypes")}}</p> +{{Compat("webextensions.api.extensionTypes")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ© sur l'API Chromium [`chrome.extensionTypes`](https://developer.chrome.com/extensions/extensionTypes) . Cette documentation provient de [`extension_types.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<p>Cette API est basĂ© sur l'API Chromium <a href="https://developer.chrome.com/extensions/extensionTypes"><code>chrome.extensionTypes</code></a> . Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json"><code>extension_types.json</code></a> dans le code de Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</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 @@ -72,5 +68,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extensionTypes // 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/extensiontypes/injectdetails/index.md b/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/injectdetails/index.md index 4282d1c192..1c3b8bbc14 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/injectdetails/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/injectdetails/index.md @@ -13,12 +13,10 @@ tags: - extensionTypes translation_of: Mozilla/Add-ons/WebExtensions/API/extensionTypes/InjectDetails --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Ce type est donnĂ© en tant que paramĂštre aux mĂ©thodes <code>tabs.executeScript()</code>, <code>tabs.insertCSS()</code>, et <code>tabs.removeCSS()</code> . Pour plus de dĂ©tails sur ses propriĂ©tĂ©s et leur utilisation, consultez les pages de documentation de ces mĂ©thodes :</p> +Ce type est donnĂ© en tant que paramĂštre aux mĂ©thodes `tabs.executeScript()`, `tabs.insertCSS()`, et `tabs.removeCSS()` . Pour plus de dĂ©tails sur ses propriĂ©tĂ©s et leur utilisation, consultez les pages de documentation de ces mĂ©thodes : -<ul> - <li>{{WebExtAPIRef("tabs.executeScript()")}}</li> - <li>{{WebExtAPIRef("tabs.insertCSS()")}}</li> - <li>{{WebExtAPIRef("tabs.removeCSS()")}}</li> -</ul> +- {{WebExtAPIRef("tabs.executeScript()")}} +- {{WebExtAPIRef("tabs.insertCSS()")}} +- {{WebExtAPIRef("tabs.removeCSS()")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/runat/index.md b/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/runat/index.md index b5555c76b9..81889451c1 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/runat/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/extensiontypes/runat/index.md @@ -13,37 +13,33 @@ tags: - extensionTypes translation_of: Mozilla/Add-ons/WebExtensions/API/extensionTypes/RunAt --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le plus tot que le Javascript ou CSS sera injectĂ© dans l'onglet.</p> +Le plus tot que le Javascript ou CSS sera injectĂ© dans l'onglet. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaines. Les valeurs possibles sont : <code>"document_start"</code>, <code>"document_end"</code>, <code>"document_idle"</code>.</p> +Les valeurs de ce type sont des chaines. Les valeurs possibles sont : `"document_start"`, `"document_end"`, `"document_idle"`. -<ul> - <li><code>"document_start"</code>: corresponds au <code>chargement</code>. Le DOM est toujours en cours de chargement.</li> - <li><code>"document_end"</code>: corresponds Ă l'<code>interactif</code>. Le DOM a fini de charger, mais des ressources telles que des scripts et des images peuvent toujours ĂȘtre en cours de chargement.</li> - <li><code>"document_idle"</code>: corresponds Ă Â <code>complete</code>. Le document et toutes ses ressources ont terminĂ© le changement.</li> -</ul> +- `"document_start"`: corresponds au `chargement`. Le DOM est toujours en cours de chargement. +- `"document_end"`: corresponds Ă l'`interactif`. Le DOM a fini de charger, mais des ressources telles que des scripts et des images peuvent toujours ĂȘtre en cours de chargement. +- `"document_idle"`: corresponds Ă Â `complete`. Le document et toutes ses ressources ont terminĂ© le changement. -<p>La valeur par dĂ©faut est <code>"document_idle"</code>.</p> +La valeur par dĂ©faut est `"document_idle"`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.extensionTypes.RunAt")}}</p> +{{Compat("webextensions.api.extensionTypes.RunAt")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ© sur l'API Chromium [`chrome.extensionTypes`](https://developer.chrome.com/extensions/extensionTypes) . Cette documentation provient de [`extension_types.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<p>Cette API est basĂ© sur l'API Chromium <a href="https://developer.chrome.com/extensions/extensionTypes"><code>chrome.extensionTypes</code></a> . Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json"><code>extension_types.json</code></a> dans le code de Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</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 @@ -70,5 +66,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/extensionTypes/RunAt // 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/find/find/index.md b/files/fr/mozilla/add-ons/webextensions/api/find/find/index.md index 5ad2c288ab..42662b9253 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/find/find/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/find/find/index.md @@ -11,150 +11,142 @@ tags: - find translation_of: Mozilla/Add-ons/WebExtensions/API/find/find --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Recherche du texte dans un onglet.</p> +Recherche du texte dans un onglet. -<p>Vous pouvez utiliser cette fonction pour rechercher des pages Web HTTP(S) normales. Il recherche un seul onglet : vous pouvez spĂ©cifier l'ID d'un onglet particulier Ă rechercher, ou il recherchera l'onglet actif par dĂ©faut. Il recherche toutes les images de l'onglet..</p> +Vous pouvez utiliser cette fonction pour rechercher des pages Web HTTP(S) normales. Il recherche un seul onglet : vous pouvez spĂ©cifier l'ID d'un onglet particulier Ă rechercher, ou il recherchera l'onglet actif par dĂ©faut. Il recherche toutes les images de l'onglet.. -<p>Vous pouvez rendre la recherche sensible Ă la casse et la faire correspondre uniquement Ă des mots entiers.</p> +Vous pouvez rendre la recherche sensible Ă la casse et la faire correspondre uniquement Ă des mots entiers. -<p>Par dĂ©faut, la fonction renvoie juste le nombre de correspondances trouvĂ©es. En transmettant les options <code>includeRangeData</code> et <code>includeRectData</code>, vous pouvez obtenir plus d'informations sur l'emplacement des correspondances dans l'onglet cible.</p> +Par dĂ©faut, la fonction renvoie juste le nombre de correspondances trouvĂ©es. En transmettant les options `includeRangeData` et `includeRectData`, vous pouvez obtenir plus d'informations sur l'emplacement des correspondances dans l'onglet cible. -<p>Cette fonction stocke les rĂ©sultats en interne, donc la prochaine fois qu'une extension appelle {{WebExtAPIRef("find.highlightResults()")}}, alors les rĂ©sultats de cet appel <em>find</em> seront mis en surbrillance, jusqu'Ă ce que quelqu'un appelle <code>find()</code>.</p> +Cette fonction stocke les rĂ©sultats en interne, donc la prochaine fois qu'une extension appelle {{WebExtAPIRef("find.highlightResults()")}}, alors les rĂ©sultats de cet appel _find_ seront mis en surbrillance, jusqu'Ă ce que quelqu'un appelle `find()`. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">browser.find.find( +```js +browser.find.find( queryphrase, // string options // optional object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>queryphrase</code></dt> - <dd><code>string</code>. Le texte Ă rechercher</dd> - <dt><code>options</code>{{optional_inline}}</dt> - <dd> - <p><code>object</code>. Un objet spĂ©cifiant des options supplĂ©mentaires. Il peut prendre l'une des propriĂ©tĂ©s suivantes, toutes facultatives :</p> - - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet Ă rechercher. Par dĂ©faut Ă l'onglet actif</dd> - <dt><code>caseSensitive</code></dt> - <dd><code>boolean</code>. Si true, la recherche est sensible Ă la casse. Par dĂ©fault Ă Â <code>false</code>.</dd> - <dt><code>entireWord</code></dt> - <dd><code>boolean</code>. Comparaison seulement entre les mots entiers : ainsi "Tok" ne sera pas comparĂ© dans "Tokyo". Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>includeRangeData</code></dt> - <dd><code>boolean</code>. Inclure les groupes de donnĂ©es dans la rĂ©ponse, which describe where in the page DOM the match was found. Defaults to <code>false</code>.</dd> - <dt><code>includeRectData</code></dt> - <dd><code>boolean</code>. Inclure les donnĂ©es de rectangle dans la rĂ©ponse, qui dĂ©crit oĂč la correspondance a Ă©tĂ© trouvĂ©e dans la page de rendu. Par dĂ©faut Ă <code>false</code>.</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p> Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet contenant jusqu'Ă trois propriĂ©tĂ©s :</p> - -<dl> - <dt><code>count</code></dt> - <dd><code>integer</code>. Le nombre de rĂ©sultat trouvĂ©s.</dd> - <dt><code>rangeData</code>{{optional_inline}}</dt> - <dd> - <p><code>array</code>. Si <code>includeRangeData</code> a Ă©tĂ© donnĂ© dans le paramĂštre <code>options</code>, cette propriĂ©tĂ© sera incluse. Il est fourni sous la forme d'un tableau d'objets <code>RangeData</code>, un pour chaque correspondance. Chaque objet <code>RangeData</code> dĂ©crit oĂč la correspondance a Ă©tĂ© trouvĂ©e dans l'arborescence DOM. Cela permettrait, par exemple, une extension pour obtenir le texte entourant chaque correspondance, afin d'afficher le contexte pour les correspondances.</p> - - <p>Les Ă©lements correspondent aux Ă©lĂ©ments donnĂ©es dans <code>rectData</code>, donc <code>rangeData[i]</code> dĂ©crit la mĂȘme correspondance que <code>rectData[i]</code>.</p> - - <p>Chaque <code>RangeData</code> contient les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>framePos</code></dt> - <dd>L'index de l'image contenant la correspondance. 0 correspond Ă une fenĂȘtre parente. Notez que l'ordre des objets dans un tableau <code>rangeData</code> s'alignera sĂ©quentiellement avec l'ordre des index d'images : par exemple, <code>framePos</code> pour la premiĂšre sĂ©quence d'objets <code>rangeData</code> sera 0, <code>framePos</code> pour la sĂ©quence suivante sera 1, et ainsi de suite.</dd> - <dt><code>startTextNodePos</code></dt> - <dd>La position ordinale du noeud de texte dans lequel la correspondance a dĂ©marrĂ©e.</dd> - <dt><code>endTextNodePos</code></dt> - <dd>La position ordinale du noeud de texte dans lequel la correspondance s'est terminĂ©e.</dd> - <dt><code>startOffset</code></dt> - <dd>La position de la chaĂźne de caractĂšres ordinale du dĂ©but du mot correspondant dans le noeud texte de dĂ©but.</dd> - <dt><code>endOffset</code></dt> - <dd>La position de la chaĂźne de caractĂšres ordinale de la fin du mot trouvĂ© dans le nĆud de texte final.</dd> - </dl> - </dd> - <dt><code>rectData</code>{{optional_inline}}</dt> - <dd> - <p><code>array</code>. Si <code>includeRectData</code> a Ă©tĂ© donnĂ© dans les paramĂštres des <code>options</code>, cette propriĂ©tĂ© sera incluse. C'est un tableau d'objets <code>RectData</code> . Il contient des rectangles clients pour tout le texte correspondant Ă la recherche, par rapport Ă la partie supĂ©rieure gauche de la fenĂȘtre. Les extensions peuvent l'utiliser pour fournir une mise en Ă©vidence personnalisĂ©e les rĂ©sultats..</p> - - <p>Chaque objet <code>RectData</code> contient des donnĂ©es rectangle pour une seule correspondance. Il a deux propriĂ©tĂ©s :</p> - - <dl> - <dt><code>rectsAndTexts</code></dt> - <dd>Un objet contenant deux propriĂ©tĂ©s, les deux tableaux : - <ul> - <li><code>rectList</code>: un tableau d'objets ayant chacun quatre propriĂ©tĂ©s entiĂšres : <code>top</code>, <code>left</code>, <code>bottom</code>, <code>right</code>. Ceux-ci dĂ©crivent un rectangle par rapport Ă la partie supĂ©rieure gauche de la fenĂȘtre.</li> - <li><code>textList</code>: un tableau de chaĂźnes, correspondant au tableau <code>rectList</code>. L'entrĂ©e de <code>textList[i]</code> contient la partie du match dĂ©limitĂ©e par le rectangle de <code>rectList[i]</code>.</li> - </ul> - - <p>Par exemple, considĂ©rons une partie d'une page Web qui ressemble Ă ceci :</p> - - <p><img alt="" src="rects-1.png">Si vous recherchez "You may", la comparaison doit ĂȘtre dĂ©crit par deux rectangles :</p> - - <p><img alt="" src="rects-2.png">Dans le cas, dans le <code>RectData</code> qui dĂ©crit cette correspondance, <code>rectsAndTexts.rectList</code> et <code>rectsAndTexts.textList</code> auront chacun 2 Ă©lĂ©ments.</p> - - <ul> - <li><code>textList[0]</code> contiendra "You ", et <code>rectList[0]</code> contiendra son rectangle de dĂ©limitation.</li> - <li><code>textList[1]</code> contiendra "may", et <code>rectList[1]</code> contiendra son rectangle de dĂ©limitation.</li> - </ul> - </dd> - <dt><code>text</code></dt> - <dd>Le texte complet de comparaison, "You may" dans l'exemple ci-dessus.</dd> - </dl> - </dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.find.find", 10)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<h3 id="Exemples_basics">Exemples basics</h3> - -<p>Recherchez "banana" dans l'onglet actif, log le nombre de correspondances et mettez-les en surbrillance :</p> - -<pre class="brush: js">function found(results) { +``` + +### ParamĂštres + +- `queryphrase` + - : `string`. Le texte Ă rechercher +- `options`{{optional_inline}} + + - : `object`. Un objet spĂ©cifiant des options supplĂ©mentaires. Il peut prendre l'une des propriĂ©tĂ©s suivantes, toutes facultatives : + + - `tabId` + - : `integer`. ID de l'onglet Ă rechercher. Par dĂ©faut Ă l'onglet actif + - `caseSensitive` + - : `boolean`. Si true, la recherche est sensible Ă la casse. Par dĂ©fault Ă Â `false`. + - `entireWord` + - : `boolean`. Comparaison seulement entre les mots entiers : ainsi "Tok" ne sera pas comparĂ© dans "Tokyo". Par dĂ©faut Ă `false`. + - `includeRangeData` + - : `boolean`. Inclure les groupes de donnĂ©es dans la rĂ©ponse, which describe where in the page DOM the match was found. Defaults to `false`. + - `includeRectData` + - : `boolean`. Inclure les donnĂ©es de rectangle dans la rĂ©ponse, qui dĂ©crit oĂč la correspondance a Ă©tĂ© trouvĂ©e dans la page de rendu. Par dĂ©faut Ă `false`. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet contenant jusqu'Ă trois propriĂ©tĂ©s : + +- `count` + - : `integer`. Le nombre de rĂ©sultat trouvĂ©s. +- `rangeData`{{optional_inline}} + + - : `array`. Si `includeRangeData` a Ă©tĂ© donnĂ© dans le paramĂštre `options`, cette propriĂ©tĂ© sera incluse. Il est fourni sous la forme d'un tableau d'objets `RangeData`, un pour chaque correspondance. Chaque objet `RangeData` dĂ©crit oĂč la correspondance a Ă©tĂ© trouvĂ©e dans l'arborescence DOM. Cela permettrait, par exemple, une extension pour obtenir le texte entourant chaque correspondance, afin d'afficher le contexte pour les correspondances. + + Les Ă©lements correspondent aux Ă©lĂ©ments donnĂ©es dans `rectData`, donc `rangeData[i]` dĂ©crit la mĂȘme correspondance que `rectData[i]`. + + Chaque `RangeData` contient les propriĂ©tĂ©s suivantes : + + - `framePos` + - : L'index de l'image contenant la correspondance. 0 correspond Ă une fenĂȘtre parente. Notez que l'ordre des objets dans un tableau `rangeData` s'alignera sĂ©quentiellement avec l'ordre des index d'images : par exemple, `framePos` pour la premiĂšre sĂ©quence d'objets `rangeData` sera 0, `framePos` pour la sĂ©quence suivante sera 1, et ainsi de suite. + - `startTextNodePos` + - : La position ordinale du noeud de texte dans lequel la correspondance a dĂ©marrĂ©e. + - `endTextNodePos` + - : La position ordinale du noeud de texte dans lequel la correspondance s'est terminĂ©e. + - `startOffset` + - : La position de la chaĂźne de caractĂšres ordinale du dĂ©but du mot correspondant dans le noeud texte de dĂ©but. + - `endOffset` + - : La position de la chaĂźne de caractĂšres ordinale de la fin du mot trouvĂ© dans le nĆud de texte final. + +- `rectData`{{optional_inline}} + + - : `array`. Si `includeRectData` a Ă©tĂ© donnĂ© dans les paramĂštres des `options`, cette propriĂ©tĂ© sera incluse. C'est un tableau d'objets `RectData` . Il contient des rectangles clients pour tout le texte correspondant Ă la recherche, par rapport Ă la partie supĂ©rieure gauche de la fenĂȘtre. Les extensions peuvent l'utiliser pour fournir une mise en Ă©vidence personnalisĂ©e les rĂ©sultats.. + + Chaque objet `RectData` contient des donnĂ©es rectangle pour une seule correspondance. Il a deux propriĂ©tĂ©s : + + - `rectsAndTexts` + + - : Un objet contenant deux propriĂ©tĂ©s, les deux tableaux : + + - `rectList`: un tableau d'objets ayant chacun quatre propriĂ©tĂ©s entiĂšres : `top`, `left`, `bottom`, `right`. Ceux-ci dĂ©crivent un rectangle par rapport Ă la partie supĂ©rieure gauche de la fenĂȘtre. + - `textList`: un tableau de chaĂźnes, correspondant au tableau `rectList`. L'entrĂ©e de `textList[i]` contient la partie du match dĂ©limitĂ©e par le rectangle de `rectList[i]`. + + Par exemple, considĂ©rons une partie d'une page Web qui ressemble Ă ceci : + + ![](rects-1.png)Si vous recherchez "You may", la comparaison doit ĂȘtre dĂ©crit par deux rectangles : + + ![](rects-2.png)Dans le cas, dans le `RectData` qui dĂ©crit cette correspondance, `rectsAndTexts.rectList` et `rectsAndTexts.textList` auront chacun 2 Ă©lĂ©ments. + + - `textList[0]` contiendra "You ", et `rectList[0]` contiendra son rectangle de dĂ©limitation. + - `textList[1]` contiendra "may", et `rectList[1]` contiendra son rectangle de dĂ©limitation. + + - `text` + - : Le texte complet de comparaison, "You may" dans l'exemple ci-dessus. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.find.find", 10)}} + +## Exemples + +### Exemples basics + +Recherchez "banana" dans l'onglet actif, log le nombre de correspondances et mettez-les en surbrillance : + +```js +function found(results) { console.log(`There were: ${results.count} matches.`); - if (results.count > 0) { + if (results.count > 0) { browser.find.highlightResults(); } } -browser.find.find("banana").then(found);</pre> +browser.find.find("banana").then(found); +``` -<p>Rechercher "banana" dans tous les onglets (notez que cela nĂ©cessite la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "tabs", car il accĂšde Ă <code>tab.url</code>):</p> +Rechercher "banana" dans tous les onglets (notez que cela nĂ©cessite la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "tabs", car il accĂšde Ă `tab.url`): -<pre class="brush: js">async function findInAllTabs(allTabs) { +```js +async function findInAllTabs(allTabs) { for (let tab of allTabs) { let results = await browser.find.find("banana", {tabId: tab.id}); console.log(`In page "${tab.url}": ${results.count} matches.`) } } -browser.tabs.query({}).then(findInAllTabs);</pre> +browser.tabs.query({}).then(findInAllTabs); +``` -<h3 id="Utilisation_de_rangeData">Utilisation de rangeData</h3> +### Utilisation de rangeData -<p>Dans cet exemple, l'extension utilise <code>rangeData</code> pour obtenir le contexte dans lequel la correspondance a Ă©tĂ© trouvĂ©e. Le contexte est le <code>textContent</code> complet du noeud dans lequel la correspondance a Ă©tĂ© trouvĂ©e. Si la correspondance s'Ă©tend sur des noeuds, le contexte est la concatĂ©nation du <code>textContent</code> de tous les noeuds Ă©tendus.</p> +Dans cet exemple, l'extension utilise `rangeData` pour obtenir le contexte dans lequel la correspondance a Ă©tĂ© trouvĂ©e. Le contexte est le `textContent` complet du noeud dans lequel la correspondance a Ă©tĂ© trouvĂ©e. Si la correspondance s'Ă©tend sur des noeuds, le contexte est la concatĂ©nation du `textContent` de tous les noeuds Ă©tendus. -<p>Notez que pour des raisons de simplicitĂ©, cet exemple ne gĂšre pas les pages contenant des cadres. Pour cela, vous devez divisez <code>rangeData</code> en groupes, un par frame, et executer le script dans chaque image.</p> +Notez que pour des raisons de simplicitĂ©, cet exemple ne gĂšre pas les pages contenant des cadres. Pour cela, vous devez divisez `rangeData` en groupes, un par frame, et executer le script dans chaque image. -<p>Le script d'arriĂšre plan :</p> +Le script d'arriĂšre plan : -<pre class="brush: js">// background.js +```js +// background.js async function getContexts(matches) { @@ -176,14 +168,15 @@ async function getContexts(matches) { } -browser.browserAction.onClicked.addListener((tab) => { +browser.browserAction.onClicked.addListener((tab) => { browser.find.find("example", {includeRangeData: true}).then(getContexts); }); -</pre> +``` -<p>Le script de contenu :</p> +Le script de contenu : -<pre class="brush: js">/** +```js +/** * Get all the text nodes into a single array */ function getNodes() { @@ -210,7 +203,7 @@ function getContexts(ranges) { for (let range of ranges) { let context = nodes[range.startTextNodePos].textContent; let pos = range.startTextNodePos; - while (pos < range.endTextNodePos) { + while (pos < range.endTextNodePos) { pos++; context += nodes[pos].textContent; } @@ -219,20 +212,21 @@ function getContexts(ranges) { return contexts; } -browser.runtime.onMessage.addListener((message, sender, sendResponse) => { +browser.runtime.onMessage.addListener((message, sender, sendResponse) => { sendResponse(getContexts(message.ranges)); }); -</pre> +``` -<h3 id="Utiliser_rectData">Utiliser rectData</h3> +### Utiliser rectData -<p>Dans cet exemple, l'extensions utilise <code>rectData</code> pour comparer "redact", en ajoutant des DIVs noires au dessus de leurs rectangles de dĂ©limitation :</p> +Dans cet exemple, l'extensions utilise `rectData` pour comparer "redact", en ajoutant des DIVs noires au dessus de leurs rectangles de dĂ©limitation : -<p><img alt="" src="redacted.png">Notez qu'il y a plusieurs façons, c'est une mauvaise façon d'atteindre les pages.</p> +![](redacted.png)Notez qu'il y a plusieurs façons, c'est une mauvaise façon d'atteindre les pages. -<p>Le script d'arriĂšre-plan :</p> +Le script d'arriĂšre-plan : -<pre class="brush: js">// background.js +```js +// background.js async function redact(matches) { @@ -248,14 +242,15 @@ async function redact(matches) { await browser.tabs.sendMessage(tabId, {rects: matches.rectData}); } -browser.browserAction.onClicked.addListener((tab) => { +browser.browserAction.onClicked.addListener((tab) => { browser.find.find("banana", {includeRectData: true}).then(redact); }); -</pre> +``` -<p>Le script de contenu :</p> +Le script de contenu : -<pre class="brush: js">// redact.js +```js +// redact.js /** * Add a black DIV where the rect is. @@ -282,9 +277,9 @@ function redactAll(rectData) { } } -browser.runtime.onMessage.addListener((message) => { +browser.runtime.onMessage.addListener((message) => { redactAll(message.rects); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/find/highlightresults/index.md b/files/fr/mozilla/add-ons/webextensions/api/find/highlightresults/index.md index 06cd245a98..8a066d2c7f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/find/highlightresults/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/find/highlightresults/index.md @@ -12,40 +12,43 @@ tags: - highlightResults translation_of: Mozilla/Add-ons/WebExtensions/API/find/highlightResults --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Souligne les rĂ©sultats d'un prĂ©cĂ©dent appel Ă {{WebExtAPIRef("find.find()")}}.</p> +Souligne les rĂ©sultats d'un prĂ©cĂ©dent appel Ă {{WebExtAPIRef("find.find()")}}. -<p>Lorsqu'une extension appelle <code>find()</code>, les correspondances ne sont pas automatiquement mises en surbrillance, mais elles sont stockĂ©es par le navigateur. Appelez <code>highlightResults()</code> pour les mettre en surbrillance.</p> +Lorsqu'une extension appelle `find()`, les correspondances ne sont pas automatiquement mises en surbrillance, mais elles sont stockĂ©es par le navigateur. Appelez `highlightResults()` pour les mettre en surbrillance. -<p>Notez que les rĂ©sultats stockĂ©s sont globaux pour toutes les extensions, par exemple, si l'extension appelle <code>find("apple")</code>, alors si l'extensions B appelle <code>find("banana")</code>, alors si l'extensions A appelle <code>highlightResults()</code>, le rĂ©sultat pour "banana" sera mis en Ă©vidence.</p> +Notez que les rĂ©sultats stockĂ©s sont globaux pour toutes les extensions, par exemple, si l'extension appelle `find("apple")`, alors si l'extensions B appelle `find("banana")`, alors si l'extensions A appelle `highlightResults()`, le rĂ©sultat pour "banana" sera mis en Ă©vidence. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.find.highlightResults() -</pre> +```js +browser.find.highlightResults() +``` -<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>Aucune.</p> +Aucune. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.find.highlightResults", 10)}}</p> +{{Compat("webextensions.api.find.highlightResults", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Recherchez "banana" dans l'onglet actif, notez le nombre de correspondances et mettez-les en surbrillance :</p> +Recherchez "banana" dans l'onglet actif, notez le nombre de correspondances et mettez-les en surbrillance : -<pre class="brush: js">function found(results) { +```js +function found(results) { console.log(`There were: ${results.count} matches.`); - if (results.count > 0) { + if (results.count > 0) { browser.find.highlightResults(); } } -browser.find.find("banana").then(found);</pre> +browser.find.find("banana").then(found); +``` diff --git a/files/fr/mozilla/add-ons/webextensions/api/find/index.md b/files/fr/mozilla/add-ons/webextensions/api/find/index.md index ac20ee5539..03aba53b16 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/find/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/find/index.md @@ -10,23 +10,21 @@ tags: - find translation_of: Mozilla/Add-ons/WebExtensions/API/find --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Trouve un texte dans une page web, et met en Ă©vidence les correspondances.</p> +Trouve un texte dans une page web, et met en Ă©vidence les correspondances. -<p>Pour utiliser cette API, vous devez disposez de la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "find".</p> +Pour utiliser cette API, vous devez disposez de la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) "find". -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("find.find()")}}</dt> - <dd>Trouver du texte dans une page web.</dd> - <dt>{{WebExtAPIRef("find.highlightResults()")}}</dt> - <dd>Mettez en surbrillance le dernier jeu de correspondance trouvĂ©.</dd> - <dt>{{WebExtAPIRef("find.removeHighlighting()")}}</dt> - <dd>Supprimez toute mise en Ă©vidence.</dd> -</dl> +- {{WebExtAPIRef("find.find()")}} + - : Trouver du texte dans une page web. +- {{WebExtAPIRef("find.highlightResults()")}} + - : Mettez en surbrillance le dernier jeu de correspondance trouvĂ©. +- {{WebExtAPIRef("find.removeHighlighting()")}} + - : Supprimez toute mise en Ă©vidence. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.find", 1, 1)}} {{WebExtExamples("h2")}}</p> +{{Compat("webextensions.api.find", 1, 1)}} {{WebExtExamples("h2")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/find/removehighlighting/index.md b/files/fr/mozilla/add-ons/webextensions/api/find/removehighlighting/index.md index 0f914d6550..d0fa337d5b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/find/removehighlighting/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/find/removehighlighting/index.md @@ -12,28 +12,30 @@ tags: - removeHighlighting translation_of: Mozilla/Add-ons/WebExtensions/API/find/removeHighlighting --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprimer toute mise en Ă©vidence d'une recherche prĂ©cĂ©dente qui a Ă©tĂ© appliquĂ©e par un appel prĂ©cĂ©dent Ă {{WebExtAPIRef("highlightResults()")}}, ou par l'interface utilisateur native du navigateur.</p> +Supprimer toute mise en Ă©vidence d'une recherche prĂ©cĂ©dente qui a Ă©tĂ© appliquĂ©e par un appel prĂ©cĂ©dent Ă {{WebExtAPIRef("highlightResults()")}}, ou par l'interface utilisateur native du navigateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.find.removeHighlighting() -</pre> +```js +browser.find.removeHighlighting() +``` -<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>Aucune.</p> +Aucune. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.find.removeHighlighting", 10)}}</p> +{{Compat("webextensions.api.find.removeHighlighting", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">browser.find.removeHighlighting(); -</pre> +```js +browser.find.removeHighlighting(); +``` diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/addurl/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/addurl/index.md index 089ce53843..9620adfc7c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/addurl/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/addurl/index.md @@ -13,50 +13,49 @@ tags: - addUrl translation_of: Mozilla/Add-ons/WebExtensions/API/history/addUrl --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ajoute un enregistrement Ă l'historique du navigateur d'une visite Ă l'URL donnĂ©e. L'heure de la visite est enregistrĂ©e comme l'heure de l'appel, et le {{WebExtAPIRef("history.TransitionType", "TransitionType")}} est enregistrĂ© comme "liens".</p> +Ajoute un enregistrement Ă l'historique du navigateur d'une visite Ă l'URL donnĂ©e. L'heure de la visite est enregistrĂ©e comme l'heure de l'appel, et le {{WebExtAPIRef("history.TransitionType", "TransitionType")}} est enregistrĂ© comme "liens". -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 addingUrl = browser.history.addUrl( +```js +var addingUrl = browser.history.addUrl( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Objet contenant l'URL Ă ajouter.</p> - <dl> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL Ă ajouter.</dd> - <dt><code>title</code>{{optional_inline}}</dt> - <dd>string: Le titre de la page. Si ce n'est pas fourni, le titre sera enregistrĂ© comme <code>null</code>.</dd> - <dt><code>transition</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef("history.TransitionType")}}. DĂ©crit comment le navigateur a naviguĂ© vers la page Ă cette occasion. Si ce n'est pas fourni, un type de transition de "lien" sera enregistrĂ©.</dd> - <dt><code>visitTime</code>{{optional_inline}}</dt> - <dd><code>number</code> ou <code>string</code> ou <code>object</code>. Cela peut ĂȘtre reprĂ©sentĂ© par: un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code>, une <a href="http://www.iso.org/iso/home/standards/iso8601.htm">chaĂźne de date ISO 8601</a>, ou le nombre de millisecondes depuis l'Ă©poque. DĂ©finit le temps de visite Ă cette valeur. Si ce n'est pas fourni, l'heure actuelle sera enregistrĂ©e.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. Objet contenant l'URL Ă ajouter. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera rempli sans paramĂštres lorsque l'Ă©lĂ©ment a Ă©tĂ© ajoutĂ©.</p> + - `url` + - : `string`. L'URL Ă ajouter. + - `title`{{optional_inline}} + - : string: Le titre de la page. Si ce n'est pas fourni, le titre sera enregistrĂ© comme `null`. + - `transition`{{optional_inline}} + - : {{WebExtAPIRef("history.TransitionType")}}. DĂ©crit comment le navigateur a naviguĂ© vers la page Ă cette occasion. Si ce n'est pas fourni, un type de transition de "lien" sera enregistrĂ©. + - `visitTime`{{optional_inline}} + - : `number` ou `string` ou `object`. Cela peut ĂȘtre reprĂ©sentĂ© par: un objet [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date), une [chaĂźne de date ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm), ou le nombre de millisecondes depuis l'Ă©poque. DĂ©finit le temps de visite Ă cette valeur. Si ce n'est pas fourni, l'heure actuelle sera enregistrĂ©e. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.history.addUrl")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera rempli sans paramĂštres lorsque l'Ă©lĂ©ment a Ă©tĂ© ajoutĂ©. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Ajoutez un enregistrement d'une visite Ă "https://example.org/", puis vĂ©rifiez que la nouvelle visite a Ă©tĂ© enregistrĂ©e en recherchant l'historique de l'Ă©lĂ©ment le plus rĂ©cent et en l'enregistrant :</p> +{{Compat("webextensions.api.history.addUrl")}} -<pre class="brush: js">function onGot(results) { +## Exemples + +Ajoutez un enregistrement d'une visite Ă "https\://example.org/", puis vĂ©rifiez que la nouvelle visite a Ă©tĂ© enregistrĂ©e en recherchant l'historique de l'Ă©lĂ©ment le plus rĂ©cent et en l'enregistrant : + +```js +function onGot(results) { if (results.length) { console.log(results[0].url); console.log(new Date(results[0].lastVisitTime)); @@ -73,11 +72,13 @@ function onAdded() { } var addingUrl = browser.history.addUrl({url: "https://example.org/"}); -addingUrl.then(onAdded);</pre> +addingUrl.then(onAdded); +``` -<p>Ajouter un enregistrement d'une visite Ă "https://example.org", mais lui donner une <code>visitTime</code> de 24 heures dans le passĂ©, et une <code>transition</code> "typed":</p> +Ajouter un enregistrement d'une visite Ă "https\://example.org", mais lui donner une `visitTime` de 24 heures dans le passĂ©, et une `transition` "typed": -<pre class="brush: js">const DAY = 24 * 60* 60 * 1000; +```js +const DAY = 24 * 60* 60 * 1000; function oneDayAgo() { return Date.now() - DAY; @@ -104,19 +105,18 @@ var addingUrl = browser.history.addUrl({ transition: "typed" }); -addingUrl.then(onAdded);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +addingUrl.then(onAdded); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</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.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -143,5 +143,4 @@ addingUrl.then(onAdded);</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/history/deleteall/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/deleteall/index.md index 924eb064e1..7e110263f5 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/deleteall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/deleteall/index.md @@ -13,36 +13,38 @@ tags: - deleteAll translation_of: Mozilla/Add-ons/WebExtensions/API/history/deleteAll --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime toutes les visites de l'historique du navigateur.</p> +Supprime toutes les visites de l'historique du navigateur. -<p>Cette fonction dĂ©clenche {{WebExtAPIRef("history.onVisitRemoved")}} une seule fois, avec <code>allHistory</code> dĂ©fini sur <code>true</code> et un argument <code>urls</code> vide.</p> +Cette fonction dĂ©clenche {{WebExtAPIRef("history.onVisitRemoved")}} une seule fois, avec `allHistory` dĂ©fini sur `true` et un argument `urls` vide. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 deletingAll = browser.history.deleteAll() -</pre> +```js +var deletingAll = browser.history.deleteAll() +``` -<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> sera remplie sans paramĂštre lorsque tout l'historique a Ă©tĂ© supprimĂ©.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera remplie sans paramĂštre lorsque tout l'historique a Ă©tĂ© supprimĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.history.deleteAll")}}</p> +{{Compat("webextensions.api.history.deleteAll")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprimer tout l'historique lorsque l'utilisateur clique sur une action du navigateur :</p> +Supprimer tout l'historique lorsque l'utilisateur clique sur une action du navigateur : -<pre class="brush: js">function onDeleteAll() { +```js +function onDeleteAll() { console.log("Deleted all history"); } @@ -51,19 +53,18 @@ function deleteAllHistory() { deletingAll.then(onDeleteAll); } -deleteAllHistory();</pre> +deleteAllHistory(); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</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 @@ deleteAllHistory();</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/history/deleterange/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/deleterange/index.md index 732978f38f..a513277480 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/deleterange/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/deleterange/index.md @@ -13,46 +13,45 @@ tags: - deleteRange translation_of: Mozilla/Add-ons/WebExtensions/API/history/deleteRange --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime toutes les visites aux pages que l'utilisateur a effectuĂ©es pendant la pĂ©riode donnĂ©e. Si cela supprime toutes les visites effectuĂ©es sur une page donnĂ©e, alors la page n'apparaĂźtra plus dans l'historique du navigateur et {{WebExtAPIRef("history.onVisitRemoved")}} se dĂ©clenchera pour cela.</p> +Supprime toutes les visites aux pages que l'utilisateur a effectuĂ©es pendant la pĂ©riode donnĂ©e. Si cela supprime toutes les visites effectuĂ©es sur une page donnĂ©e, alors la page n'apparaĂźtra plus dans l'historique du navigateur et {{WebExtAPIRef("history.onVisitRemoved")}} se dĂ©clenchera pour cela. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 deletingRange = browser.history.deleteRange( +```js +var deletingRange = browser.history.deleteRange( range // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>range</code></dt> - <dd><p><code>object</code>. SpĂ©cification de la plage de temps pour laquelle supprimer des visites.</p> - <dl> - <dt><code>startTime</code></dt> - <dd><code>number</code> ou <code>string</code> ou <code>object</code>. Une valeur indiquant une date et une heure. Cela peut ĂȘtre reprĂ©sentĂ© par: un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code>, une <a href="http://www.iso.org/iso/home/standards/iso8601.htm">chaĂźne de de date ISO 8601</a>, ou le nombre de <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>. SpĂ©cifie l'heure de dĂ©but de la plage.</dd> - <dt><code>endTime</code></dt> - <dd><code>number</code> ou <code>string</code> ou <code>object</code>. Une valeur indiquant une date et une heure. Cela peut ĂȘtre reprĂ©sentĂ© par: un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code>, une <a href="http://www.iso.org/iso/home/standards/iso8601.htm">chaĂźne de date ISO 8601</a>, ou le nombre de <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>. SpĂ©cifie l'heure de fin de la plage.</dd> - </dl> - </dd> -</dl> +- `range` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. SpĂ©cification de la plage de temps pour laquelle supprimer des visites. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera remplie sans paramĂštre lorsque la plage a Ă©tĂ© supprimĂ©e.</p> + - `startTime` + - : `number` ou `string` ou `object`. Une valeur indiquant une date et une heure. Cela peut ĂȘtre reprĂ©sentĂ© par: un objet [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date), une [chaĂźne de de date ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm), ou le nombre de [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). SpĂ©cifie l'heure de dĂ©but de la plage. + - `endTime` + - : `number` ou `string` ou `object`. Une valeur indiquant une date et une heure. Cela peut ĂȘtre reprĂ©sentĂ© par: un objet [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date), une [chaĂźne de date ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm), ou le nombre de [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). SpĂ©cifie l'heure de fin de la plage. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.history.deleteRange")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera remplie sans paramĂštre lorsque la plage a Ă©tĂ© supprimĂ©e. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Supprimer toutes les visites effectuĂ©es Ă la derniĂšre minute :</p> +{{Compat("webextensions.api.history.deleteRange")}} -<pre class="brush: js">const MINUTE = 60 * 1000; +## Exemples + +Supprimer toutes les visites effectuĂ©es Ă la derniĂšre minute : + +```js +const MINUTE = 60 * 1000; function oneMinuteAgo() { return Date.now() - MINUTE; @@ -61,19 +60,18 @@ function oneMinuteAgo() { browser.history.deleteRange({ startTime: oneMinuteAgo(), endTime: Date.now() -});</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +}); +``` -<p>This API is based on Chromium's <a href="https://developer.chrome.com/extensions/history#method-deleteRange"><code>chrome.history</code></a> API. This documentation is derived from <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> in the Chromium code.</p> +{{WebExtExamples}} -<p>Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.</p> -</div> +> **Note :** +> +> This API is based on Chromium's [`chrome.history`](https://developer.chrome.com/extensions/history#method-deleteRange) API. This documentation is derived from [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) in the Chromium code. +> +> Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License. -<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 +98,4 @@ browser.history.deleteRange({ // 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/history/deleteurl/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/deleteurl/index.md index 18259c9485..7c4402a1b6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/deleteurl/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/deleteurl/index.md @@ -13,44 +13,43 @@ tags: - deleteUrl translation_of: Mozilla/Add-ons/WebExtensions/API/history/deleteUrl --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime toutes les visites Ă l'URL donnĂ©e de l'historique du navigateur.</p> +Supprime toutes les visites Ă l'URL donnĂ©e de l'historique du navigateur. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 deletingUrl = browser.history.deleteUrl( +```js +var deletingUrl = browser.history.deleteUrl( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Objet contenant l'URL dont les visites doivent ĂȘtre supprimĂ©es.</p> - <dl> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL dont les visites doivent ĂȘtre supprimĂ©es.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. Objet contenant l'URL dont les visites doivent ĂȘtre supprimĂ©es. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera remplie sans paramĂštres lorsque les visites auront Ă©tĂ© supprimĂ©es.</p> + - `url` + - : `string`. L'URL dont les visites doivent ĂȘtre supprimĂ©es. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.history.deleteUrl")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera remplie sans paramĂštres lorsque les visites auront Ă©tĂ© supprimĂ©es. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Supprimez toutes les visites de "https://example.org/" de l'historique, puis vĂ©rifiez que cette URL n'est plus renvoyĂ©e par {{WebExtAPIRef("history.search()")}}:</p> +{{Compat("webextensions.api.history.deleteUrl")}} -<pre class="brush: js">var urlToRemove = "https://example.org/"; +## Exemples + +Supprimez toutes les visites de "https\://example.org/" de l'historique, puis vĂ©rifiez que cette URL n'est plus renvoyĂ©e par {{WebExtAPIRef("history.search()")}}: + +```js +var urlToRemove = "https://example.org/"; function onGot(results) { if (!results.length) { @@ -71,11 +70,13 @@ function onRemoved() { var deletingUrl = browser.history.deleteUrl({url: urlToRemove}); -deletingUrl.then(onRemoved);</pre> +deletingUrl.then(onRemoved); +``` -<p>Supprimez la derniĂšre page visitĂ©e de l'historique, avec un Ă©couteur Ă {{WebExtAPIRef("history.onVisitRemoved")}} pour consigner l'URL de la page supprimĂ©e :</p> +Supprimez la derniĂšre page visitĂ©e de l'historique, avec un Ă©couteur Ă {{WebExtAPIRef("history.onVisitRemoved")}} pour consigner l'URL de la page supprimĂ©e : -<pre class="brush: js">function onRemoved(removeInfo) { +```js +function onRemoved(removeInfo) { if (removeInfo.urls.length) { console.log("Removed: " + removeInfo.urls[0]); } @@ -96,19 +97,18 @@ var searching = browser.history.search({ maxResults: 1 }); -searching.then(onGot);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +searching.then(onGot); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</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.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -135,5 +135,4 @@ searching.then(onGot);</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/history/getvisits/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/getvisits/index.md index c33457b87d..7fa7967c6d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/getvisits/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/getvisits/index.md @@ -13,44 +13,43 @@ tags: - getVisits translation_of: Mozilla/Add-ons/WebExtensions/API/history/getVisits --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>RĂ©cupĂšre des informations sur toutes les visites de l'URL donnĂ©e.</p> +RĂ©cupĂšre des informations sur toutes les visites de l'URL donnĂ©e. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 getting = browser.history.getVisits( +```js +var getting = browser.history.getVisits( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL pour laquelle rĂ©cupĂ©rer les informations de visite.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="valeur_retournĂ©e">valeur retournĂ©e</h3> + - : `object`. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera remplie avec un tableau d'objets <code>{{WebExtAPIRef('history.VisitItem')}}</code> reprĂ©sentant chacun une visite Ă l'URL donnĂ©e. Les visites sont triĂ©es dans l'ordre chronologique inverse.</p> + - `url` + - : `string`. L'URL pour laquelle rĂ©cupĂ©rer les informations de visite. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### valeur retournĂ©e -<p>{{Compat("webextensions.api.history.getVisits")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera remplie avec un tableau d'objets `{{WebExtAPIRef('history.VisitItem')}}` reprĂ©sentant chacun une visite Ă l'URL donnĂ©e. Les visites sont triĂ©es dans l'ordre chronologique inverse. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Liste toutes les visites de la page la plus rĂ©cemment visitĂ©e :</p> +{{Compat("webextensions.api.history.getVisits")}} -<pre class="brush: js">function gotVisits(visits) { +## Exemples + +Liste toutes les visites de la page la plus rĂ©cemment visitĂ©e : + +```js +function gotVisits(visits) { console.log("Visit count: " + visits.length); for (visit of visits) { console.log(visit.visitTime); @@ -73,19 +72,18 @@ var searching = browser.history.search({ maxResults: 1 }); -searching.then(listVisits);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +searching.then(listVisits); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</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.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -112,5 +110,4 @@ searching.then(listVisits);</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/history/historyitem/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/historyitem/index.md index 0e9da92609..a5a79b11c7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/historyitem/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/historyitem/index.md @@ -13,44 +13,40 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/history/HistoryItem --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>Un objet <code>HistoryItem</code> fournit des informations sur une page dans l'historique du navigateur.</p> +Un objet `HistoryItem` fournit des informations sur une page dans l'historique du navigateur. -<h2 id="Type">Type</h2> +## Type -<p>C'est un objet avec les propriĂ©tĂ©s suivantes :</p> +C'est un objet avec les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>id</code></dt> - <dd><code>string</code>. Identifiant unique pour l'article.</dd> - <dt><code>url</code> {{optional_inline}}</dt> - <dd><code>string</code>. L'URL de la page.</dd> - <dt><code>title</code> {{optional_inline}}</dt> - <dd><code>string</code>. Le titre de la page.</dd> - <dt><code>lastVisitTime</code> {{optional_inline}}</dt> - <dd><code>number</code>. Date et heure du dernier chargement de la page, reprĂ©sentĂ©e en millisecondes depuis l'Ă©poque.</dd> - <dt><code>visitCount</code> {{optional_inline}}</dt> - <dd><code>number</code>. Le nombre de fois que l'utilisateur a visitĂ© la page.</dd> - <dt><code>typedCount</code> {{optional_inline}}</dt> - <dd><code>number</code>. Le nombre de fois que l'utilisateur a naviguĂ© sur cette page en tapant l'adresse.</dd> -</dl> +- `id` + - : `string`. Identifiant unique pour l'article. +- `url` {{optional_inline}} + - : `string`. L'URL de la page. +- `title` {{optional_inline}} + - : `string`. Le titre de la page. +- `lastVisitTime` {{optional_inline}} + - : `number`. Date et heure du dernier chargement de la page, reprĂ©sentĂ©e en millisecondes depuis l'Ă©poque. +- `visitCount` {{optional_inline}} + - : `number`. Le nombre de fois que l'utilisateur a visitĂ© la page. +- `typedCount` {{optional_inline}} + - : `number`. Le nombre de fois que l'utilisateur a naviguĂ© sur cette page en tapant l'adresse. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.history.HistoryItem")}}</p> +{{Compat("webextensions.api.history.HistoryItem")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</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 @@ -77,5 +73,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history/HistoryItem // 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/history/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/index.md index ff8c4ff2eb..ffeb70276d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/index.md @@ -12,96 +12,74 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/history --- -<div>{{AddonSidebar}}</div> - -<p>Utilisez l'API <code>historique</code> pour interargir avec l'historique du navigateur.</p> - -<p>Si vous recherchez des informations sur l'historique de session du navigateur, consultez l'<a href="/fr/docs/Web/API/History">interface historique</a>.</p> - -<div class="note"> -<p><strong>Note :</strong> Les tĂ©lĂ©chargements sont traitĂ©s comme des objets <a href="/fr/Add-ons/WebExtensions/API/history/HistoryItem"><code>HistoryItem</code></a>. Par consĂ©quent, des Ă©vĂ©nements tels que <a href="/fr/Add-ons/WebExtensions/API/history/onVisited"><code>history.onVisited</code></a> seront Ă©galement dĂ©clenchĂ©s pour les tĂ©lĂ©chargements.</p> -</div> - -<p>L'historique du navigateur est un enregistrement chronologique des pages que l'utilisateur a visitĂ©es. l'API d'historique vous permet de :</p> - -<ul> - <li><a href="/fr/Add-ons/WebExtensions/API/history/search">Recherchez dans des pagesqui apparaissent dans l'historique du navigateur</a></li> - <li><a href="/fr/Add-ons/WebExtensions/API/history/deleteUrl">Supprimer des pages individuelles de l'historique du navigateur</a></li> - <li><a href="/fr/Add-ons/WebExtensions/API/history/addUrl">Ajouter des pages Ă l'historique du navigateur</a></li> - <li><a href="/fr/Add-ons/WebExtensions/API/history/deleteAll">Supprimer toutes les pages de l'historique du navigateur</a>.</li> -</ul> - -<p>Cependant, l'utilisateur peut avoir visitĂ© une seule page, plusieurs fois, de sorte que l'API a Ă©galement le concept de"visites". Vous pouvez Ă©galement utiliser cette API pour :</p> - -<ul> - <li><a href="/fr/Add-ons/WebExtensions/API/history/getVisits">RĂ©cupĂ©rer l'ensemble des visites effectuĂ©es par l'utilisateur sur une page particuliĂšre</a></li> - <li><a href="/fr/Add-ons/WebExtensions/API/history/deleteRange">Supprimer les visites Ă toutes les pages faites pendant une pĂ©riode de temps</a>.</li> -</ul> - -<p>Pour utiliser cette API, une extension doit demander la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "history" dans le fichier <code><a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a></code>.</p> - -<h2 id="Types">Types</h2> - -<dl> - <dt>{{WebExtAPIRef("history.TransitionType")}}</dt> - <dd>DĂ©crit comment le navigateur a naviguĂ© vers une page particuliĂšre.</dd> - <dt>{{WebExtAPIRef("history.HistoryItem")}}</dt> - <dd> - <p>Fournit des informations sur une page particuliĂšre dans l'historique du navigateur.</p> - </dd> - <dt>{{WebExtAPIRef("history.VisitItem")}}</dt> - <dd> - <p>DĂ©crit une seule visite sur une page.</p> - </dd> -</dl> - -<h2 id="Fonctions">Fonctions</h2> - -<dl> - <dt>{{WebExtAPIRef("history.search()")}}</dt> - <dd>Recherche dans l'historique du navigateur les objets <a href="/fr/Add-ons/WebExtensions/API/History/HistoryItem"><code>history.HistoryItem</code></a> correspondant aux critĂšres donnĂ©s.</dd> - <dt>{{WebExtAPIRef("history.getVisits()")}}</dt> - <dd>RĂ©cupĂšre des informations sur les visites sur une page donnĂ©e.</dd> - <dt>{{WebExtAPIRef("history.addUrl()")}}</dt> - <dd>Ajoute un enregistrement Ă l'historique du navigateur d'une visite sur la page donnĂ©e.</dd> - <dt>{{WebExtAPIRef("history.deleteUrl()")}}</dt> - <dd>Supprime toutes les visites Ă l'URL donnĂ©e de l'historique du navigateur.</dd> - <dt>{{WebExtAPIRef("history.deleteRange()")}}</dt> - <dd>Supprime toutes les visites aux pages que l'utilisateur a effectuĂ©es pendant la pĂ©riode donnĂ©e.</dd> - <dt>{{WebExtAPIRef("history.deleteAll()")}}</dt> - <dd>Supprime toutes les visites de l'historique du navigateur.</dd> -</dl> - -<h2 id="EvĂ©nements">EvĂ©nements</h2> - -<dl> - <dt>{{WebExtAPIRef("history.onTitleChanged")}}</dt> - <dd> - <div>LancĂ© lorsque le titre d'une page visitĂ©e par l'utilisateur est enregistrĂ©.</div> - </dd> - <dt>{{WebExtAPIRef("history.onVisited")}}</dt> - <dd>LancĂ© chaque fois que l'utilisateur visite une page, en fournissant les donnĂ©es {{WebExtAPIRef("history.HistoryItem")}} pour cette page.</dd> - <dt>{{WebExtAPIRef("history.onVisitRemoved")}}</dt> - <dd> - <p>LancĂ© lorsqu'une URL est complĂštement supprimĂ©e de l'historique du navigateur.</p> - </dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.history")}}</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/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</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}} + +Utilisez l'API `historique` pour interargir avec l'historique du navigateur. + +Si vous recherchez des informations sur l'historique de session du navigateur, consultez l'[interface historique](/fr/docs/Web/API/History). + +> **Note :** Les tĂ©lĂ©chargements sont traitĂ©s comme des objets [`HistoryItem`](/fr/Add-ons/WebExtensions/API/history/HistoryItem). Par consĂ©quent, des Ă©vĂ©nements tels que [`history.onVisited`](/fr/Add-ons/WebExtensions/API/history/onVisited) seront Ă©galement dĂ©clenchĂ©s pour les tĂ©lĂ©chargements. + +L'historique du navigateur est un enregistrement chronologique des pages que l'utilisateur a visitĂ©es. l'API d'historique vous permet de : + +- [Recherchez dans des pagesqui apparaissent dans l'historique du navigateur](/fr/Add-ons/WebExtensions/API/history/search) +- [Supprimer des pages individuelles de l'historique du navigateur](/fr/Add-ons/WebExtensions/API/history/deleteUrl) +- [Ajouter des pages Ă l'historique du navigateur](/fr/Add-ons/WebExtensions/API/history/addUrl) +- [Supprimer toutes les pages de l'historique du navigateur](/fr/Add-ons/WebExtensions/API/history/deleteAll). + +Cependant, l'utilisateur peut avoir visitĂ© une seule page, plusieurs fois, de sorte que l'API a Ă©galement le concept de"visites". Vous pouvez Ă©galement utiliser cette API pour : + +- [RĂ©cupĂ©rer l'ensemble des visites effectuĂ©es par l'utilisateur sur une page particuliĂšre](/fr/Add-ons/WebExtensions/API/history/getVisits) +- [Supprimer les visites Ă toutes les pages faites pendant une pĂ©riode de temps](/fr/Add-ons/WebExtensions/API/history/deleteRange). + +Pour utiliser cette API, une extension doit demander la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "history" dans le fichier [`manifest.json`](/fr/Add-ons/WebExtensions/manifest.json). + +## Types + +- {{WebExtAPIRef("history.TransitionType")}} + - : DĂ©crit comment le navigateur a naviguĂ© vers une page particuliĂšre. +- {{WebExtAPIRef("history.HistoryItem")}} + - : Fournit des informations sur une page particuliĂšre dans l'historique du navigateur. +- {{WebExtAPIRef("history.VisitItem")}} + - : DĂ©crit une seule visite sur une page. + +## Fonctions + +- {{WebExtAPIRef("history.search()")}} + - : Recherche dans l'historique du navigateur les objets [`history.HistoryItem`](/fr/Add-ons/WebExtensions/API/History/HistoryItem) correspondant aux critĂšres donnĂ©s. +- {{WebExtAPIRef("history.getVisits()")}} + - : RĂ©cupĂšre des informations sur les visites sur une page donnĂ©e. +- {{WebExtAPIRef("history.addUrl()")}} + - : Ajoute un enregistrement Ă l'historique du navigateur d'une visite sur la page donnĂ©e. +- {{WebExtAPIRef("history.deleteUrl()")}} + - : Supprime toutes les visites Ă l'URL donnĂ©e de l'historique du navigateur. +- {{WebExtAPIRef("history.deleteRange()")}} + - : Supprime toutes les visites aux pages que l'utilisateur a effectuĂ©es pendant la pĂ©riode donnĂ©e. +- {{WebExtAPIRef("history.deleteAll()")}} + - : Supprime toutes les visites de l'historique du navigateur. + +## EvĂ©nements + +- {{WebExtAPIRef("history.onTitleChanged")}} + - : LancĂ© lorsque le titre d'une page visitĂ©e par l'utilisateur est enregistrĂ©. +- {{WebExtAPIRef("history.onVisited")}} + - : LancĂ© chaque fois que l'utilisateur visite une page, en fournissant les donnĂ©es {{WebExtAPIRef("history.HistoryItem")}} pour cette page. +- {{WebExtAPIRef("history.onVisitRemoved")}} + - : LancĂ© lorsqu'une URL est complĂštement supprimĂ©e de l'historique du navigateur. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.history")}} + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. + +<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 @@ -128,5 +106,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history // 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/history/ontitlechanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/ontitlechanged/index.md index aa3124d95e..5371ad6a99 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/ontitlechanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/ontitlechanged/index.md @@ -11,80 +11,64 @@ tags: - onTitleChanged translation_of: Mozilla/Add-ons/WebExtensions/API/history/onTitleChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}LancĂ© lorsque le titre d'une page visitĂ©e par l'utilisateur est enregistrĂ©.Pour Ă©couter les visites d'une page, vous pouvez utiliser {{WebExtAPIRef("history.onVisited")}}. Cependant, le {{WebExtAPIRef("history.HistoryItem")}} que cet Ă©vĂ©nement passe Ă son Ă©couteur n'inclut pas le titre de la page, car le titre de la page n'est gĂ©nĂ©ralement pas connu au moment oĂč `history.onVisited` est envoyĂ©.Au lieu de cela, {{WebExtAPIRef("history.HistoryItem")}} stockĂ© est mis Ă jour avec le titre de la page aprĂšs le chargement de la page, une fois le titre connu. L'Ă©vĂ©nement history.onTitleChanged est dĂ©clenchĂ© Ă ce moment-lĂ . Donc, si vous avez besoin de connaĂźtre les titres des pages telles qu'elles sont visitĂ©es, Ă©coutez `history.onTitleChanged`. -<div>LancĂ© lorsque le titre d'une page visitĂ©e par l'utilisateur est enregistrĂ©.</div> +## Syntaxe -<div></div> - -<div>Pour Ă©couter les visites d'une page, vous pouvez utiliser {{WebExtAPIRef("history.onVisited")}}. Cependant, le {{WebExtAPIRef("history.HistoryItem")}} que cet Ă©vĂ©nement passe Ă son Ă©couteur n'inclut pas le titre de la page, car le titre de la page n'est gĂ©nĂ©ralement pas connu au moment oĂč <code>history.onVisited</code> est envoyĂ©.</div> - -<div></div> - -<div>Au lieu de cela, {{WebExtAPIRef("history.HistoryItem")}} stockĂ© est mis Ă jour avec le titre de la page aprĂšs le chargement de la page, une fois le titre connu. L'Ă©vĂ©nement history.onTitleChanged est dĂ©clenchĂ© Ă ce moment-lĂ . Donc, si vous avez besoin de connaĂźtre les titres des pages telles qu'elles sont visitĂ©es, Ă©coutez <code>history.onTitleChanged</code>.</div> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">browser.history.onTitleChanged.addListener(listener) +```js +browser.history.onTitleChanged.addListener(listener) browser.history.onTitleChanged.removeListener(listener) browser.history.onTitleChanged.hasListener(listener) -</pre> +``` + +Les Ă©vĂ©nements ont trois fonctions : -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` argument est l'Ă©couteur Ă supprimer +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> argument est l'Ă©couteur Ă supprimer</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +## Syntaxe addListener -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +### ParamĂštres -<h3 id="ParamĂštres">ParamĂštres</h3> +- `callback` -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Function that will be called when this event occurs. The function will be passed an object with the following properties:</p> + - : Function that will be called when this event occurs. The function will be passed an object with the following properties: - <dl> - <dt><code>url</code></dt> - <dd><code>String</code>. URL of the page visited.</dd> - <dt><code>title</code></dt> - <dd><code>String</code>. Title of the page visited.</dd> - </dl> - </dd> -</dl> + - `url` + - : `String`. URL of the page visited. + - `title` + - : `String`. Title of the page visited. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.history.onTitleChanged")}}</p> +{{Compat("webextensions.api.history.onTitleChanged")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ăcoutez les Ă©vĂ©nements de changement de titre et consignez l'URL et le titre des pages visitĂ©es</p> +Ăcoutez les Ă©vĂ©nements de changement de titre et consignez l'URL et le titre des pages visitĂ©es -<pre class="brush: js">function handleTitleChanged(item) { +```js +function handleTitleChanged(item) { console.log(item.title); console.log(item.url); } -browser.history.onTitleChanged.addListener(handleTitleChanged);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.history.onTitleChanged.addListener(handleTitleChanged); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</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.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -111,5 +95,4 @@ browser.history.onTitleChanged.addListener(handleTitleChanged);</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/history/onvisited/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/onvisited/index.md index 20a507a95d..a5c16a414b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/onvisited/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/onvisited/index.md @@ -13,74 +13,67 @@ tags: - onVisited translation_of: Mozilla/Add-ons/WebExtensions/API/history/onVisited --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Mise en place Ă chaque fois que l'utilisateur visite une page. Un objet {{WebExtAPIRef("history.HistoryItem")}} est transmis Ă l'Ă©couteur. Cet Ă©vĂ©nement se dĂ©clenche avant que la page ne soit chargĂ©e.</p> +Mise en place Ă chaque fois que l'utilisateur visite une page. Un objet {{WebExtAPIRef("history.HistoryItem")}} est transmis Ă l'Ă©couteur. Cet Ă©vĂ©nement se dĂ©clenche avant que la page ne soit chargĂ©e. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.history.onVisited.addListener(listener) +```js +browser.history.onVisited.addListener(listener) browser.history.onVisited.removeListener(listener) browser.history.onVisited.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>result</code></dt> - <dd> - <p>{{WebExtAPIRef('history.HistoryItem')}}. Un objet reprĂ©sentant l'Ă©lĂ©ment dans l'historique du navigateur.</p> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <p>Au moment oĂč cet Ă©vĂ©nement est envoyĂ©, le navigateur ne connaĂźt pas encore le titre de la page. Si le navigateur a dĂ©jĂ visitĂ© cette page et s'est souvenu de son ancien titre, l'objet <code>HistoryItem.title</code> contiendra l'ancien titre de la page. Si le navigateur n'a pas d'enregistrement de l'ancien titre de la page, alors <code>HistoryItem.title</code> sera vide. Pour obtenir les titres des pages dĂšs qu'ils sont connus, Ă©coutez {{WebExtAPIRef("history.onTitleChanged")}}.</p> - </dd> - </dl> - </dd> -</dl> + - `result` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : {{WebExtAPIRef('history.HistoryItem')}}. Un objet reprĂ©sentant l'Ă©lĂ©ment dans l'historique du navigateur. -<p>{{Compat("webextensions.api.history.onVisited")}}</p> + Au moment oĂč cet Ă©vĂ©nement est envoyĂ©, le navigateur ne connaĂźt pas encore le titre de la page. Si le navigateur a dĂ©jĂ visitĂ© cette page et s'est souvenu de son ancien titre, l'objet `HistoryItem.title` contiendra l'ancien titre de la page. Si le navigateur n'a pas d'enregistrement de l'ancien titre de la page, alors `HistoryItem.title` sera vide. Pour obtenir les titres des pages dĂšs qu'ils sont connus, Ă©coutez {{WebExtAPIRef("history.onTitleChanged")}}. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Ăcoutez les visites et consignez l'URL et l'heure de visite.</p> +{{Compat("webextensions.api.history.onVisited")}} -<pre class="brush: js">function onVisited(historyItem) { +## Exemples + +Ăcoutez les visites et consignez l'URL et l'heure de visite. + +```js +function onVisited(historyItem) { console.log(historyItem.url); console.log(new Date(historyItem.lastVisitTime)); } -browser.history.onVisited.addListener(onVisited);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.history.onVisited.addListener(onVisited); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</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.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -107,5 +100,4 @@ browser.history.onVisited.addListener(onVisited);</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/history/onvisitremoved/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/onvisitremoved/index.md index 57e2a4a063..14317d8a5c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/onvisitremoved/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/onvisitremoved/index.md @@ -13,60 +13,54 @@ tags: - onVisitRemoved translation_of: Mozilla/Add-ons/WebExtensions/API/history/onVisitRemoved --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'une page est complĂštement supprimĂ©e de l'historique du navigateur.</p> +LancĂ© lorsqu'une page est complĂštement supprimĂ©e de l'historique du navigateur. -<ul> - <li>Si toutes les visites d'une seule page sont supprimĂ©es (par exemple, en utilisant {{WebExtAPIRef("history.deleteUrl")}}), cet Ă©vĂ©nement est dĂ©clenchĂ© une fois.</li> - <li>Si une sĂ©rie de visites est supprimĂ©e (par exemple, en utilisant {{WebExtAPIRef("history.deleteRange")}} ou une fonctionnalitĂ© de navigateur telle que "Effacer l'historique rĂ©cent"), alors il est tirĂ© une fois pour chaque page <em>dont les visites tombent toutes dans la plage autorisĂ©e</em>.</li> - <li>Si l'historique complet du navigateur est effacĂ© (par exemple, en utilisant {{WebExtAPIRef("history.deleteAll")}}), il est dĂ©clenchĂ© une seule fois.</li> -</ul> +- Si toutes les visites d'une seule page sont supprimĂ©es (par exemple, en utilisant {{WebExtAPIRef("history.deleteUrl")}}), cet Ă©vĂ©nement est dĂ©clenchĂ© une fois. +- Si une sĂ©rie de visites est supprimĂ©e (par exemple, en utilisant {{WebExtAPIRef("history.deleteRange")}} ou une fonctionnalitĂ© de navigateur telle que "Effacer l'historique rĂ©cent"), alors il est tirĂ© une fois pour chaque page _dont les visites tombent toutes dans la plage autorisĂ©e_. +- Si l'historique complet du navigateur est effacĂ© (par exemple, en utilisant {{WebExtAPIRef("history.deleteAll")}}), il est dĂ©clenchĂ© une seule fois. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.history.onVisitRemoved.addListener(listener) +```js +browser.history.onVisitRemoved.addListener(listener) browser.history.onVisitRemoved.removeListener(listener) browser.history.onVisitRemoved.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd><p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction sera passĂ©e l'argument suivant :</p> - <dl> - <dt><code>removed</code></dt> - <dd><p><code>object</code>. DĂ©tails de l'enlĂšvement. C'est un objet contenant deux propriĂ©tĂ©s: un boolĂ©en <code>allHistory</code> et un tableau <code>urls</code>.</p> - <ul> - <li>Si cet Ă©vĂ©nement se dĂ©clenche parce qu'il est clair, <code>allHistory</code> sera <code>true</code> et <code>urls</code> sera un tableau vide.</li> - <li>Dans le cas contraire, <code>allHistory</code> sera <code>false</code> et <code>urls</code> contiendront un qui est l'URL de la page supprimĂ©e.</li> - </ul> - </dd> - </dl> - </dd> -</dl> +- `callback` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction sera passĂ©e l'argument suivant : -<p>{{Compat("webextensions.api.history.onVisitRemoved")}}</p> + - `removed` -<h2 id="Exemples">Exemples</h2> + - : `object`. DĂ©tails de l'enlĂšvement. C'est un objet contenant deux propriĂ©tĂ©s: un boolĂ©en `allHistory` et un tableau `urls`. -<pre class="brush: js">function onRemoved(removed) { + - Si cet Ă©vĂ©nement se dĂ©clenche parce qu'il est clair, `allHistory` sera `true` et `urls` sera un tableau vide. + - Dans le cas contraire, `allHistory` sera `false` et `urls` contiendront un qui est l'URL de la page supprimĂ©e. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.history.onVisitRemoved")}} + +## Exemples + +```js +function onRemoved(removed) { if (removed.allHistory) { console.log("All history removed"); } else if (removed.urls.length) { @@ -74,19 +68,18 @@ browser.history.onVisitRemoved.hasListener(listener) } } -browser.history.onVisitRemoved.addListener(onRemoved);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.history.onVisitRemoved.addListener(onRemoved); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</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.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 +106,4 @@ browser.history.onVisitRemoved.addListener(onRemoved);</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/history/search/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/search/index.md index 9538c36511..4ed3e94435 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/search/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/search/index.md @@ -13,55 +13,61 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/history/search --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Recherche dans l'historique du navigateur les objets {{WebExtAPIRef("history.HistoryItem")}} correspondant aux critĂšres donnĂ©s.</p> +Recherche dans l'historique du navigateur les objets {{WebExtAPIRef("history.HistoryItem")}} correspondant aux critĂšres donnĂ©s. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 searching = browser.history.search( +```js +var searching = browser.history.search( query // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>query</code></dt> - <dd><p>Un objet qui indique ce qu'il faut rechercher dans l'historique du navigateur. Cet objet a les champs suivants :</p> - <dl> - <dt><code>text</code></dt> - <dd><p><code>string</code>. Rechercher des Ă©lĂ©ments d'historique par URL et titre. La chaĂźne est divisĂ©e en termes de recherche distincts aux limites de l'espace. Chaque terme de recherche est insensible Ă la casse par rapport Ă l'URL et au titre de l'Ă©lĂ©ment d'historique. L'Ă©lĂ©ment d'historique sera renvoyĂ© si tous les termes de recherche correspondent.</p> - <p>Par exemple, considĂ©rez cet article :</p> - <p><p>URL: <code>"http://example.org"</code></p> - <p>Title: <code>"Example Domain"</code></p> - <pre>"http" -> matches -"domain" -> matches -"MAIN ample" -> matches -"main tt" -> matches -"main https" -> does not match</pre> - <p>SpĂ©cifiez une chaĂźne vide (<code>""</code>) pour rĂ©cupĂ©rer tous les objets {{WebExtAPIRef("history.HistoryItem")}} qui rĂ©pondent Ă tous les autres critĂšres.</p></dd> - <dt><code>startTime</code> {{optional_inline}}</dt> - <dd><code>number</code> ou <code>string</code> ou <code>object</code>. Une valeur indiquant une date et une heure. Cela peut ĂȘtre reprĂ©sentĂ© par : un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code>, une <a href="http://www.iso.org/iso/home/standards/iso8601.htm">chaĂźne de date ISO 8601</a>, ou le nombre de millisecondes depuis l'Ă©poque. Si elle est fournie, cette option exclut les rĂ©sultats dont <code>lastVisitTime</code> est antĂ©rieure Ă cette heure. Si elle est omise, la recherche est limitĂ©e aux derniĂšres 24 heures.</dd> - <dt><code>endTime</code> {{optional_inline}}</dt> - <dd><code>number</code> ou <code>string</code> ou <code>object</code>. Une valeur indiquant une date et une heure. Cela peut ĂȘtre reprĂ©sentĂ© par : un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code>, une <a href="http://www.iso.org/iso/home/standards/iso8601.htm">chaĂźne de date ISO 8601</a>, ou le nombre de millisecondes depuis l'Ă©poque. Si elle est fournie, cette option exclut les rĂ©sultats dont <code>lastVisitTime</code> est postĂ©rieur Ă cette fois. Si elle est omise, toutes les entrĂ©es sont prises en compte Ă partir de l'heure de dĂ©but.</dd> - <dt><code>maxResults</code> {{optional_inline}}</dt> - <dd><code>number</code>. Le nombre maximum de rĂ©sultats Ă rĂ©cupĂ©rer. La valeur par dĂ©faut est 100, avec une valeur minimale de 1. La fonction renvoie une erreur si vous lui transmettez une valeur <code>maxResults</code> infĂ©rieure Ă 1.</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera remplie avec un tableau d'objets de type {{WebExtAPIRef("history.HistoryItem")}}, chacun dĂ©crivant un seul Ă©lĂ©ment d'historique correspondant. Les articles sont triĂ©s dans l'ordre chronologique inverse.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Consigne l'URL et la derniĂšre heure de visite pour tous les Ă©lĂ©ments d'historique visitĂ©s au cours des derniĂšres 24 heures :</p> - -<pre class="brush: js">function onGot(historyItems) { +``` + +### ParamĂštres + +- `query` + + - : Un objet qui indique ce qu'il faut rechercher dans l'historique du navigateur. Cet objet a les champs suivants : + + - `text` + + - : `string`. Rechercher des Ă©lĂ©ments d'historique par URL et titre. La chaĂźne est divisĂ©e en termes de recherche distincts aux limites de l'espace. Chaque terme de recherche est insensible Ă la casse par rapport Ă l'URL et au titre de l'Ă©lĂ©ment d'historique. L'Ă©lĂ©ment d'historique sera renvoyĂ© si tous les termes de recherche correspondent. + + Par exemple, considĂ©rez cet article : + + URL: `"http://example.org"` + + Title: `"Example Domain"` + + "http" -> matches + "domain" -> matches + "MAIN ample" -> matches + "main tt" -> matches + "main https" -> does not match + + SpĂ©cifiez une chaĂźne vide (`""`) pour rĂ©cupĂ©rer tous les objets {{WebExtAPIRef("history.HistoryItem")}} qui rĂ©pondent Ă tous les autres critĂšres. + + - `startTime` {{optional_inline}} + - : `number` ou `string` ou `object`. Une valeur indiquant une date et une heure. Cela peut ĂȘtre reprĂ©sentĂ© par : un objet [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date), une [chaĂźne de date ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm), ou le nombre de millisecondes depuis l'Ă©poque. Si elle est fournie, cette option exclut les rĂ©sultats dont `lastVisitTime` est antĂ©rieure Ă cette heure. Si elle est omise, la recherche est limitĂ©e aux derniĂšres 24 heures. + - `endTime` {{optional_inline}} + - : `number` ou `string` ou `object`. Une valeur indiquant une date et une heure. Cela peut ĂȘtre reprĂ©sentĂ© par : un objet [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date), une [chaĂźne de date ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm), ou le nombre de millisecondes depuis l'Ă©poque. Si elle est fournie, cette option exclut les rĂ©sultats dont `lastVisitTime` est postĂ©rieur Ă cette fois. Si elle est omise, toutes les entrĂ©es sont prises en compte Ă partir de l'heure de dĂ©but. + - `maxResults` {{optional_inline}} + - : `number`. Le nombre maximum de rĂ©sultats Ă rĂ©cupĂ©rer. La valeur par dĂ©faut est 100, avec une valeur minimale de 1. La fonction renvoie une erreur si vous lui transmettez une valeur `maxResults` infĂ©rieure Ă 1. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera remplie avec un tableau d'objets de type {{WebExtAPIRef("history.HistoryItem")}}, chacun dĂ©crivant un seul Ă©lĂ©ment d'historique correspondant. Les articles sont triĂ©s dans l'ordre chronologique inverse. + +## Exemples + +Consigne l'URL et la derniĂšre heure de visite pour tous les Ă©lĂ©ments d'historique visitĂ©s au cours des derniĂšres 24 heures : + +```js +function onGot(historyItems) { for (item of historyItems) { console.log(item.url); console.log(new Date(item.lastVisitTime)); @@ -70,11 +76,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history/search var searching = browser.history.search({text: ""}); -searching.then(onGot);</pre> +searching.then(onGot); +``` -<p>Logs the URL and last visit time for all history items ever visited:</p> +Logs the URL and last visit time for all history items ever visited: -<pre class="brush: js">function onGot(historyItems) { +```js +function onGot(historyItems) { for (item of historyItems) { console.log(item.url); console.log(new Date(item.lastVisitTime)); @@ -86,11 +94,13 @@ var searching = browser.history.search({ startTime: 0 }); -searching.then(onGot);</pre> +searching.then(onGot); +``` -<p>Consigne l'URL et la derniĂšre visite de la derniĂšre visite sur une page contenant la chaĂźne "mozilla" :</p> +Consigne l'URL et la derniĂšre visite de la derniĂšre visite sur une page contenant la chaĂźne "mozilla" : -<pre class="brush: js">function onGot(historyItems) { +```js +function onGot(historyItems) { for (item of historyItems) { console.log(item.url); console.log(new Date(item.lastVisitTime)); @@ -103,23 +113,22 @@ var searching = browser.history.search({ maxResults: 1 }); -searching.then(onGot);</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +searching.then(onGot); +``` -<p>{{Compat("webextensions.api.history.search")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> +{{Compat("webextensions.api.history.search")}} -<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.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -146,5 +155,4 @@ searching.then(onGot);</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/history/transitiontype/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/transitiontype/index.md index c64743e6f1..45a6e3fd23 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/transitiontype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/transitiontype/index.md @@ -13,54 +13,50 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/history/TransitionType --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>Ceci dĂ©crit comment le navigateur a naviguĂ© vers une page particuliĂšre. Par exemple, "lien" signifie que le navigateur a naviguĂ© vers la page parce que l'utilisateur a cliquĂ© sur un lien</p> +Ceci dĂ©crit comment le navigateur a naviguĂ© vers une page particuliĂšre. Par exemple, "lien" signifie que le navigateur a naviguĂ© vers la page parce que l'utilisateur a cliquĂ© sur un lien -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<dl> - <dt>"link"</dt> - <dd>L'utilisateur a cliquĂ© sur un lien dans une autre page.</dd> - <dt>"typed"</dt> - <dd>L'utilisateur a tapĂ© l'URL dans la barre d'adresse. Ceci est Ă©galement utilisĂ© si l'utilisateur a commencĂ© Ă taper dans la barre d'adresse, puis sĂ©lectionnĂ© une URL parmi les suggestions qu'il a proposĂ©es. Voir aussi "gĂ©nĂ©rĂ©".</dd> - <dt>"auto_bookmark"</dt> - <dd>L'utilisateur a cliquĂ© sur un signet ou un Ă©lĂ©ment dans l'historique du navigateur.</dd> - <dt>"auto_subframe"</dt> - <dd>Les iframes imbriquĂ©s qui sont automatiquement chargĂ©s par leur parent.</dd> - <dt>"manual_subframe"</dt> - <dd>Les iframes imbriquĂ©s chargĂ©s en tant qu'action utilisateur explicite. Le chargement d'une telle iframe gĂ©nĂ©rera une entrĂ©e dans la liste de navigation avant / arriĂšre.</dd> - <dt>"generated"</dt> - <dd>L'utilisateur a commencĂ© Ă taper dans la barre d'adresse, puis a cliquĂ© sur une entrĂ©e suggĂ©rĂ©e qui ne contenait pas d'URL.</dd> - <dt>"auto_toplevel"</dt> - <dd>La page a Ă©tĂ© passĂ©e Ă la ligne de commande ou est la page de dĂ©marrage.</dd> - <dt>"form_submit"</dt> - <dd>L'utilisateur a soumis un formulaire. Notez que dans certaines situations, par exemple lorsqu'un formulaire utilise un script pour soumettre son contenu, l'envoi d'un formulaire n'entraĂźne pas ce type de transition.</dd> - <dt>"reload"</dt> - <dd>L'utilisateur a rechargĂ© la page en utilisant le bouton Recharger ou en appuyant sur EntrĂ©e dans la barre d'adresse. Ceci est Ă©galement utilisĂ© pour la restauration de session et la rĂ©ouverture des onglets fermĂ©s.</dd> - <dt>"keyword"</dt> - <dd>L'URL a Ă©tĂ© gĂ©nĂ©rĂ©e Ă l'aide d'une <a href="https://support.mozilla.org/en-US/kb/how-search-from-address-bar">recherche par mot clĂ©</a> configurĂ© par l'utilisateur.</dd> - <dt>"keyword_generated"</dt> - <dd>Correspond Ă une visite gĂ©nĂ©rĂ©e pour un mot clĂ©.</dd> -</dl> +- "link" + - : L'utilisateur a cliquĂ© sur un lien dans une autre page. +- "typed" + - : L'utilisateur a tapĂ© l'URL dans la barre d'adresse. Ceci est Ă©galement utilisĂ© si l'utilisateur a commencĂ© Ă taper dans la barre d'adresse, puis sĂ©lectionnĂ© une URL parmi les suggestions qu'il a proposĂ©es. Voir aussi "gĂ©nĂ©rĂ©". +- "auto_bookmark" + - : L'utilisateur a cliquĂ© sur un signet ou un Ă©lĂ©ment dans l'historique du navigateur. +- "auto_subframe" + - : Les iframes imbriquĂ©s qui sont automatiquement chargĂ©s par leur parent. +- "manual_subframe" + - : Les iframes imbriquĂ©s chargĂ©s en tant qu'action utilisateur explicite. Le chargement d'une telle iframe gĂ©nĂ©rera une entrĂ©e dans la liste de navigation avant / arriĂšre. +- "generated" + - : L'utilisateur a commencĂ© Ă taper dans la barre d'adresse, puis a cliquĂ© sur une entrĂ©e suggĂ©rĂ©e qui ne contenait pas d'URL. +- "auto_toplevel" + - : La page a Ă©tĂ© passĂ©e Ă la ligne de commande ou est la page de dĂ©marrage. +- "form_submit" + - : L'utilisateur a soumis un formulaire. Notez que dans certaines situations, par exemple lorsqu'un formulaire utilise un script pour soumettre son contenu, l'envoi d'un formulaire n'entraĂźne pas ce type de transition. +- "reload" + - : L'utilisateur a rechargĂ© la page en utilisant le bouton Recharger ou en appuyant sur EntrĂ©e dans la barre d'adresse. Ceci est Ă©galement utilisĂ© pour la restauration de session et la rĂ©ouverture des onglets fermĂ©s. +- "keyword" + - : L'URL a Ă©tĂ© gĂ©nĂ©rĂ©e Ă l'aide d'une [recherche par mot clĂ©](https://support.mozilla.org/en-US/kb/how-search-from-address-bar) configurĂ© par l'utilisateur. +- "keyword_generated" + - : Correspond Ă une visite gĂ©nĂ©rĂ©e pour un mot clĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.history.TransitionType")}}</p> +{{Compat("webextensions.api.history.TransitionType")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</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 @@ -87,5 +83,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history/TransitionType // 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/history/visititem/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/visititem/index.md index 5a0b34fdd2..d49417ce9a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/visititem/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/visititem/index.md @@ -13,42 +13,38 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/history/VisitItem --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet dĂ©crivant une seule visite sur une page.</p> +Un objet dĂ©crivant une seule visite sur une page. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>id</code></dt> - <dd><code>string</code>. L'identifiant unique du {{WebExtAPIRef("history.HistoryItem")}} associĂ© Ă cette visite.</dd> - <dt><code>visitId</code></dt> - <dd><code>string</code>. L'identifiant unique pour cette visite.</dd> - <dt><code>visitTime</code>{{optional_inline}}</dt> - <dd><code>number</code>. Lorsque cette visite s'est produite, reprĂ©sentĂ©e en millisecondes depuis l'Ă©poque.</dd> - <dt><code>referringVisitId</code></dt> - <dd><code>string</code>. L'ID de visite du rĂ©fĂ©rent.</dd> - <dt><code>transition</code></dt> - <dd>{{WebExtAPIRef('history.TransitionType')}}. DĂ©crit comment le navigateur a naviguĂ© vers la page Ă cette occasion.</dd> -</dl> +- `id` + - : `string`. L'identifiant unique du {{WebExtAPIRef("history.HistoryItem")}} associĂ© Ă cette visite. +- `visitId` + - : `string`. L'identifiant unique pour cette visite. +- `visitTime`{{optional_inline}} + - : `number`. Lorsque cette visite s'est produite, reprĂ©sentĂ©e en millisecondes depuis l'Ă©poque. +- `referringVisitId` + - : `string`. L'ID de visite du rĂ©fĂ©rent. +- `transition` + - : {{WebExtAPIRef('history.TransitionType')}}. DĂ©crit comment le navigateur a naviguĂ© vers la page Ă cette occasion. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.history.VisitItem")}}</p> +{{Compat("webextensions.api.history.VisitItem")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dĂ©rivĂ©e de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</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 @@ -75,5 +71,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history/VisitItem // 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/i18n/detectlanguage/index.md b/files/fr/mozilla/add-ons/webextensions/api/i18n/detectlanguage/index.md index 3d0ab33444..6edad6a096 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/i18n/detectlanguage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/detectlanguage/index.md @@ -13,51 +13,48 @@ tags: - i18n translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/detectLanguage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©tecte la langue du texte fourni Ă l'aide du <a href="https://github.com/CLD2Owners/cld2">dĂ©tecteur de langue compact</a> (CLD).</p> +DĂ©tecte la langue du texte fourni Ă l'aide du [dĂ©tecteur de langue compact](https://github.com/CLD2Owners/cld2) (CLD). -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 detectingLanguages = browser.i18n.detectLanguage( +```js +var detectingLanguages = browser.i18n.detectLanguage( text // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>text</code></dt> - <dd><code>string</code>. ChaĂźne d'entrĂ©e de l'utilisateur Ă traduire.</dd> -</dl> +- `text` + - : `string`. ChaĂźne d'entrĂ©e de l'utilisateur Ă traduire. -<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 rĂ©sultat. L'objet rĂ©sultat a deux propriĂ©tĂ©s :</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet rĂ©sultat. L'objet rĂ©sultat a deux propriĂ©tĂ©s : -<dl> - <dt><code>isReliable</code></dt> - <dd><code>boolean</code>. Si la langue a Ă©tĂ© dĂ©tectĂ©e de maniĂšre fiable.</dd> - <dt><code>languages</code></dt> - <dd><p><code>array</code> d'objets, dont chacun a deux propriĂ©tĂ©s:</p> - <dl> - <dt><code>language</code></dt> - <dd>{{WebExtAPIRef('i18n.LanguageCode')}}. La langue dĂ©tectĂ©e.</dd> - <dt><code>percentage</code></dt> - <dd><code>integer</code>. Le pourcentage de la chaĂźne d'entrĂ©e qui Ă©tait dans la langue dĂ©tectĂ©e.</dd> - </dl> - </dd> -</dl> +- `isReliable` + - : `boolean`. Si la langue a Ă©tĂ© dĂ©tectĂ©e de maniĂšre fiable. +- `languages` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : `array` d'objets, dont chacun a deux propriĂ©tĂ©s: -<p>{{Compat("webextensions.api.i18n.detectLanguage")}}</p> + - `language` + - : {{WebExtAPIRef('i18n.LanguageCode')}}. La langue dĂ©tectĂ©e. + - `percentage` + - : `integer`. Le pourcentage de la chaĂźne d'entrĂ©e qui Ă©tait dans la langue dĂ©tectĂ©e. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function onLanguageDetected(langInfo) { +{{Compat("webextensions.api.i18n.detectLanguage")}} + +## Exemples + +```js +function onLanguageDetected(langInfo) { for (lang of langInfo.languages) { console.log("Le langage est : " + lang.language); console.log("Le pourcentage est : " + lang.percentage); @@ -68,20 +65,17 @@ var text = "L'homme est nĂ© libre, et partout il est dans les fers." var detecting = browser.i18n.detectLanguage(text); detecting.then(onLanguageDetected); +``` -</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/i18n"><code>chrome.i18n</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.json"><code>i18n.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.i18n`](https://developer.chrome.com/extensions/i18n). Cette documentation est dĂ©rivĂ©e de [`i18n.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.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 @@ -108,5 +102,4 @@ detecting.then(onLanguageDetected); // 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/i18n/getacceptlanguages/index.md b/files/fr/mozilla/add-ons/webextensions/api/i18n/getacceptlanguages/index.md index ff37745f2c..af88a78ce8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/i18n/getacceptlanguages/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/getacceptlanguages/index.md @@ -13,53 +13,51 @@ tags: - i18n translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/getAcceptLanguages --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient les <a href="/fr/docs/Web/HTTP/Content_negotiation#The_Accept-Language_header">accept-languages</a> du navigateur. Ceci est diffĂ©rent des paramĂštres rĂ©gionaux utilisĂ©s par le navigateur. Pour obtenir les paramĂštres rĂ©gionaux, utilisez {{WebExtAPIRef('i18n.getUILanguage')}}.</p> +Obtient les [accept-languages](/fr/docs/Web/HTTP/Content_negotiation#The_Accept-Language_header) du navigateur. Ceci est diffĂ©rent des paramĂštres rĂ©gionaux utilisĂ©s par le navigateur. Pour obtenir les paramĂštres rĂ©gionaux, utilisez {{WebExtAPIRef('i18n.getUILanguage')}}. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingAcceptLanguages = browser.i18n.getAcceptLanguages() -</pre> +```js +var gettingAcceptLanguages = browser.i18n.getAcceptLanguages() +``` -<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 remplie avec un <code>array</code> d'objets <code>{{WebExtAPIRef('i18n.LanguageCode')}}</code>.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un `array` d'objets `{{WebExtAPIRef('i18n.LanguageCode')}}`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.i18n.getAcceptLanguages")}}</p> +{{Compat("webextensions.api.i18n.getAcceptLanguages")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function onGot(languages) { +```js +function onGot(languages) { console.log(languages); //e.g. Array [ "en-US", "en" ] } var gettingAcceptLanguages = browser.i18n.getAcceptLanguages(); gettingAcceptLanguages.then(onGot); -</pre> +``` +{{WebExtExamples}} +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.i18n`](https://developer.chrome.com/extensions/i18n). Cette documentation est dĂ©rivĂ©e de [`i18n.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.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>{{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/i18n"><code>chrome.i18n</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.json"><code>i18n.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 @@ -86,5 +84,4 @@ gettingAcceptLanguages.then(onGot); // 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/i18n/getmessage/index.md b/files/fr/mozilla/add-ons/webextensions/api/i18n/getmessage/index.md index 2d023fb195..60fafca46a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/i18n/getmessage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/getmessage/index.md @@ -13,51 +13,52 @@ tags: - i18n translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/getMessage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient la chaĂźne localisĂ©e pour le message spĂ©cifiĂ©.</p> +Obtient la chaĂźne localisĂ©e pour le message spĂ©cifiĂ©. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.i18n.getMessage( +```js +browser.i18n.getMessage( messageName, // string substitutions // optional any ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>messageName</code></dt> - <dd><p><code>string</code>. Le nom du message, tel que spĂ©cifiĂ© dans le fichier messages.json. Si le message ne peut pas ĂȘtre trouvĂ© dans messages.json :</p> - <ul> - <li>Firefox renvoie "" et enregistre une erreur.</li> - <li>Chrome renvoie "" et n'enregistre pas d'erreur.</li> - </ul> - </dd> - <dt><code>substitutions</code>{{optional_inline}}</dt> - <dd><code>string</code> ou <code>array</code> de <code>string</code>. Une chaĂźne de substitution unique ou un tableau de chaĂźnes de substitution. Dans Chrome, si vous fournissez plus de 9 chaĂźnes de substitution, <code>getMessage()</code> renvoie <code>undefined</code>.</dd> -</dl> +- `messageName` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `string`. Le nom du message, tel que spĂ©cifiĂ© dans le fichier messages.json. Si le message ne peut pas ĂȘtre trouvĂ© dans messages.json : -<p><code>string</code>. Message localisĂ© pour les paramĂštres rĂ©gionaux en cours.</p> + - Firefox renvoie "" et enregistre une erreur. + - Chrome renvoie "" et n'enregistre pas d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- `substitutions`{{optional_inline}} + - : `string` ou `array` de `string`. Une chaĂźne de substitution unique ou un tableau de chaĂźnes de substitution. Dans Chrome, si vous fournissez plus de 9 chaĂźnes de substitution, `getMessage()` renvoie `undefined`. -<p>{{Compat("webextensions.api.i18n.getMessage")}}</p> +### Valeur retournĂ©e -<h2 id="Exemples">Exemples</h2> +`string`. Message localisĂ© pour les paramĂštres rĂ©gionaux en cours. -<p>Obtenez la chaĂźne localisĂ©e pour <code>"messageContent"</code>, avec <code>target.url</code> substituĂ© :</p> +## CompatibilitĂ© du navigateur -<pre class="brush: js">var message = browser.i18n.getMessage("messageContent", target.url); +{{Compat("webextensions.api.i18n.getMessage")}} + +## Exemples + +Obtenez la chaĂźne localisĂ©e pour `"messageContent"`, avec `target.url` substituĂ© : + +```js +var message = browser.i18n.getMessage("messageContent", target.url); console.log(message); -</pre> +``` -<p>Cela fonctionnerait avec un fichier _locales/en/messages.json contenant :</p> +Cela fonctionnerait avec un fichier \_locales/en/messages.json contenant : -<pre class="brush: json">{ +```json +{ "messageContent": { "message": "You clicked $URL$.", "description": "Tells the user which link they clicked.", @@ -68,23 +69,22 @@ console.log(message); } } } -}</pre> - -<p>Si <code>target.url</code> est "https://developer.mozilla.org", alors la valeur de message, dans la locale "en", serait :</p> - -<pre>"You clicked https://developer.mozilla.org."</pre> +} +``` -<p>{{WebExtExamples}}</p> +Si `target.url` est "https\://developer.mozilla.org", alors la valeur de message, dans la locale "en", serait : -<div class="note"><p><strong>Note :</strong></p> + "You clicked https://developer.mozilla.org." -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/i18n"><code>chrome.i18n</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.json"><code>i18n.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.i18n`](https://developer.chrome.com/extensions/i18n). Cette documentation est dĂ©rivĂ©e de [`i18n.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.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 @@ -111,5 +111,4 @@ console.log(message); // 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/i18n/getuilanguage/index.md b/files/fr/mozilla/add-ons/webextensions/api/i18n/getuilanguage/index.md index 882ed3c4ee..6ed82bfc4c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/i18n/getuilanguage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/getuilanguage/index.md @@ -13,45 +13,46 @@ tags: - i18n translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/getUILanguage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient la langue de l'interface utilisateur du navigateur. Ceci est diffĂ©rent de {{WebExtAPIRef('i18n.getAcceptLanguages')}} qui renvoie les langues utilisateur prĂ©fĂ©rĂ©es.</p> +Obtient la langue de l'interface utilisateur du navigateur. Ceci est diffĂ©rent de {{WebExtAPIRef('i18n.getAcceptLanguages')}} qui renvoie les langues utilisateur prĂ©fĂ©rĂ©es. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.i18n.getUILanguage() -</pre> +```js +browser.i18n.getUILanguage() +``` -<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><code>string</code>. Le code de langue de l'interface utilisateur du navigateur en tant que {{WebExtAPIRef("i18n.LanguageCode")}}.</p> +`string`. Le code de langue de l'interface utilisateur du navigateur en tant que {{WebExtAPIRef("i18n.LanguageCode")}}. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.i18n.getUILanguage")}}</p> +{{Compat("webextensions.api.i18n.getUILanguage")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">var uiLanguage = browser.i18n.getUILanguage(); +```js +var uiLanguage = browser.i18n.getUILanguage(); console.log(uiLanguage); -//e.g. "fr"</pre> +//e.g. "fr" +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.i18n`](https://developer.chrome.com/extensions/i18n). Cette documentation est dĂ©rivĂ©e de [`i18n.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.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/i18n"><code>chrome.i18n</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.json"><code>i18n.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 @@ -78,5 +79,4 @@ console.log(uiLanguage); // 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/i18n/index.md b/files/fr/mozilla/add-ons/webextensions/api/i18n/index.md index 7e04021ff9..fc09e6bb30 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/i18n/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/index.md @@ -12,46 +12,38 @@ tags: - i18n translation_of: Mozilla/Add-ons/WebExtensions/API/i18n --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Fonctions permettant d'internationaliser votre extension. Vous pouvez utiliser ces API pour obtenir des chaĂźnes localisĂ©es Ă partir de fichiers locaux conditionnĂ©s avec votre extension, connaĂźtre la langue actuelle du navigateur et en connaĂźtre la valeur de son <a href="/fr/docs/Web/HTTP/Content_negotiation#The_Accept-Language_header">En-tete "Accept-Language"</a>.</p> +Fonctions permettant d'internationaliser votre extension. Vous pouvez utiliser ces API pour obtenir des chaĂźnes localisĂ©es Ă partir de fichiers locaux conditionnĂ©s avec votre extension, connaĂźtre la langue actuelle du navigateur et en connaĂźtre la valeur de son [En-tete "Accept-Language"](/fr/docs/Web/HTTP/Content_negotiation#The_Accept-Language_header). -<p>Pour plus de dĂ©tails sur l'utilisation de i18n pour votre extension, voir :</p> +Pour plus de dĂ©tails sur l'utilisation de i18n pour votre extension, voir : -<ul> - <li><a href="/fr/Add-ons/WebExtensions/Internationalization">Internationalization</a>: un guide d'utilisation du systĂšme WebExtension i18n.</li> - <li><a href="/fr/Add-ons/WebExtensions/API/i18n/Locale-Specific_Message_reference">RĂ©fĂ©rence de message spĂ©cifique aux paramĂštres rĂ©gionaux </a>: Les extensions fournissent des chaĂźnes de caractĂšres locales dans des fichiers appelĂ©s <code>messages.json</code>. Cette page dĂ©crit le format de <code>messages.json</code>.</li> -</ul> +- [Internationalization](/fr/Add-ons/WebExtensions/Internationalization): un guide d'utilisation du systĂšme WebExtension i18n. +- [RĂ©fĂ©rence de message spĂ©cifique aux paramĂštres rĂ©gionaux ](/fr/Add-ons/WebExtensions/API/i18n/Locale-Specific_Message_reference): Les extensions fournissent des chaĂźnes de caractĂšres locales dans des fichiers appelĂ©s `messages.json`. Cette page dĂ©crit le format de `messages.json`. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("i18n.LanguageCode")}}</dt> - <dd>Une <a href="https://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.10">balise de langue</a> telle que <code>"en-US"</code> ou "<code>fr</code>".</dd> -</dl> +- {{WebExtAPIRef("i18n.LanguageCode")}} + - : Une [balise de langue](https://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.10) telle que `"en-US"` ou "`fr`". -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("i18n.getAcceptLanguages()")}}</dt> - <dd>Obtient les <a href="/fr/docs/Web/HTTP/Content_negotiation#The_Accept-Language_header">accept-languages</a> du navigateur. Ceci est diffĂ©rent des paramĂštres rĂ©gionaux utilisĂ©s par le navigateur. Pour obtenir les paramĂštres rĂ©gionaux, utilisez {{WebExtAPIRef('i18n.getUILanguage')}}.</dd> - <dt>{{WebExtAPIRef("i18n.getMessage()")}}</dt> - <dd>Obtient la chaĂźne localisĂ©e pour le message spĂ©cifiĂ©.</dd> - <dt>{{WebExtAPIRef("i18n.getUILanguage()")}}</dt> - <dd>Obtient la langue de l'interface utilisateur du navigateur. Ceci est diffĂ©rent de {{WebExtAPIRef('i18n.getAcceptLanguages')}} qui renvoie les langues utilisateur prĂ©fĂ©rĂ©es.</dd> - <dt>{{WebExtAPIRef("i18n.detectLanguage()")}}</dt> - <dd>DĂ©tecte la langue du texte fourni en utilisant le <a href="https://github.com/CLD2Owners/cld2">dĂ©tecteur de langue compact</a>.</dd> -</dl> +- {{WebExtAPIRef("i18n.getAcceptLanguages()")}} + - : Obtient les [accept-languages](/fr/docs/Web/HTTP/Content_negotiation#The_Accept-Language_header) du navigateur. Ceci est diffĂ©rent des paramĂštres rĂ©gionaux utilisĂ©s par le navigateur. Pour obtenir les paramĂštres rĂ©gionaux, utilisez {{WebExtAPIRef('i18n.getUILanguage')}}. +- {{WebExtAPIRef("i18n.getMessage()")}} + - : Obtient la chaĂźne localisĂ©e pour le message spĂ©cifiĂ©. +- {{WebExtAPIRef("i18n.getUILanguage()")}} + - : Obtient la langue de l'interface utilisateur du navigateur. Ceci est diffĂ©rent de {{WebExtAPIRef('i18n.getAcceptLanguages')}} qui renvoie les langues utilisateur prĂ©fĂ©rĂ©es. +- {{WebExtAPIRef("i18n.detectLanguage()")}} + - : DĂ©tecte la langue du texte fourni en utilisant le [dĂ©tecteur de langue compact](https://github.com/CLD2Owners/cld2). -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> +## CompatibilitĂ© des navigateurs -<p>{{Compat("webextensions.api.i18n")}}</p> +{{Compat("webextensions.api.i18n")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"> -<p><strong>Note :</strong> - Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/i18n"><code>chrome.i18n</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.json"><code>i18n.json</code></a> dans le code de Chromium.<br> - <br> - 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.i18n`](https://developer.chrome.com/extensions/i18n). Cette documentation est dĂ©rivĂ©e de [`i18n.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/i18n/languagecode/index.md b/files/fr/mozilla/add-ons/webextensions/api/i18n/languagecode/index.md index 45f3e263a6..6bd77e2813 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/i18n/languagecode/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/languagecode/index.md @@ -14,29 +14,27 @@ tags: - i18n translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/LanguageCode --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Une <a href="https://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.10">balise de langue</a> telle que <code>"en-US"</code> ou "<code>fr</code>".</p> +Une [balise de langue](https://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.10) telle que `"en-US"` ou "`fr`". -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes.</p> +Les valeurs de ce type sont des chaĂźnes. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.i18n.LanguageCode")}}</p> +{{Compat("webextensions.api.i18n.LanguageCode")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.i18n`](https://developer.chrome.com/extensions/i18n). Cette documentation est dĂ©rivĂ©e de [`i18n.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.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/i18n"><code>chrome.i18n</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.json"><code>i18n.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 @@ -63,5 +61,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/LanguageCode // 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/i18n/locale-specific_message_reference/index.md b/files/fr/mozilla/add-ons/webextensions/api/i18n/locale-specific_message_reference/index.md index b6b48d94e3..27e5b4b439 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/i18n/locale-specific_message_reference/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/i18n/locale-specific_message_reference/index.md @@ -13,19 +13,18 @@ tags: - placeholders translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/Locale-Specific_Message_reference --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>Chaque extension internationalisĂ©e a au moins un fichier nommĂ© <code>messages.json</code> qui fournit des chaĂźnes spĂ©cifiques aux paramĂštres rĂ©gionaux. Cette page dĂ©crit le format des fichiers <code>messages.json</code>.</p> +Chaque extension internationalisĂ©e a au moins un fichier nommĂ© `messages.json` qui fournit des chaĂźnes spĂ©cifiques aux paramĂštres rĂ©gionaux. Cette page dĂ©crit le format des fichiers `messages.json`. -<div class="note"> -<p><strong>Note :</strong> Pour plus d'informations sur l'internationalisation de vos extensions, consultez notre guide <a href="/fr/Add-ons/WebExtensions/WebExtension_i18n">i18n</a>.</p> -</div> +> **Note :** Pour plus d'informations sur l'internationalisation de vos extensions, consultez notre guide [i18n](/fr/Add-ons/WebExtensions/WebExtension_i18n). -<h2 id="Exemple_messages.json">Exemple messages.json</h2> +## Exemple messages.json -<p>Le code suivant montre un exemple de fichier <code>messages.json file</code>, tirĂ© de notre extension <a href="https://github.com/mdn/webextensions-examples/tree/master/notify-link-clicks-i18n">d'exemple notify-link-clicks-i18n</a>. Seuls les champs "<em>name</em>" et "message" ont obligatoires.</p> +Le code suivant montre un exemple de fichier `messages.json file`, tirĂ© de notre extension [d'exemple notify-link-clicks-i18n](https://github.com/mdn/webextensions-examples/tree/master/notify-link-clicks-i18n). Seuls les champs "_name_" et "message" ont obligatoires. -<pre class="brush: json">{ +```json +{ "extensionName": { "message": "Notify link clicks i18n", "description": "Name of the extension." @@ -51,79 +50,76 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/i18n/Locale-Specific_Message_r } } } -}</pre> +} +``` -<h2 id="Placement">Placement</h2> +## Placement -<p>Vos fichiers <code>messages.json</code> doivent ĂȘtre placĂ©s dans des rĂ©pertoires nommĂ©s d'aprĂšs les paramĂštres rĂ©gionaux que chacun supporte â <code>en</code>, <code>de</code>, <code>ja</code>, etc. Ceux-ci doivent ĂȘtre placĂ©s dans un rĂ©pertoire appelĂ© <code>_locales</code>, Ă l'intĂ©rieur de la racine de votre extension.</p> +Vos fichiers `messages.json` doivent ĂȘtre placĂ©s dans des rĂ©pertoires nommĂ©s d'aprĂšs les paramĂštres rĂ©gionaux que chacun supporte â `en`, `de`, `ja`, etc. Ceux-ci doivent ĂȘtre placĂ©s dans un rĂ©pertoire appelĂ© `_locales`, Ă l'intĂ©rieur de la racine de votre extension. -<h2 id="DĂ©tails_des_membres">DĂ©tails des membres</h2> +## DĂ©tails des membres -<p>Cette section dĂ©crit chaque membre qui peut apparaĂźtre dans un fichier <code>messages.json</code>.</p> +Cette section dĂ©crit chaque membre qui peut apparaĂźtre dans un fichier `messages.json`. -<h3 id="name">name</h3> +### name -<p>Chaque membre de niveau supĂ©rieur est nommĂ© d'aprĂšs le nom de la chaĂźne de message que vous localisez, par exemple <code>"extensionName"</code> ou <code>"notificationContent"</code> dans l'exemple ci-dessus. Chaque nom est insensible Ă la casse et agit comme une clĂ© vous permettant de rĂ©cupĂ©rer le texte du message localisĂ©.</p> +Chaque membre de niveau supĂ©rieur est nommĂ© d'aprĂšs le nom de la chaĂźne de message que vous localisez, par exemple `"extensionName"` ou `"notificationContent"` dans l'exemple ci-dessus. Chaque nom est insensible Ă la casse et agit comme une clĂ© vous permettant de rĂ©cupĂ©rer le texte du message localisĂ©. -<p>Le nom peut inclure les caractĂšres suivants :</p> +Le nom peut inclure les caractĂšres suivants : -<ul> - <li>A-Z</li> - <li>a-z</li> - <li>0-9</li> - <li>_ (underscore)</li> - <li>@</li> -</ul> +- A-Z +- a-z +- 0-9 +- \_ (underscore) +- @ -<div class="note"><p><strong>Note :</strong> Vous ne devez pas dĂ©finir les noms commençant par @@. Ces noms sont rĂ©servĂ©s aux <a href="/fr/Add-ons/WebExtensions/Internationalization#Predefined_messages">messages prĂ©dĂ©finis</a>.</p></div> +> **Note :** Vous ne devez pas dĂ©finir les noms commençant par @@. Ces noms sont rĂ©servĂ©s aux [messages prĂ©dĂ©finis](/fr/Add-ons/WebExtensions/Internationalization#Predefined_messages). -<h3 id="message">message</h3> +### message -<p>Au moins, cette propriĂ©tĂ© doit ĂȘtre dĂ©finie pour chaque chaĂźne. Le membre <code>"message"</code> contient une chaĂźne localisĂ©e qui peut contenir {{anch("placeholders")}}. Vous pouvez utiliser :</p> +Au moins, cette propriĂ©tĂ© doit ĂȘtre dĂ©finie pour chaque chaĂźne. Le membre `"message"` contient une chaĂźne localisĂ©e qui peut contenir {{anch("placeholders")}}. Vous pouvez utiliser : -<ul> - <li><em>$placeholder_name$</em> (case insensitive) pour insĂ©rer un espace rĂ©servĂ© particulier (par exemple $URL$ dans l'exemple ci-dessus) dans votre chaĂźne.</li> - <li><code>$1</code>, <code>$2</code>,<code> $3</code>, etc. pour insĂ©rer directement les valeurs obtenues Ă partir d'un {{WebExtAPIRef("i18n.getMessage()")}} appel dans votre chaĂźne.</li> -</ul> +- _$placeholder_name$_ (case insensitive) pour insĂ©rer un espace rĂ©servĂ© particulier (par exemple $URL$ dans l'exemple ci-dessus) dans votre chaĂźne. +- `$1`, `$2`,` $3`, etc. pour insĂ©rer directement les valeurs obtenues Ă partir d'un {{WebExtAPIRef("i18n.getMessage()")}} appel dans votre chaĂźne. -<p>Autres points Ă noter :</p> +Autres points Ă noter : -<ul> - <li>Tout nombre de signes dollar consĂ©cutifs apparaissant dans les chaĂźnes est remplacĂ© par le mĂȘme nombre de signes dollar moins un. donc, $$ > $, $$$ > $$, etc.</li> - <li>Lorsque le fichier de paramĂštres rĂ©gionaux est lu, les jetons correspondant Ă Â <code>/\$([a-z0-9_@]+)\$/i</code> sont remplacĂ©s par la valeur correspondante de l'objet "placeholders" de la chaĂźne. Ces substitutions se produisent avant le traitement des <code>/\$\d/</code> jetons dans le message.</li> - <li>Lorsqu'une chaĂźne locale est utilisĂ©e, les jetons correspondant Ă <code>/\$\d+/</code> sont remplacĂ©s par les remplacements passĂ©s Ă {{WebExtAPIRef("i18n.getMessage()")}}.</li> - <li><code>getMessage()</code> ne traitera pas les appels avec plus de 9 placeholders/substitutions.</li> -</ul> +- Tout nombre de signes dollar consĂ©cutifs apparaissant dans les chaĂźnes est remplacĂ© par le mĂȘme nombre de signes dollar moins un. donc, $$ > $, $$$ > $$, etc. +- Lorsque le fichier de paramĂštres rĂ©gionaux est lu, les jetons correspondant Ă Â `/\$([a-z0-9_@]+)\$/i` sont remplacĂ©s par la valeur correspondante de l'objet "placeholders" de la chaĂźne. Ces substitutions se produisent avant le traitement des `/\$\d/` jetons dans le message. +- Lorsqu'une chaĂźne locale est utilisĂ©e, les jetons correspondant Ă `/\$\d+/` sont remplacĂ©s par les remplacements passĂ©s Ă {{WebExtAPIRef("i18n.getMessage()")}}. +- `getMessage()` ne traitera pas les appels avec plus de 9 placeholders/substitutions. -<h3 id="description">description</h3> +### description -<p>{{optional_inline}}</p> +{{optional_inline}} -<p>Le membre <code>"description"</code> doit contenir une description du contenu de la chaĂźne de message, destinĂ©e Ă fournir un traducteur pour aider Ă crĂ©er la meilleure traduction possible de la chaĂźne.</p> +Le membre `"description"` doit contenir une description du contenu de la chaĂźne de message, destinĂ©e Ă fournir un traducteur pour aider Ă crĂ©er la meilleure traduction possible de la chaĂźne. -<h3 id="placeholders">placeholders</h3> +### placeholders -<p>{{optional_inline}}</p> +{{optional_inline}} -<p>Le membre <code>"placeholders"</code> dĂ©finit une ou plusieurs sous-chaĂźnes Ă utiliser dans le message â celles-ci peuvent ĂȘtre utilisĂ©es pour coder en dur les Ă©lĂ©ments que vous ne voulez pas traduire, ou vous rĂ©fĂ©rer Ă des variables.</p> +Le membre `"placeholders"` dĂ©finit une ou plusieurs sous-chaĂźnes Ă utiliser dans le message â celles-ci peuvent ĂȘtre utilisĂ©es pour coder en dur les Ă©lĂ©ments que vous ne voulez pas traduire, ou vous rĂ©fĂ©rer Ă des variables. -<p>Chaque dĂ©finition de sous-chaĂźne d'espace rĂ©servĂ© possĂšde un certain nombre de valeurs :</p> +Chaque dĂ©finition de sous-chaĂźne d'espace rĂ©servĂ© possĂšde un certain nombre de valeurs : -<pre class="brush: json">"url" : { +```json +"url" : { "content" : "$1", "example" : "https://developer.mozilla.org" -}</pre> +} +``` -<h4 id="Nom_placeholder">Nom placeholder</h4> +#### Nom placeholder -<p>Le nom de l'espace rĂ©servĂ© est utilisĂ© pour reprĂ©senter l'espace rĂ©servĂ© dans la chaĂźne de substitution (par exemple <code>"url"</code> devient <code>$url$</code>). Il est insensible Ă la casse et peut contenir les mĂȘmes caractĂšres qu'une chaĂźne de message {{anch("name")}}.</p> +Le nom de l'espace rĂ©servĂ© est utilisĂ© pour reprĂ©senter l'espace rĂ©servĂ© dans la chaĂźne de substitution (par exemple `"url"` devient `$url$`). Il est insensible Ă la casse et peut contenir les mĂȘmes caractĂšres qu'une chaĂźne de message {{anch("name")}}. -<h4 id="contenu">contenu</h4> +#### contenu -<p>L'Ă©lĂ©ment "contenu" dĂ©finit le contenu de l'espace rĂ©servĂ©. Cela peut ĂȘtre une chaĂźne codĂ©e en dur, telle que "My placeholder", mais elle peut Ă©galement inclure des valeurs obtenues Ă partir d'un appel {{WebExtAPIRef("i18n.getMessage()")}}. Cette propriĂ©tĂ© est obligatoire Pour plus d'informations, voir <a href="/fr/Add-ons/WebExtensions/Internationalization#Retrieving_message_strings_from_JavaScript">RĂ©cupĂ©ration des chaĂźnes de messages Ă partir de Javascript</a>.</p> +L'Ă©lĂ©ment "contenu" dĂ©finit le contenu de l'espace rĂ©servĂ©. Cela peut ĂȘtre une chaĂźne codĂ©e en dur, telle que "My placeholder", mais elle peut Ă©galement inclure des valeurs obtenues Ă partir d'un appel {{WebExtAPIRef("i18n.getMessage()")}}. Cette propriĂ©tĂ© est obligatoire Pour plus d'informations, voir [RĂ©cupĂ©ration des chaĂźnes de messages Ă partir de Javascript](/fr/Add-ons/WebExtensions/Internationalization#Retrieving_message_strings_from_JavaScript). -<h4 id="exemple">exemple</h4> +#### exemple -<p>{{optional_inline}}</p> +{{optional_inline}} -<p>L'Ă©lĂ©ment optionnel "exemple" est lĂ encore destinĂ© Ă aider les traducteurs en leur montrant un exemple de la façon dont l'espace rĂ©servĂ© apparaĂźtrait aux utilisateurs finaux, leur permettant de faire le meilleur choix lors de la localisation du fichier.</p> +L'Ă©lĂ©ment optionnel "exemple" est lĂ encore destinĂ© Ă aider les traducteurs en leur montrant un exemple de la façon dont l'espace rĂ©servĂ© apparaĂźtrait aux utilisateurs finaux, leur permettant de faire le meilleur choix lors de la localisation du fichier. diff --git a/files/fr/mozilla/add-ons/webextensions/api/identity/getredirecturl/index.md b/files/fr/mozilla/add-ons/webextensions/api/identity/getredirecturl/index.md index 6bf56f1975..f28bfeca7f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/identity/getredirecturl/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/identity/getredirecturl/index.md @@ -12,42 +12,44 @@ tags: - getRedirectURL translation_of: Mozilla/Add-ons/WebExtensions/API/identity/getRedirectURL --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>GĂ©nĂšre une URL que vous pouvez utiliser comme URL de redirection.</p> +GĂ©nĂšre une URL que vous pouvez utiliser comme URL de redirection. -<p>L'URL est dĂ©rivĂ©e de l'ID de votre extension. Si vous utilisez cette fonction, vous devrez probablement dĂ©finir explicitement l'ID de votre extension Ă l'aide de la clĂ© des <code><a href="/fr/Add-ons/WebExtensions/manifest.json/applications">applications</a></code> (sinon, chaque fois que vous installerez <a href="/fr/Add-ons/WebExtensions/Temporary_Installation_in_Firefox">temporairement l'extension</a>, vous obtiendrez une URL de redirection diffĂ©rente).</p> +L'URL est dĂ©rivĂ©e de l'ID de votre extension. Si vous utilisez cette fonction, vous devrez probablement dĂ©finir explicitement l'ID de votre extension Ă l'aide de la clĂ© des [`applications`](/fr/Add-ons/WebExtensions/manifest.json/applications) (sinon, chaque fois que vous installerez [temporairement l'extension](/fr/Add-ons/WebExtensions/Temporary_Installation_in_Firefox), vous obtiendrez une URL de redirection diffĂ©rente). -<p>Voir <a href="/fr/Add-ons/WebExtensions/API/identity#Getting_the_redirect_URL">Obtenir une URL de redirection</a> pour plus d'informations sur les URL de redirection.</p> +Voir [Obtenir une URL de redirection](/fr/Add-ons/WebExtensions/API/identity#Getting_the_redirect_URL) pour plus d'informations sur les URL de redirection. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var redirectURL = browser.identity.getRedirectURL() -</pre> +```js +var redirectURL = browser.identity.getRedirectURL() +``` -<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 chaĂźne contenant une valeur d'URL de redirection.</p> +Une chaĂźne contenant une valeur d'URL de redirection. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.identity.getRedirectURL")}}</p> +{{Compat("webextensions.api.identity.getRedirectURL")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Obtenez l'URL de redirection :</p> +Obtenez l'URL de redirection : -<pre class="brush: js">var redirectURL = browser.identity.getRedirectURL();</pre> +```js +var redirectURL = browser.identity.getRedirectURL(); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/identity"><code>chrome.identity</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.identity`](https://developer.chrome.com/extensions/identity). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/identity/index.md b/files/fr/mozilla/add-ons/webextensions/api/identity/index.md index f681457d83..50004009a9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/identity/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/identity/index.md @@ -10,72 +10,64 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/identity --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Utilisez l'API d'identitĂ© pour obtenir un code d'autorisation ou un jeton d'accĂšs <a href="https://oauth.net/2/">OAuth2</a>, qu'une extension peut ensuite utiliser pour accĂ©der aux donnĂ©es utilisateur d'un service prenant en charge l'accĂšs Ă OAuth2 (tel qu'un compte Google ou Facebook).</p> +Utilisez l'API d'identitĂ© pour obtenir un code d'autorisation ou un jeton d'accĂšs [OAuth2](https://oauth.net/2/), qu'une extension peut ensuite utiliser pour accĂ©der aux donnĂ©es utilisateur d'un service prenant en charge l'accĂšs Ă OAuth2 (tel qu'un compte Google ou Facebook). -<p>Les dĂ©tails du fonctionnement du flux OAuth2 diffĂšrent d'un fournisseur de services Ă l'autre. Pour utiliser cette API avec un fournisseur de services particulier, vous devez consulter leur documentation. Par exemple :</p> +Les dĂ©tails du fonctionnement du flux OAuth2 diffĂšrent d'un fournisseur de services Ă l'autre. Pour utiliser cette API avec un fournisseur de services particulier, vous devez consulter leur documentation. Par exemple : -<ul> - <li><a href="https://developers.google.com/identity/protocols/OAuth2UserAgent">https://developers.google.com/identity/protocols/OAuth2UserAgent</a></li> - <li><a href="https://developer.github.com/v3/oauth/">https://developer.github.com/v3/oauth/</a></li> -</ul> +- <https://developers.google.com/identity/protocols/OAuth2UserAgent> +- <https://developer.github.com/v3/oauth/> -<p>L'API d'identitĂ© fournit la fonction {{WebExtAPIRef("identity.launchWebAuthFlow()")}}. Cela authentifie l'utilisateur avec le service, si nĂ©cessaire, et demande Ă l'utilisateur d'autoriser l'extension Ă accĂ©der aux donnĂ©es, si nĂ©cessaire. La fonction se termine par un jeton d'accĂšs ou un code d'autorisation, selon le fournisseur.</p> +L'API d'identitĂ© fournit la fonction {{WebExtAPIRef("identity.launchWebAuthFlow()")}}. Cela authentifie l'utilisateur avec le service, si nĂ©cessaire, et demande Ă l'utilisateur d'autoriser l'extension Ă accĂ©der aux donnĂ©es, si nĂ©cessaire. La fonction se termine par un jeton d'accĂšs ou un code d'autorisation, selon le fournisseur. -<p>L'extension termine alors le flux OAuth2 pour obtenir un jeton d'accĂšs validĂ©, et peut ensuite l'utiliser dans les requĂȘtes HTTP pour accĂ©der aux donnĂ©es de l'utilisateur en fonction de l'autorisation donnĂ©e par l'utilisateur.</p> +L'extension termine alors le flux OAuth2 pour obtenir un jeton d'accĂšs validĂ©, et peut ensuite l'utiliser dans les requĂȘtes HTTP pour accĂ©der aux donnĂ©es de l'utilisateur en fonction de l'autorisation donnĂ©e par l'utilisateur. -<p>Pour utiliser cette API, vous devez possĂ©der la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission de l'API </a>"identity"</p> +Pour utiliser cette API, vous devez possĂ©der la [permission de l'API ](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions)"identity" -<h2 id="Installer">Installer</h2> +## Installer -<p>Il y a une certaine configuration que vous devez faire avant de publier votre extension.</p> +Il y a une certaine configuration que vous devez faire avant de publier votre extension. -<h3 id="Obtenir_l'URL_de_redirection">Obtenir l'URL de redirection</h3> +### Obtenir l'URL de redirection -<p>L'<a href="https://www.oauth.com/oauth2-servers/redirect-uris/">URL de redirection</a> reprĂ©sente le point final de {{WebExtAPIRef("identity.launchWebAuthFlow()")}}, dans lequel le jeton d'accĂšs ou le code d'autorisation est remis Ă l'extension..</p> +L'[URL de redirection](https://www.oauth.com/oauth2-servers/redirect-uris/) reprĂ©sente le point final de {{WebExtAPIRef("identity.launchWebAuthFlow()")}}, dans lequel le jeton d'accĂšs ou le code d'autorisation est remis Ă l'extension.. -<p>Vous pouvez obtenir une URL de redirection en appelant {{WebExtAPIRef("identity.getRedirectURL()")}}. Cette fonction dĂ©rive une URL de redirection Ă partir de l'ID du module, donc si vous voulez l'utiliser, vous devez probablement dĂ©finir explicitement l'ID de votre module en utilisant la clĂ© des <code><a href="/fr/Add-ons/WebExtensions/manifest.json/applications">applications</a></code> (sinon, chaque fois que vous <a href="/fr/Add-ons/WebExtensions/Temporary_Installation_in_Firefox">installez temporairement le module complĂ©mentaire</a>, vous obtiendrez une URL de redirection diffĂ©rente).</p> +Vous pouvez obtenir une URL de redirection en appelant {{WebExtAPIRef("identity.getRedirectURL()")}}. Cette fonction dĂ©rive une URL de redirection Ă partir de l'ID du module, donc si vous voulez l'utiliser, vous devez probablement dĂ©finir explicitement l'ID de votre module en utilisant la clĂ© des [`applications`](/fr/Add-ons/WebExtensions/manifest.json/applications) (sinon, chaque fois que vous [installez temporairement le module complĂ©mentaire](/fr/Add-ons/WebExtensions/Temporary_Installation_in_Firefox), vous obtiendrez une URL de redirection diffĂ©rente). -<p>Vous n'avez pas besoin d'utiliser l'URL de redirection retournĂ©e par <code>identity.getRedirectURL()</code>: vous pouvez fournir la vĂŽtre, et cela peut ĂȘtre tout ce que le service redirigera. Cependant, il devrait utiliser un domaine que vous contrĂŽlez.</p> +Vous n'avez pas besoin d'utiliser l'URL de redirection retournĂ©e par `identity.getRedirectURL()`: vous pouvez fournir la vĂŽtre, et cela peut ĂȘtre tout ce que le service redirigera. Cependant, il devrait utiliser un domaine que vous contrĂŽlez. -<p>Vous utiliserez l'URL de redirection Ă deux endroits :</p> +Vous utiliserez l'URL de redirection Ă deux endroits : -<ul> - <li>Fournissez-le lors de l'enregistrement de votre extension en tant que client OAuth2</li> - <li>Transmettez-le dans <code>identity.launchWebAuthFlow()</code>, en tant que paramĂštre d'URL ajoutĂ© Ă l'argument <code>url</code> de cette fonction.</li> -</ul> +- Fournissez-le lors de l'enregistrement de votre extension en tant que client OAuth2 +- Transmettez-le dans `identity.launchWebAuthFlow()`, en tant que paramĂštre d'URL ajoutĂ© Ă l'argument `url` de cette fonction. -<h3 id="Enregistrement_de_votre_extension">Enregistrement de votre extension</h3> +### Enregistrement de votre extension -<p>Avant de pouvoir utiliser OAuth2 avec un fournisseur de services, vous devez enregistrer l'extension auprĂšs du fournisseur en tant que client OAuth2.</p> +Avant de pouvoir utiliser OAuth2 avec un fournisseur de services, vous devez enregistrer l'extension auprĂšs du fournisseur en tant que client OAuth2. -<p>Cela aura tendance Ă ĂȘtre spĂ©cifique au fournisseur de services, mais en gĂ©nĂ©ral cela signifie crĂ©er une entrĂ©e pour votre extension sur le site Web du fournisseur. Dans ce processus, vous fournirez votre URL de redirection, et recevrez un identifiant de client (et parfois aussi un secret). Vous devrez passer les deux dans {{WebExtAPIRef("identity.launchWebAuthFlow()")}}.</p> +Cela aura tendance Ă ĂȘtre spĂ©cifique au fournisseur de services, mais en gĂ©nĂ©ral cela signifie crĂ©er une entrĂ©e pour votre extension sur le site Web du fournisseur. Dans ce processus, vous fournirez votre URL de redirection, et recevrez un identifiant de client (et parfois aussi un secret). Vous devrez passer les deux dans {{WebExtAPIRef("identity.launchWebAuthFlow()")}}. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("identity.getRedirectURL()")}}</dt> - <dd>Obtient l'URL de redirection.</dd> - <dt>{{WebExtAPIRef("identity.launchWebAuthFlow()")}}</dt> - <dd>Lancement WAF.</dd> -</dl> +- {{WebExtAPIRef("identity.getRedirectURL()")}} + - : Obtient l'URL de redirection. +- {{WebExtAPIRef("identity.launchWebAuthFlow()")}} + - : Lancement WAF. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.identity")}}</p> +{{Compat("webextensions.api.identity")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.identity`](https://developer.chrome.com/extensions/identity). +> +> 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/identity"><code>chrome.identity</code></a>.</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 @@ -102,5 +94,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/identity // 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/identity/launchwebauthflow/index.md b/files/fr/mozilla/add-ons/webextensions/api/identity/launchwebauthflow/index.md index ba6efa8b65..dc729041af 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/identity/launchwebauthflow/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/identity/launchwebauthflow/index.md @@ -12,82 +12,74 @@ tags: - launchWebAuthFlow translation_of: Mozilla/Add-ons/WebExtensions/API/identity/launchWebAuthFlow --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Effectue la premiĂšre partie d'un flux <a href="https://oauth.net/2/">OAuth2</a> y compris l'authentification de l'utilisateur et l'autorisation du client.</p> +Effectue la premiĂšre partie d'un flux [OAuth2](https://oauth.net/2/) y compris l'authentification de l'utilisateur et l'autorisation du client. -<p>Le seul paramĂštre obligatoire de cette fonction est l'URL d'autorisation du fournisseur de services, qui doit contenir un certain nombre de paramĂštres d'URL, y compris l'<a href="/fr/Add-ons/WebExtensions/API/identity#Getting_the_redirect_URL">URL de redirection</a> et l'<a href="/fr/Add-ons/WebExtensions/API/identity#Registering_your_add-on">ID client</a> de l'extension. Le fournisseur de service alors :</p> +Le seul paramĂštre obligatoire de cette fonction est l'URL d'autorisation du fournisseur de services, qui doit contenir un certain nombre de paramĂštres d'URL, y compris l'[URL de redirection](/fr/Add-ons/WebExtensions/API/identity#Getting_the_redirect_URL) et l'[ID client](/fr/Add-ons/WebExtensions/API/identity#Registering_your_add-on) de l'extension. Le fournisseur de service alors : -<ul> - <li>authentifie l'utilisateur auprĂšs du fournisseur de services, si nĂ©cessaire (c'est-Ă -dire: s'ils ne sont pas dĂ©jĂ connectĂ©s)</li> - <li>demande Ă l'utilisateur d'autoriser l'extension Ă accĂ©der aux donnĂ©es demandĂ©es, si nĂ©cessaire (c'est-Ă -dire : si l'utilisateur n'a pas dĂ©jĂ autorisĂ© l'extension)</li> -</ul> +- authentifie l'utilisateur auprĂšs du fournisseur de services, si nĂ©cessaire (c'est-Ă -dire: s'ils ne sont pas dĂ©jĂ connectĂ©s) +- demande Ă l'utilisateur d'autoriser l'extension Ă accĂ©der aux donnĂ©es demandĂ©es, si nĂ©cessaire (c'est-Ă -dire : si l'utilisateur n'a pas dĂ©jĂ autorisĂ© l'extension) -<p>Notez que si aucune authentification ou autorisation n'est nĂ©cessaire, cette fonction se terminera silencieusement, sans interaction de l'utilisateur.</p> +Notez que si aucune authentification ou autorisation n'est nĂ©cessaire, cette fonction se terminera silencieusement, sans interaction de l'utilisateur. -<p>Cette fonction prend Ă©galement un paramĂštre facultatif <code>interactif</code>: si cette valeur est omise ou dĂ©finie sur false, le flux est forcĂ© de se terminer en mode silencieux. Dans ce cas, si l'utilisateur doit s'authentifier ou autoriser, l'opĂ©ration Ă©chouera tout simplement.</p> +Cette fonction prend Ă©galement un paramĂštre facultatif `interactif`: si cette valeur est omise ou dĂ©finie sur false, le flux est forcĂ© de se terminer en mode silencieux. Dans ce cas, si l'utilisateur doit s'authentifier ou autoriser, l'opĂ©ration Ă©chouera tout simplement. -<p>Cette fonction renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>: si l'authentification et l'autorisation ont abouti, la promesse est remplie avec une URL de redirection contenant un certain nombre de paramĂštres d'URL. En fonction du flux OAuth2 implĂ©mentĂ© par le fournisseur de services en question, l'extension devra passer par d'autres Ă©tapes pour obtenir un code d'accĂšs valide, qu'elle pourra ensuite utiliser pour accĂ©der aux donnĂ©es de l'utilisateur.</p> +Cette fonction renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise): si l'authentification et l'autorisation ont abouti, la promesse est remplie avec une URL de redirection contenant un certain nombre de paramĂštres d'URL. En fonction du flux OAuth2 implĂ©mentĂ© par le fournisseur de services en question, l'extension devra passer par d'autres Ă©tapes pour obtenir un code d'accĂšs valide, qu'elle pourra ensuite utiliser pour accĂ©der aux donnĂ©es de l'utilisateur. -<p>S'il y a une erreur, la promesse est rejetĂ©e avec un message d'erreur. Les conditions d'erreur peuvent inclure :</p> +S'il y a une erreur, la promesse est rejetĂ©e avec un message d'erreur. Les conditions d'erreur peuvent inclure : -<ul> - <li>l'URL du fournisseur de services n'a pas pu ĂȘtre atteinte</li> - <li>l'ID du client ne correspond pas Ă l'ID d'un client enregistrĂ©</li> - <li>l'URL de redirection ne correspond Ă aucune URL de redirection enregistrĂ©e pour ce client</li> - <li>l'utilisateur ne s'est pas authentifiĂ© avec succĂšs</li> - <li>l'utilisateur n'a pas autorisĂ© l'extension</li> - <li>Le paramĂštre <code>interactif</code> a Ă©tĂ© omis ou faux, mais l'interaction de l'utilisateur aurait Ă©tĂ© nĂ©cessaire pour autoriser l'extension.</li> -</ul> +- l'URL du fournisseur de services n'a pas pu ĂȘtre atteinte +- l'ID du client ne correspond pas Ă l'ID d'un client enregistrĂ© +- l'URL de redirection ne correspond Ă aucune URL de redirection enregistrĂ©e pour ce client +- l'utilisateur ne s'est pas authentifiĂ© avec succĂšs +- l'utilisateur n'a pas autorisĂ© l'extension +- Le paramĂštre `interactif` a Ă©tĂ© omis ou faux, mais l'interaction de l'utilisateur aurait Ă©tĂ© nĂ©cessaire pour autoriser l'extension. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var authorizing = browser.identity.launchWebAuthFlow( +```js +var authorizing = browser.identity.launchWebAuthFlow( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Options pour le flux, contenant les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>url</code></dt> - <dd> - <p><code>string</code>. URL fournie par le fournisseur de services OAuth2 pour obtenir un jeton d'accĂšs. Les dĂ©tails de cette URL doivent figurer dans la documentation du fournisseur de services en question, mais les paramĂštres d'URL doivent toujours inclure :</p> +- `details` - <ul> - <li>redirect_uri: ceci reprĂ©sente l'URI que votre extension est redirigĂ©e lorsque le flux est terminĂ©. Il n'est pas nĂ©cessaire pour que le flux fonctionne du cĂŽtĂ© navigateur s'il correspond Ă l'URL de redirection gĂ©nĂ©rĂ©e. Voir <a href="/fr/Add-ons/WebExtensions/API/identity#Getting_the_redirect_URL">Obtenir l'URL de redirection</a>.</li> - </ul> - </dd> - <dt><code>interactive</code> {{optional_inline}}</dt> - <dd> - <p><code>boolean</code>. Si omis ou <code>false</code>, force le flux Ă se terminer en silence, sans interaction de l'utilisateur.</p> + - : `object`. Options pour le flux, contenant les propriĂ©tĂ©s suivantes : - <p>Si l'utilisateur est dĂ©jĂ connectĂ© et a dĂ©jĂ accordĂ© l'accĂšs pour l'extension, <code>launchWebAuthFlow()</code> peut se terminer en mode silencieux, sans interaction de l'utilisateur. Sinon (si le fournisseur de services a besoin que l'utilisateur se connecte ou autorise l'extension), <code>launchWebAuthFlow()</code> invite l'utilisateur, c'est-Ă -dire que le flux sera interactif.</p> + - `url` - <p>Les extensions ne doivent pas lancer de flux interactifs sauf en rĂ©ponse Ă une action de l'utilisateur. Cependant, parfois les extensions veulent toujours accĂ©der aux donnĂ©es de l'utilisateur sans une action directe de l'utilisateur (par exemple, imaginez une extension qui veut accĂ©der aux donnĂ©es lorsque le navigateur se lance).</p> + - : `string`. URL fournie par le fournisseur de services OAuth2 pour obtenir un jeton d'accĂšs. Les dĂ©tails de cette URL doivent figurer dans la documentation du fournisseur de services en question, mais les paramĂštres d'URL doivent toujours inclure : - <p>TC'est le but de l'<code>interactif</code>: Si vous omettez <code>interactif</code> ou le dĂ©finissez sur <code>false</code>, le flux est forcĂ© de conclure en silence : si le fournisseur de services doit interagir avec l'utilisateur, le flux Ă©chouera tout simplement. Donc en rĂšgle gĂ©nĂ©rale: mettez <code>interactif</code> Ă <code>true</code> si vous lancez le flux en rĂ©ponse Ă une action de l'utilisateur, et omettez le sinon.</p> - </dd> - </dl> - </dd> -</dl> + - redirect_uri: ceci reprĂ©sente l'URI que votre extension est redirigĂ©e lorsque le flux est terminĂ©. Il n'est pas nĂ©cessaire pour que le flux fonctionne du cĂŽtĂ© navigateur s'il correspond Ă l'URL de redirection gĂ©nĂ©rĂ©e. Voir [Obtenir l'URL de redirection](/fr/Add-ons/WebExtensions/API/identity#Getting_the_redirect_URL). -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - `interactive` {{optional_inline}} -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>. Si l'extension est autorisĂ©e avec succĂšs, elle sera remplie avec une chaĂźne contenant l'URL de redirection. L'URL inclura un paramĂštre qui est un jeton d'accĂšs ou qui peut ĂȘtre Ă©changĂ© contre un jeton d'accĂšs, en utilisant le flux documentĂ© pour le fournisseur de services particulier. </p> + - : `boolean`. Si omis ou `false`, force le flux Ă se terminer en silence, sans interaction de l'utilisateur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + Si l'utilisateur est dĂ©jĂ connectĂ© et a dĂ©jĂ accordĂ© l'accĂšs pour l'extension, `launchWebAuthFlow()` peut se terminer en mode silencieux, sans interaction de l'utilisateur. Sinon (si le fournisseur de services a besoin que l'utilisateur se connecte ou autorise l'extension), `launchWebAuthFlow()` invite l'utilisateur, c'est-Ă -dire que le flux sera interactif. -<p>{{Compat("webextensions.api.identity.launchWebAuthFlow")}}</p> + Les extensions ne doivent pas lancer de flux interactifs sauf en rĂ©ponse Ă une action de l'utilisateur. Cependant, parfois les extensions veulent toujours accĂ©der aux donnĂ©es de l'utilisateur sans une action directe de l'utilisateur (par exemple, imaginez une extension qui veut accĂ©der aux donnĂ©es lorsque le navigateur se lance). -<h2 id="Exemples">Exemples</h2> + TC'est le but de l'`interactif`: Si vous omettez `interactif` ou le dĂ©finissez sur `false`, le flux est forcĂ© de conclure en silence : si le fournisseur de services doit interagir avec l'utilisateur, le flux Ă©chouera tout simplement. Donc en rĂšgle gĂ©nĂ©rale: mettez `interactif` Ă `true` si vous lancez le flux en rĂ©ponse Ă une action de l'utilisateur, et omettez le sinon. -<p>Cette fonction autorise une extension des donnĂ©es Google d'un utilisateur, conformĂ©ment Ă la documentation disponible Ă l'adresse <a href="https://developers.google.com/identity/protocols/OAuth2UserAgent">https://developers.google.com/identity/protocols/OAuth2UserAgent</a>. La validation du jeton d'accĂšs renvoyĂ© n'est pas affichĂ©e ici :</p> +### Valeur retournĂ©e -<pre class="brush: js">function validate(redirectURL) { +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si l'extension est autorisĂ©e avec succĂšs, elle sera remplie avec une chaĂźne contenant l'URL de redirection. L'URL inclura un paramĂštre qui est un jeton d'accĂšs ou qui peut ĂȘtre Ă©changĂ© contre un jeton d'accĂšs, en utilisant le flux documentĂ© pour le fournisseur de services particulier. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.identity.launchWebAuthFlow")}} + +## Exemples + +Cette fonction autorise une extension des donnĂ©es Google d'un utilisateur, conformĂ©ment Ă la documentation disponible Ă l'adresse <https://developers.google.com/identity/protocols/OAuth2UserAgent>. La validation du jeton d'accĂšs renvoyĂ© n'est pas affichĂ©e ici : + +```js +function validate(redirectURL) { // validate the access token } @@ -97,9 +89,9 @@ function authorize() { const scopes = ["openid", "email", "profile"]; let authURL = "https://accounts.google.com/o/oauth2/auth"; authURL += `?client_id=${clientID}`; - authURL += `&response_type=token`; - authURL += `&redirect_uri=${encodeURIComponent(redirectURL)}`; - authURL += `&scope=${encodeURIComponent(scopes.join(' '))}`; + authURL += `&response_type=token`; + authURL += `&redirect_uri=${encodeURIComponent(redirectURL)}`; + authURL += `&scope=${encodeURIComponent(scopes.join(' '))}`; return browser.identity.launchWebAuthFlow({ interactive: true, @@ -109,13 +101,13 @@ function authorize() { function getAccessToken() { return authorize().then(validate); -}</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/identity"><code>chrome.identity</code></a>.</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.identity`](https://developer.chrome.com/extensions/identity). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/idle/idlestate/index.md b/files/fr/mozilla/add-ons/webextensions/api/idle/idlestate/index.md index 9d9169a73f..f9bbe57728 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/idle/idlestate/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/idle/idlestate/index.md @@ -13,29 +13,27 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/idle/IdleState --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>ChaĂźne d'Ă©crivant l'Ă©tat d'inactivitĂ© du pĂ©riphĂ©rique.</p> +ChaĂźne d'Ă©crivant l'Ă©tat d'inactivitĂ© du pĂ©riphĂ©rique. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : <code>"active"</code>, <code>"idle"</code>, <code>"locked"</code>.</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : `"active"`, `"idle"`, `"locked"`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.idle.IdleState")}}</p> +{{Compat("webextensions.api.idle.IdleState")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.idle`](https://developer.chrome.com/extensions/idle). Cette documentation est dĂ©rivĂ©e de [`idle.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/idle.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/idle"><code>chrome.idle</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/idle.json"><code>idle.json</code></a> dans le code Chromium.</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 @@ -62,5 +60,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/idle/IdleState // 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/idle/index.md b/files/fr/mozilla/add-ons/webextensions/api/idle/index.md index 6de0d110c6..4417617bd0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/idle/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/idle/index.md @@ -12,52 +12,42 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/idle --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>DĂ©couvrez quand le systĂšme de l'utilisateur est inactif, vĂ©rouillĂ© ou actif.</p> +DĂ©couvrez quand le systĂšme de l'utilisateur est inactif, vĂ©rouillĂ© ou actif. -<p>Pour utiliser cette API, vous disposez de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "idle" .</p> +Pour utiliser cette API, vous disposez de la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "idle" . -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("idle.IdleState")}}</dt> - <dd> - <p>ChaĂźne dĂ©crivant l'Ă©tat d'inactivitĂ© du pĂ©riphĂ©rique</p> - </dd> -</dl> +- {{WebExtAPIRef("idle.IdleState")}} + - : ChaĂźne dĂ©crivant l'Ă©tat d'inactivitĂ© du pĂ©riphĂ©rique -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("idle.queryState()")}}</dt> - <dd>Renvoie <code>"locked"</code> si le systĂšme est verrouillĂ©, <code>"idle"</code> si l'utilisateur n'a gĂ©nĂ©rĂ© aucune entrĂ©e pendant un nombre de secondes spĂ©cifiĂ©, ou sinon <code>"active"</code></dd> - <dt>{{WebExtAPIRef("idle.setDetectionInterval()")}}</dt> - <dd>DĂ©finit l'intervalle utilisĂ© pour dĂ©terminer quand le systĂšme est inactif pour les Ă©vĂ©nements {{WebExtAPIRef("idle.onStateChanged")}}.</dd> -</dl> +- {{WebExtAPIRef("idle.queryState()")}} + - : Renvoie `"locked"` si le systĂšme est verrouillĂ©, `"idle"` si l'utilisateur n'a gĂ©nĂ©rĂ© aucune entrĂ©e pendant un nombre de secondes spĂ©cifiĂ©, ou sinon `"active"` +- {{WebExtAPIRef("idle.setDetectionInterval()")}} + - : DĂ©finit l'intervalle utilisĂ© pour dĂ©terminer quand le systĂšme est inactif pour les Ă©vĂ©nements {{WebExtAPIRef("idle.onStateChanged")}}. -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt>{{WebExtAPIRef("idle.onStateChanged")}}</dt> - <dd>DĂ©finit quand le systĂšme change d'Ă©tat.</dd> -</dl> +- {{WebExtAPIRef("idle.onStateChanged")}} + - : DĂ©finit quand le systĂšme change d'Ă©tat. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.idle")}}</p> +{{Compat("webextensions.api.idle")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.idle`](https://developer.chrome.com/extensions/idle). Cette documentation est dĂ©rivĂ©e de [`idle.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/idle.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/idle"><code>chrome.idle</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/idle.json"><code>idle.json</code></a> dans le code Chromium.</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 +74,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/idle // 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/idle/onstatechanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/idle/onstatechanged/index.md index bcf1605f4f..2607f24ee5 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/idle/onstatechanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/idle/onstatechanged/index.md @@ -14,73 +14,65 @@ tags: - onStateChanged translation_of: Mozilla/Add-ons/WebExtensions/API/idle/onStateChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque le systĂšme change passe Ă l'Ă©tat actif, inactif ou vĂ©rouillĂ©. L'Ă©couteur d'Ă©vĂ©nement reçoit une chaĂźne qui a l'une des trois valeurs suivantes :</p> +LancĂ© lorsque le systĂšme change passe Ă l'Ă©tat actif, inactif ou vĂ©rouillĂ©. L'Ă©couteur d'Ă©vĂ©nement reçoit une chaĂźne qui a l'une des trois valeurs suivantes : -<ul> - <li>"vĂ©rouillĂ©" si l'Ă©cran est vĂ©rouillĂ© ou si l'Ă©conomisateur d'Ă©cran s'active</li> - <li>"inactif" si le systĂšme est vĂ©rouillĂ© ou si l'Ă©conomisateur n'a gĂ©nĂ©rĂ© aucune entrĂ©e pendant un nombre de secondes spĂ©cifiĂ©. Ce nombre est dĂ©fini par dĂ©faut sur 60, mais peut-ĂȘtre dĂ©fini Ă l'aide de {{WebExtAPIRef("idle.setDetectionInterval()")}}.</li> - <li>"actif" quand l'utilisateur gĂ©nĂšre une entrĂ©e sur un systĂšme inactif.</li> -</ul> +- "vĂ©rouillĂ©" si l'Ă©cran est vĂ©rouillĂ© ou si l'Ă©conomisateur d'Ă©cran s'active +- "inactif" si le systĂšme est vĂ©rouillĂ© ou si l'Ă©conomisateur n'a gĂ©nĂ©rĂ© aucune entrĂ©e pendant un nombre de secondes spĂ©cifiĂ©. Ce nombre est dĂ©fini par dĂ©faut sur 60, mais peut-ĂȘtre dĂ©fini Ă l'aide de {{WebExtAPIRef("idle.setDetectionInterval()")}}. +- "actif" quand l'utilisateur gĂ©nĂšre une entrĂ©e sur un systĂšme inactif. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.idle.onStateChanged.addListener(listener) +```js +browser.idle.onStateChanged.addListener(listener) browser.idle.onStateChanged.removeListener(listener) browser.idle.onStateChanged.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂ©tez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si l' <code>Ă©couteur</code> est enregistrĂ© pour cet Ă©vĂ©nement. Retourne <code>true</code> s'il Ă©coute, <code>false</code> sinon.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂ©tez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si l' `Ă©couteur` est enregistrĂ© pour cet Ă©vĂ©nement. Retourne `true` s'il Ă©coute, `false` sinon. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>newState</code></dt> - <dd>{{WebExtAPIRef('idle.IdleState')}}. Le nouvel Ă©tat est inactif.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `newState` + - : {{WebExtAPIRef('idle.IdleState')}}. Le nouvel Ă©tat est inactif. -<p>{{Compat("webextensions.api.idle.onStateChanged")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.idle.onStateChanged")}} -<pre class="brush: js">function newState(state) { +## Exemples + +```js +function newState(state) { console.log(`New state: ${state}`); } -browser.idle.onStateChanged.addListener(newState);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.idle.onStateChanged.addListener(newState); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/idle"><code>chrome.idle</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/idle.json"><code>idle.json</code></a> dans le code Chromium.</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.idle`](https://developer.chrome.com/extensions/idle). Cette documentation est dĂ©rivĂ©e de [`idle.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/idle.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -107,5 +99,4 @@ browser.idle.onStateChanged.addListener(newState);</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/idle/querystate/index.md b/files/fr/mozilla/add-ons/webextensions/api/idle/querystate/index.md index 42461f4848..67c54a1821 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/idle/querystate/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/idle/querystate/index.md @@ -14,39 +14,39 @@ tags: - queryState translation_of: Mozilla/Add-ons/WebExtensions/API/idle/queryState --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Renvoie <code>"locked"</code> si le systĂšme est vĂ©rouillĂ©, <code>"inactif"</code> si l'utilisation n'a gĂ©nĂ©rĂ© aucune entrĂ©e pendant un nombre de secondes spĂ©cifiĂ©, ou <code>"actif"</code> dans le cas contraire.</p> +Renvoie `"locked"` si le systĂšme est vĂ©rouillĂ©, `"inactif"` si l'utilisation n'a gĂ©nĂ©rĂ© aucune entrĂ©e pendant un nombre de secondes spĂ©cifiĂ©, ou `"actif"` dans le cas contraire. -<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 querying = browser.idle.queryState( +```js +var querying = browser.idle.queryState( detectionIntervalInSeconds // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>detectionIntervalInSeconds</code></dt> - <dd><code>integer</code>. Le systĂšme est considĂ©rĂ© inactif si <code>detectionIntervalInSeconds</code> secondes s'est Ă©coulĂ© depuis la derniĂšre entrĂ©e utilisateur dĂ©tectĂ©e.</dd> -</dl> +- `detectionIntervalInSeconds` + - : `integer`. Le systĂšme est considĂ©rĂ© inactif si `detectionIntervalInSeconds` secondes s'est Ă©coulĂ© depuis la derniĂšre entrĂ©e utilisateur dĂ©tectĂ©e. -<h3 id="Valeur_renvoyĂ©e">Valeur renvoyĂ©e</h3> +### Valeur renvoyĂ©e -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec une chaĂźne {{WebExtAPIRef('idle.IdleState')}}, indiquant l'Ă©tat actuel.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec une chaĂźne {{WebExtAPIRef('idle.IdleState')}}, indiquant l'Ă©tat actuel. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.idle.queryState")}}</p> +{{Compat("webextensions.api.idle.queryState")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Dans cet extrait simple, nous appelons <code>queryState()</code> et vĂ©rifions si le <code>newState</code> est <code>inactif</code> ou <code>active</code>, en enregistrant un message selon le cas. Comme nous avons spĂ©cifiĂ© une valeur de <code>detectionIntervalInSeconds</code> de 15, un Ă©tat <code>inactif</code> ne sera signalĂ© que s'il n'y a pas eu d'activitĂ© de l'utilisateur depuis au moins 15 secondes</p> +Dans cet extrait simple, nous appelons `queryState()` et vĂ©rifions si le `newState` est `inactif` ou `active`, en enregistrant un message selon le cas. Comme nous avons spĂ©cifiĂ© une valeur de `detectionIntervalInSeconds` de 15, un Ă©tat `inactif` ne sera signalĂ© que s'il n'y a pas eu d'activitĂ© de l'utilisateur depuis au moins 15 secondes -<pre class="brush: js">function onGot(newState) { +```js +function onGot(newState) { if (newState === 'idle') { console.log('Please come back â we miss you!'); } else if (newState === 'active') { @@ -55,19 +55,18 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/idle/queryState } var querying = browser.idle.queryState(15); -querying.then(onGot);</pre> +querying.then(onGot); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.idle`](https://developer.chrome.com/extensions/idle). Cette documentation est dĂ©rivĂ©e de [`idle.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/idle.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/idle"><code>chrome.idle</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/idle.json"><code>idle.json</code></a> dans le code Chromium.</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 @@ -94,5 +93,4 @@ querying.then(onGot);</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/idle/setdetectioninterval/index.md b/files/fr/mozilla/add-ons/webextensions/api/idle/setdetectioninterval/index.md index 3247128749..5f626b3250 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/idle/setdetectioninterval/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/idle/setdetectioninterval/index.md @@ -13,45 +13,44 @@ tags: - setDetectionInterval translation_of: Mozilla/Add-ons/WebExtensions/API/idle/setDetectionInterval --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit l'intervalle, en secondes, utilisĂ© pour dĂ©terminer quand le systĂšme est dans un Ă©tat inactif pour les Ă©vĂ©nements {{WebExtAPIRef("idle.onStateChanged")}} . L'intervalle par dĂ©faut est de 60 secondes.</p> +DĂ©finit l'intervalle, en secondes, utilisĂ© pour dĂ©terminer quand le systĂšme est dans un Ă©tat inactif pour les Ă©vĂ©nements {{WebExtAPIRef("idle.onStateChanged")}} . L'intervalle par dĂ©faut est de 60 secondes. -<p>L'intervalle de dĂ©tection est spĂ©cifique Ă l'extension qui appelle la mĂ©thode. La modification de l'intervalle dans une extension n'affecte pas l'intervalle de dĂ©tection dans une autre extension.</p> +L'intervalle de dĂ©tection est spĂ©cifique Ă l'extension qui appelle la mĂ©thode. La modification de l'intervalle dans une extension n'affecte pas l'intervalle de dĂ©tection dans une autre extension. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.idle.setDetectionInterval( +```js +browser.idle.setDetectionInterval( intervalInSeconds // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>intervalInSeconds</code></dt> - <dd><code>integer</code>. Seuil, en secondes, utilisĂ© pour dĂ©terminer quand le systĂšme est dans un Ă©tat inactif. La valeur minimum que vous pouvez fournir ici est 15.</dd> -</dl> +- `intervalInSeconds` + - : `integer`. Seuil, en secondes, utilisĂ© pour dĂ©terminer quand le systĂšme est dans un Ă©tat inactif. La valeur minimum que vous pouvez fournir ici est 15. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.idle.setDetectionInterval")}}</p> +{{Compat("webextensions.api.idle.setDetectionInterval")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">browser.idle.setDetectionInterval(15);</pre> +```js +browser.idle.setDetectionInterval(15); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.idle`](https://developer.chrome.com/extensions/idle). Cette documentation est dĂ©rivĂ©e de [`idle.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/idle.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/idle"><code>chrome.idle</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/idle.json"><code>idle.json</code></a> dans le code Chromium.</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 @@ -78,5 +77,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/idle/setDetectionInterval // 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/index.md b/files/fr/mozilla/add-ons/webextensions/api/index.md index fde24d4ca1..ea15c3f2a7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/index.md @@ -6,24 +6,26 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Les APIs WebExtensions en JavaScript peuvent ĂȘtre utilisĂ©es au sein des <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension">scripts dâarriĂšre plan</a> de lâextension et dans tout autre document livrĂ© avec celle-ci. Ceci inclut les pop-ups relatives Ă une <a href="/fr/Add-ons/WebExtensions/user_interface/Browser_action">action navigateur</a> ou <a href="/fr/Add-ons/WebExtensions/user_interface/Page_actions">action de page</a>, <a href="/fr/Add-ons/WebExtensions/user_interface/barres_laterales">barres latĂ©rales</a>, <a href="/fr/Add-ons/WebExtensions/user_interface/Options_pages">pages dâoptions</a>, ou <a href="/fr/Add-ons/WebExtensions/manifest.json/chrome_url_overrides">pages de nouvel onglet</a>. Certaines de ces APIs peuvent Ă©galement ĂȘtre interrogĂ©es par des <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Content_scripts">scripts de contenu</a> de lâextension (voir la <a href="/fr/Add-ons/WebExtensions/Content_scripts#WebExtension_APIs">liste dans le guide des scripts de contenu</a>).</p> +Les APIs WebExtensions en JavaScript peuvent ĂȘtre utilisĂ©es au sein des [scripts dâarriĂšre plan](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension) de lâextension et dans tout autre document livrĂ© avec celle-ci. Ceci inclut les pop-ups relatives Ă une [action navigateur](/fr/Add-ons/WebExtensions/user_interface/Browser_action) ou [action de page](/fr/Add-ons/WebExtensions/user_interface/Page_actions), [barres latĂ©rales](/fr/Add-ons/WebExtensions/user_interface/barres_laterales), [pages dâoptions](/fr/Add-ons/WebExtensions/user_interface/Options_pages), ou [pages de nouvel onglet](/fr/Add-ons/WebExtensions/manifest.json/chrome_url_overrides). Certaines de ces APIs peuvent Ă©galement ĂȘtre interrogĂ©es par des [scripts de contenu](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Content_scripts) de lâextension (voir la [liste dans le guide des scripts de contenu](/fr/Add-ons/WebExtensions/Content_scripts#WebExtension_APIs)). -<p>Pour utiliser les APIs plus puissantes, vous devez en <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">demander la permission</a> dans le manifest.json de votre extension.</p> +Pour utiliser les APIs plus puissantes, vous devez en [demander la permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) dans le manifest.json de votre extension. -<p>Vous pouvez accĂ©der aux APIs en utilisant lâespace de noms <code>browser</code> :</p> +Vous pouvez accĂ©der aux APIs en utilisant lâespace de noms `browser` : -<pre class="brush: js">function afficherTabs (tabs) { +```js +function afficherTabs (tabs) { console.log(tabs) } -browser.tabs.query({currentWindow: true}, afficherTabs)</pre> +browser.tabs.query({currentWindow: true}, afficherTabs) +``` +De nombreuses APIs sont asynchrones et retournent une {{JSxRef("Promise")}}: -<p>De nombreuses APIs sont asynchrones et retournent une {{JSxRef("Promise")}}:</p> - -<pre class="brush: js">function afficherCookie (c) { +```js +function afficherCookie (c) { console.log(c) } @@ -34,25 +36,23 @@ function afficherErreur (e) { let setCookie = browser.cookies.set( {url: "https://developer.mozilla.org/"} ); -setCookie.then(logCookie, afficherErreur)</pre> - +setCookie.then(logCookie, afficherErreur) +``` -<div> -<p>Notez que ceci est diffĂ©rent du systĂšme d'extension de Google Chrome, qui utilise lâespace de noms <code>chrome</code> Ă la place de <code>browser</code>, et qui utilise des fonctions de rappel (callbacks) plutĂŽt que des promesses pour les fonctions asynchrones. Afin de favoriser la portabilitĂ©, lâimplĂ©mentation Firefox des WebExtensions prend en charge <code>chrome</code> et les fonctions de rappel ainsi que <code>browser</code> et les promesses. Mozilla a Ă©galement Ă©crit une prothĂšse dâĂ©mulation (polyfill) permettant au code qui utilise <code>browser</code> et les promesses de fonctionner sans modification dans Chrome: <a href="https://github.com/mozilla/webextension-polyfill">https://github.com/mozilla/webextension-polyfill</a>.</p> +Notez que ceci est diffĂ©rent du systĂšme d'extension de Google Chrome, qui utilise lâespace de noms `chrome` Ă la place de `browser`, et qui utilise des fonctions de rappel (callbacks) plutĂŽt que des promesses pour les fonctions asynchrones. Afin de favoriser la portabilitĂ©, lâimplĂ©mentation Firefox des WebExtensions prend en charge `chrome` et les fonctions de rappel ainsi que `browser` et les promesses. Mozilla a Ă©galement Ă©crit une prothĂšse dâĂ©mulation (polyfill) permettant au code qui utilise `browser` et les promesses de fonctionner sans modification dans Chrome: <https://github.com/mozilla/webextension-polyfill>. -<p>Firefox implĂ©mente Ă©galement ces API sous lâespace de noms Chrome Ă lâaide de rappels. Cela permet au code Ă©crit pour Chrome de fonctionner en grande partie inchangĂ© dans Firefox pour les API documentĂ©es ici.</p> +Firefox implĂ©mente Ă©galement ces API sous lâespace de noms Chrome Ă lâaide de rappels. Cela permet au code Ă©crit pour Chrome de fonctionner en grande partie inchangĂ© dans Firefox pour les API documentĂ©es ici. -<p>Microsoft Edge utilise lâespace de noms <code>browser</code>, mais ne supporte pas encore les APIs asynchrones basĂ©es sur les promesses. Avec Edge, Ă lâheure actuelle, les API asynchrones doivent utiliser des fonctions de rappel.</p> +Microsoft Edge utilise lâespace de noms `browser`, mais ne supporte pas encore les APIs asynchrones basĂ©es sur les promesses. Avec Edge, Ă lâheure actuelle, les API asynchrones doivent utiliser des fonctions de rappel. -<p>Tous les navigateurs ne sont pas compatibles avec toutes les APIs : pour de plus amples informations, consultez <a href="/fr/Add-ons/WebExtensions/prise_en_charge_du_navigateur_pour_les_api_javascript">la compatibilitĂ© navigateur pour les APIs JavaScript</a>.</p> +Tous les navigateurs ne sont pas compatibles avec toutes les APIs : pour de plus amples informations, consultez [la compatibilitĂ© navigateur pour les APIs JavaScript](/fr/Add-ons/WebExtensions/prise_en_charge_du_navigateur_pour_les_api_javascript). -<p>Conseil : dans les listes d'API JavaScript, vous trouverez des exemples de codes courts qui illustrent la maniĂšre dont l'API est utilisĂ©e. Vous pouvez utiliser ces exemples, sans avoir besoin de crĂ©er une extension web, en utilisant la console de la <a href="https://extensionworkshop.com/documentation/develop/debugging/#developer-tools-toolbox">boĂźte Ă outils</a>. Par exemple, voici le premier exemple de code sur cette page fonctionnant dans la console de la boĂźte Ă outils dans Firefox Developpeur Edition :</p> +Conseil : dans les listes d'API JavaScript, vous trouverez des exemples de codes courts qui illustrent la maniĂšre dont l'API est utilisĂ©e. Vous pouvez utiliser ces exemples, sans avoir besoin de crĂ©er une extension web, en utilisant la console de la [boĂźte Ă outils](https://extensionworkshop.com/documentation/develop/debugging/#developer-tools-toolbox). Par exemple, voici le premier exemple de code sur cette page fonctionnant dans la console de la boĂźte Ă outils dans Firefox Developpeur Edition : -<p><img alt="Illustration of a snippet of web extension code run from the console in the Toolbox" src="javaScript_exercised_in_console.jpg"></p> +![Illustration of a snippet of web extension code run from the console in the Toolbox](javaScript_exercised_in_console.jpg) -<h2 id="Liste_des_API_JavaScript">Liste des API JavaScript</h2> +## Liste des API JavaScript -<p>Voir ci-dessous pour une liste complĂšte des API JavaScript :</p> -</div> +Voir ci-dessous pour une liste complĂšte des API JavaScript : -<div>{{SubpagesWithSummaries}}</div> +{{SubpagesWithSummaries}} 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> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/action_menu_top_level_limit/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/action_menu_top_level_limit/index.md index 29765ce11e..00873408b8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/action_menu_top_level_limit/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/action_menu_top_level_limit/index.md @@ -13,27 +13,25 @@ tags: - contextMenus translation_of: Mozilla/Add-ons/WebExtensions/API/menus/ACTION_MENU_TOP_LEVEL_LIMIT --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le nombre maximal d'Ă©lĂ©ments d'extension de niveau supĂ©rieur pouvant ĂȘtre ajoutĂ©s Ă un Ă©lĂ©ment de menu dont {{WebExtAPIRef("contextMenus.ContextType", "ContextType")}} est "browser_action" ou "page_action". Tout Ă©lĂ©ment au-delĂ de cette limite sera ignorĂ©.</p> +Le nombre maximal d'Ă©lĂ©ments d'extension de niveau supĂ©rieur pouvant ĂȘtre ajoutĂ©s Ă un Ă©lĂ©ment de menu dont {{WebExtAPIRef("contextMenus.ContextType", "ContextType")}} est "browser_action" ou "page_action". Tout Ă©lĂ©ment au-delĂ de cette limite sera ignorĂ©. -<p>Sa valeur est de <code>6</code> pour Firefox et Chrome.</p> +Sa valeur est de `6` pour Firefox et Chrome. -<p>Pour la compatibilitĂ© avec d'autres navigateurs, Firefox rend cette propriĂ©tĂ© disponible via l'espace de noms <code>contextMenus</code> ainsi que l'espace de noms des <code>menus</code>.</p> +Pour la compatibilitĂ© avec d'autres navigateurs, Firefox rend cette propriĂ©tĂ© disponible via l'espace de noms `contextMenus` ainsi que l'espace de noms des `menus`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.menus.ACTION_MENU_TOP_LEVEL_LIMIT", 10)}}</p> +{{Compat("webextensions.api.menus.ACTION_MENU_TOP_LEVEL_LIMIT", 10)}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.contextMenus`](https://developer.chrome.com/extensions/contextMenus) de chromium. Cette documentation est dĂ©rivĂ©e de [`context_menus.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json) dans le code Chromium. -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</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 @@ -60,5 +58,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/ACTION_MENU_TOP_LEVEL_LI // 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/menus/contexttype/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/contexttype/index.md index 9f8c8c824c..2cd7a9a243 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/contexttype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/contexttype/index.md @@ -14,62 +14,58 @@ tags: - menus translation_of: Mozilla/Add-ons/WebExtensions/API/menus/ContextType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Les diffĂ©rents contextes dans lesquels un Ă©lĂ©ment de menu peut apparaĂźtre.</p> +Les diffĂ©rents contextes dans lesquels un Ă©lĂ©ment de menu peut apparaĂźtre. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. L'Ă©lĂ©ment est affichĂ© lorsque le contexte donnĂ© s'applique. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. L'Ă©lĂ©ment est affichĂ© lorsque le contexte donnĂ© s'applique. Les valeurs possibles sont : -<dl> - <dt>all</dt> - <dd>La spĂ©cification de "tous" Ă©quivaut Ă la combinaison de tous les autres contextes, Ă l'exception de 'bookmark', 'tab' et 'tools_menu'.</dd> - <dt>audio</dt> - <dd>S'applique lorsque l'utilisateur clique sur le contexte d'un Ă©lĂ©ment <a href="/fr/docs/Web/HTML/Element/audio">audio</a>.</dd> - <dt>bookmark</dt> - <dd>S'applique lorsque l'utilisateur clique en contexte sur un Ă©lĂ©ment de signet dans la barre d'outils des signets, le menu des signets, la barre latĂ©rale des signets (<kbd>Ctrl</kbd> + <kbd>B</kbd>) et la fenĂȘtre BibliothĂšque (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>B</kbd>). Ces deux derniers sont supportĂ©s Ă partir de Firefox 66. NĂ©cessite la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission d'API</a> dans le manifest.</dd> - <dt>browser_action</dt> - <dd>S'applique lorsque l'utilisateur clique en contexte sur l'action de votre navigateur. Le nombre maximal d'Ă©lĂ©ments pouvant ĂȘtre ajoutĂ©s au menu contextuel de l'action du navigateur de niveau supĂ©rieur est {{WebExtAPIRef("menus.ACTION_MENU_TOP_LEVEL_LIMIT")}}, mais vous pouvez ajouter n'importe quel nombre d'Ă©lĂ©ments aux sous-menus.</dd> - <dt>editable</dt> - <dd>S'applique lorsque l'utilisateur clique en contexte sur un Ă©lĂ©ment modifiable, comme un <a href="/fr/docs/Web/HTML/Element/textarea">textarea</a>.</dd> - <dt>frame</dt> - <dd>S'applique lorsque l'utilisateur clique sur le contexte dans une <a href="/fr/docs/Web/HTML/Element/iframe">iframe</a> imbriquĂ©.</dd> - <dt>image</dt> - <dd>S'applique lorsque l'utilisateur clique sur le contexte d'une image.</dd> - <dt>link</dt> - <dd>S'applique lorsque l'utilisateur clique en contexte sur un lien.</dd> - <dt>page</dt> - <dd>S'applique lorsque l'utilisateur clique sur le contexte dans la page, mais aucun des autres contextes de page ne s'applique (par exemple, le clic ne se trouve pas sur une image ou une <em>iframe</em> imbriquĂ© ou un lien).</dd> - <dt>page_action</dt> - <dd>S'applique lorsque l'utilisateur clique en contexte sur l'action de votre page. Le nombre maximal d'Ă©lĂ©ments pouvant ĂȘtre ajoutĂ©s au menu contextuel de l'action de page de niveau supĂ©rieur est {{WebExtAPIRef("menus.ACTION_MENU_TOP_LEVEL_LIMIT")}}, mais vous pouvez ajouter n'importe quel nombre d'Ă©lĂ©ments aux sous-menus.</dd> - <dt>password</dt> - <dd>S'applique lorsque l'utilisateur clique en contexte sur un <a href="/fr/docs/Web/HTML/Element/input/password">Ă©lĂ©ment d'entrĂ©e de mot de passe</a>.</dd> - <dt>selection</dt> - <dd>S'applique lorsqu'une partie de la page est sĂ©lectionnĂ©e.</dd> - <dt>tab</dt> - <dd>S'applique lorsque l'utilisateur clique en contexte sur un onglet (en particulier, il s'agit de l'onglet ou d'un autre Ă©lĂ©ment de l'interface utilisateur permettant Ă l'utilisateur de passer d'un onglet de navigateur Ă un autre, et non Ă la page elle-mĂȘme). Depuis Firefox 63, cliquer sur l'Ă©lĂ©ment du menu d'un onglet accorde la permission <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#activeTab_permission">activeTab</a> pour l'onglet cliquĂ©, mĂȘme si ce n'est pas l'onglet actuellement actif.</dd> - <dt>tools_menu</dt> - <dd>L'Ă©lĂ©ment sera ajoutĂ© au menu des outils du navigateur. Notez que ceci n'est disponible que si vous accĂ©dez Ă <code>ContextType</code> via l'espace de nom des <code>menus</code>. Il n'est pas disponible si vous y accĂ©dez via l'espace de noms <code>contextMenus</code>.</dd> - <dt>video</dt> - <dd>S'applique lorsque l'utilisateur clique sur le contexte d'un Ă©lĂ©ment <a href="/fr/docs/Web/HTML/Element/video">video</a>.</dd> -</dl> +- all + - : La spĂ©cification de "tous" Ă©quivaut Ă la combinaison de tous les autres contextes, Ă l'exception de 'bookmark', 'tab' et 'tools_menu'. +- audio + - : S'applique lorsque l'utilisateur clique sur le contexte d'un Ă©lĂ©ment [audio](/fr/docs/Web/HTML/Element/audio). +- bookmark + - : S'applique lorsque l'utilisateur clique en contexte sur un Ă©lĂ©ment de signet dans la barre d'outils des signets, le menu des signets, la barre latĂ©rale des signets (\<kbd>Ctrl\</kbd> + \<kbd>B\</kbd>) et la fenĂȘtre BibliothĂšque (\<kbd>Ctrl\</kbd> + \<kbd>Shift\</kbd> + \<kbd>B\</kbd>). Ces deux derniers sont supportĂ©s Ă partir de Firefox 66. NĂ©cessite la [permission d'API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) dans le manifest. +- browser_action + - : S'applique lorsque l'utilisateur clique en contexte sur l'action de votre navigateur. Le nombre maximal d'Ă©lĂ©ments pouvant ĂȘtre ajoutĂ©s au menu contextuel de l'action du navigateur de niveau supĂ©rieur est {{WebExtAPIRef("menus.ACTION_MENU_TOP_LEVEL_LIMIT")}}, mais vous pouvez ajouter n'importe quel nombre d'Ă©lĂ©ments aux sous-menus. +- editable + - : S'applique lorsque l'utilisateur clique en contexte sur un Ă©lĂ©ment modifiable, comme un [textarea](/fr/docs/Web/HTML/Element/textarea). +- frame + - : S'applique lorsque l'utilisateur clique sur le contexte dans une [iframe](/fr/docs/Web/HTML/Element/iframe) imbriquĂ©. +- image + - : S'applique lorsque l'utilisateur clique sur le contexte d'une image. +- link + - : S'applique lorsque l'utilisateur clique en contexte sur un lien. +- page + - : S'applique lorsque l'utilisateur clique sur le contexte dans la page, mais aucun des autres contextes de page ne s'applique (par exemple, le clic ne se trouve pas sur une image ou une _iframe_ imbriquĂ© ou un lien). +- page_action + - : S'applique lorsque l'utilisateur clique en contexte sur l'action de votre page. Le nombre maximal d'Ă©lĂ©ments pouvant ĂȘtre ajoutĂ©s au menu contextuel de l'action de page de niveau supĂ©rieur est {{WebExtAPIRef("menus.ACTION_MENU_TOP_LEVEL_LIMIT")}}, mais vous pouvez ajouter n'importe quel nombre d'Ă©lĂ©ments aux sous-menus. +- password + - : S'applique lorsque l'utilisateur clique en contexte sur un [Ă©lĂ©ment d'entrĂ©e de mot de passe](/fr/docs/Web/HTML/Element/input/password). +- selection + - : S'applique lorsqu'une partie de la page est sĂ©lectionnĂ©e. +- tab + - : S'applique lorsque l'utilisateur clique en contexte sur un onglet (en particulier, il s'agit de l'onglet ou d'un autre Ă©lĂ©ment de l'interface utilisateur permettant Ă l'utilisateur de passer d'un onglet de navigateur Ă un autre, et non Ă la page elle-mĂȘme). Depuis Firefox 63, cliquer sur l'Ă©lĂ©ment du menu d'un onglet accorde la permission [activeTab](/fr/Add-ons/WebExtensions/manifest.json/permissions#activeTab_permission) pour l'onglet cliquĂ©, mĂȘme si ce n'est pas l'onglet actuellement actif. +- tools_menu + - : L'Ă©lĂ©ment sera ajoutĂ© au menu des outils du navigateur. Notez que ceci n'est disponible que si vous accĂ©dez Ă `ContextType` via l'espace de nom des `menus`. Il n'est pas disponible si vous y accĂ©dez via l'espace de noms `contextMenus`. +- video + - : S'applique lorsque l'utilisateur clique sur le contexte d'un Ă©lĂ©ment [video](/fr/docs/Web/HTML/Element/video). -<p>Notez que "launcher" n'est pas supportĂ©.</p> +Notez que "launcher" n'est pas supportĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.menus.ContextType", 10)}}</p> +{{Compat("webextensions.api.menus.ContextType", 10)}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.contextMenus`](https://developer.chrome.com/extensions/contextMenus) de chromium. Cette documentation est dĂ©rivĂ©e de [`context_menus.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json) dans le code Chromium. -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</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 @@ -96,5 +92,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/ContextType // 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/menus/create/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/create/index.md index 412c463af9..b137881186 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/create/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/create/index.md @@ -13,119 +13,115 @@ tags: - contextMenus translation_of: Mozilla/Add-ons/WebExtensions/API/menus/create --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>CrĂ©e un nouvel Ă©lĂ©ment de menu, avec un objet d'options dĂ©finissant les propriĂ©tĂ©s de l'Ă©lĂ©ment.</p> +CrĂ©e un nouvel Ă©lĂ©ment de menu, avec un objet d'options dĂ©finissant les propriĂ©tĂ©s de l'Ă©lĂ©ment. -<p>Contrairement aux autres fonctions asynchrones, celle-ci ne renvoie pas de promesse, mais utilise un callback optionnel pour communiquer le succĂšs ou l'Ă©chec. C'est parce que sa valeur de retour est l'ID du nouvel Ă©lĂ©ment.</p> +Contrairement aux autres fonctions asynchrones, celle-ci ne renvoie pas de promesse, mais utilise un callback optionnel pour communiquer le succĂšs ou l'Ă©chec. C'est parce que sa valeur de retour est l'ID du nouvel Ă©lĂ©ment. -<p>Pour la compatibilitĂ© avec d'autres navigateurs, Firefox rend cette mĂ©thode disponible via l'espace noms <code>contextMenus</code> ainsi que l'espace de noms des <code>menus</code>. Notez cependant qu'il n'est pas possible de crĂ©er des Ă©lĂ©ments de menu d'outils (<code>contexts: ["tools_menu"]</code>) en utilisant l'espace de noms <code>contextMenus</code>.</p> +Pour la compatibilitĂ© avec d'autres navigateurs, Firefox rend cette mĂ©thode disponible via l'espace noms `contextMenus` ainsi que l'espace de noms des `menus`. Notez cependant qu'il n'est pas possible de crĂ©er des Ă©lĂ©ments de menu d'outils (`contexts: ["tools_menu"]`) en utilisant l'espace de noms `contextMenus`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.menus.create( +```js +browser.menus.create( createProperties, // object function() {...} // optional function ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>createProperties</code></dt> - <dd><p><code>object</code>. PropriĂ©tĂ©s pour le nouvel Ă©lĂ©ment de menu.</p> - <dl> - <dt><code>checked</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. L'Ă©tat initial d'une case Ă cocher ou d'un Ă©lĂ©ment radio : <code>true</code> pour selected et <code>false</code> pour non sĂ©lectionnĂ©. Un seul Ă©lĂ©ment radio peut ĂȘtre sĂ©lectionnĂ© Ă la fois dans un groupe donnĂ© d'Ă©lĂ©ments radio.</dd> - <dt><code>command</code> {{optional_inline}}</dt> - <dd> - <p><code>string</code>. ChaĂźne dĂ©crivant une action Ă effectuer lorsque l'utilisateur clique sur l'Ă©lĂ©ment. Les valeurs possibles sont:</p> - - <ul> - <li><code>"_execute_browser_action"</code>: simule un clic sur l'action du navigateur de l'extension, en ouvrant son popup s'il en a un</li> - <li><code>"_execute_page_action"</code>: simule un clic sur l'action de la page de l'extension, en ouvrant son popup s'il en a un</li> - <li><code>"_execute_sidebar_action"</code>: ouvre la barre latĂ©rale de l'extension</li> - </ul> - - <p>Cliquer sur l'Ă©lĂ©ment dĂ©clenchera toujours l'Ă©vĂ©nement {{WebExtAPIRef("menus.onClicked")}}, mais il n'y a aucune garantie de la commande ici: la commande peut ĂȘtre exĂ©cutĂ©e avant les incendies <code>onClicked</code>.</p> - </dd> - <dt><code>contexts</code> {{optional_inline}}</dt> - <dd> - <p><code>array</code> de <code>{{WebExtAPIRef('menus.ContextType')}}</code>. Tableau des contextes dans lesquels cet Ă©lĂ©ment de menu apparaĂźtra. Si cette option est omise :</p> - - <ul> - <li>Si l'Ă©lĂ©ment parent a des contextes dĂ©finis, alors cet Ă©lĂ©ment hĂ©ritera des contextes de ses parents</li> - <li>sinon, l'Ă©lĂ©ment reçoit un tableau de contexte de ["page"].</li> - </ul> - </dd> - <dt><code>documentUrlPatterns</code> {{optional_inline}}</dt> - <dd><code>array</code> de <code><code>string</code></code>. Vous permet de restreindre l'Ă©lĂ©ment Ă appliquer uniquement aux documents dont l'URL correspond Ă l'un des <a href="/fr/Add-ons/WebExtensions/Match_patterns">motifs</a> donnĂ©es. Cela s'applique Ă©galement aux cadres.</dd> - <dt><code>enabled</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si cet Ă©lĂ©ment de menu est activĂ© ou dĂ©sactivĂ©. Par dĂ©faut Ă <code>true</code>.</dd> - <dt><code>icons</code> {{optional_inline}}</dt> - <dd> - <p><code>object</code>. Une ou plusieurs icĂŽnes personnalisĂ©es Ă afficher en regard de l'Ă©lĂ©ment. Les icĂŽnes personnalisĂ©es ne peuvent ĂȘtre dĂ©finies que pour les Ă©lĂ©ments apparaissant dans les sous-menus. Cette propriĂ©tĂ© est un objet avec une propriĂ©tĂ© pour chaque icĂŽne fournie: le nom de la propriĂ©tĂ© est la taille de l'icĂŽne en pixels et sa valeur est un chemin vers l'icĂŽne Ă partir du rĂ©pertoire racine de l'extension. Le navigateur va essayer de choisir une icĂŽne de 16x16 pixels pour un affichage normal ou une icĂŽne de 32x32 pixels pour un affichage haute densitĂ©. Donc, pour Ă©viter toute mise Ă l'Ă©chelle, vous pouvez spĂ©cifier des icĂŽnes comme ceci :</p> - - <pre class="brush: json">"icons": { - "16": "path/to/geo-16.png", - "32": "path/to/geo-32.png" - }</pre> - - <p>Vous pouvez Ă©galement spĂ©cifier une seule icĂŽne SVG, qui sera mise Ă l'Ă©chelle de maniĂšre appropriĂ©e :</p> - - <pre class="brush: json">"icons": { - "16": "path/to/geo.svg" - }</pre> - - <div class="note"> - <p><strong>Note :</strong> L'Ă©lĂ©ment de menu de niveau supĂ©rieur utilise les <a href="/fr/Add-ons/WebExtensions/manifest.json/icons">icĂŽnes</a> spĂ©cifiĂ©es dans le manifest plutĂŽt que ce qui est spĂ©cifiĂ© avec cette touche.</p> - </div> - </dd> - <dt><code>id</code> {{optional_inline}}</dt> - <dd><code>string</code>. Identifiant unique Ă attribuer Ă cet Ă©lĂ©ment Obligatoire pour les pages d'Ă©vĂ©nement. Ne peut pas ĂȘtre identique Ă un autre ID pour cette extension.</dd> - <dt><code>onclick</code> {{optional_inline}}</dt> - <dd><code>function</code>. Une fonction qui sera appelĂ©e lorsque l'Ă©lĂ©ment de menu est cliquĂ©. Les pages d'Ă©vĂ©nements ne peuvent pas utiliser ceci : Ă la place, elles devraient enregistrer un Ă©couteur pour {{WebExtAPIRef('menus.onClicked')}}.</dd> - <dt><code>parentId</code> {{optional_inline}}</dt> - <dd><code><code>integer</code></code> ou <code><code>string</code></code>. L'ID d'un Ă©lĂ©ment de menu parent; Cela fait de l'Ă©lĂ©ment un enfant d'un Ă©lĂ©ment ajoutĂ© prĂ©cĂ©demment. Remarque : Si vous avez crĂ©Ă© plus d'un Ă©lĂ©ment de menu, les Ă©lĂ©ments seront placĂ©s dans un sous-menu. Le parent du sous-menu sera Ă©tiquetĂ© avec le nom de l'extension.</dd> - <dt><code>targetUrlPatterns</code> {{optional_inline}}</dt> - <dd><code>array</code> de <code><code>string</code></code>. Similaire Ă <code>documentUrlPatterns</code>, mais vous permet de filtrer en fonction du <code>href</code> des balises d'ancrage et de l'attribut <code>src</code> des balises img/audio/video tags. Ce paramĂštre prend en charge n'importe quel schĂ©ma d'URL, mĂȘme ceux qui ne sont gĂ©nĂ©ralement pas autorisĂ©s dans un modĂšle de correspondance.</dd> - <dt><code>title</code> {{optional_inline}}</dt> - <dd> - <p><code>string</code>. Le texte Ă afficher dans l'article. Obligatoire sauf si le <code>type</code> est "separator".</p> - - <p>Vous pouvez utiliser "<code>%s</code>" dans la chaĂźne. Si vous le faites dans un Ă©lĂ©ment de menu et que du texte est sĂ©lectionnĂ© dans la page lorsque le menu est affichĂ©, le texte sĂ©lectionnĂ© sera interpolĂ© dans le titre. Par exemple, si le <code>titre</code> est "traduire '%s' en Pig Latin" et que l'utilisateur sĂ©lectionne le mot "cool", alors le menu est activĂ©, le titre de l'Ă©lĂ©ment de menu sera : "Traduire 'cool' en Pig Latin".</p> - - <p>Si le titre contient une esperluette "&" le caractĂšre suivant sera utilisĂ© comme clĂ© d'accĂšs pour l'Ă©lĂ©ment et l'esperluette ne sera pas affichĂ©e. Les exceptions Ă cette rĂšgle sont les suivantes :</p> - - <ul> - <li>Si le caractĂšre suivant est Ă©galement une esperluette : alors une esperluette simple sera affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie. En effet, "&&" est utilisĂ© pour afficher une seule esperluette.</li> - <li>Si les caractĂšres suivants sont la directive d'interpolation "%s" :  alors l'esperluette ne sera pas affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie.</li> - <li>Si l'esperluette est le dernier caractĂšre du titre : alors l'esperluette ne sera pas affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie.</li> - </ul> - - <p>Seule la premiĂšre esperluette sera utilisĂ©e pour dĂ©finir une clĂ© d'accĂšs : les esperluettes suivantes ne seront pas affichĂ©es mais ne dĂ©finiront pas les clĂ©s. Ainsi "&A et &B" seront affichĂ©s comme "A et B" et "A" comme clĂ© d'accĂšs.</p> - </dd> - <dt><code>type</code> {{optional_inline}}</dt> - <dd><code>{{WebExtAPIRef('menus.ItemType')}}</code>. Le type d'Ă©lĂ©ment de menu : "normal", "checkbox", "radio", "separator". Par dĂ©fault Ă "normal".</dd> - <dt><code>viewType</code> {{optional_inline}}</dt> - <dd><code>{{WebExtAPIRef('extension.ViewType')}}</code>. Liste des types d'affichage oĂč l'Ă©lĂ©ment de menu sera affichĂ©. Par dĂ©faut Ă n'importe quelle vue, y compris celles qui n'ont pas de <code>viewType</code>.</dd> - <dt><code>visible</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'Ă©lĂ©ment est affichĂ© dans le menu. Par dĂ©faut, la valeur est <code>true</code>.</dd> - </dl> - </dd> - <dt><code>callback</code> {{optional_inline}}</dt> - <dd><code>function</code>. AppelĂ© lorsque l'Ă©lĂ©ment a Ă©tĂ© crĂ©Ă©. S'il y a eu des problĂšmes lors de la crĂ©ation de l'Ă©lĂ©ment, les dĂ©tails seront disponibles dans {{WebExtAPIRef('runtime.lastError')}}.</dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p><code><code>integer</code></code> ou <code><code>string</code></code>. L'ID de l'article nouvellement crĂ©Ă©.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Cet exemple crĂ©e un Ă©lĂ©ment de menu contextuel qui s'affiche lorsque l'utilisateur a sĂ©lectionnĂ© du texte dans la page. Il enregistre simplement le texte sĂ©lectionnĂ© sur la console</p> - -<pre class="brush: js">browser.menus.create({ +``` + +### ParamĂštres + +- `createProperties` + + - : `object`. PropriĂ©tĂ©s pour le nouvel Ă©lĂ©ment de menu. + + - `checked` {{optional_inline}} + - : `boolean`. L'Ă©tat initial d'une case Ă cocher ou d'un Ă©lĂ©ment radio : `true` pour selected et `false` pour non sĂ©lectionnĂ©. Un seul Ă©lĂ©ment radio peut ĂȘtre sĂ©lectionnĂ© Ă la fois dans un groupe donnĂ© d'Ă©lĂ©ments radio. + - `command` {{optional_inline}} + + - : `string`. ChaĂźne dĂ©crivant une action Ă effectuer lorsque l'utilisateur clique sur l'Ă©lĂ©ment. Les valeurs possibles sont: + + - `"_execute_browser_action"`: simule un clic sur l'action du navigateur de l'extension, en ouvrant son popup s'il en a un + - `"_execute_page_action"`: simule un clic sur l'action de la page de l'extension, en ouvrant son popup s'il en a un + - `"_execute_sidebar_action"`: ouvre la barre latĂ©rale de l'extension + + Cliquer sur l'Ă©lĂ©ment dĂ©clenchera toujours l'Ă©vĂ©nement {{WebExtAPIRef("menus.onClicked")}}, mais il n'y a aucune garantie de la commande ici: la commande peut ĂȘtre exĂ©cutĂ©e avant les incendies `onClicked`. + + - `contexts` {{optional_inline}} + + - : `array` de `{{WebExtAPIRef('menus.ContextType')}}`. Tableau des contextes dans lesquels cet Ă©lĂ©ment de menu apparaĂźtra. Si cette option est omise : + + - Si l'Ă©lĂ©ment parent a des contextes dĂ©finis, alors cet Ă©lĂ©ment hĂ©ritera des contextes de ses parents + - sinon, l'Ă©lĂ©ment reçoit un tableau de contexte de \["page"]. + + - `documentUrlPatterns` {{optional_inline}} + - : `array` de `string`. Vous permet de restreindre l'Ă©lĂ©ment Ă appliquer uniquement aux documents dont l'URL correspond Ă l'un des [motifs](/fr/Add-ons/WebExtensions/Match_patterns) donnĂ©es. Cela s'applique Ă©galement aux cadres. + - `enabled` {{optional_inline}} + - : `boolean`. Si cet Ă©lĂ©ment de menu est activĂ© ou dĂ©sactivĂ©. Par dĂ©faut Ă `true`. + - `icons` {{optional_inline}} + + - : `object`. Une ou plusieurs icĂŽnes personnalisĂ©es Ă afficher en regard de l'Ă©lĂ©ment. Les icĂŽnes personnalisĂ©es ne peuvent ĂȘtre dĂ©finies que pour les Ă©lĂ©ments apparaissant dans les sous-menus. Cette propriĂ©tĂ© est un objet avec une propriĂ©tĂ© pour chaque icĂŽne fournie: le nom de la propriĂ©tĂ© est la taille de l'icĂŽne en pixels et sa valeur est un chemin vers l'icĂŽne Ă partir du rĂ©pertoire racine de l'extension. Le navigateur va essayer de choisir une icĂŽne de 16x16 pixels pour un affichage normal ou une icĂŽne de 32x32 pixels pour un affichage haute densitĂ©. Donc, pour Ă©viter toute mise Ă l'Ă©chelle, vous pouvez spĂ©cifier des icĂŽnes comme ceci : + + ```json + "icons": { + "16": "path/to/geo-16.png", + "32": "path/to/geo-32.png" + } + ``` + + Vous pouvez Ă©galement spĂ©cifier une seule icĂŽne SVG, qui sera mise Ă l'Ă©chelle de maniĂšre appropriĂ©e : + + ```json + "icons": { + "16": "path/to/geo.svg" + } + ``` + + > **Note :** L'Ă©lĂ©ment de menu de niveau supĂ©rieur utilise les [icĂŽnes](/fr/Add-ons/WebExtensions/manifest.json/icons) spĂ©cifiĂ©es dans le manifest plutĂŽt que ce qui est spĂ©cifiĂ© avec cette touche. + + - `id` {{optional_inline}} + - : `string`. Identifiant unique Ă attribuer Ă cet Ă©lĂ©ment Obligatoire pour les pages d'Ă©vĂ©nement. Ne peut pas ĂȘtre identique Ă un autre ID pour cette extension. + - `onclick` {{optional_inline}} + - : `function`. Une fonction qui sera appelĂ©e lorsque l'Ă©lĂ©ment de menu est cliquĂ©. Les pages d'Ă©vĂ©nements ne peuvent pas utiliser ceci : Ă la place, elles devraient enregistrer un Ă©couteur pour {{WebExtAPIRef('menus.onClicked')}}. + - `parentId` {{optional_inline}} + - : `integer` ou `string`. L'ID d'un Ă©lĂ©ment de menu parent; Cela fait de l'Ă©lĂ©ment un enfant d'un Ă©lĂ©ment ajoutĂ© prĂ©cĂ©demment. Remarque : Si vous avez crĂ©Ă© plus d'un Ă©lĂ©ment de menu, les Ă©lĂ©ments seront placĂ©s dans un sous-menu. Le parent du sous-menu sera Ă©tiquetĂ© avec le nom de l'extension. + - `targetUrlPatterns` {{optional_inline}} + - : `array` de `string`. Similaire Ă `documentUrlPatterns`, mais vous permet de filtrer en fonction du `href` des balises d'ancrage et de l'attribut `src` des balises img/audio/video tags. Ce paramĂštre prend en charge n'importe quel schĂ©ma d'URL, mĂȘme ceux qui ne sont gĂ©nĂ©ralement pas autorisĂ©s dans un modĂšle de correspondance. + - `title` {{optional_inline}} + + - : `string`. Le texte Ă afficher dans l'article. Obligatoire sauf si le `type` est "separator". + + Vous pouvez utiliser "`%s`" dans la chaĂźne. Si vous le faites dans un Ă©lĂ©ment de menu et que du texte est sĂ©lectionnĂ© dans la page lorsque le menu est affichĂ©, le texte sĂ©lectionnĂ© sera interpolĂ© dans le titre. Par exemple, si le `titre` est "traduire '%s' en Pig Latin" et que l'utilisateur sĂ©lectionne le mot "cool", alors le menu est activĂ©, le titre de l'Ă©lĂ©ment de menu sera : "Traduire 'cool' en Pig Latin". + + Si le titre contient une esperluette "&" le caractĂšre suivant sera utilisĂ© comme clĂ© d'accĂšs pour l'Ă©lĂ©ment et l'esperluette ne sera pas affichĂ©e. Les exceptions Ă cette rĂšgle sont les suivantes : + + - Si le caractĂšre suivant est Ă©galement une esperluette : alors une esperluette simple sera affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie. En effet, "&&" est utilisĂ© pour afficher une seule esperluette. + - Si les caractĂšres suivants sont la directive d'interpolation "%s" :  alors l'esperluette ne sera pas affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie. + - Si l'esperluette est le dernier caractĂšre du titre : alors l'esperluette ne sera pas affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie. + + Seule la premiĂšre esperluette sera utilisĂ©e pour dĂ©finir une clĂ© d'accĂšs : les esperluettes suivantes ne seront pas affichĂ©es mais ne dĂ©finiront pas les clĂ©s. Ainsi "\&A et \&B" seront affichĂ©s comme "A et B" et "A" comme clĂ© d'accĂšs. + + - `type` {{optional_inline}} + - : `{{WebExtAPIRef('menus.ItemType')}}`. Le type d'Ă©lĂ©ment de menu : "normal", "checkbox", "radio", "separator". Par dĂ©fault Ă "normal". + - `viewType` {{optional_inline}} + - : `{{WebExtAPIRef('extension.ViewType')}}`. Liste des types d'affichage oĂč l'Ă©lĂ©ment de menu sera affichĂ©. Par dĂ©faut Ă n'importe quelle vue, y compris celles qui n'ont pas de `viewType`. + - `visible` {{optional_inline}} + - : `boolean`. Si l'Ă©lĂ©ment est affichĂ© dans le menu. Par dĂ©faut, la valeur est `true`. + +- `callback` {{optional_inline}} + - : `function`. AppelĂ© lorsque l'Ă©lĂ©ment a Ă©tĂ© crĂ©Ă©. S'il y a eu des problĂšmes lors de la crĂ©ation de l'Ă©lĂ©ment, les dĂ©tails seront disponibles dans {{WebExtAPIRef('runtime.lastError')}}. + +### Valeur retournĂ©e + +`integer` ou `string`. L'ID de l'article nouvellement crĂ©Ă©. + +## Exemples + +Cet exemple crĂ©e un Ă©lĂ©ment de menu contextuel qui s'affiche lorsque l'utilisateur a sĂ©lectionnĂ© du texte dans la page. Il enregistre simplement le texte sĂ©lectionnĂ© sur la console + +```js +browser.menus.create({ id: "log-selection", title: "Log '%s' to the console", contexts: ["selection"] @@ -135,11 +131,13 @@ browser.menus.onClicked.addListener(function(info, tab) { if (info.menuItemId == "log-selection") { console.log(info.selectionText); } -});</pre> +}); +``` -<p>Cet exemple ajoute deux Ă©lĂ©ments radio, que vous pouvez utiliser pour choisir d'appliquer une bordure verte ou bleue Ă la page. Notez que cet exemple nĂ©cessitera la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#activeTab_permission">permission activeTab</a>.</p> +Cet exemple ajoute deux Ă©lĂ©ments radio, que vous pouvez utiliser pour choisir d'appliquer une bordure verte ou bleue Ă la page. Notez que cet exemple nĂ©cessitera la [permission activeTab](/fr/Add-ons/WebExtensions/manifest.json/permissions#activeTab_permission). -<pre class="brush: js">function onCreated() { +```js +function onCreated() { if (browser.runtime.lastError) { console.log("error creating item:" + browser.runtime.lastError); } else { @@ -176,21 +174,20 @@ browser.menus.onClicked.addListener(function(info, tab) { code: makeItGreen }); } -});</pre> - -<p>{{WebExtExamples}}</p> +}); +``` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{WebExtExamples}} -<p>{{Compat("webextensions.api.menus.create", 10)}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.menus.create", 10)}} -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.contextMenus`](https://developer.chrome.com/extensions/contextMenus) de chromium. Cette documentation est dĂ©rivĂ©e de [`context_menus.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json) dans le code Chromium. -<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 @@ -217,5 +214,4 @@ browser.menus.onClicked.addListener(function(info, tab) { // 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/menus/createproperties/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/createproperties/index.md index bae8cfe9ca..fe16e30b0f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/createproperties/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/createproperties/index.md @@ -3,102 +3,94 @@ title: createProperties slug: Mozilla/Add-ons/WebExtensions/API/menus/createProperties translation_of: Mozilla/Add-ons/WebExtensions/API/menus/createProperties --- -<p>{{AddonSidebar()}}</p> - -<p>Un <code>object</code> passĂ© au mĂ©thodes {{WebExtAPIRef("menus.create()", "menus.create()")}} ou {{WebExtAPIRef("menus.update()", "menus.update()")}}  pour dĂ©crire les propriĂ©tĂ©s de l'Ă©lĂ©ment de menu nouveau ou mis Ă jour.</p> - -<dl> - <dt><code>checked</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. The initial state of a checkbox or radio item: <code>true</code> for selected and <code>false</code> for unselected. Only one radio item can be selected at a time in a given group of radio items.</dd> - <dt><code>command</code> {{optional_inline}}</dt> - <dd> - <p><code>string</code>. String describing an action that should be taken when the user clicks the item. Possible values are:</p> - - <ul> - <li><code>"_execute_browser_action"</code>: simulate a click on the extension's browser action, opening its popup if it has one</li> - <li><code>"_execute_page_action"</code>: simulate a click on the extension's page action, opening its popup if it has one</li> - <li><code>"_execute_sidebar_action"</code>: open the extension's sidebar</li> - </ul> - - <p>Clicking the item will still trigger the {{WebExtAPIRef("menus.onClicked")}} event, but there's no guarantee of the ordering here: the command may be executed before <code>onClicked</code> fires.</p> - </dd> - <dt><code>contexts</code> {{optional_inline}}</dt> - <dd> - <p><code>array</code> of <code>{{WebExtAPIRef('menus.ContextType')}}</code>. Array of contexts in which this menu item will appear. If this option is omitted:</p> - - <ul> - <li>if the item's parent has contexts set, then this item will inherit its parent's contexts</li> - <li>otherwise, the item is given a context array of ["page"].</li> - </ul> - </dd> - <dt><code>documentUrlPatterns</code> {{optional_inline}}</dt> - <dd><code>array</code> of <code><code>string</code></code>. Lets you restrict the item to apply only to documents whose URL matches one of the given <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">match patterns</a>. This applies to frames as well.</dd> - <dt><code>enabled</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Whether this menu item is enabled or disabled. Defaults to <code>true</code>.</dd> - <dt><code>icons</code> {{optional_inline}}</dt> - <dd> - <p><code>object</code>. One or more custom icons to display next to the item. Custom icons can only be set for items appearing in submenus. This property is an object with one property for each supplied icon: the property's name should include the icon's size in pixels, and path is relative to the icon from the extension's root directory. The browser tries to choose a 16x16 pixel icon for a normal display or a 32x32 pixel icon for a high-density display. To avoid any scaling, you can specify icons like this:</p> - - <pre class="brush: json">"icons": { - "16": "path/to/geo-16.png", - "32": "path/to/geo-32.png" - }</pre> - - <p>Alternatively, you can specify a single SVG icon, and it will be scaled appropriately:</p> - - <pre class="brush: json">"icons": { - "16": "path/to/geo.svg" - }</pre> - - <div class="note"> - <p><strong>Note :</strong> The top-level menu item uses the <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/icons">icons</a> specified in the manifest rather than what is specified with this key.</p> - </div> - </dd> - <dt><code>id</code> {{optional_inline}}</dt> - <dd><code>string</code>. The unique ID to assign to this item. Mandatory for event pages. Cannot be the same as another ID for this extension.</dd> - <dt><code>onclick</code> {{optional_inline}}</dt> - <dd><code>function</code>. A function that will be called when the menu item is clicked. Event pages cannot use this: instead, they should register a listener for {{WebExtAPIRef('menus.onClicked')}}.</dd> - <dt><code>parentId</code> {{optional_inline}}</dt> - <dd><code><code>integer</code></code> or <code><code>string</code></code>. The ID of a parent menu item; this makes the item a child of a previously added item. Note: If you have created more than one menu item, then the items will be placed in a submenu. The submenu's parent will be labeled with the name of the extension.</dd> - <dt><code>targetUrlPatterns</code> {{optional_inline}}</dt> - <dd><code>array</code> of <code><code>string</code></code>. Similar to <code>documentUrlPatterns</code>, but lets you filter based on the <code>href</code> of anchor tags and the <code>src</code> attribute of img/audio/video tags. This parameter supports any URL scheme, even those that are usually not allowed in a match pattern.</dd> - <dt><code>title</code> {{optional_inline}}</dt> - <dd> - <p><code>string</code>. The text to be displayed in the item. Mandatory unless <code>type</code> is "separator".</p> - - <p>You can use "<code>%s</code>" in the string. If you do this in a menu item, and some text is selected in the page when the menu is shown, then the selected text will be interpolated into the title. For example, if <code>title</code> is "Translate '%s' to Pig Latin" and the user selects the word "cool", then activates the menu, then the menu item's title will be: "Translate 'cool' to Pig Latin".</p> - - <p>If the title contains an ampersand "&" then the next character will be used as an access key for the item, and the ampersand will not be displayed. Exceptions to this are:</p> - - <ul> - <li>If the next character is also an ampersand: then a single ampersand will be displayed and no access key will be set. In effect, "&&" is used to display a single ampersand.</li> - <li>If the next characters are the interpolation directive "%s": then the ampersand will not be displayed and no access key will be set.</li> - <li>If the ampersand is the last character in the title: then the ampersand will not be displayed and no access key will be set.</li> - </ul> - - <p>Only the first ampersand will be used to set an access key: subsequent ampersands will not be displayed but will not set keys. So "&A and &B" will be shown as "A and B" and set "A" as the access key.</p> - </dd> - <dt><code>type</code> {{optional_inline}}</dt> - <dd><code>{{WebExtAPIRef('menus.ItemType')}}</code>. The type of menu item: "normal", "checkbox", "radio", "separator". Defaults to "normal".</dd> - <dt><code>viewTypes</code> {{optional_inline}}</dt> - <dd><code>{{WebExtAPIRef('extension.ViewType')}}</code>. List of view types where the menu item will be shown. Defaults to any view, including those without a <code>viewType</code>.</dd> - <dt><code>visible</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Whether the item is shown in the menu. Defaults to <code>true</code>.</dd> -</dl> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>{{Compat("webextensions.api.menus.createProperties", 10)}}</p> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> - -<p>This API is based on Chromium's <a href="https://developer.chrome.com/extensions/contextMenus#type-OnClickData"><code>chrome.contextMenus</code></a> API. This documentation is derived from <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> in the Chromium code.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +{{AddonSidebar()}} + +Un `object` passĂ© au mĂ©thodes {{WebExtAPIRef("menus.create()", "menus.create()")}} ou {{WebExtAPIRef("menus.update()", "menus.update()")}}  pour dĂ©crire les propriĂ©tĂ©s de l'Ă©lĂ©ment de menu nouveau ou mis Ă jour. + +- `checked` {{optional_inline}} + - : `boolean`. The initial state of a checkbox or radio item: `true` for selected and `false` for unselected. Only one radio item can be selected at a time in a given group of radio items. +- `command` {{optional_inline}} + + - : `string`. String describing an action that should be taken when the user clicks the item. Possible values are: + + - `"_execute_browser_action"`: simulate a click on the extension's browser action, opening its popup if it has one + - `"_execute_page_action"`: simulate a click on the extension's page action, opening its popup if it has one + - `"_execute_sidebar_action"`: open the extension's sidebar + + Clicking the item will still trigger the {{WebExtAPIRef("menus.onClicked")}} event, but there's no guarantee of the ordering here: the command may be executed before `onClicked` fires. + +- `contexts` {{optional_inline}} + + - : `array` of `{{WebExtAPIRef('menus.ContextType')}}`. Array of contexts in which this menu item will appear. If this option is omitted: + + - if the item's parent has contexts set, then this item will inherit its parent's contexts + - otherwise, the item is given a context array of \["page"]. + +- `documentUrlPatterns` {{optional_inline}} + - : `array` of `string`. Lets you restrict the item to apply only to documents whose URL matches one of the given [match patterns](/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns). This applies to frames as well. +- `enabled` {{optional_inline}} + - : `boolean`. Whether this menu item is enabled or disabled. Defaults to `true`. +- `icons` {{optional_inline}} + + - : `object`. One or more custom icons to display next to the item. Custom icons can only be set for items appearing in submenus. This property is an object with one property for each supplied icon: the property's name should include the icon's size in pixels, and path is relative to the icon from the extension's root directory. The browser tries to choose a 16x16 pixel icon for a normal display or a 32x32 pixel icon for a high-density display. To avoid any scaling, you can specify icons like this: + + ```json + "icons": { + "16": "path/to/geo-16.png", + "32": "path/to/geo-32.png" + } + ``` + + Alternatively, you can specify a single SVG icon, and it will be scaled appropriately: + + ```json + "icons": { + "16": "path/to/geo.svg" + } + ``` + + > **Note :** The top-level menu item uses the [icons](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/icons) specified in the manifest rather than what is specified with this key. + +- `id` {{optional_inline}} + - : `string`. The unique ID to assign to this item. Mandatory for event pages. Cannot be the same as another ID for this extension. +- `onclick` {{optional_inline}} + - : `function`. A function that will be called when the menu item is clicked. Event pages cannot use this: instead, they should register a listener for {{WebExtAPIRef('menus.onClicked')}}. +- `parentId` {{optional_inline}} + - : `integer` or `string`. The ID of a parent menu item; this makes the item a child of a previously added item. Note: If you have created more than one menu item, then the items will be placed in a submenu. The submenu's parent will be labeled with the name of the extension. +- `targetUrlPatterns` {{optional_inline}} + - : `array` of `string`. Similar to `documentUrlPatterns`, but lets you filter based on the `href` of anchor tags and the `src` attribute of img/audio/video tags. This parameter supports any URL scheme, even those that are usually not allowed in a match pattern. +- `title` {{optional_inline}} + + - : `string`. The text to be displayed in the item. Mandatory unless `type` is "separator". + + You can use "`%s`" in the string. If you do this in a menu item, and some text is selected in the page when the menu is shown, then the selected text will be interpolated into the title. For example, if `title` is "Translate '%s' to Pig Latin" and the user selects the word "cool", then activates the menu, then the menu item's title will be: "Translate 'cool' to Pig Latin". + + If the title contains an ampersand "&" then the next character will be used as an access key for the item, and the ampersand will not be displayed. Exceptions to this are: + + - If the next character is also an ampersand: then a single ampersand will be displayed and no access key will be set. In effect, "&&" is used to display a single ampersand. + - If the next characters are the interpolation directive "%s": then the ampersand will not be displayed and no access key will be set. + - If the ampersand is the last character in the title: then the ampersand will not be displayed and no access key will be set. + + Only the first ampersand will be used to set an access key: subsequent ampersands will not be displayed but will not set keys. So "\&A and \&B" will be shown as "A and B" and set "A" as the access key. + +- `type` {{optional_inline}} + - : `{{WebExtAPIRef('menus.ItemType')}}`. The type of menu item: "normal", "checkbox", "radio", "separator". Defaults to "normal". +- `viewTypes` {{optional_inline}} + - : `{{WebExtAPIRef('extension.ViewType')}}`. List of view types where the menu item will be shown. Defaults to any view, including those without a `viewType`. +- `visible` {{optional_inline}} + - : `boolean`. Whether the item is shown in the menu. Defaults to `true`. + +## Browser compatibility + +{{Compat("webextensions.api.menus.createProperties", 10)}} + +{{WebExtExamples}} + +> **Note :** +> +> This API is based on Chromium's [`chrome.contextMenus`](https://developer.chrome.com/extensions/contextMenus#type-OnClickData) API. This documentation is derived from [`context_menus.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json) in the Chromium code. + +<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 @@ -124,5 +116,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/createProperties // 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> +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/gettargetelement/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/gettargetelement/index.md index 3965d1355d..3d4e0d6588 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/gettargetelement/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/gettargetelement/index.md @@ -10,42 +10,37 @@ tags: - menus translation_of: Mozilla/Add-ons/WebExtensions/API/menus/getTargetElement --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Renvoie l'Ă©lĂ©ment pour un <code>targetElementId</code> donnĂ©</p> +Renvoie l'Ă©lĂ©ment pour un `targetElementId` donnĂ© -<p>Cette mĂ©thode est disponible pour tous les contextes de script d'extension (scripts de contenu, pages de fond et autres pages d'extension) et retourne l'Ă©lĂ©ment pour un <code>info.targetElementId</code> donnĂ©e, Ă condition que l'Ă©lĂ©ment existe toujours dans le document oĂč la mĂ©thode est appelĂ©e.</p> +Cette mĂ©thode est disponible pour tous les contextes de script d'extension (scripts de contenu, pages de fond et autres pages d'extension) et retourne l'Ă©lĂ©ment pour un `info.targetElementId` donnĂ©e, Ă condition que l'Ă©lĂ©ment existe toujours dans le document oĂč la mĂ©thode est appelĂ©e. -<p>La mĂ©thode ne fonctionne que dans le document qui inclut l'Ă©lĂ©ment cliquĂ© avec le bouton droit de la souris et la mĂ©thode <code>targetElementId</code> expire lorsque l'utilisateur ouvre un autre menu contextuel.</p> +La mĂ©thode ne fonctionne que dans le document qui inclut l'Ă©lĂ©ment cliquĂ© avec le bouton droit de la souris et la mĂ©thode `targetElementId` expire lorsque l'utilisateur ouvre un autre menu contextuel. -<div class="blockIndicator note"> -<p><strong>Note:</strong> <code>menus.getTargetElement</code> ne retourne l'Ă©lĂ©ment demandĂ© que s'il est appelĂ© dans le mĂȘme contexte que le document qui contient l'Ă©lĂ©ment, par exemple en utilisant des scripts de contenu (comme dans l'exemple ci-dessous).</p> -</div> +> **Note :** `menus.getTargetElement` ne retourne l'Ă©lĂ©ment demandĂ© que s'il est appelĂ© dans le mĂȘme contexte que le document qui contient l'Ă©lĂ©ment, par exemple en utilisant des scripts de contenu (comme dans l'exemple ci-dessous). -<p><br> - Une extension nĂ©cessite la permission "menus" pour utiliser cette API</p> +Une extension nĂ©cessite la permission "menus" pour utiliser cette API -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">let elem = browser.menus.getTargetElement(targetElementId); -</pre> + let elem = browser.menus.getTargetElement(targetElementId); -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>targetElementId</code></dt> - <dd>La propriĂ©tĂ© de l'objet <code>{{WebExtAPIRef("menus.OnClickData")}}</code> passĂ© au gestionnaire <code>{{WebExtAPIRef("menus.onClicked")}}</code>ou Ă l'Ă©vĂ©nement <code>{{WebExtAPIRef("menus.onShown")}}</code>.</dd> -</dl> +- `targetElementId` + - : La propriĂ©tĂ© de l'objet `{{WebExtAPIRef("menus.OnClickData")}}` passĂ© au gestionnaire `{{WebExtAPIRef("menus.onClicked")}}`ou Ă l'Ă©vĂ©nement `{{WebExtAPIRef("menus.onShown")}}`. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p>L'Ă©lĂ©ment auquel se rĂ©fĂšre le paramĂštre <code>targetElementId</code>. Si le paramĂštre <code>targetElementId</code> n'est pas valide, La mĂ©thode retourne <code>null</code>.</p> +L'Ă©lĂ©ment auquel se rĂ©fĂšre le paramĂštre `targetElementId`. Si le paramĂštre `targetElementId` n'est pas valide, La mĂ©thode retourne `null`. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>L'exemple suivant utilise la mĂ©thode <code>getTargetElement</code> pour obtenir l'Ă©lĂ©ment auquel se rĂ©fĂšre la propriĂ©tĂ© <code>info.targetElementId</code> puis le supprime.</p> +L'exemple suivant utilise la mĂ©thode `getTargetElement` pour obtenir l'Ă©lĂ©ment auquel se rĂ©fĂšre la propriĂ©tĂ© `info.targetElementId` puis le supprime. -<pre class="brush: js">browser.menus.create({ +```js +browser.menus.create({ title: "Remove element", documentUrlPatterns: ["*://*/*"], contexts: ["audio", "editable", "frame", "image", "link", "page", "password", "video"], @@ -56,19 +51,15 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/getTargetElement }); }, }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.menus.getTargetElement")}} +## voir aussi -<p>{{Compat("webextensions.api.menus.getTargetElement")}}</p> - -<h2 id="voir_aussi">voir aussi</h2> - -<ul> - <li>{{WebExtAPIRef("menus.create")}}</li> - <li>{{WebExtAPIRef("menus.OnClickData")}}</li> -</ul> +- {{WebExtAPIRef("menus.create")}} +- {{WebExtAPIRef("menus.OnClickData")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/index.md index d6bfc9eebc..379ac32a31 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/index.md @@ -13,54 +13,53 @@ tags: - menus translation_of: Mozilla/Add-ons/WebExtensions/API/menus --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Ajoutez des Ă©lĂ©ments au systĂšme de menus du navigateur.</p> +Ajoutez des Ă©lĂ©ments au systĂšme de menus du navigateur. -<p>Cette API est modĂ©lisĂ©e dans l'API <a href="https://developer.chrome.com/extensions/contextMenus">"contextMenus"</a> de Chrome, qui permet aux extensions Chrome d'ajouter des Ă©lĂ©ments au menu contextuel du navigateur. L'API <code>browser.menus</code> ajoute quelques fonctionnalitĂ©s Ă l'API de Chrome.</p> +Cette API est modĂ©lisĂ©e dans l'API ["contextMenus"](https://developer.chrome.com/extensions/contextMenus) de Chrome, qui permet aux extensions Chrome d'ajouter des Ă©lĂ©ments au menu contextuel du navigateur. L'API `browser.menus` ajoute quelques fonctionnalitĂ©s Ă l'API de Chrome. -<p>Avant Firefox 55, cette API s'appelait Ă l'origine <code>contextMenus</code>, et ce nom a Ă©tĂ© retenu comme alias. Vous pouvez donc utiliser <code>contextMenus</code> pour Ă©crire du code qui fonctionne dans Firefox et dans d'autres navigateurs.</p> +Avant Firefox 55, cette API s'appelait Ă l'origine `contextMenus`, et ce nom a Ă©tĂ© retenu comme alias. Vous pouvez donc utiliser `contextMenus` pour Ă©crire du code qui fonctionne dans Firefox et dans d'autres navigateurs. -<p>Pour utiliser cette API, vous devez avoir la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> des <code>menus.</code> vous pouvez Ă©galement utiliser l'alias <code>contextMenus</code> Ă la place des <code>menus</code>, mais si vous le faites, vous devez accĂ©der aux API sous le nom <code>browser.contextMenus</code> Ă la place.</p> +Pour utiliser cette API, vous devez avoir la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) des `menus.` vous pouvez Ă©galement utiliser l'alias `contextMenus` Ă la place des `menus`, mais si vous le faites, vous devez accĂ©der aux API sous le nom `browser.contextMenus` Ă la place. -<p>ExceptĂ© que <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/menus/getTargetElement">menus.getTargetElement()</a></code>, cette API ne peut pas ĂȘtre utilisĂ©e Ă partir de scripts de contenu.</p> +ExceptĂ© que [`menus.getTargetElement()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/menus/getTargetElement), cette API ne peut pas ĂȘtre utilisĂ©e Ă partir de scripts de contenu. -<h2 id="CrĂ©er_des_Ă©lĂ©ments_de_menu">CrĂ©er des Ă©lĂ©ments de menu</h2> +## CrĂ©er des Ă©lĂ©ments de menu -<p>Pour crĂ©er un Ă©lĂ©ment de menu, appelez la mĂ©thode {{WebExtAPIRef("menus.create()")}}. Vous transmettez Ă cette mĂ©thode un objet contenant des options pour l'Ă©lĂ©ment, y compris l'ID d'Ă©lĂ©ment, le type d'Ă©lĂ©ment et les contextes dans lesquels il doit ĂȘtre affichĂ©.</p> +Pour crĂ©er un Ă©lĂ©ment de menu, appelez la mĂ©thode {{WebExtAPIRef("menus.create()")}}. Vous transmettez Ă cette mĂ©thode un objet contenant des options pour l'Ă©lĂ©ment, y compris l'ID d'Ă©lĂ©ment, le type d'Ă©lĂ©ment et les contextes dans lesquels il doit ĂȘtre affichĂ©. -<p>Ăcoutez les clics sur votre Ă©lĂ©ment de menu en ajoutant un Ă©couteur Ă l'Ă©vĂ©nement {{WebExtAPIRef("menus.onClicked")}}. Cet Ă©couteur recevra un objet {{WebExtAPIRef("menus.OnClickData")}} contenant les dĂ©tails de l'Ă©vĂ©nement.</p> +Ăcoutez les clics sur votre Ă©lĂ©ment de menu en ajoutant un Ă©couteur Ă l'Ă©vĂ©nement {{WebExtAPIRef("menus.onClicked")}}. Cet Ă©couteur recevra un objet {{WebExtAPIRef("menus.OnClickData")}} contenant les dĂ©tails de l'Ă©vĂ©nement. -<p>Vous pouvez crĂ©er quatre types diffĂ©rents d'Ă©lĂ©ment de menu, en fonction de la valeur de la propriĂ©tĂ© <code>type</code> que vous fournissez dans les options de <code>create()</code>:</p> +Vous pouvez crĂ©er quatre types diffĂ©rents d'Ă©lĂ©ment de menu, en fonction de la valeur de la propriĂ©tĂ© `type` que vous fournissez dans les options de `create()`: -<ul> - <li>"normal": un Ă©lĂ©ment de menu qui affiche simplement une Ă©tiquette</li> - <li>"checkbox": un Ă©lĂ©ment de menu qui reprĂ©sente un Ă©tat binaire. Il affiche une coche Ă cĂŽtĂ© de l'Ă©tiquette. Cliquez sur l'Ă©lĂ©ment pour activer la case. L'Ă©couteur de clic recevra deux propriĂ©tĂ©s supplĂ©mentaires : "checked",indiquant si l'Ă©lĂ©ment est vĂ©rifiĂ© maintenant, et "wasChecked", indiquant si l'Ă©lĂ©ment a Ă©tĂ© vĂ©rifiĂ© avant l'Ă©vĂ©nement click.</li> - <li>"radio": un Ă©lĂ©ment de menu qui reprĂ©sente l'un des groupes de choix. Tout comme une case Ă cocher, cela affiche Ă©galement une coche Ă cĂŽtĂ© de l'Ă©tiquette, et son Ă©couteur de clic est passĂ© "checked" et "wasChecked". Cependant, si vous crĂ©ez plus d'un Ă©lĂ©ment radio, les Ă©lĂ©ments fonctionnent comme un groupe d'Ă©lĂ©ments radio: un seul Ă©lĂ©ment du groupe peut ĂȘtre vĂ©rifiĂ©, et cliquer sur un Ă©lĂ©ment en fait l'Ă©lĂ©ment sĂ©lectionnĂ©.</li> - <li>"separateur": une ligne sĂ©parant un groupe d'Ă©lĂ©ments.</li> -</ul> +- "normal": un Ă©lĂ©ment de menu qui affiche simplement une Ă©tiquette +- "checkbox": un Ă©lĂ©ment de menu qui reprĂ©sente un Ă©tat binaire. Il affiche une coche Ă cĂŽtĂ© de l'Ă©tiquette. Cliquez sur l'Ă©lĂ©ment pour activer la case. L'Ă©couteur de clic recevra deux propriĂ©tĂ©s supplĂ©mentaires : "checked",indiquant si l'Ă©lĂ©ment est vĂ©rifiĂ© maintenant, et "wasChecked", indiquant si l'Ă©lĂ©ment a Ă©tĂ© vĂ©rifiĂ© avant l'Ă©vĂ©nement click. +- "radio": un Ă©lĂ©ment de menu qui reprĂ©sente l'un des groupes de choix. Tout comme une case Ă cocher, cela affiche Ă©galement une coche Ă cĂŽtĂ© de l'Ă©tiquette, et son Ă©couteur de clic est passĂ© "checked" et "wasChecked". Cependant, si vous crĂ©ez plus d'un Ă©lĂ©ment radio, les Ă©lĂ©ments fonctionnent comme un groupe d'Ă©lĂ©ments radio: un seul Ă©lĂ©ment du groupe peut ĂȘtre vĂ©rifiĂ©, et cliquer sur un Ă©lĂ©ment en fait l'Ă©lĂ©ment sĂ©lectionnĂ©. +- "separateur": une ligne sĂ©parant un groupe d'Ă©lĂ©ments. -<p>Si vous avez crĂ©Ă© plus d'un Ă©lĂ©ment de menu contextuel ou plus d'un Ă©lĂ©ment de menu d'outils, les Ă©lĂ©ments seront placĂ©s dans un sous-menu. Le parent du sous-menu sera Ă©tiquetĂ© avec le nom de l'extension. Par exemple, voici une extension appelĂ©e "Menu dĂ©mo" qui ajoute deux Ă©lĂ©ments de menu contextuel:</p> +Si vous avez crĂ©Ă© plus d'un Ă©lĂ©ment de menu contextuel ou plus d'un Ă©lĂ©ment de menu d'outils, les Ă©lĂ©ments seront placĂ©s dans un sous-menu. Le parent du sous-menu sera Ă©tiquetĂ© avec le nom de l'extension. Par exemple, voici une extension appelĂ©e "Menu dĂ©mo" qui ajoute deux Ă©lĂ©ments de menu contextuel: -<p><img alt="" src="menus-1.png"></p> +![](menus-1.png) -<h2 id="IcĂŽnes">IcĂŽnes</h2> +## IcĂŽnes -<p>Si vous avez spĂ©cifiĂ© des icĂŽnes pour votre extension Ă l'aide de la <a href="/fr/Add-ons/WebExtensions/manifest.json/icons">clĂ© de manifest "icons"</a>, votre Ă©lĂ©ment de menu affichera l'icĂŽne spĂ©cifiĂ©e Ă cĂŽtĂ© de son libellĂ©. Le navigateur va essayer de choisir une icĂŽne de 16x16 pixels pour un affichage normal ou une icĂŽne de 32x32 pixels pour un affichage haute dĂ©finition :</p> +Si vous avez spĂ©cifiĂ© des icĂŽnes pour votre extension Ă l'aide de la [clĂ© de manifest "icons"](/fr/Add-ons/WebExtensions/manifest.json/icons), votre Ă©lĂ©ment de menu affichera l'icĂŽne spĂ©cifiĂ©e Ă cĂŽtĂ© de son libellĂ©. Le navigateur va essayer de choisir une icĂŽne de 16x16 pixels pour un affichage normal ou une icĂŽne de 32x32 pixels pour un affichage haute dĂ©finition : -<p><img alt="" src="menus-2.png"></p> +![](menus-2.png) -<p>Uniquement pour les Ă©lĂ©ments d'un sous-menu, vous pouvez spĂ©cifier des icĂŽnes personnalisĂ©es en passant l'option <code>icons</code> Ă {{WebExtAPIRef("menus.create()")}} :</p> +Uniquement pour les Ă©lĂ©ments d'un sous-menu, vous pouvez spĂ©cifier des icĂŽnes personnalisĂ©es en passant l'option `icons` Ă {{WebExtAPIRef("menus.create()")}} : -<p><img alt="" src="menus-3.png"></p> +![](menus-3.png) -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>Voici un menu contextuel contenant 4 Ă©lĂ©ments: un Ă©lĂ©ment normal, deux Ă©lĂ©ments radio avec des sĂ©parateurs de chaque cĂŽtĂ© et une case Ă cocher. Les Ă©lĂ©ments radio sont dotĂ©s d'icĂŽnes personnalisĂ©es.</p> +Voici un menu contextuel contenant 4 Ă©lĂ©ments: un Ă©lĂ©ment normal, deux Ă©lĂ©ments radio avec des sĂ©parateurs de chaque cĂŽtĂ© et une case Ă cocher. Les Ă©lĂ©ments radio sont dotĂ©s d'icĂŽnes personnalisĂ©es. -<p><img alt="" src="menus-4.png">Vous pouvez crĂ©er un sous-menu comme celui-ci en utilisant du code comme :</p> +![](menus-4.png)Vous pouvez crĂ©er un sous-menu comme celui-ci en utilisant du code comme : -<pre class="brush: js">browser.menus.create({ +```js +browser.menus.create({ id: "remove-me", title: browser.i18n.getMessage("menuItemRemoveMe"), contexts: ["all"] @@ -110,69 +109,60 @@ browser.menus.create({ title: browser.i18n.getMessage("menuItemUncheckMe"), contexts: ["all"], checked: checkedState -}, onCreated);</pre> - -<h2 id="Types">Types</h2> - -<dl> - <dt>{{WebExtAPIRef("menus.ContextType")}}</dt> - <dd>Les diffĂ©rents contextes dans lesquels un menu peut apparaĂźtre.</dd> - <dt>{{WebExtAPIRef("menus.ItemType")}}</dt> - <dd>Le type d'Ă©lĂ©ment de menu : "normal", "checkbox", "radio", "separator".</dd> - <dt>{{WebExtAPIRef("menus.OnClickData")}}</dt> - <dd>Informations envoyĂ©es lorsqu'un Ă©lĂ©ment de menu est cliquĂ©.</dd> -</dl> - -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> - -<dl> - <dt>{{WebExtAPIRef("menus.ACTION_MENU_TOP_LEVEL_LIMIT")}}</dt> - <dd>Le nombre maximal d'Ă©lĂ©ments d'extension de niveau supĂ©rieur pouvant ĂȘtre ajoutĂ©s Ă un Ă©lĂ©ment de menu dont le type de contexte est "browser_action" ou "page_action".</dd> -</dl> - -<h2 id="Functions">Functions</h2> - -<dl> - <dt>{{WebExtAPIRef("menus.create()")}}</dt> - <dd>CrĂ©e un nouvel Ă©lĂ©ment de menu.</dd> - <dt>{{WebExtApiRef("menus.getTargetElement()")}}</dt> - <dd>Retourne l'Ă©lĂ©ment pour un <code>info.targetElementId</code> donnĂ©</dd> - <dt>{{WebExtApiRef("menus.overrideContext()")}}</dt> - <dd>Masquer tous les Ă©lĂ©ments de menu par dĂ©faut de Firefox en faveur d'une interface utilisateur de menu contextuel personnalisĂ©.</dd> - <dt>{{WebExtAPIRef("menus.refresh()")}}</dt> - <dd>Mettre Ă jour un menu actuellement affichĂ©.</dd> - <dt>{{WebExtAPIRef("menus.remove()")}}</dt> - <dd>Supprime un Ă©lĂ©ment de menu.</dd> - <dt>{{WebExtAPIRef("menus.removeAll()")}}</dt> - <dd>Supprime tous les Ă©lĂ©ments de menu ajoutĂ©s par cette extension.</dd> - <dt>{{WebExtAPIRef("menus.update()")}}</dt> - <dd>Met Ă jour un Ă©lĂ©ment de menu prĂ©cĂ©demment crĂ©Ă©.</dd> -</dl> - -<h2 id="EvĂ©nements">EvĂ©nements</h2> - -<dl> - <dt>{{WebExtAPIRef("menus.onClicked")}}</dt> - <dd>LancĂ© lorsqu'un Ă©lĂ©ment de menu est cliquĂ©.</dd> - <dt>{{WebExtAPIRef("menus.onHidden")}}</dt> - <dd>LancĂ© lorsque le navigateur cache un menu.</dd> - <dt>{{WebExtAPIRef("menus.onShown")}}</dt> - <dd>LancĂ© lorsque le navigateur affiche un menu.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{ Compat("webextensions.api.menus", 1, "true") }}</p> - -<p>{{WebExtExamples("h2")}}</p> - -<div class="note"><p><strong>Note :</strong></p> - -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +}, onCreated); +``` + +## Types + +- {{WebExtAPIRef("menus.ContextType")}} + - : Les diffĂ©rents contextes dans lesquels un menu peut apparaĂźtre. +- {{WebExtAPIRef("menus.ItemType")}} + - : Le type d'Ă©lĂ©ment de menu : "normal", "checkbox", "radio", "separator". +- {{WebExtAPIRef("menus.OnClickData")}} + - : Informations envoyĂ©es lorsqu'un Ă©lĂ©ment de menu est cliquĂ©. + +## PropriĂ©tĂ©s + +- {{WebExtAPIRef("menus.ACTION_MENU_TOP_LEVEL_LIMIT")}} + - : Le nombre maximal d'Ă©lĂ©ments d'extension de niveau supĂ©rieur pouvant ĂȘtre ajoutĂ©s Ă un Ă©lĂ©ment de menu dont le type de contexte est "browser_action" ou "page_action". + +## Functions + +- {{WebExtAPIRef("menus.create()")}} + - : CrĂ©e un nouvel Ă©lĂ©ment de menu. +- {{WebExtApiRef("menus.getTargetElement()")}} + - : Retourne l'Ă©lĂ©ment pour un `info.targetElementId` donnĂ© +- {{WebExtApiRef("menus.overrideContext()")}} + - : Masquer tous les Ă©lĂ©ments de menu par dĂ©faut de Firefox en faveur d'une interface utilisateur de menu contextuel personnalisĂ©. +- {{WebExtAPIRef("menus.refresh()")}} + - : Mettre Ă jour un menu actuellement affichĂ©. +- {{WebExtAPIRef("menus.remove()")}} + - : Supprime un Ă©lĂ©ment de menu. +- {{WebExtAPIRef("menus.removeAll()")}} + - : Supprime tous les Ă©lĂ©ments de menu ajoutĂ©s par cette extension. +- {{WebExtAPIRef("menus.update()")}} + - : Met Ă jour un Ă©lĂ©ment de menu prĂ©cĂ©demment crĂ©Ă©. + +## EvĂ©nements + +- {{WebExtAPIRef("menus.onClicked")}} + - : LancĂ© lorsqu'un Ă©lĂ©ment de menu est cliquĂ©. +- {{WebExtAPIRef("menus.onHidden")}} + - : LancĂ© lorsque le navigateur cache un menu. +- {{WebExtAPIRef("menus.onShown")}} + - : LancĂ© lorsque le navigateur affiche un menu. + +## CompatibilitĂ© du navigateur + +{{ Compat("webextensions.api.menus", 1, "true") }} + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.contextMenus`](https://developer.chrome.com/extensions/contextMenus) de chromium. Cette documentation est dĂ©rivĂ©e de [`context_menus.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json) dans le code Chromium. + +<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 @@ -199,5 +189,4 @@ browser.menus.create({ // 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/menus/itemtype/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/itemtype/index.md index 070bc6a36a..6d0292a863 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/itemtype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/itemtype/index.md @@ -13,42 +13,34 @@ tags: - itemtype translation_of: Mozilla/Add-ons/WebExtensions/API/menus/ItemType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type d'Ă©lĂ©ment de menu.</p> +Le type d'Ă©lĂ©ment de menu. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont:</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont: -<dl> - <dt>normal</dt> - <dd>Un Ă©lĂ©ment de menu qui affiche simplement une Ă©tiquette.</dd> - <dt>checkbox</dt> - <dd> - <p>Un Ă©lĂ©ment de menu qui reprĂ©sente un Ă©tat binaire. Il affiche une coche Ă cĂŽtĂ© de l'Ă©tiquette. Cliquez sur l'Ă©lĂ©ment pour activer la coche. L'Ă©couteur  {{WebExtAPIRef("menus.onClicked")}} recevra deux propriĂ©tĂ©s supplĂ©mentaires : "checked", indiquant si l'Ă©lĂ©ment est vĂ©rifiĂ© maintenant, et "wasChecked", indiquant si l'Ă©lĂ©ment a Ă©tĂ© vĂ©rifiĂ© avant l'Ă©vĂ©nement click.</p> - </dd> - <dt>radio</dt> - <dd> - <p>Un Ă©lĂ©ment de menu qui reprĂ©sente l'un des groupes de choix. Tout comme une case Ă cocher, cela affiche Ă©galement une coche Ă cĂŽtĂ© de l'Ă©tiquette, et son Ă©couteur {{WebExtAPIRef("menus.onClicked")}} est passĂ© "checked" et "wasChecked". However, Cependant, si vous crĂ©ez plus d'un Ă©lĂ©ment radio, les Ă©lĂ©ments fonctionnent comme un groupe d'Ă©lĂ©ments radio items: un seul Ă©lĂ©ment du groupe peut ĂȘtre vĂ©rifiĂ©, et cliquer sur un Ă©lĂ©ment en fait l'Ă©lĂ©ment sĂ©lectionnĂ©.</p> - </dd> - <dt>separator</dt> - <dd>Une ligne sĂ©parant un groupe d'Ă©lĂ©ments.</dd> -</dl> +- normal + - : Un Ă©lĂ©ment de menu qui affiche simplement une Ă©tiquette. +- checkbox + - : Un Ă©lĂ©ment de menu qui reprĂ©sente un Ă©tat binaire. Il affiche une coche Ă cĂŽtĂ© de l'Ă©tiquette. Cliquez sur l'Ă©lĂ©ment pour activer la coche. L'Ă©couteur  {{WebExtAPIRef("menus.onClicked")}} recevra deux propriĂ©tĂ©s supplĂ©mentaires : "checked", indiquant si l'Ă©lĂ©ment est vĂ©rifiĂ© maintenant, et "wasChecked", indiquant si l'Ă©lĂ©ment a Ă©tĂ© vĂ©rifiĂ© avant l'Ă©vĂ©nement click. +- radio + - : Un Ă©lĂ©ment de menu qui reprĂ©sente l'un des groupes de choix. Tout comme une case Ă cocher, cela affiche Ă©galement une coche Ă cĂŽtĂ© de l'Ă©tiquette, et son Ă©couteur {{WebExtAPIRef("menus.onClicked")}} est passĂ© "checked" et "wasChecked". However, Cependant, si vous crĂ©ez plus d'un Ă©lĂ©ment radio, les Ă©lĂ©ments fonctionnent comme un groupe d'Ă©lĂ©ments radio items: un seul Ă©lĂ©ment du groupe peut ĂȘtre vĂ©rifiĂ©, et cliquer sur un Ă©lĂ©ment en fait l'Ă©lĂ©ment sĂ©lectionnĂ©. +- separator + - : Une ligne sĂ©parant un groupe d'Ă©lĂ©ments. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.menus.ItemType", 10)}}</p> +{{Compat("webextensions.api.menus.ItemType", 10)}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.contextMenus`](https://developer.chrome.com/extensions/contextMenus) de chromium. Cette documentation est dĂ©rivĂ©e de [`context_menus.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json) dans le code Chromium. -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</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 @@ -75,5 +67,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/ItemType // 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/menus/onclickdata/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/onclickdata/index.md index a0385e964c..b4502ddcbd 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/onclickdata/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/onclickdata/index.md @@ -13,66 +13,62 @@ tags: - contextMenus translation_of: Mozilla/Add-ons/WebExtensions/API/menus/OnClickData --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Informations transmises Ă l'Ă©couteur d'Ă©vĂ©nement {{WebExtAPIRef("menus.onClicked")}} lorsque vous cliquez sur un Ă©lĂ©ment de menu.</p> +Informations transmises Ă l'Ă©couteur d'Ă©vĂ©nement {{WebExtAPIRef("menus.onClicked")}} lorsque vous cliquez sur un Ă©lĂ©ment de menu. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>bookmarkId</code> {{optional_inline}}</dt> - <dd><code>string</code>. L'ID du signet dans lequel le menu contextuel a Ă©tĂ© cliquĂ©.***</dd> - <dt><code>button</code> {{optional_inline}}</dt> - <dd><code>integer</code>. Quel bouton de la souris a Ă©tĂ© enfoncĂ©. Les valeurs sont les mĂȘmes que pour <a href="/fr/docs/Web/API/MouseEvent/button"><code>MouseEvent.button</code></a>.</dd> - <dt><code>checked</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Un <em>flag</em> indiquant si une case Ă cocher ou un Ă©lĂ©ment radio a Ă©tĂ© vĂ©rifiĂ© aprĂšs avoir Ă©tĂ© cliquĂ©.</dd> - <dt><code>editable</code></dt> - <dd><code>boolean</code>. Un indicateur indiquant si l'Ă©lĂ©ment est modifiable: par exemple, s'il s'agit d'un <a href="/fr/docs/Web/HTML/Element/textarea">textarea</a>.</dd> - <dt><code>frameId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'image dans laquelle l'Ă©lĂ©ment a Ă©tĂ© cliquĂ©. L'ID de trame peut ĂȘtre utilisĂ© dans d'autres API acceptant des ID de trame, tels que {{WebExtAPIRef("tabs.sendMessage()")}}. Si l'Ă©lĂ©ment a Ă©tĂ© cliquĂ© dans le document de niveau supĂ©rieur,par exemple, dans <code>tools_menu</code> ou <code>tab</code> context), <code>frameId</code> n'est <code>pas dĂ©fini</code>.</dd> - <dt><code>frameUrl</code> {{optional_inline}}</dt> - <dd><code>string</code>. L'URL du cadre de l'Ă©lĂ©ment sur lequel le menu contextuel a Ă©tĂ© cliquĂ©, s'il Ă©tait dans un cadre</dd> - <dt><code>linkText</code> {{optional_inline}}</dt> - <dd><code>string</code>. Si l'Ă©lĂ©ment est un lien, le texte du lien. Si le lien ne contient aucun texte, l'URL elle-mĂȘme est donnĂ©e ici.</dd> - <dt><code>linkUrl </code>{{optional_inline}}</dt> - <dd><code>string</code>. Si l'Ă©lĂ©ment est un lien, l'URL vers laquelle il pointe.</dd> - <dt><code>mediaType</code> {{optional_inline}}</dt> - <dd><code>string</code>. Une de "image", "video", ou "audio" si le menu contextuel a Ă©tĂ© activĂ© sur l'un de ces types d'Ă©lĂ©ments.</dd> - <dt><code>menuItemId</code></dt> - <dd><code><code>integer</code></code> ou <code><code>string</code></code>. ID de l'Ă©lĂ©ment de menu sur lequel vous avez cliquĂ©.</dd> - <dt><code>modifiers</code></dt> - <dd><code><code>Array</code></code> de<code><code>string</code></code>. Un tableau contenant toutes les touches de modification qui ont Ă©tĂ© pressĂ©es lorsque l'Ă©lĂ©ment a Ă©tĂ© cliquĂ©. Les valeurs possibles sont : "Alt", "Command", "Ctrl", "MacCtrl", et "Shift". Sur un Mac, si l'utilisateur a la touche Ctrl enfoncĂ©e, alors "Ctrl" et "MacCtrl" sont inclus.</dd> - <dt><code>pageUrl</code> {{optional_inline}}</dt> - <dd><code>string</code>. L'URL de la page sur laquelle l'Ă©lĂ©ment de menu a Ă©tĂ© cliquĂ©. Cette propriĂ©tĂ© n'est pas prĂ©sente si le clic s'est produit dans un contexte oĂč il n'y a pas de page en cours, comme dans le cas d'une action du navigateur.</dd> - <dt><code>parentMenuItemId</code> {{optional_inline}}</dt> - <dd><code><code>integer</code></code> ou <code><code>string</code></code>. L'ID parent, le cas Ă©chĂ©ant, pour l'Ă©lĂ©ment cliquĂ©.</dd> - <dt><code>selectionText </code>{{optional_inline}}</dt> - <dd><code>string</code>. Si du texte a Ă©tĂ© sĂ©lectionnĂ© dans la page, il contient le texte sĂ©lectionnĂ©.</dd> - <dt><code>srcUrl</code> {{optional_inline}}</dt> - <dd><code>string</code>. Sera prĂ©sent pour les Ă©lĂ©ments avec une URL "src".</dd> - <dt><code>targetElementId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Un identificateur de l'Ă©lĂ©ment, le cas Ă©chĂ©ant, sur lequel le menu contextuel a Ă©tĂ© crĂ©Ă©. Utilisez {{WebExtAPIRef("menus.getTargetElement()")}} dans le script de contenu pour localiser l'Ă©lĂ©ment. Notez que ce n'est pas l'attribut <a href="/fr/docs/Web/HTML/Attributs_universels/id">id</a> de l'Ă©lĂ©ment page.</dd> - <dt><code>viewType</code> {{optional_inline}}</dt> - <dd>{{WebExtAPIRef("extension.ViewType", "ViewType")}}. Le type de vue de l'extension.</dd> - <dt><code>wasChecked</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Un indicateur indiquant si une case Ă cocher ou un Ă©lĂ©ment radio a Ă©tĂ© vĂ©rifiĂ© avant d'avoir cliquĂ©.</dd> -</dl> +- `bookmarkId` {{optional_inline}} + - : `string`. L'ID du signet dans lequel le menu contextuel a Ă©tĂ© cliquĂ©.\*\*\* +- `button` {{optional_inline}} + - : `integer`. Quel bouton de la souris a Ă©tĂ© enfoncĂ©. Les valeurs sont les mĂȘmes que pour [`MouseEvent.button`](/fr/docs/Web/API/MouseEvent/button). +- `checked` {{optional_inline}} + - : `boolean`. Un _flag_ indiquant si une case Ă cocher ou un Ă©lĂ©ment radio a Ă©tĂ© vĂ©rifiĂ© aprĂšs avoir Ă©tĂ© cliquĂ©. +- `editable` + - : `boolean`. Un indicateur indiquant si l'Ă©lĂ©ment est modifiable: par exemple, s'il s'agit d'un [textarea](/fr/docs/Web/HTML/Element/textarea). +- `frameId` {{optional_inline}} + - : `integer`. L'ID de l'image dans laquelle l'Ă©lĂ©ment a Ă©tĂ© cliquĂ©. L'ID de trame peut ĂȘtre utilisĂ© dans d'autres API acceptant des ID de trame, tels que {{WebExtAPIRef("tabs.sendMessage()")}}. Si l'Ă©lĂ©ment a Ă©tĂ© cliquĂ© dans le document de niveau supĂ©rieur,par exemple, dans `tools_menu` ou `tab` context), `frameId` n'est `pas dĂ©fini`. +- `frameUrl` {{optional_inline}} + - : `string`. L'URL du cadre de l'Ă©lĂ©ment sur lequel le menu contextuel a Ă©tĂ© cliquĂ©, s'il Ă©tait dans un cadre +- `linkText` {{optional_inline}} + - : `string`. Si l'Ă©lĂ©ment est un lien, le texte du lien. Si le lien ne contient aucun texte, l'URL elle-mĂȘme est donnĂ©e ici. +- `linkUrl `{{optional_inline}} + - : `string`. Si l'Ă©lĂ©ment est un lien, l'URL vers laquelle il pointe. +- `mediaType` {{optional_inline}} + - : `string`. Une de "image", "video", ou "audio" si le menu contextuel a Ă©tĂ© activĂ© sur l'un de ces types d'Ă©lĂ©ments. +- `menuItemId` + - : `integer` ou `string`. ID de l'Ă©lĂ©ment de menu sur lequel vous avez cliquĂ©. +- `modifiers` + - : `Array` de`string`. Un tableau contenant toutes les touches de modification qui ont Ă©tĂ© pressĂ©es lorsque l'Ă©lĂ©ment a Ă©tĂ© cliquĂ©. Les valeurs possibles sont : "Alt", "Command", "Ctrl", "MacCtrl", et "Shift". Sur un Mac, si l'utilisateur a la touche Ctrl enfoncĂ©e, alors "Ctrl" et "MacCtrl" sont inclus. +- `pageUrl` {{optional_inline}} + - : `string`. L'URL de la page sur laquelle l'Ă©lĂ©ment de menu a Ă©tĂ© cliquĂ©. Cette propriĂ©tĂ© n'est pas prĂ©sente si le clic s'est produit dans un contexte oĂč il n'y a pas de page en cours, comme dans le cas d'une action du navigateur. +- `parentMenuItemId` {{optional_inline}} + - : `integer` ou `string`. L'ID parent, le cas Ă©chĂ©ant, pour l'Ă©lĂ©ment cliquĂ©. +- `selectionText `{{optional_inline}} + - : `string`. Si du texte a Ă©tĂ© sĂ©lectionnĂ© dans la page, il contient le texte sĂ©lectionnĂ©. +- `srcUrl` {{optional_inline}} + - : `string`. Sera prĂ©sent pour les Ă©lĂ©ments avec une URL "src". +- `targetElementId`{{optional_inline}} + - : `integer`. Un identificateur de l'Ă©lĂ©ment, le cas Ă©chĂ©ant, sur lequel le menu contextuel a Ă©tĂ© crĂ©Ă©. Utilisez {{WebExtAPIRef("menus.getTargetElement()")}} dans le script de contenu pour localiser l'Ă©lĂ©ment. Notez que ce n'est pas l'attribut [id](/fr/docs/Web/HTML/Attributs_universels/id) de l'Ă©lĂ©ment page. +- `viewType` {{optional_inline}} + - : {{WebExtAPIRef("extension.ViewType", "ViewType")}}. Le type de vue de l'extension. +- `wasChecked` {{optional_inline}} + - : `boolean`. Un indicateur indiquant si une case Ă cocher ou un Ă©lĂ©ment radio a Ă©tĂ© vĂ©rifiĂ© avant d'avoir cliquĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.menus.OnClickData", 10)}}</p> +{{Compat("webextensions.api.menus.OnClickData", 10)}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.contextMenus`](https://developer.chrome.com/extensions/contextMenus) de chromium. Cette documentation est dĂ©rivĂ©e de [`context_menus.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json) dans le code Chromium. -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</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 +95,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/menus/OnClickData // 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/menus/onclicked/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/onclicked/index.md index df69d648c9..f44a22a151 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/onclicked/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/onclicked/index.md @@ -13,79 +13,73 @@ tags: - onClicked translation_of: Mozilla/Add-ons/WebExtensions/API/menus/onClicked --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'un Ă©lĂ©ment de menu est cliquĂ©.</p> +LancĂ© lorsqu'un Ă©lĂ©ment de menu est cliquĂ©. -<p>Pour la compatibilitĂ© avec les autres navigateurs, Firefox rend cet Ă©vĂ©nement disponible via l'espace de noms <code>contextMenus</code> ainsi que l'espace de noms des <code>menus</code>.</p> +Pour la compatibilitĂ© avec les autres navigateurs, Firefox rend cet Ă©vĂ©nement disponible via l'espace de noms `contextMenus` ainsi que l'espace de noms des `menus`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.menus.onClicked.addListener(listener) +```js +browser.menus.onClicked.addListener(listener) browser.menus.onClicked.removeListener(listener) browser.menus.onClicked.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>info</code></dt> - <dd>{{WebExtAPIRef('menus.OnClickData')}}. Informations sur l'Ă©lĂ©ment cliquĂ© et le contexte dans lequel le clic s'est produit.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>tab</code></dt> - <dd>{{WebExtAPIRef('tabs.Tab')}}. Les dĂ©tails de l'onglet oĂč le clic a eu lieu. Si le clic n'a pas eu lieu dans ou sur un onglet, ce paramĂštre sera manquant.</dd> - </dl> - </dd> -</dl> + - `info` + - : {{WebExtAPIRef('menus.OnClickData')}}. Informations sur l'Ă©lĂ©ment cliquĂ© et le contexte dans lequel le clic s'est produit. -<h2 id="CompatibiltĂ©_du_navigateur">CompatibiltĂ© du navigateur</h2> + <!----> -<p>{{Compat("webextensions.api.menus.onClicked", 10)}}</p> + - `tab` + - : {{WebExtAPIRef('tabs.Tab')}}. Les dĂ©tails de l'onglet oĂč le clic a eu lieu. Si le clic n'a pas eu lieu dans ou sur un onglet, ce paramĂštre sera manquant. -<h2 id="Exemples">Exemples</h2> +## CompatibiltĂ© du navigateur -<p>Cet exemple Ă©coute les clics sur un Ă©lĂ©ment de menu, puis enregistre l'ID de l'Ă©lĂ©ment et l'ID de l'onglet :</p> +{{Compat("webextensions.api.menus.onClicked", 10)}} -<pre class="brush: js">browser.menus.create({ +## Exemples + +Cet exemple Ă©coute les clics sur un Ă©lĂ©ment de menu, puis enregistre l'ID de l'Ă©lĂ©ment et l'ID de l'onglet : + +```js +browser.menus.create({ id: "click-me", title: "Click me!", contexts: ["all"] }); -browser.menus.onClicked.addListener((info, tab) => { +browser.menus.onClicked.addListener((info, tab) => { console.log("Item " + info.menuItemId + " clicked " + "in tab " + tab.id); -});</pre> - -<p>{{WebExtExamples}}</p> +}); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.contextMenus`](https://developer.chrome.com/extensions/contextMenus) de chromium. Cette documentation est dĂ©rivĂ©e de [`context_menus.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json) dans le code Chromium. -<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 @@ -112,5 +106,4 @@ browser.menus.onClicked.addListener((info, tab) => { // 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/menus/onhidden/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/onhidden/index.md index d2e1c3fd8c..73b35daf49 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/onhidden/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/onhidden/index.md @@ -12,57 +12,54 @@ tags: - onHidden translation_of: Mozilla/Add-ons/WebExtensions/API/menus/onHidden --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque le navigateur cesse d'afficher un menu: par exemple, parce que l'utilisateur a cliquĂ© Ă l'extĂ©rieur ou sĂ©lectionnĂ© un Ă©lĂ©ment.</p> +LancĂ© lorsque le navigateur cesse d'afficher un menu: par exemple, parce que l'utilisateur a cliquĂ© Ă l'extĂ©rieur ou sĂ©lectionnĂ© un Ă©lĂ©ment. -<p>Elle est seulement dĂ©clenchĂ©e pour les menus qui peuvent ĂȘtre manipulĂ©s en utilisant l'API {{WebExtAPIRef("menus")}} elle-mĂȘme: ceci inclut le menu contextuel, le menu des outils du navigateur et le menu des signets.</p> +Elle est seulement dĂ©clenchĂ©e pour les menus qui peuvent ĂȘtre manipulĂ©s en utilisant l'API {{WebExtAPIRef("menus")}} elle-mĂȘme: ceci inclut le menu contextuel, le menu des outils du navigateur et le menu des signets. -<p>Ceci est plus susceptible d'ĂȘtre utilisĂ© en combinaison avec {{WebExtAPIRef("menus.onShown")}} et {{WebExtAPIRef("menus.refresh()")}} API: une extension peut mettre Ă jour le menu quand il est affichĂ© , puis annuler les modifications quand il est cachĂ©.</p> +Ceci est plus susceptible d'ĂȘtre utilisĂ© en combinaison avec {{WebExtAPIRef("menus.onShown")}} et {{WebExtAPIRef("menus.refresh()")}} API: une extension peut mettre Ă jour le menu quand il est affichĂ© , puis annuler les modifications quand il est cachĂ©. -<p>Firefox rend cet Ă©vĂ©nement disponible via l'espace de noms <code>contextMenus</code> ainsi que l'espace de nom des <code>menus</code>.</p> +Firefox rend cet Ă©vĂ©nement disponible via l'espace de noms `contextMenus` ainsi que l'espace de nom des `menus`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.menus.onHidden.addListener(listener) +```js +browser.menus.onHidden.addListener(listener) browser.menus.onHidden.removeListener(listener) browser.menus.onHidden.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code>  est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, <code>false</code> sinon.</dd> -</dl> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener`  est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, `false` sinon. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction sera transmise sans paramĂštre.</p> - </dd> -</dl> +- `callback` + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction sera transmise sans paramĂštre. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.menus.onHidden", 10)}}</p> +{{Compat("webextensions.api.menus.onHidden", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple enregistre simplement un message chaque fois qu'un menu est masquĂ© :</p> +Cet exemple enregistre simplement un message chaque fois qu'un menu est masquĂ© : -<pre class="brush: js">function hidden() { +```js +function hidden() { console.log("Menu was hidden"); } -browser.menus.onHidden.addListener(hidden);</pre> +browser.menus.onHidden.addListener(hidden); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/onshown/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/onshown/index.md index 9765d30086..cd7731fd05 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/onshown/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/onshown/index.md @@ -12,23 +12,24 @@ tags: - onShown translation_of: Mozilla/Add-ons/WebExtensions/API/menus/onShown --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque le navigateur a montrĂ© un menu.</p> +LancĂ© lorsque le navigateur a montrĂ© un menu. -<p>Une extension peut utiliser cet Ă©vĂ©nement pour mettre Ă jour ses Ă©lĂ©ments de menu en utilisant des informations qui ne sont disponibles qu'une fois le menu affichĂ©. GĂ©nĂ©ralement, une extension trouvera la mise Ă jour dans son gestionnaire <code>onShown</code> puis appellera {{WebExtAPIRef("menus.refresh()")}} pour mettre Ă jour le menu lui-mĂȘme.</p> +Une extension peut utiliser cet Ă©vĂ©nement pour mettre Ă jour ses Ă©lĂ©ments de menu en utilisant des informations qui ne sont disponibles qu'une fois le menu affichĂ©. GĂ©nĂ©ralement, une extension trouvera la mise Ă jour dans son gestionnaire `onShown` puis appellera {{WebExtAPIRef("menus.refresh()")}} pour mettre Ă jour le menu lui-mĂȘme. -<p>Le gestionnaire peut ajouter, supprimer ou mettre Ă jour des Ă©lĂ©ments de menu.</p> +Le gestionnaire peut ajouter, supprimer ou mettre Ă jour des Ă©lĂ©ments de menu. -<p>Par exemple, l'extension d'exemple <a href="https://github.com/mdn/webextensions-examples/tree/master/menu-labelled-open">menu-labelled-open</a> ajoute un Ă©lĂ©ment de menu qui s'affiche lorsque l'utilisateur clique sur un lien et qui, lorsqu'il est cliquĂ©, ouvre simplement le lien. Il utilise <code>onShown</code> et <code>refresh()</code> pour annoter l'Ă©lĂ©ment de menu avec le nom d'hĂŽte du lien, afin que l'utilisateur puisse facilement voir oĂč il ira avant de cliquer.</p> +Par exemple, l'extension d'exemple [menu-labelled-open](https://github.com/mdn/webextensions-examples/tree/master/menu-labelled-open) ajoute un Ă©lĂ©ment de menu qui s'affiche lorsque l'utilisateur clique sur un lien et qui, lorsqu'il est cliquĂ©, ouvre simplement le lien. Il utilise `onShown` et `refresh()` pour annoter l'Ă©lĂ©ment de menu avec le nom d'hĂŽte du lien, afin que l'utilisateur puisse facilement voir oĂč il ira avant de cliquer. -<p>Notez qu'une extension ne devrait pas prendre trop de temps avant d'appeler <code>refresh()</code>, sinon la mise Ă jour sera visible par l'utilisateur.</p> +Notez qu'une extension ne devrait pas prendre trop de temps avant d'appeler `refresh()`, sinon la mise Ă jour sera visible par l'utilisateur. -<p>Le gestionnaire reçoit des informations sur le menu et son contenu, ainsi que des informations sur la page (telles que le lien et / ou le texte de sĂ©lection). Pour accĂ©der aux informations de la page, votre extension doit avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permission de l'hĂŽte</a>.</p> +Le gestionnaire reçoit des informations sur le menu et son contenu, ainsi que des informations sur la page (telles que le lien et / ou le texte de sĂ©lection). Pour accĂ©der aux informations de la page, votre extension doit avoir la [permission de l'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions). -<p>Si le gestionnaire <code>onShown</code> appelle des API asynchrones, il est possible que le menu ait Ă©tĂ© fermĂ© Ă nouveau avant que le gestionnaire ne reprenne l'exĂ©cution. Pour cette raison, si un gestionnaire appelle des API asynchrones, il doit vĂ©rifier que le menu est toujours affichĂ© avant la mise Ă jour du menu. Par exemple :</p> +Si le gestionnaire `onShown` appelle des API asynchrones, il est possible que le menu ait Ă©tĂ© fermĂ© Ă nouveau avant que le gestionnaire ne reprenne l'exĂ©cution. Pour cette raison, si un gestionnaire appelle des API asynchrones, il doit vĂ©rifier que le menu est toujours affichĂ© avant la mise Ă jour du menu. Par exemple : -<pre class="brush: js">var lastMenuInstanceId = 0; +```js +var lastMenuInstanceId = 0; var nextMenuInstanceId = 1; browser.menus.onShown.addListener(async function(info, tab) { @@ -47,19 +48,23 @@ browser.menus.onShown.addListener(async function(info, tab) { browser.menus.onHidden.addListener(function() { lastMenuInstanceId = 0; -});</pre> +}); +``` -<p>Notez qu'il est possible d'appeler les fonctions API des menus de maniĂšre synchrone, et dans ce cas vous n'avez pas Ă effectuer cette vĂ©rification :</p> +Notez qu'il est possible d'appeler les fonctions API des menus de maniĂšre synchrone, et dans ce cas vous n'avez pas Ă effectuer cette vĂ©rification : -<pre class="brush: js">browser.menus.onShown.addListener(async function(info, tab) { +```js +browser.menus.onShown.addListener(async function(info, tab) { browser.menus.update(menuId, ...); // Note: Not waiting for returned promise. browser.menus.refresh(); -});</pre> +}); +``` -<p>Toutefois, si vous appelez ces API de maniĂšre asynchrone, vous devez effectuer la vĂ©rification suivante :</p> +Toutefois, si vous appelez ces API de maniĂšre asynchrone, vous devez effectuer la vĂ©rification suivante : -<pre class="brush: js">browser.menus.onShown.addListener(async function(info, tab) { +```js +browser.menus.onShown.addListener(async function(info, tab) { var menuInstanceId = nextMenuInstanceId++; lastMenuInstanceId = menuInstanceId; @@ -69,76 +74,69 @@ browser.menus.onHidden.addListener(function() { return; } browser.menus.refresh(); -});</pre> +}); +``` -<p>Firefox rend cet Ă©vĂ©nement disponible via l'espace de noms <code>contextMenus</code> ainsi que l'espace de nom des <code>menus</code>.</p> +Firefox rend cet Ă©vĂ©nement disponible via l'espace de noms `contextMenus` ainsi que l'espace de nom des `menus`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.menus.onShown.addListener(listener) +```js +browser.menus.onShown.addListener(listener) browser.menus.onShown.removeListener(listener) browser.menus.onShown.hasListener(listener) -</pre> +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si le `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. + +## Syntaxe addListener -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +### ParamĂštres -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si le <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `callback` -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h3 id="ParamĂštres">ParamĂštres</h3> + - `info` -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> + - : `Object`. Ceci est juste comme l'objet {{WebExtAPIRef('menus.OnClickData')}}, sauf qu'il contient deux propriĂ©tĂ©s supplĂ©mentaires: - <dl> - <dt><code>info</code></dt> - <dd> - <p><code>Object</code>. Ceci est juste comme l'objet {{WebExtAPIRef('menus.OnClickData')}}, sauf qu'il contient deux propriĂ©tĂ©s supplĂ©mentaires:</p> + - `contexts`: un tableau de tous les {{WebExtAPIRef("menus.ContextType", "contexts")}} applicables Ă ce menu. + - `menuIds`: un tableau d'ID de tous les Ă©lĂ©ments de menu appartenant Ă cette extension qui sont affichĂ©s dans ce menu. - <ul> - <li><code>contexts</code>: un tableau de tous les {{WebExtAPIRef("menus.ContextType", "contexts")}} applicables Ă ce menu.</li> - <li><code>menuIds</code>: un tableau d'ID de tous les Ă©lĂ©ments de menu appartenant Ă cette extension qui sont affichĂ©s dans ce menu.</li> - </ul> + En comparaison avec `menus.OnClickData`, l'objet `info` omet Ă©galement les propriĂ©tĂ©s `menuItemId` et `modifiers`, car bien sĂ»r, celles-ci ne sont pas disponibles tant qu'un Ă©lĂ©ment de menu n'a pas Ă©tĂ© sĂ©lectionnĂ©. - <p>En comparaison avec <code>menus.OnClickData</code>, l'objet <code>info</code> omet Ă©galement les propriĂ©tĂ©s <code>menuItemId</code> et <code>modifiers</code>, car bien sĂ»r, celles-ci ne sont pas disponibles tant qu'un Ă©lĂ©ment de menu n'a pas Ă©tĂ© sĂ©lectionnĂ©.</p> + Les propriĂ©tĂ©s `contexts`, `menuIds`, `frameId`, et `editable` modifiables sont toujours fournis. Toutes les autres propriĂ©tĂ©s dans `info` sont uniquement fournies si l'extension a la [permission d'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) pour la page. - <p>Les propriĂ©tĂ©s <code>contexts</code>, <code>menuIds</code>, <code>frameId</code>, et <code>editable</code> modifiables sont toujours fournis. Toutes les autres propriĂ©tĂ©s dans <code>info</code> sont uniquement fournies si l'extension a la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permission d'hĂŽte</a> pour la page.</p> - </dd> - </dl> + <!----> - <dl> - <dt><code>tab</code></dt> - <dd>{{WebExtAPIRef('tabs.Tab')}}. Les dĂ©tails de l'onglet oĂč le clic a eu lieu. Si le clic n'a pas eu lieu dans ou sur un onglet, ce paramĂštre sera manquant.</dd> - </dl> - </dd> -</dl> + - `tab` + - : {{WebExtAPIRef('tabs.Tab')}}. Les dĂ©tails de l'onglet oĂč le clic a eu lieu. Si le clic n'a pas eu lieu dans ou sur un onglet, ce paramĂštre sera manquant. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.menus.onShown", 10)}}</p> +{{Compat("webextensions.api.menus.onShown", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple permet d'afficher le menu contextuel sur un lien, puis met Ă jour l'Ă©lĂ©ment de menu <code>openLabelledId</code> avec le nom d'hĂŽte du lien :</p> +Cet exemple permet d'afficher le menu contextuel sur un lien, puis met Ă jour l'Ă©lĂ©ment de menu `openLabelledId` avec le nom d'hĂŽte du lien : -<pre class="brush: js">function updateMenuItem(linkHostname) { +```js +function updateMenuItem(linkHostname) { browser.menus.update(openLabelledId, { title: `Open (${linkHostname})` }); browser.menus.refresh(); } -browser.menus.onShown.addListener(info => { +browser.menus.onShown.addListener(info => { if (!info.linkUrl) { return; } @@ -146,6 +144,6 @@ browser.menus.onShown.addListener(info => { linkElement.href = info.linkUrl; updateMenuItem(linkElement.hostname); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/overridecontext/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/overridecontext/index.md index 739b9acbd5..c879a6f45f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/overridecontext/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/overridecontext/index.md @@ -11,34 +11,33 @@ tags: - contextMenus translation_of: Mozilla/Add-ons/WebExtensions/API/menus/overrideContext --- -<p>{{AddonSidebar}}</p> +{{AddonSidebar}} -<p>Masquer tous les Ă©lĂ©ments de menu par dĂ©faut de Firefox en faveur d'un menu contextuel personnalisĂ©.</p> +Masquer tous les Ă©lĂ©ments de menu par dĂ©faut de Firefox en faveur d'un menu contextuel personnalisĂ©. -<p>La mĂ©thode overrideContext permet d'afficher les Ă©lĂ©ments de menu correspondants de cette extension Ă la place du menu par dĂ©faut. Cette mĂ©thode doit ĂȘtre appelĂ©e Ă partir d'un gestionnaire d'Ă©vĂ©nements DOM 'contextmenu', et ne s'applique qu'au menu qui s'ouvre aprĂšs cet Ă©vĂ©nement.</p> +La mĂ©thode overrideContext permet d'afficher les Ă©lĂ©ments de menu correspondants de cette extension Ă la place du menu par dĂ©faut. Cette mĂ©thode doit ĂȘtre appelĂ©e Ă partir d'un gestionnaire d'Ă©vĂ©nements DOM 'contextmenu', et ne s'applique qu'au menu qui s'ouvre aprĂšs cet Ă©vĂ©nement. -<p>Pour appeler cette mĂ©thode, votre extension doit avoir la permission <code>menus.overrideContext</code>.</p> +Pour appeler cette mĂ©thode, votre extension doit avoir la permission `menus.overrideContext`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.menus.overrideContext( +```js +browser.menus.overrideContext( contextOptions // object -)</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>contextOptions</code></dt> - <dd><p><code>object</code>. Options sur la façon dont les menus contextuels seront remplacĂ©s.</p> - <dl> - <dt><code>showDefaults</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. S'il faut Ă©galement inclure les Ă©lĂ©ments de menu par dĂ©faut dans le menu.</dd> - <dt><code>context </code>{{optional_inline}}</dt> - <dd><code>string</code>. Le ContextType Ă surcharger, pour autoriser les Ă©lĂ©ments de menu d'autres extensions dans le menu. Actuellement, seuls <code>'bookmark'</code> et <code>'tab'</code> sont supportĂ©s. <code>showDefaults</code> ne peut pas ĂȘtre utilisĂ© avec cette option.</dd> - <dt><code>bookmarkId </code>{{optional_inline}}</dt> - <dd><code>string</code>. Requis lorsque le contexte est <code>'bookmark'</code>. NĂ©cessite la permission 'bookmark'.</dd> - <dt><code>tabId </code>{{optional_inline}}</dt> - <dd><code>integer</code>. Requis lorsque le contexte est <code>'tab'</code>. NĂ©cessite la permission 'tabs'.</dd> - </dl> - </dd> -</dl> +) +``` + +### ParamĂštres + +- `contextOptions` + + - : `object`. Options sur la façon dont les menus contextuels seront remplacĂ©s. + + - `showDefaults` {{optional_inline}} + - : `boolean`. S'il faut Ă©galement inclure les Ă©lĂ©ments de menu par dĂ©faut dans le menu. + - `context `{{optional_inline}} + - : `string`. Le ContextType Ă surcharger, pour autoriser les Ă©lĂ©ments de menu d'autres extensions dans le menu. Actuellement, seuls `'bookmark'` et `'tab'` sont supportĂ©s. `showDefaults` ne peut pas ĂȘtre utilisĂ© avec cette option. + - `bookmarkId `{{optional_inline}} + - : `string`. Requis lorsque le contexte est `'bookmark'`. NĂ©cessite la permission 'bookmark'. + - `tabId `{{optional_inline}} + - : `integer`. Requis lorsque le contexte est `'tab'`. NĂ©cessite la permission 'tabs'. diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/refresh/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/refresh/index.md index 925305277d..eed1eeca4a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/refresh/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/refresh/index.md @@ -12,53 +12,56 @@ tags: - refresh translation_of: Mozilla/Add-ons/WebExtensions/API/menus/refresh --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Actualise un menu affichĂ©.</p> +Actualise un menu affichĂ©. -<p>Met Ă jour les Ă©lĂ©ments de menu de l'extension dans le menu affichĂ© par le navigateur, y compris les modifications effectuĂ©es depuis l'affichage du menu. N'a aucun effet si le menu n'est pas affichĂ©. La reconstruction d'un menu affichĂ© est une opĂ©ration coĂ»teuse. N'utilisez cette mĂ©thode que lorsque cela est nĂ©cessaire.</p> +Met Ă jour les Ă©lĂ©ments de menu de l'extension dans le menu affichĂ© par le navigateur, y compris les modifications effectuĂ©es depuis l'affichage du menu. N'a aucun effet si le menu n'est pas affichĂ©. La reconstruction d'un menu affichĂ© est une opĂ©ration coĂ»teuse. N'utilisez cette mĂ©thode que lorsque cela est nĂ©cessaire. -<p>Cela est gĂ©nĂ©ralement appelĂ© depuis l'intĂ©rieur d'un gestionnaire d'Ă©vĂ©nements {{WebExtAPIRef("menus.onShown")}} aprĂšs que le gestionnaire a effectuĂ© des mises Ă jour dans le menu.</p> +Cela est gĂ©nĂ©ralement appelĂ© depuis l'intĂ©rieur d'un gestionnaire d'Ă©vĂ©nements {{WebExtAPIRef("menus.onShown")}} aprĂšs que le gestionnaire a effectuĂ© des mises Ă jour dans le menu. -<p>Firefox rend cette fonction disponible via l'espace de noms <code>contextMenus</code> ainsi que l'espace de noms des <code>menus</code>.</p> +Firefox rend cette fonction disponible via l'espace de noms `contextMenus` ainsi que l'espace de noms des `menus`. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">browser.menus.refresh() -</pre> +```js +browser.menus.refresh() +``` -<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 se rĂ©alise sans arguments.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui se rĂ©alise sans arguments. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.menus.refresh", 10)}}</p> +{{Compat("webextensions.api.menus.refresh", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple permet d'afficher le menu contextuel sur un lien, puis met Ă jour l'Ă©lĂ©ment de menu <code>openLabelledId</code> menu item avec le nom d'hĂŽte du lien :</p> +Cet exemple permet d'afficher le menu contextuel sur un lien, puis met Ă jour l'Ă©lĂ©ment de menu `openLabelledId` menu item avec le nom d'hĂŽte du lien : -<pre class="brush: js">function updateMenuItem(linkHostname) { +```js +function updateMenuItem(linkHostname) { browser.menus.update(openLabelledId, { title: `Open (${linkHostname})` }); browser.menus.refresh(); } -browser.menus.onShown.addListener(info => { +browser.menus.onShown.addListener(info => { if (!info.linkUrl) { return; } let linkElement = document.createElement("a"); linkElement.href = info.linkUrl; updateMenuItem(linkElement.hostname); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/menus/remove/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/remove/index.md index e3084010cf..59b4af3943 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/remove/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/remove/index.md @@ -13,37 +13,37 @@ tags: - remove translation_of: Mozilla/Add-ons/WebExtensions/API/menus/remove --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime un Ă©lĂ©ment de menu.</p> +Supprime un Ă©lĂ©ment de menu. -<p>Pour la compatibilitĂ© avec d'autres navigateurs, Firefox rend cette mĂ©thode disponible via l'espace de noms <code>contextMenus</code> ainsi que l'espace de noms des <code>menus</code>.</p> +Pour la compatibilitĂ© avec d'autres navigateurs, Firefox rend cette mĂ©thode disponible via l'espace de noms `contextMenus` ainsi que l'espace de noms des `menus`. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.menus.remove( +```js +var removing = browser.menus.remove( menuItemId // integer or string ) -</pre> +``` -<h3 id="Parameters">Parameters</h3> +### Parameters -<dl> - <dt><code>menuItemId</code></dt> - <dd><code><code>integer</code></code> or <code><code>string</code></code>. The ID of the menu item to remove.</dd> -</dl> +- `menuItemId` + - : `integer` or `string`. The ID of the menu item to remove. -<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 dĂ©finit sans argument si la suppression a rĂ©ussi, ou rejetĂ©e avec un message d'erreur si la suppression a Ă©chouĂ© (par exemple, parce que l'Ă©lĂ©ment n'a pas pu ĂȘtre trouvĂ©).</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera dĂ©finit sans argument si la suppression a rĂ©ussi, ou rejetĂ©e avec un message d'erreur si la suppression a Ă©chouĂ© (par exemple, parce que l'Ă©lĂ©ment n'a pas pu ĂȘtre trouvĂ©). -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cette extension ajoute un Ă©lĂ©ment de menu intitulĂ© "Remove me!". Si vous cliquez sur l'Ă©lĂ©ment, l'extension le supprime.</p> +Cette extension ajoute un Ă©lĂ©ment de menu intitulĂ© "Remove me!". Si vous cliquez sur l'Ă©lĂ©ment, l'extension le supprime. -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("item removed successfully"); } @@ -62,21 +62,20 @@ browser.menus.onClicked.addListener(function(info, tab) { var removing = browser.menus.remove(info.menuItemId); removing.then(onRemoved, onError); } -});</pre> - -<p>{{WebExtExamples}}</p> +}); +``` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{WebExtExamples}} -<p>{{Compat("webextensions.api.menus.remove", 10)}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.menus.remove", 10)}} -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.contextMenus`](https://developer.chrome.com/extensions/contextMenus) de chromium. Cette documentation est dĂ©rivĂ©e de [`context_menus.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json) dans le code Chromium. -<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 @@ -103,5 +102,4 @@ browser.menus.onClicked.addListener(function(info, tab) { // 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/menus/removeall/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/removeall/index.md index 5654a5e15c..0688c98921 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/removeall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/removeall/index.md @@ -14,36 +14,38 @@ tags: - removeAll translation_of: Mozilla/Add-ons/WebExtensions/API/menus/removeAll --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime tous les Ă©lĂ©ments de menu ajoutĂ©s par l'extension.</p> +Supprime tous les Ă©lĂ©ments de menu ajoutĂ©s par l'extension. -<p>Pour la compatibilitĂ© avec d'autres navigateurs, Firefox rend cette mĂ©thode disponible via l'espace de noms <code>contextMenus</code> ainsi que l'espace de noms des <code>menus</code>.</p> +Pour la compatibilitĂ© avec d'autres navigateurs, Firefox rend cette mĂ©thode disponible via l'espace de noms `contextMenus` ainsi que l'espace de noms des `menus`. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.menus.removeAll() -</pre> +```js +var removing = browser.menus.removeAll() +``` -<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 remplie sans argument lorsque tous les Ă©lĂ©ments ont Ă©tĂ© supprimĂ©s.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque tous les Ă©lĂ©ments ont Ă©tĂ© supprimĂ©s. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.menus.removeAll", 10)}}</p> +{{Compat("webextensions.api.menus.removeAll", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple ajoute deux Ă©lĂ©ments de menu. Lorsque l'utilisateur clique sur l'Ă©lĂ©ment "Supprimer tout !", L'extension supprime les deux Ă©lĂ©ments en utilisant <code>removeAll()</code>.</p> +Cet exemple ajoute deux Ă©lĂ©ments de menu. Lorsque l'utilisateur clique sur l'Ă©lĂ©ment "Supprimer tout !", L'extension supprime les deux Ă©lĂ©ments en utilisant `removeAll()`. -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("items removed successfully"); } @@ -64,17 +66,16 @@ browser.menus.onClicked.addListener(function(info, tab) { var removing = browser.menus.removeAll(); removing.then(onRemoved); } -});</pre> - -<p>{{WebExtExamples}}</p> +}); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.contextMenus`](https://developer.chrome.com/extensions/contextMenus) de chromium. Cette documentation est dĂ©rivĂ©e de [`context_menus.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json) dans le code Chromium. -<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 +102,4 @@ browser.menus.onClicked.addListener(function(info, tab) { // 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/menus/update/index.md b/files/fr/mozilla/add-ons/webextensions/api/menus/update/index.md index 762d21d228..df24382938 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/menus/update/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/menus/update/index.md @@ -13,119 +13,114 @@ tags: - contextMenus translation_of: Mozilla/Add-ons/WebExtensions/API/menus/update --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Met Ă jour un Ă©lĂ©ment de menu prĂ©cĂ©demment crĂ©Ă©.</p> +Met Ă jour un Ă©lĂ©ment de menu prĂ©cĂ©demment crĂ©Ă©. -<p>Pour la compatibilitĂ© avec d'autres navigateurs, Firefox rend cette mĂ©thode disponible via l'espace de noms <code>contextMenus</code> ainsi que l'espace de noms des <code>menus</code>.</p> +Pour la compatibilitĂ© avec d'autres navigateurs, Firefox rend cette mĂ©thode disponible via l'espace de noms `contextMenus` ainsi que l'espace de noms des `menus`. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 updating = browser.menus.update( +```js +var updating = browser.menus.update( id, // integer or string updateProperties // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>id</code></dt> - <dd><code><code>integer</code></code> ou <code><code>string</code></code>. L'ID de l'article Ă mettre Ă jour.</dd> - <dt><code>updateProperties</code></dt> - <dd><p><code>object</code>. Les propriĂ©tĂ©s Ă mettre Ă jour. Identique Ă l'objet <code>createProperties</code> passĂ© Ă Â {{WebExtAPIRef("menus.create()", "menus.create()")}}, sauf que l'<code>id</code> ne peut ĂȘtre dĂ©fini. En outre, les <code>icĂŽnes</code> ne peuvent ĂȘtre modifiĂ©es que dans les commandes de menu, et non dans le menu contextuel de niveau supĂ©rieur. L'icĂŽne de niveau supĂ©rieur correspond Ă l'icĂŽne principale de l'extension telle que dĂ©clarĂ©e dans le fichier manifeste de l'extension.</p> - <dl> - <dt><code>checked</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. L'Ă©tat initial d'une case Ă cocher ou d'un Ă©lĂ©ment radio : <code>true</code> fpour sĂ©lectionnĂ© et <code>false</code> pour non sĂ©lectionnĂ©. Un seul Ă©lĂ©ment radio peut ĂȘtre sĂ©lectionnĂ© Ă la fois dans un groupe donnĂ© d'Ă©lĂ©ments radio.</dd> - <dt><code>command</code> {{optional_inline}}</dt> - <dd> - <p><code>string</code>. ChaĂźne dĂ©crivant une action qui doit ĂȘtre effectuĂ©e lorsque l'utilisateur clique sur l'Ă©lĂ©ment. Les valeurs possibles sont :</p> - - <ul> - <li><code>"_execute_browser_action"</code>: simuler un clic sur l'action du navigateur de l'extension, en ouvrant son popup s'il en a un</li> - <li><code>"_execute_page_action"</code>: simuler un clic sur l'action de la page de l'extension, en ouvrant son popup si elle en a une</li> - <li><code>"_execute_sidebar_action"</code>: ouvre la barre latĂ©rale de l'extension</li> - </ul> - - <p>Cliquer sur l'Ă©lĂ©ment dĂ©clenchera toujours l'Ă©vĂ©nement {{WebExtAPIRef("menus.onClicked")}}, mais rien ne garantit l'ordre ici: la commande peut ĂȘtre exĂ©cutĂ©e avant le lancement de <code>onClicked</code>.</p> - </dd> - <dt><code>contexts</code> {{optional_inline}}</dt> - <dd> - <p><code>array</code> de <code>{{WebExtAPIRef('menus.ContextType')}}</code>. Tableau des contextes dans lesquels cet Ă©lĂ©ment de menu apparaĂźtra. Si cette option est omise :</p> - - <ul> - <li>si le parent de l'Ă©lĂ©ment a des contextes dĂ©finis, alors cet Ă©lĂ©ment hĂ©ritera des contextes de son parent</li> - <li>sinon, l'Ă©lĂ©ment reçoit un tableau de contexte de ["page"].</li> - </ul> - </dd> - <dt><code>documentUrlPatterns</code> {{optional_inline}}</dt> - <dd><code>array</code> de <code><code>string</code></code>. Vous permet de limiter l'Ă©lĂ©ment Ă s'appliquer uniquement aux documents dont l'URL correspond Ă l'un des Ă©lĂ©ments <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">motifs</a> de donnĂ©es. Ceci s'applique Ă©galement aux cadres.</dd> - <dt><code>enabled</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si cet Ă©lĂ©ment de menu est activĂ© ou dĂ©sactivĂ©. La valeur par dĂ©faut est <code>true</code>.</dd> - <dt><code>icons</code> {{optional_inline}}</dt> - <dd> - <p><code>object</code>. Une ou plusieurs icĂŽnes personnalisĂ©es Ă afficher Ă cĂŽtĂ© de l'Ă©lĂ©ment. Les icĂŽnes personnalisĂ©es ne peuvent ĂȘtre dĂ©finies que pour les Ă©lĂ©ments apparaissant dans les sous-menus. Cette propriĂ©tĂ© est un objet avec une propriĂ©tĂ© pour chaque icĂŽne fournie : le nom de la propriĂ©tĂ© doit inclure la taille de l'icĂŽne en pixels, et le chemin est relatif Ă l'icĂŽne du rĂ©pertoire racine de l'extension. Le navigateur essaie de choisir une icĂŽne 16x16 pixels pour un affichage normal ou une icĂŽne 32x32 pixels pour un affichage haute densitĂ©. Pour Ă©viter toute mise Ă l'Ă©chelle, vous pouvez spĂ©cifier des icĂŽnes comme celle-ci :</p> - - <pre class="brush: json">"icons": { - "16": "path/to/geo-16.png", - "32": "path/to/geo-32.png" - }</pre> - - <p>Alternativement, vous pouvez spĂ©cifier une seule icĂŽne SVG, et elle sera mise Ă l'Ă©chelle de maniĂšre appropriĂ©e :</p> - - <pre class="brush: json">"icons": { - "16": "path/to/geo.svg" - }</pre> - - <div class="note"> - <p><strong>Note :</strong> The top-level menu item uses the <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/icons">icons</a> specified in the manifest rather than what is specified with this key.</p> - </div> - </dd> - <dt><code>id</code> {{optional_inline}}</dt> - <dd><code>string</code>. L'ID unique Ă affecter Ă cet article. Obligatoire pour les pages d'Ă©vĂ©nements. Ne peut pas ĂȘtre le mĂȘme qu'un autre ID pour cette extension.</dd> - <dt><code>onclick</code> {{optional_inline}}</dt> - <dd><code>function</code>. Une fonction qui sera appelĂ©e lorsque vous cliquerez sur l'Ă©lĂ©ment de menu. Les pages d'Ă©vĂ©nements ne peuvent pas l'utiliser : elles doivent plutĂŽt enregistrer un auditeur pour {{WebExtAPIRef('menus.onClicked')}}.</dd> - <dt><code>parentId</code> {{optional_inline}}</dt> - <dd><code><code>integer</code></code> ou <code><code>string</code></code>. L'ID d'un Ă©lĂ©ment de menu parent ; ceci fait de l'Ă©lĂ©ment un enfant d'un Ă©lĂ©ment prĂ©cĂ©demment ajoutĂ©. Remarque : Si vous avez crĂ©Ă© plus d'un Ă©lĂ©ment de menu, les Ă©lĂ©ments seront placĂ©s dans un sous-menu. Le parent du sous-menu sera Ă©tiquetĂ© avec le nom de l'extension.</dd> - <dt><code>targetUrlPatterns</code> {{optional_inline}}</dt> - <dd><code>array</code> de <code><code>string</code></code>. Similairer Ă <code>documentUrlPatterns</code>, mais vous permet de filtrer en fonction de la <code>href</code> des balises d'ancre et l'attribut <code>src</code> des balises img/audio/video. Ce paramĂštre prend en charge n'importe quel schĂ©ma d'URL, mĂȘme ceux qui ne sont gĂ©nĂ©ralement pas autorisĂ©s dans un modĂšle de correspondance.</dd> - <dt><code>title</code> {{optional_inline}}</dt> - <dd> - <p><code>string</code>. Le texte Ă afficher dans le poste. Obligatoire sauf si le <code>type</code> est "separateur".</p> - - <p>Vous pouvez utiliser "<code>%s</code>" dans la chaĂźne de caractĂšres. Si vous le faites dans un Ă©lĂ©ment de menu, et qu'un texte est sĂ©lectionnĂ© dans la page lorsque le menu est affichĂ©, le texte sĂ©lectionnĂ© sera interpolĂ© dans le titre. Par exemple, si <code>title</code> est "Traduction '%s' Ă Pig Latin" et que l'utilisateur sĂ©lectionne le mot "cool", puis active le menu, alors le titre de l'Ă©lĂ©ment de menu sera : "Traduction 'cool' Ă Pig Latin".</p> - - <p>Si le titre contient une esperluette "&", le caractĂšre suivant sera utilisĂ© comme clĂ© d'accĂšs pour l'Ă©lĂ©ment et l'esperluette ne sera pas affichĂ©e. Les exceptions Ă cette rĂšgle sont les suivantes :</p> - - <ul> - <li>Si le caractĂšre suivant est Ă©galement une esperluette : alors une esperluette simple sera affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie. En effet, "&&" est utilisĂ© pour afficher une seule esperluette.</li> - <li>Si les caractĂšres suivants sont la directive d'interpolation "%s" : alors l'esperluette ne sera pas affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie.</li> - <li>Si l'esperluette est le dernier caractĂšre du titre : alors l'esperluette ne sera pas affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie.</li> - </ul> - - <p>Seule la premiĂšre esperluette sera utilisĂ©e pour dĂ©finir une clĂ© d'accĂšs : les esperluettes suivantes ne seront pas affichĂ©es mais ne dĂ©finiront pas les clĂ©s. Ainsi, "&A et &B" seront affichĂ©s comme "A et B" et "A" comme clĂ© d'accĂšs</p> - </dd> - <dt><code>type</code> {{optional_inline}}</dt> - <dd><code>{{WebExtAPIRef('menus.ItemType')}}</code>. Le type d'Ă©lĂ©ment de menu : "normal", "checkbox", "radio", "separator". Defaults to "normal".</dd> - <dt><code>viewTypes</code> {{optional_inline}}</dt> - <dd><code>{{WebExtAPIRef('extension.ViewType')}}</code>. Liste des types d'affichage oĂč l'Ă©lĂ©ment de menu sera affichĂ©. Par dĂ©faut Ă n'importe quelle vue, y compris celles qui n'ont pas de <code>viewType</code>.</dd> - <dt><code>visible</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'Ă©lĂ©ment est affichĂ© dans le menu. La valeur par dĂ©faut est <code>true</code>.</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera satisfaite sans argument si la mise Ă jour a rĂ©ussi, ou rejetĂ©e avec un message d'erreur si la mise Ă jour a Ă©chouĂ©.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Cet exemple crĂ©e un Ă©lĂ©ment de menu, puis met Ă jour son titre lorsque l'utilisateur clique dessus :</p> - -<pre class="brush: js">function onUpdated() { +``` + +### ParamĂštres + +- `id` + - : `integer` ou `string`. L'ID de l'article Ă mettre Ă jour. +- `updateProperties` + + - : `object`. Les propriĂ©tĂ©s Ă mettre Ă jour. Identique Ă l'objet `createProperties` passĂ© Ă Â {{WebExtAPIRef("menus.create()", "menus.create()")}}, sauf que l'`id` ne peut ĂȘtre dĂ©fini. En outre, les `icĂŽnes` ne peuvent ĂȘtre modifiĂ©es que dans les commandes de menu, et non dans le menu contextuel de niveau supĂ©rieur. L'icĂŽne de niveau supĂ©rieur correspond Ă l'icĂŽne principale de l'extension telle que dĂ©clarĂ©e dans le fichier manifeste de l'extension. + + - `checked` {{optional_inline}} + - : `boolean`. L'Ă©tat initial d'une case Ă cocher ou d'un Ă©lĂ©ment radio : `true` fpour sĂ©lectionnĂ© et `false` pour non sĂ©lectionnĂ©. Un seul Ă©lĂ©ment radio peut ĂȘtre sĂ©lectionnĂ© Ă la fois dans un groupe donnĂ© d'Ă©lĂ©ments radio. + - `command` {{optional_inline}} + + - : `string`. ChaĂźne dĂ©crivant une action qui doit ĂȘtre effectuĂ©e lorsque l'utilisateur clique sur l'Ă©lĂ©ment. Les valeurs possibles sont : + + - `"_execute_browser_action"`: simuler un clic sur l'action du navigateur de l'extension, en ouvrant son popup s'il en a un + - `"_execute_page_action"`: simuler un clic sur l'action de la page de l'extension, en ouvrant son popup si elle en a une + - `"_execute_sidebar_action"`: ouvre la barre latĂ©rale de l'extension + + Cliquer sur l'Ă©lĂ©ment dĂ©clenchera toujours l'Ă©vĂ©nement {{WebExtAPIRef("menus.onClicked")}}, mais rien ne garantit l'ordre ici: la commande peut ĂȘtre exĂ©cutĂ©e avant le lancement de `onClicked`. + + - `contexts` {{optional_inline}} + + - : `array` de `{{WebExtAPIRef('menus.ContextType')}}`. Tableau des contextes dans lesquels cet Ă©lĂ©ment de menu apparaĂźtra. Si cette option est omise : + + - si le parent de l'Ă©lĂ©ment a des contextes dĂ©finis, alors cet Ă©lĂ©ment hĂ©ritera des contextes de son parent + - sinon, l'Ă©lĂ©ment reçoit un tableau de contexte de \["page"]. + + - `documentUrlPatterns` {{optional_inline}} + - : `array` de `string`. Vous permet de limiter l'Ă©lĂ©ment Ă s'appliquer uniquement aux documents dont l'URL correspond Ă l'un des Ă©lĂ©ments [motifs](/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns) de donnĂ©es. Ceci s'applique Ă©galement aux cadres. + - `enabled` {{optional_inline}} + - : `boolean`. Si cet Ă©lĂ©ment de menu est activĂ© ou dĂ©sactivĂ©. La valeur par dĂ©faut est `true`. + - `icons` {{optional_inline}} + + - : `object`. Une ou plusieurs icĂŽnes personnalisĂ©es Ă afficher Ă cĂŽtĂ© de l'Ă©lĂ©ment. Les icĂŽnes personnalisĂ©es ne peuvent ĂȘtre dĂ©finies que pour les Ă©lĂ©ments apparaissant dans les sous-menus. Cette propriĂ©tĂ© est un objet avec une propriĂ©tĂ© pour chaque icĂŽne fournie : le nom de la propriĂ©tĂ© doit inclure la taille de l'icĂŽne en pixels, et le chemin est relatif Ă l'icĂŽne du rĂ©pertoire racine de l'extension. Le navigateur essaie de choisir une icĂŽne 16x16 pixels pour un affichage normal ou une icĂŽne 32x32 pixels pour un affichage haute densitĂ©. Pour Ă©viter toute mise Ă l'Ă©chelle, vous pouvez spĂ©cifier des icĂŽnes comme celle-ci : + + ```json + "icons": { + "16": "path/to/geo-16.png", + "32": "path/to/geo-32.png" + } + ``` + + Alternativement, vous pouvez spĂ©cifier une seule icĂŽne SVG, et elle sera mise Ă l'Ă©chelle de maniĂšre appropriĂ©e : + + ```json + "icons": { + "16": "path/to/geo.svg" + } + ``` + + > **Note :** The top-level menu item uses the [icons](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/icons) specified in the manifest rather than what is specified with this key. + + - `id` {{optional_inline}} + - : `string`. L'ID unique Ă affecter Ă cet article. Obligatoire pour les pages d'Ă©vĂ©nements. Ne peut pas ĂȘtre le mĂȘme qu'un autre ID pour cette extension. + - `onclick` {{optional_inline}} + - : `function`. Une fonction qui sera appelĂ©e lorsque vous cliquerez sur l'Ă©lĂ©ment de menu. Les pages d'Ă©vĂ©nements ne peuvent pas l'utiliser : elles doivent plutĂŽt enregistrer un auditeur pour {{WebExtAPIRef('menus.onClicked')}}. + - `parentId` {{optional_inline}} + - : `integer` ou `string`. L'ID d'un Ă©lĂ©ment de menu parent ; ceci fait de l'Ă©lĂ©ment un enfant d'un Ă©lĂ©ment prĂ©cĂ©demment ajoutĂ©. Remarque : Si vous avez crĂ©Ă© plus d'un Ă©lĂ©ment de menu, les Ă©lĂ©ments seront placĂ©s dans un sous-menu. Le parent du sous-menu sera Ă©tiquetĂ© avec le nom de l'extension. + - `targetUrlPatterns` {{optional_inline}} + - : `array` de `string`. Similairer Ă `documentUrlPatterns`, mais vous permet de filtrer en fonction de la `href` des balises d'ancre et l'attribut `src` des balises img/audio/video. Ce paramĂštre prend en charge n'importe quel schĂ©ma d'URL, mĂȘme ceux qui ne sont gĂ©nĂ©ralement pas autorisĂ©s dans un modĂšle de correspondance. + - `title` {{optional_inline}} + + - : `string`. Le texte Ă afficher dans le poste. Obligatoire sauf si le `type` est "separateur". + + Vous pouvez utiliser "`%s`" dans la chaĂźne de caractĂšres. Si vous le faites dans un Ă©lĂ©ment de menu, et qu'un texte est sĂ©lectionnĂ© dans la page lorsque le menu est affichĂ©, le texte sĂ©lectionnĂ© sera interpolĂ© dans le titre. Par exemple, si `title` est "Traduction '%s' Ă Pig Latin" et que l'utilisateur sĂ©lectionne le mot "cool", puis active le menu, alors le titre de l'Ă©lĂ©ment de menu sera : "Traduction 'cool' Ă Pig Latin". + + Si le titre contient une esperluette "&", le caractĂšre suivant sera utilisĂ© comme clĂ© d'accĂšs pour l'Ă©lĂ©ment et l'esperluette ne sera pas affichĂ©e. Les exceptions Ă cette rĂšgle sont les suivantes : + + - Si le caractĂšre suivant est Ă©galement une esperluette : alors une esperluette simple sera affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie. En effet, "&&" est utilisĂ© pour afficher une seule esperluette. + - Si les caractĂšres suivants sont la directive d'interpolation "%s" : alors l'esperluette ne sera pas affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie. + - Si l'esperluette est le dernier caractĂšre du titre : alors l'esperluette ne sera pas affichĂ©e et aucune clĂ© d'accĂšs ne sera dĂ©finie. + + Seule la premiĂšre esperluette sera utilisĂ©e pour dĂ©finir une clĂ© d'accĂšs : les esperluettes suivantes ne seront pas affichĂ©es mais ne dĂ©finiront pas les clĂ©s. Ainsi, "\&A et \&B" seront affichĂ©s comme "A et B" et "A" comme clĂ© d'accĂšs + + - `type` {{optional_inline}} + - : `{{WebExtAPIRef('menus.ItemType')}}`. Le type d'Ă©lĂ©ment de menu : "normal", "checkbox", "radio", "separator". Defaults to "normal". + - `viewTypes` {{optional_inline}} + - : `{{WebExtAPIRef('extension.ViewType')}}`. Liste des types d'affichage oĂč l'Ă©lĂ©ment de menu sera affichĂ©. Par dĂ©faut Ă n'importe quelle vue, y compris celles qui n'ont pas de `viewType`. + - `visible` {{optional_inline}} + - : `boolean`. Si l'Ă©lĂ©ment est affichĂ© dans le menu. La valeur par dĂ©faut est `true`. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera satisfaite sans argument si la mise Ă jour a rĂ©ussi, ou rejetĂ©e avec un message d'erreur si la mise Ă jour a Ă©chouĂ©. + +## Exemples + +Cet exemple crĂ©e un Ă©lĂ©ment de menu, puis met Ă jour son titre lorsque l'utilisateur clique dessus : + +```js +function onUpdated() { console.log("item updated successfully"); } @@ -146,21 +141,20 @@ browser.menus.onClicked.addListener(function(info, tab) { }); updating.then(onUpdated, onError); } -});</pre> - -<p>{{WebExtExamples}}</p> +}); +``` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{WebExtExamples}} -<p>{{Compat("webextensions.api.menus.update", 10)}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.menus.update", 10)}} -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/contextMenus"><code>chrome.contextMenus</code></a> de chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json"><code>context_menus.json</code></a> dans le code Chromium.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.contextMenus`](https://developer.chrome.com/extensions/contextMenus) de chromium. Cette documentation est dĂ©rivĂ©e de [`context_menus.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/context_menus.json) dans le code Chromium. -<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 @@ -187,5 +181,4 @@ browser.menus.onClicked.addListener(function(info, tab) { // 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/notifications/clear/index.md b/files/fr/mozilla/add-ons/webextensions/api/notifications/clear/index.md index c0bf295d6b..ae28407604 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/notifications/clear/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/notifications/clear/index.md @@ -13,39 +13,39 @@ tags: - clear translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/clear --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Efface une notification, compte tenu de son identifiant.</p> +Efface une notification, compte tenu de son identifiant. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 clearing = browser.notifications.clear( +```js +var clearing = browser.notifications.clear( 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 la notification Ă effacer. C'est la mĂȘme chose que l'ID transmis dans le callback {{WebExtAPIRef('notifications.create()')}}.</dd> -</dl> +- `id` + - : `string`. L'ID de la notification Ă effacer. C'est la mĂȘme chose que l'ID transmis dans le callback {{WebExtAPIRef('notifications.create()')}}. -<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 boolĂ©en : <code>true</code> la notification a Ă©tĂ© effacĂ©e, ou <code>false</code> si ce n'est pas le cas (par exemple, parce que la notification rĂ©fĂ©rencĂ©e par <code>id </code> n'existe pas).</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un boolĂ©en : `true` la notification a Ă©tĂ© effacĂ©e, ou `false` si ce n'est pas le cas (par exemple, parce que la notification rĂ©fĂ©rencĂ©e par `id ` n'existe pas). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.notifications.clear")}}</p> +{{Compat("webextensions.api.notifications.clear")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple affiche une notification lorsque l'utilisateur clique sur une action du navigateur, Ă moins que la notification ne soit dĂ©jĂ affichĂ©e, auquel cas il efface la notification :</p> +Cet exemple affiche une notification lorsque l'utilisateur clique sur une action du navigateur, Ă moins que la notification ne soit dĂ©jĂ affichĂ©e, auquel cas il efface la notification : -<pre class="brush: js">var myNotification = "my-notification"; +```js +var myNotification = "my-notification"; function toggleAlarm(all) { if (myNotification in all) { @@ -66,13 +66,12 @@ function handleClick() { } browser.browserAction.onClicked.addListener(handleClick); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/notifications"><code>chrome.notifications</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.notifications`](https://developer.chrome.com/extensions/notifications). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/notifications/create/index.md b/files/fr/mozilla/add-ons/webextensions/api/notifications/create/index.md index 7180da2576..bc3fc15529 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/notifications/create/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/notifications/create/index.md @@ -13,52 +13,50 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/create --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>CrĂ©e et affiche une notification.</p> +CrĂ©e et affiche une notification. -<p>Passez un {{WebExtAPIRef("notifications.NotificationOptions")}} pour dĂ©finir le contenu et le comportement de la notification.</p> +Passez un {{WebExtAPIRef("notifications.NotificationOptions")}} pour dĂ©finir le contenu et le comportement de la notification. -<p>Vous pouvez Ă©ventuellement fournir un ID pour la notification. Si vous omettez l'ID, un ID sera gĂ©nĂ©rĂ©. Vous pouvez utiliser l'ID pour {{WebExtAPIRef("notifications.update()", "update")}} ou {{WebExtAPIRef("notifications.clear()", "clear")}} la notification.</p> +Vous pouvez Ă©ventuellement fournir un ID pour la notification. Si vous omettez l'ID, un ID sera gĂ©nĂ©rĂ©. Vous pouvez utiliser l'ID pour {{WebExtAPIRef("notifications.update()", "update")}} ou {{WebExtAPIRef("notifications.clear()", "clear")}} la notification. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<div class="warning"> -<p><strong>Attention :</strong> Si vous appelez <code>notifications.create()</code> plus d'une fois de suite, Firefox peut ne pas afficher de notification pour tout.</p> -</div> +> **Attention :** Si vous appelez `notifications.create()` plus d'une fois de suite, Firefox peut ne pas afficher de notification pour tout. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var creating = browser.notifications.create( +```js +var creating = browser.notifications.create( id, // optional string options // NotificationOptions ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>id</code>{{optional_inline}}</dt> - <dd><code>string</code>. Ceci est utilisĂ© pour faire rĂ©fĂ©rence Ă cette notification dans {{WebExtAPIRef("notifications.update()")}}, {{WebExtAPIRef("notifications.clear()")}}, et les Ă©couteurs d'Ă©vĂ©nements. Si vous omettez cet argument ou passez une chaĂźne vide, un nouvel ID sera gĂ©nĂ©rĂ© pour cette notification. Si l'ID que vous fournissez correspond Ă l'ID d'une notification existante provenant de cette extension, l'autre notification sera effacĂ©e.</dd> - <dt><code>options</code></dt> - <dd>{{WebExtAPIRef('notifications.NotificationOptions')}}. DĂ©finit le contenu et le comportement de la notification.</dd> -</dl> +- `id`{{optional_inline}} + - : `string`. Ceci est utilisĂ© pour faire rĂ©fĂ©rence Ă cette notification dans {{WebExtAPIRef("notifications.update()")}}, {{WebExtAPIRef("notifications.clear()")}}, et les Ă©couteurs d'Ă©vĂ©nements. Si vous omettez cet argument ou passez une chaĂźne vide, un nouvel ID sera gĂ©nĂ©rĂ© pour cette notification. Si l'ID que vous fournissez correspond Ă l'ID d'une notification existante provenant de cette extension, l'autre notification sera effacĂ©e. +- `options` + - : {{WebExtAPIRef('notifications.NotificationOptions')}}. DĂ©finit le contenu et le comportement de la notification. -<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 lorsque la notification est crĂ©Ă©e et que le processus d'affichage a Ă©tĂ© dĂ©marrĂ©, avant que la notification ne s'affiche rĂ©ellement Ă l'utilisateur. Il est rempli avec une chaĂźne reprĂ©sentant l'identifiant de la notification.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie lorsque la notification est crĂ©Ă©e et que le processus d'affichage a Ă©tĂ© dĂ©marrĂ©, avant que la notification ne s'affiche rĂ©ellement Ă l'utilisateur. Il est rempli avec une chaĂźne reprĂ©sentant l'identifiant de la notification. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.notifications.create")}}</p> +{{Compat("webextensions.api.notifications.create")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>CrĂ©ez et affichez pĂ©riodiquement une notification de base Ă l'aide d'un {{WebExtAPIRef("alarms", "alarm")}}. En cliquant sur l'action du navigateur, la notification est rejetĂ©e.</p> +CrĂ©ez et affichez pĂ©riodiquement une notification de base Ă l'aide d'un {{WebExtAPIRef("alarms", "alarm")}}. En cliquant sur l'action du navigateur, la notification est rejetĂ©e. -<p>Notez que vous aurez besoin de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "alarms" pour crĂ©er des alarmes (ainsi que de la permission "notifications" pour crĂ©er des notifications).</p> +Notez que vous aurez besoin de la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "alarms" pour crĂ©er des alarmes (ainsi que de la permission "notifications" pour crĂ©er des notifications). -<pre class="brush: js">var cakeNotification = "cake-notification" +```js +var cakeNotification = "cake-notification" /* @@ -82,16 +80,18 @@ browser.alarms.onAlarm.addListener(function(alarm) { }); }); -browser.browserAction.onClicked.addListener(()=> { +browser.browserAction.onClicked.addListener(()=> { var clearing = browser.notifications.clear(cakeNotification); - clearing.then(() => { + clearing.then(() => { console.log("cleared"); }); -});</pre> +}); +``` -<p>Affichez une notification similaire, mais ajoutez des boutons nommant des gĂąteaux et consignez le gĂąteau sĂ©lectionnĂ© lorsque vous cliquez sur un bouton :</p> +Affichez une notification similaire, mais ajoutez des boutons nommant des gĂąteaux et consignez le gĂąteau sĂ©lectionnĂ© lorsque vous cliquez sur un bouton : -<pre class="brush: js">var cakeNotification = "cake-notification" +```js +var cakeNotification = "cake-notification" /* @@ -124,24 +124,23 @@ browser.alarms.onAlarm.addListener(function(alarm) { }); }); -browser.browserAction.onClicked.addListener(()=> { +browser.browserAction.onClicked.addListener(()=> { var clearing = browser.notifications.clear(cakeNotification); - clearing.then(() => { + clearing.then(() => { console.log("cleared"); }); }); -browser.notifications.onButtonClicked.addListener((id, index) => { +browser.notifications.onButtonClicked.addListener((id, index) => { browser.notifications.clear(id); console.log("You chose: " + buttons[index].title); }); -</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/notifications"><code>chrome.notifications</code></a>.</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.notifications`](https://developer.chrome.com/extensions/notifications). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/notifications/getall/index.md b/files/fr/mozilla/add-ons/webextensions/api/notifications/getall/index.md index fefafda8c5..45e67292c2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/notifications/getall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/notifications/getall/index.md @@ -13,36 +13,38 @@ tags: - getAll translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/getAll --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient toutes les notifications actuellement actives crĂ©Ă©es par l'extension.</p> +Obtient toutes les notifications actuellement actives crĂ©Ă©es par l'extension. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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.notifications.getAll() -</pre> +```js +var gettingAll = browser.notifications.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 accomplie avec un objet. Chaque notification actuellement active est une propriĂ©tĂ© de cet objet : le nom de la propriĂ©tĂ© est l'ID de la notification et la valeur de la propriĂ©tĂ© est un objet {{WebExtAPIRef("notifications.NotificationOptions")}} dĂ©crivant cette notification.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera accomplie avec un objet. Chaque notification actuellement active est une propriĂ©tĂ© de cet objet : le nom de la propriĂ©tĂ© est l'ID de la notification et la valeur de la propriĂ©tĂ© est un objet {{WebExtAPIRef("notifications.NotificationOptions")}} dĂ©crivant cette notification. -<p>Notez que vous pouvez dĂ©finir explicitement un ID pour une notification en le passant dans {{WebExtAPIRef("notifications.create()")}}. Si vous ne le faites pas, le navigateur en gĂ©nĂ©rera un. Les ID spĂ©cifiĂ©s explicitement sont des chaĂźnes, mais les ID gĂ©nĂ©rĂ©s sont des nombres. </p> +Notez que vous pouvez dĂ©finir explicitement un ID pour une notification en le passant dans {{WebExtAPIRef("notifications.create()")}}. Si vous ne le faites pas, le navigateur en gĂ©nĂ©rera un. Les ID spĂ©cifiĂ©s explicitement sont des chaĂźnes, mais les ID gĂ©nĂ©rĂ©s sont des nombres. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.notifications.getAll")}}</p> +{{Compat("webextensions.api.notifications.getAll")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple affiche une notification lorsque l'utilisateur clique sur une action du navigateur, Ă moins que la notification ne soit dĂ©jĂ affichĂ©e, auquel cas il efface la notification. Il utilise getAll() pour dĂ©terminer si la notification est affichĂ©e :</p> +Cet exemple affiche une notification lorsque l'utilisateur clique sur une action du navigateur, Ă moins que la notification ne soit dĂ©jĂ affichĂ©e, auquel cas il efface la notification. Il utilise getAll() pour dĂ©terminer si la notification est affichĂ©e : -<pre class="brush: js">var myNotification = "my-notification"; +```js +var myNotification = "my-notification"; function toggleAlarm(all) { let ids = Object.keys(all); @@ -64,23 +66,25 @@ function handleClick() { browser.notifications.getAll().then(toggleAlarm); } -browser.browserAction.onClicked.addListener(handleClick);</pre> +browser.browserAction.onClicked.addListener(handleClick); +``` -<p>Cet exemple enregistre le titre de toutes les notifications actives :</p> +Cet exemple enregistre le titre de toutes les notifications actives : -<pre class="brush: js">function logNotifications(all) { +```js +function logNotifications(all) { for (let id in all) { console.log(`Title: ${all[id].title}`); } } -browser.notifications.getAll().then(logNotifications);</pre> +browser.notifications.getAll().then(logNotifications); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/notifications"><code>chrome.notifications</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.notifications`](https://developer.chrome.com/extensions/notifications). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/notifications/index.md b/files/fr/mozilla/add-ons/webextensions/api/notifications/index.md index 128a0bc7e6..94f2f3ab66 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/notifications/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/notifications/index.md @@ -9,58 +9,51 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/notifications --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Afficher les notifications Ă l'utilisateur, en utilisant le mĂ©canisme de notification du systĂšme d'exploitation sous-jacent. Ătant donnĂ© que cette API utilise le mĂ©canisme de notification du systĂšme d'exploitation, les dĂ©tails de l'apparence et du comportement des notifications peuvent varier en fonction du systĂšme d'exploitation et des paramĂštres de l'utilisateur.</p> +Afficher les notifications Ă l'utilisateur, en utilisant le mĂ©canisme de notification du systĂšme d'exploitation sous-jacent. Ătant donnĂ© que cette API utilise le mĂ©canisme de notification du systĂšme d'exploitation, les dĂ©tails de l'apparence et du comportement des notifications peuvent varier en fonction du systĂšme d'exploitation et des paramĂštres de l'utilisateur. -<p>Pour utiliser cette API, vous devez avoir la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "notifications".</p> +Pour utiliser cette API, vous devez avoir la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) "notifications". -<p>La notification est identique sur tous les systĂšmes d'exploitation de bureau. Quelque chose comme :</p> +La notification est identique sur tous les systĂšmes d'exploitation de bureau. Quelque chose comme : -<p><img alt="" src="notification.png"></p> +![](notification.png) -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("notifications.NotificationOptions")}}</dt> - <dd>DĂ©finit le contenu d'une notification.</dd> - <dt>{{WebExtAPIRef("notifications.TemplateType")}}</dt> - <dd>Le type de notification Par exemple, cela dĂ©finit si la notification peut contenir une image.</dd> -</dl> +- {{WebExtAPIRef("notifications.NotificationOptions")}} + - : DĂ©finit le contenu d'une notification. +- {{WebExtAPIRef("notifications.TemplateType")}} + - : Le type de notification Par exemple, cela dĂ©finit si la notification peut contenir une image. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("notifications.clear()")}}</dt> - <dd>Effacer une notification spĂ©cifique, compte tenu de son identifiant.</dd> - <dt>{{WebExtAPIRef("notifications.create()")}}</dt> - <dd> CrĂ©ez et affichez une nouvelle notification.</dd> - <dt>{{WebExtAPIRef("notifications.getAll()")}}</dt> - <dd>Recevez toutes les notifications</dd> - <dt>{{WebExtAPIRef("notifications.update()")}}</dt> - <dd>Mettre Ă jour une notification</dd> -</dl> +- {{WebExtAPIRef("notifications.clear()")}} + - : Effacer une notification spĂ©cifique, compte tenu de son identifiant. +- {{WebExtAPIRef("notifications.create()")}} + - :  CrĂ©ez et affichez une nouvelle notification. +- {{WebExtAPIRef("notifications.getAll()")}} + - : Recevez toutes les notifications +- {{WebExtAPIRef("notifications.update()")}} + - : Mettre Ă jour une notification -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt>{{WebExtAPIRef("notifications.onButtonClicked")}}</dt> - <dd>LancĂ© lorsque l'utilisateur a cliquĂ© sur un bouton dans la notification.</dd> - <dt>{{WebExtAPIRef("notifications.onClicked")}}</dt> - <dd>LancĂ© lorsque l'utilisateur a cliquĂ© sur la notification, mais pas sur un bouton.</dd> - <dt>{{WebExtAPIRef("notifications.onClosed")}}</dt> - <dd>LancĂ© lorsqu'une notification est fermĂ©e, soit par le systĂšme, soit parce que l'utilisateur l'a rejetĂ©..</dd> - <dt>{{WebExtAPIRef("notifications.onShown")}}</dt> - <dd>LancĂ© immĂ©diatement aprĂšs l'affichage d'une notification.</dd> -</dl> +- {{WebExtAPIRef("notifications.onButtonClicked")}} + - : LancĂ© lorsque l'utilisateur a cliquĂ© sur un bouton dans la notification. +- {{WebExtAPIRef("notifications.onClicked")}} + - : LancĂ© lorsque l'utilisateur a cliquĂ© sur la notification, mais pas sur un bouton. +- {{WebExtAPIRef("notifications.onClosed")}} + - : LancĂ© lorsqu'une notification est fermĂ©e, soit par le systĂšme, soit parce que l'utilisateur l'a rejetĂ©.. +- {{WebExtAPIRef("notifications.onShown")}} + - : LancĂ© immĂ©diatement aprĂšs l'affichage d'une notification. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.notifications")}}</p> +{{Compat("webextensions.api.notifications")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<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/notifications"><code>chrome.notifications</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.notifications`](https://developer.chrome.com/extensions/notifications). diff --git a/files/fr/mozilla/add-ons/webextensions/api/notifications/notificationoptions/index.md b/files/fr/mozilla/add-ons/webextensions/api/notifications/notificationoptions/index.md index 4202939183..515f9887f1 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/notifications/notificationoptions/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/notifications/notificationoptions/index.md @@ -12,75 +12,72 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/NotificationOptions --- -<div>{{AddonSidebar()}}</div> - -<p>Ce type contient les donnĂ©es nĂ©cessaires pour :</p> - -<ul> - <li>crĂ©er une notification avec {{WebExtAPIRef("notifications.create()")}},</li> - <li>mettre Ă jour une notification avec {{WebExtAPIRef("notifications.update()")}}.</li> -</ul> - -<h2 id="Type">Type</h2> - -<p>Les valeurs de ce type sont des objets qui contiennent les propriĂ©tĂ©s listĂ©es ci-dessous.</p> - -<p>Les trois premiĂšres propriĂ©tĂ©s - <code>type</code>, <code>title</code>, <code>message</code> - sont obligatoires pour {{WebExtAPIRef("notifications.create()")}}, mais pas avec {{WebExtAPIRef("notifications.update()")}}. Firefox ne supporte que les propriĂ©tĂ©s <code>type</code>, <code>title</code>, <code>message</code>, et <code>iconUrl</code> pour le moment, et le seul <code>type</code> disponible est <code>'basic'</code>.</p> - -<dl> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef("notifications.TemplateType")}}. Le type de notification que vous voulez. Selon votre choix ici, certaines propriĂ©tĂ©s seront soit nĂ©cĂ©ssaires, soit interdites.</dd> - <dt><code>message</code></dt> - <dd><code>string</code>. Le contenu de la notification</dd> - <dt><code>title</code></dt> - <dd><code>string</code>. Le titre de la notification</dd> - <dt><code>iconUrl</code>{{optional_inline}}</dt> - <dd><code>string</code>. Une URL correspondant vers une icĂŽne Ă afficher dans la notification. Ăa peut ĂȘtre une URL de donnĂ©e, une URL blob, une URL http ou https, ou une <a href="/fr/Add-ons/WebExtensions/Chrome_incompatibilities#Relative_URLs">l'URL relative</a> d'un fichier de l'extension.</dd> - <dt><code>contextMessage</code>{{optional_inline}}</dt> - <dd><code>string</code>. Du texte supplĂ©mentaire Ă afficher.</dd> - <dt><code>priority</code>{{optional_inline}}</dt> - <dd><code>number</code>. La prioritĂ© de cette notification. Ăa peut ĂȘtre 0, 1, or 2. La valeur par dĂ©faut est 0.</dd> - <dt><code>eventTime</code>{{optional_inline}}</dt> - <dd><code>number</code>. Un timestamp en millisecondes pour cette notification <a href="https://fr.wikipedia.org/wiki/Temps_Unix">depuis le timestamp 0</a>.</dd> - <dt><code>buttons</code>{{optional_inline}}</dt> - <dd><p><code>array</code> de <code>button</code>. Un tableau pouvant contenir jusqu'Ă deux boutons Ă afficher dans la notification. Vous pouvez rĂ©agir aux clics sur ces boutons grĂące Ă {{WebExtAPIRef("notifications.onButtonClicked")}}. Chaque bouton est un objet avec ces propriĂ©tĂ©s :</p> - <dl> - <dt><code>title</code></dt> - <dd><code>string</code>. Le texte du bouton.</dd> - <dt><code>iconUrl</code>{{optional_inline}}</dt> - <dd><code>string</code>. Une URL pointant vers l'icĂŽne de ce bouton.</dd> - </dl> - </dd> - <dt><code>imageUrl</code></dt> - <dd> - <p><code>string</code>. Une URL pointant vers une image Ă utiliser dans la notification. Ăa peut ĂȘtre une URL de donnĂ©e, une URL blob, une URL http ou https, ou une <a href="/fr/Add-ons/WebExtensions/Chrome_incompatibilities#Relative_URLs">l'URL relative</a> d'un fichier de l'extension.</p> - - <p><em>Cette propriĂ©tĂ© est utilisable seuleument si le <code>type</code> de la notification est <code>'image'</code>. Dans ce cas, cette propriĂ©tĂ© sera obligatoire si l'objet <code>NotificationOptions</code> est utilisĂ© avec {{WebExtAPIRef("notifications.create()")}}, mais optionel avec </em><em>{{WebExtAPIRef("notifications.update()")}}.</em></p> - </dd> - <dt><code>items</code></dt> - <dd><p><code>array</code> of <code>item</code>. Un tableau d'Ă©lĂ©ments Ă inclure dans la notification. Selon les paramĂštres de notification du systĂšme d'exploitation, certains Ă©lĂ©ments que vous souhaitez afficher pourraient ne pas l'ĂȘtre. Chaque Ă©lĂ©ment est un objet avec les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>title</code></dt> - <dd><code>string</code>. Le titre de cet Ă©lĂ©ment.</dd> - <dt><code>message</code></dt> - <dd><code>string</code>. Le message Ă afficher pour cet Ă©lĂ©ment.</dd> - </dl> - <p><em>Cette propriĂ©tĂ© est utilisable seuleument si le <code>type</code> de la notification est <code>'list'</code>. Dans ce cas, cette propriĂ©tĂ© sera obligatoire si l'objet <code>NotificationOptions</code> est utilisĂ© avec {{WebExtAPIRef("notifications.create()")}}, mais optionel avec </em><em>{{WebExtAPIRef("notifications.update()")}}.</em></p></dd> - <dt><code>progress</code></dt> - <dd><code>integer</code>. Une valeur entre 0 et 100, qui reprĂ©sente l'avancĂ©e actuelle d'un indicateur de progression. <em>Cette propriĂ©tĂ© est utilisable seuleument si le <code>type</code> de la notification est <code>'progress'</code>. Dans ce cas, cette propriĂ©tĂ© sera obligatoire si l'objet <code>NotificationOptions</code> est utilisĂ© avec {{WebExtAPIRef("notifications.create()")}}, mais optionel avec </em><em>{{WebExtAPIRef("notifications.update()")}}.</em></dd> -</dl> - -<p>Notez que les propriĂ©tĂ©s <code>appIconMaskUrl</code> et <code>isClickable</code> ne sont pas supportĂ©es.</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.notifications.NotificationOptions")}}</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/notifications"><code>chrome.notifications</code></a>.</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> +{{AddonSidebar()}} + +Ce type contient les donnĂ©es nĂ©cessaires pour : + +- crĂ©er une notification avec {{WebExtAPIRef("notifications.create()")}}, +- mettre Ă jour une notification avec {{WebExtAPIRef("notifications.update()")}}. + +## Type + +Les valeurs de ce type sont des objets qui contiennent les propriĂ©tĂ©s listĂ©es ci-dessous. + +Les trois premiĂšres propriĂ©tĂ©s - `type`, `title`, `message` - sont obligatoires pour {{WebExtAPIRef("notifications.create()")}}, mais pas avec {{WebExtAPIRef("notifications.update()")}}. Firefox ne supporte que les propriĂ©tĂ©s `type`, `title`, `message`, et `iconUrl` pour le moment, et le seul `type` disponible est `'basic'`. + +- `type` + - : {{WebExtAPIRef("notifications.TemplateType")}}. Le type de notification que vous voulez. Selon votre choix ici, certaines propriĂ©tĂ©s seront soit nĂ©cĂ©ssaires, soit interdites. +- `message` + - : `string`. Le contenu de la notification +- `title` + - : `string`. Le titre de la notification +- `iconUrl`{{optional_inline}} + - : `string`. Une URL correspondant vers une icĂŽne Ă afficher dans la notification. Ăa peut ĂȘtre une URL de donnĂ©e, une URL blob, une URL http ou https, ou une [l'URL relative](/fr/Add-ons/WebExtensions/Chrome_incompatibilities#Relative_URLs) d'un fichier de l'extension. +- `contextMessage`{{optional_inline}} + - : `string`. Du texte supplĂ©mentaire Ă afficher. +- `priority`{{optional_inline}} + - : `number`. La prioritĂ© de cette notification. Ăa peut ĂȘtre 0, 1, or 2. La valeur par dĂ©faut est 0. +- `eventTime`{{optional_inline}} + - : `number`. Un timestamp en millisecondes pour cette notification [depuis le timestamp 0](https://fr.wikipedia.org/wiki/Temps_Unix). +- `buttons`{{optional_inline}} + + - : `array` de `button`. Un tableau pouvant contenir jusqu'Ă deux boutons Ă afficher dans la notification. Vous pouvez rĂ©agir aux clics sur ces boutons grĂące Ă {{WebExtAPIRef("notifications.onButtonClicked")}}. Chaque bouton est un objet avec ces propriĂ©tĂ©s : + + - `title` + - : `string`. Le texte du bouton. + - `iconUrl`{{optional_inline}} + - : `string`. Une URL pointant vers l'icĂŽne de ce bouton. + +- `imageUrl` + + - : `string`. Une URL pointant vers une image Ă utiliser dans la notification. Ăa peut ĂȘtre une URL de donnĂ©e, une URL blob, une URL http ou https, ou une [l'URL relative](/fr/Add-ons/WebExtensions/Chrome_incompatibilities#Relative_URLs) d'un fichier de l'extension. + + _Cette propriĂ©tĂ© est utilisable seuleument si le `type` de la notification est `'image'`. Dans ce cas, cette propriĂ©tĂ© sera obligatoire si l'objet `NotificationOptions` est utilisĂ© avec {{WebExtAPIRef("notifications.create()")}}, mais optionel avec_ _{{WebExtAPIRef("notifications.update()")}}._ + +- `items` + + - : `array` of `item`. Un tableau d'Ă©lĂ©ments Ă inclure dans la notification. Selon les paramĂštres de notification du systĂšme d'exploitation, certains Ă©lĂ©ments que vous souhaitez afficher pourraient ne pas l'ĂȘtre. Chaque Ă©lĂ©ment est un objet avec les propriĂ©tĂ©s suivantes : + + - `title` + - : `string`. Le titre de cet Ă©lĂ©ment. + - `message` + - : `string`. Le message Ă afficher pour cet Ă©lĂ©ment. + + _Cette propriĂ©tĂ© est utilisable seuleument si le `type` de la notification est `'list'`. Dans ce cas, cette propriĂ©tĂ© sera obligatoire si l'objet `NotificationOptions` est utilisĂ© avec {{WebExtAPIRef("notifications.create()")}}, mais optionel avec_ _{{WebExtAPIRef("notifications.update()")}}._ + +- `progress` + - : `integer`. Une valeur entre 0 et 100, qui reprĂ©sente l'avancĂ©e actuelle d'un indicateur de progression. _Cette propriĂ©tĂ© est utilisable seuleument si le `type` de la notification est `'progress'`. Dans ce cas, cette propriĂ©tĂ© sera obligatoire si l'objet `NotificationOptions` est utilisĂ© avec {{WebExtAPIRef("notifications.create()")}}, mais optionel avec_ _{{WebExtAPIRef("notifications.update()")}}._ + +Notez que les propriĂ©tĂ©s `appIconMaskUrl` et `isClickable` ne sont pas supportĂ©es. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.notifications.NotificationOptions")}} + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API chromium [`chrome.notifications`](https://developer.chrome.com/extensions/notifications). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/notifications/onbuttonclicked/index.md b/files/fr/mozilla/add-ons/webextensions/api/notifications/onbuttonclicked/index.md index 7a3ded3472..29c6c8501a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/notifications/onbuttonclicked/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/notifications/onbuttonclicked/index.md @@ -13,55 +13,48 @@ tags: - onButtonClicked translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/onButtonClicked --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque l'utilisateur clique sur l'un des boutons de la notification.</p> +LancĂ© lorsque l'utilisateur clique sur l'un des boutons de la notification. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.notifications.onButtonClicked.addListener(listener) +```js +browser.notifications.onButtonClicked.addListener(listener) browser.notifications.onButtonClicked.removeListener(listener) browser.notifications.onButtonClicked.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="Parameters">Parameters</h3> +### Parameters -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>notificationId</code></dt> - <dd><code>string</code>. ID de la notification sur laquelle le bouton a Ă©tĂ© cliquĂ©.</dd> - <dt><code>buttonIndex</code></dt> - <dd><code>integer</code>. L'index <a href="https://en.wikipedia.org/wiki/Zero-based_numbering">zero-based</a> du bouton sur lequel vous avez cliquĂ©.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `notificationId` + - : `string`. ID de la notification sur laquelle le bouton a Ă©tĂ© cliquĂ©. + - `buttonIndex` + - : `integer`. L'index [zero-based](https://en.wikipedia.org/wiki/Zero-based_numbering) du bouton sur lequel vous avez cliquĂ©. -<p>{{Compat("webextensions.api.notifications.onButtonClicked")}}</p> +## CompatibilitĂ© du navigateur -<p>{{WebExtExamples}}</p> +{{Compat("webextensions.api.notifications.onButtonClicked")}} -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/notifications"><code>chrome.notifications</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.notifications`](https://developer.chrome.com/extensions/notifications). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/notifications/onclicked/index.md b/files/fr/mozilla/add-ons/webextensions/api/notifications/onclicked/index.md index ec5580789f..50cdd59bc0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/notifications/onclicked/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/notifications/onclicked/index.md @@ -13,61 +13,56 @@ tags: - onClicked translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/onClicked --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque l'utilisateur clique sur une notification, mais pas sur l'un des boutons de la notification (pour cela, voir {{WebExtAPIRef("notifications.onButtonClicked")}}).</p> +LancĂ© lorsque l'utilisateur clique sur une notification, mais pas sur l'un des boutons de la notification (pour cela, voir {{WebExtAPIRef("notifications.onButtonClicked")}}). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.notifications.onClicked.addListener(listener) +```js +browser.notifications.onClicked.addListener(listener) browser.notifications.onClicked.removeListener(listener) browser.notifications.onClicked.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="syntaxe_addListener">syntaxe addListener</h2> +## syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>notificationId</code></dt> - <dd><code>string</code>. ID de la notification sur laquelle l'utilisateur a cliquĂ©.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `notificationId` + - : `string`. ID de la notification sur laquelle l'utilisateur a cliquĂ©. -<p>{{Compat("webextensions.api.notifications.onClicked")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.notifications.onClicked")}} -<p>Dans cet exemple simple, nous ajoutons un Ă©couteur Ă l'Ă©vĂ©nement {{WebExtAPIRef("notifications.onClicked")}} pour Ă©couter les notifications systĂšme en cours de clic. Lorsque cela se produit, nous enregistrons un message appropriĂ© Ă la console.</p> +## Exemples -<pre class="brush: js">browser.notifications.onClicked.addListener(function(notificationId) { - console.log('Notification ' + notificationId + ' was clicked by the user'); -});</pre> - -<p>{{WebExtExamples}}</p> +Dans cet exemple simple, nous ajoutons un Ă©couteur Ă l'Ă©vĂ©nement {{WebExtAPIRef("notifications.onClicked")}} pour Ă©couter les notifications systĂšme en cours de clic. Lorsque cela se produit, nous enregistrons un message appropriĂ© Ă la console. -<div class="note"><p><strong>Note :</strong></p> +```js +browser.notifications.onClicked.addListener(function(notificationId) { + console.log('Notification ' + notificationId + ' was clicked by the user'); +}); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/notifications"><code>chrome.notifications</code></a>.</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.notifications`](https://developer.chrome.com/extensions/notifications). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/notifications/onclosed/index.md b/files/fr/mozilla/add-ons/webextensions/api/notifications/onclosed/index.md index 4c2c3fd405..213bc42757 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/notifications/onclosed/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/notifications/onclosed/index.md @@ -13,63 +13,58 @@ tags: - onClosed translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/onClosed --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'une notification est fermĂ©e, soit par le systĂšme, soit par l'utilisateur.</p> +LancĂ© lorsqu'une notification est fermĂ©e, soit par le systĂšme, soit par l'utilisateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.notifications.onClosed.addListener(listener) +```js +browser.notifications.onClosed.addListener(listener) browser.notifications.onClosed.removeListener(listener) browser.notifications.onClosed.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> st l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> st enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` st l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` st enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="Parameters">Parameters</h3> +### Parameters -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>notificationId</code></dt> - <dd><code>string</code>. ID de la notification fermĂ©e.</dd> - <dt><code>byUser</code></dt> - <dd><code>boolean</code>. <code>true</code> si la notification a Ă©tĂ© fermĂ©e par l'utilisateur, ou <code>false</code>si elle a Ă©tĂ© fermĂ©e par le systĂšme. Cet argument n'est pas supportĂ© dans Firefox.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `notificationId` + - : `string`. ID de la notification fermĂ©e. + - `byUser` + - : `boolean`. `true` si la notification a Ă©tĂ© fermĂ©e par l'utilisateur, ou `false`si elle a Ă©tĂ© fermĂ©e par le systĂšme. Cet argument n'est pas supportĂ© dans Firefox. -<p>{{Compat("webextensions.api.notifications.onClosed")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.notifications.onClosed")}} -<p>Dans cet exemple simple, nous ajoutons un Ă©couteur Ă l'Ă©vĂ©nement {{WebExtAPIRef("notifications.onClosed")}} pour Ă©couter les notifications systĂšme fermĂ©es. Lorsque cela se produit, nous enregistrons un message appropriĂ© Ă la console.</p> +## Exemples -<pre class="brush: js">browser.notifications.onClosed.addListener(function(notificationId) { - console.log('Notification ' + notificationId + ' has closed.'); -});</pre> - -<p>{{WebExtExamples}}</p> +Dans cet exemple simple, nous ajoutons un Ă©couteur Ă l'Ă©vĂ©nement {{WebExtAPIRef("notifications.onClosed")}} pour Ă©couter les notifications systĂšme fermĂ©es. Lorsque cela se produit, nous enregistrons un message appropriĂ© Ă la console. -<div class="note"><p><strong>Note :</strong></p> +```js +browser.notifications.onClosed.addListener(function(notificationId) { + console.log('Notification ' + notificationId + ' has closed.'); +}); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/notifications"><code>chrome.notifications</code></a>.</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.notifications`](https://developer.chrome.com/extensions/notifications). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/notifications/onshown/index.md b/files/fr/mozilla/add-ons/webextensions/api/notifications/onshown/index.md index 3514c20062..ec6176caf9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/notifications/onshown/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/notifications/onshown/index.md @@ -12,64 +12,59 @@ tags: - onShown translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/onShown --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© immĂ©diatement aprĂšs l'affichage d'une notification.</p> +LancĂ© immĂ©diatement aprĂšs l'affichage d'une notification. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.notifications.onShown.addListener(listener) +```js +browser.notifications.onShown.addListener(listener) browser.notifications.onShown.removeListener(listener) browser.notifications.onShown.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code>s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true`s'il Ă©coute, sinon `false`. -<h2 id="syntaxe_addListener">syntaxe addListener</h2> +## syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>notificationId</code></dt> - <dd><code>string</code>. ID de la notification qui a Ă©tĂ© affichĂ©e.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `notificationId` + - : `string`. ID de la notification qui a Ă©tĂ© affichĂ©e. -<p>{{Compat("webextensions.api.notifications.onShown")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.notifications.onShown")}} -<p>Ajoutez un Ă©couteur Ă l'Ă©vĂ©nement {{WebExtAPIRef("notifications.onShown")}} et consignez ses dĂ©tails :</p> +## Exemples -<pre class="brush: js">function logShown(itemId) { +Ajoutez un Ă©couteur Ă l'Ă©vĂ©nement {{WebExtAPIRef("notifications.onShown")}} et consignez ses dĂ©tails : + +```js +function logShown(itemId) { console.log(`shown: ${itemId}`); - browser.notifications.getAll().then((all) => { + browser.notifications.getAll().then((all) => { console.log(all[itemId]); }) } -browser.notifications.onShown.addListener(logShown);</pre> - -<p>{{WebExtExamples}}</p> +browser.notifications.onShown.addListener(logShown); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/notifications"><code>chrome.notifications</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.notifications`](https://developer.chrome.com/extensions/notifications). diff --git a/files/fr/mozilla/add-ons/webextensions/api/notifications/templatetype/index.md b/files/fr/mozilla/add-ons/webextensions/api/notifications/templatetype/index.md index b949e5233a..6b6e752f4d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/notifications/templatetype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/notifications/templatetype/index.md @@ -13,55 +13,46 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/TemplateType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ceci est une chaĂźne et reprĂ©sente le type de notification Ă crĂ©er. Il existe quatre types de notification : "basic", "image", "list", "progress".</p> +Ceci est une chaĂźne et reprĂ©sente le type de notification Ă crĂ©er. Il existe quatre types de notification : "basic", "image", "list", "progress". -<p>Ceci est passĂ© dans {{WebExtAPIRef("notifications.create()")}} et {{WebExtAPIRef("notifications.update()")}} comme propriĂ©tĂ© de <code>type</code> {{WebExtAPIRef("notifications.NotificationOptions", "NotificationOptions")}}.</p> +Ceci est passĂ© dans {{WebExtAPIRef("notifications.create()")}} et {{WebExtAPIRef("notifications.update()")}} comme propriĂ©tĂ© de `type` {{WebExtAPIRef("notifications.NotificationOptions", "NotificationOptions")}}. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<ul> - <li><code>"basic"</code>: la notification comprend : +- `"basic"`: la notification comprend : - <ul> - <li>un titre (<code><a href="/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#title">NotificationOptions.title</a></code>)</li> - <li>un message (<code><a href="/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#message">NotificationOptions.message</a></code>)</li> - <li>une icĂŽne (<code><a href="/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#iconUrl">NotificationOptions.iconUrl</a></code>){{optional_inline}}</li> - <li>un message supplĂ©mentaire (<code><a href="/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#contextMessage">NotificationOptions.contextMessage</a></code>){{optional_inline}}</li> - <li>jusqu'Ă deux boutons (<code><a href="/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#buttons">NotificationOptions.buttons</a></code>){{optional_inline}}</li> - </ul> - </li> - <li><code>"image"</code>: tout dans <code>"basic"</code> et aussi : - <ul> - <li>Une image (<code><a href="/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#imageUrl">NotificationOptions.imageUrl</a></code>)</li> - </ul> - </li> - <li><code>"list"</code>: tout dans <code>"basic"</code> et aussi : - <ul> - <li>Une liste d'Ă©lĂ©ments (<code><a href="/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#items">NotificationOptions.items</a></code>)</li> - </ul> - </li> - <li><code>"progress"</code>: tout en <code>"basic"</code> et aussi : - <ul> - <li>Un indicator de progression (<code><a href="/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#progress">NotificationOptions.progress</a></code>)</li> - </ul> - </li> -</ul> + - un titre ([`NotificationOptions.title`](/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#title)) + - un message ([`NotificationOptions.message`](/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#message)) + - une icĂŽne ([`NotificationOptions.iconUrl`](/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#iconUrl)){{optional_inline}} + - un message supplĂ©mentaire ([`NotificationOptions.contextMessage`](/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#contextMessage)){{optional_inline}} + - jusqu'Ă deux boutons ([`NotificationOptions.buttons`](/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#buttons)){{optional_inline}} -<p>Actuellement Firefox ne supporte que "basic" ici.</p> +- `"image"`: tout dans `"basic"` et aussi : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - Une image ([`NotificationOptions.imageUrl`](/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#imageUrl)) -<p>{{Compat("webextensions.api.notifications.TemplateType")}}</p> +- `"list"`: tout dans `"basic"` et aussi : -<p>{{WebExtExamples}}</p> + - Une liste d'Ă©lĂ©ments ([`NotificationOptions.items`](/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#items)) -<div class="note"><p><strong>Note :</strong></p> +- `"progress"`: tout en `"basic"` et aussi : -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/notifications"><code>chrome.notifications</code></a>.</p> + - Un indicator de progression ([`NotificationOptions.progress`](/fr/Add-ons/WebExtensions/API/notifications/NotificationOptions#progress)) -<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> +Actuellement Firefox ne supporte que "basic" ici. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.notifications.TemplateType")}} + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.notifications`](https://developer.chrome.com/extensions/notifications). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/notifications/update/index.md b/files/fr/mozilla/add-ons/webextensions/api/notifications/update/index.md index 4ef3bc6280..04a7b66084 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/notifications/update/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/notifications/update/index.md @@ -13,44 +13,44 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/notifications/update --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Met Ă jour une notification, compte tenu de son identifiant</p> +Met Ă jour une notification, compte tenu de son identifiant -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 updating = browser.notifications.update( +```js +var updating = browser.notifications.update( id, // string options // NotificationOptions ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>id</code></dt> - <dd><code>string</code>. L'ID de la notification Ă mettre Ă jour. C'est la mĂȘme chose que l'ID transmis dans le callback {{WebExtAPIRef('notifications.create()')}}.</dd> - <dt><code>options</code></dt> - <dd>{{WebExtAPIRef('notifications.NotificationOptions')}}. DĂ©finit le nouveau contenu et le nouveau comportement de la notification.</dd> -</dl> +- `id` + - : `string`. L'ID de la notification Ă mettre Ă jour. C'est la mĂȘme chose que l'ID transmis dans le callback {{WebExtAPIRef('notifications.create()')}}. +- `options` + - : {{WebExtAPIRef('notifications.NotificationOptions')}}. DĂ©finit le nouveau contenu et le nouveau comportement de la notification. -<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 boolĂ©en : <code>true</code> si la notification a Ă©tĂ© mise Ă jour, ou <code>false</code> si ce n'est pas le cas (par exemple, parce que la notification rĂ©fĂ©rencĂ©e par <code>id</code> n'existe pas).</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un boolĂ©en : `true` si la notification a Ă©tĂ© mise Ă jour, ou `false` si ce n'est pas le cas (par exemple, parce que la notification rĂ©fĂ©rencĂ©e par `id` n'existe pas). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.notifications.update")}}</p> +{{Compat("webextensions.api.notifications.update")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple utilise <code>update()</code> pour mettre Ă jour une notification de progression. Cliquez sur l'action du navigateur pour afficher la notification et lancer un {{WebExtAPIRef("alarms", "alarm")}}, que nous utilisons pour mettre Ă jour l'indicateur de progression de la notification.</p> +Cet exemple utilise `update()` pour mettre Ă jour une notification de progression. Cliquez sur l'action du navigateur pour afficher la notification et lancer un {{WebExtAPIRef("alarms", "alarm")}}, que nous utilisons pour mettre Ă jour l'indicateur de progression de la notification. -<p>Notez que vous aurez besoin de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "alarms" pour crĂ©er des alarmes (ainsi que de la permission "notifications" pour crĂ©er des notifications). Notez Ă©galement que Firefox ne prend pas en charge l'attribut de <code>progress</code>.</p> +Notez que vous aurez besoin de la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "alarms" pour crĂ©er des alarmes (ainsi que de la permission "notifications" pour crĂ©er des notifications). Notez Ă©galement que Firefox ne prend pas en charge l'attribut de `progress`. -<pre class="brush: js">var cakeNotification = "cake-notification"; +```js +var cakeNotification = "cake-notification"; /* @@ -67,7 +67,7 @@ var progress = 0; browser.alarms.onAlarm.addListener(function(alarm) { progress = progress + 10; - if (progress > 100) { + if (progress > 100) { browser.notifications.clear(cakeNotification); browser.alarms.clear("cake-progress"); } else { @@ -78,8 +78,8 @@ browser.alarms.onAlarm.addListener(function(alarm) { }); browser.browserAction.onClicked.addListener(function () { - browser.notifications.getAll((all) => { - if (all.length > 0) { + browser.notifications.getAll((all) => { + if (all.length > 0) { browser.notifications.clear(cakeNotification); return; } @@ -96,13 +96,13 @@ browser.browserAction.onClicked.addListener(function () { {periodInMinutes: CAKE_PREP_INTERVAL} ); }); -});</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/notifications"><code>chrome.notifications</code></a>.</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.notifications`](https://developer.chrome.com/extensions/notifications). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/omnibox/index.md b/files/fr/mozilla/add-ons/webextensions/api/omnibox/index.md index 2cfcf11c69..3cac8008c6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/omnibox/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/omnibox/index.md @@ -10,61 +10,52 @@ tags: - omnibox translation_of: Mozilla/Add-ons/WebExtensions/API/omnibox --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Permet aux extensions d'implĂ©menter un comportement personnalisĂ© lorsque l'utilisateur tape dans la barre d'adresse du navigateur.</p> +Permet aux extensions d'implĂ©menter un comportement personnalisĂ© lorsque l'utilisateur tape dans la barre d'adresse du navigateur. -<p>Lorsque l'utilisateur se concentre sur la barre d'adresse du navigateur et commence Ă taper, le navigateur affiche une liste dĂ©roulante contenant des pages suggĂ©rĂ©es, en fonction de ce qu'ils ont tapĂ©. Cela permet Ă l'utilisateur d'accĂ©der rapidement, par exemple, aux pages de son historique ou de ses favoris.</p> +Lorsque l'utilisateur se concentre sur la barre d'adresse du navigateur et commence Ă taper, le navigateur affiche une liste dĂ©roulante contenant des pages suggĂ©rĂ©es, en fonction de ce qu'ils ont tapĂ©. Cela permet Ă l'utilisateur d'accĂ©der rapidement, par exemple, aux pages de son historique ou de ses favoris. -<p>L'API omnibox fournit Ă l'extension un moyen de personnaliser les suggestions affichĂ©es dans la liste dĂ©roulante, lorsque l'utilisateur saisit un mot clĂ© dĂ©fini par l'extension. Cela fonctionne comme suit:...</p> +L'API omnibox fournit Ă l'extension un moyen de personnaliser les suggestions affichĂ©es dans la liste dĂ©roulante, lorsque l'utilisateur saisit un mot clĂ© dĂ©fini par l'extension. Cela fonctionne comme suit:... -<ol> - <li>Tout d'abord, l'extension doit inclure une clĂ©Â "<a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/omnibox">omnibox</a>" dans le fichier <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json">manifest.json</a> qui dĂ©finit un mot-clĂ©.</li> - <li>Lorsque l'utilisateur met la barre d'adresse en surbrillance et tape le mot-clĂ©, suivi d'un espace, l'extension recevra un Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputStarted")}}.</li> - <li>Facultativement, l'extension peut appeler {{WebExtAPIRef("omnibox.setDefaultSuggestion()")}} pour dĂ©finir la premiĂšre suggestion qui sera affichĂ©e dans la liste dĂ©roulante de la barre d'adresse.</li> - <li>Comme l'utilisateur continue Ă taper des caractĂšres aprĂšs cela, l'extension recevra {{WebExtAPIRef("omnibox.onInputChanged")}} Ă©vĂ©nements. L'Ă©couteur d'Ă©vĂ©nement recevra la valeur actuelle que l'utilisateur a saisie et pourra remplir la liste dĂ©roulante de la barre d'adresse avec des suggestions. Si l'extension dĂ©finit une suggestion par dĂ©faut en utilisant {{WebExtAPIRef("omnibox.setDefaultSuggestion()")}}, elle apparaĂźt en premier dans la liste dĂ©roulante.</li> - <li>Si l'utilisateur accepte une suggestion, l'extension recevra un Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputEntered")}}. L'Ă©couteur d'Ă©vĂ©nement recevra la suggestion acceptĂ©e.</li> - <li>Si l'utilisateur supprime la liste dĂ©roulante, l'extension recevra un Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputCancelled")}}.</li> -</ol> +1. Tout d'abord, l'extension doit inclure une clĂ©Â "[omnibox](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/omnibox)" dans le fichier [manifest.json](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json) qui dĂ©finit un mot-clĂ©. +2. Lorsque l'utilisateur met la barre d'adresse en surbrillance et tape le mot-clĂ©, suivi d'un espace, l'extension recevra un Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputStarted")}}. +3. Facultativement, l'extension peut appeler {{WebExtAPIRef("omnibox.setDefaultSuggestion()")}} pour dĂ©finir la premiĂšre suggestion qui sera affichĂ©e dans la liste dĂ©roulante de la barre d'adresse. +4. Comme l'utilisateur continue Ă taper des caractĂšres aprĂšs cela, l'extension recevra {{WebExtAPIRef("omnibox.onInputChanged")}} Ă©vĂ©nements. L'Ă©couteur d'Ă©vĂ©nement recevra la valeur actuelle que l'utilisateur a saisie et pourra remplir la liste dĂ©roulante de la barre d'adresse avec des suggestions. Si l'extension dĂ©finit une suggestion par dĂ©faut en utilisant {{WebExtAPIRef("omnibox.setDefaultSuggestion()")}}, elle apparaĂźt en premier dans la liste dĂ©roulante. +5. Si l'utilisateur accepte une suggestion, l'extension recevra un Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputEntered")}}. L'Ă©couteur d'Ă©vĂ©nement recevra la suggestion acceptĂ©e. +6. Si l'utilisateur supprime la liste dĂ©roulante, l'extension recevra un Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputCancelled")}}. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}}</dt> - <dd>DĂ©crit la mĂ©thode recommandĂ©e pour gĂ©rer la suggestion sĂ©lectionnĂ©e: ouvrir dans l'onglet actuel, ouvrir dans un nouvel onglet de premier plan ou ouvrir dans un nouvel onglet d'arriĂšre-plan.</dd> - <dt>{{WebExtAPIRef("omnibox.SuggestResult")}}</dt> - <dd>Objet reprĂ©sentant une suggestion Ă ajouter Ă la liste dĂ©roulante de la barre.</dd> -</dl> +- {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}} + - : DĂ©crit la mĂ©thode recommandĂ©e pour gĂ©rer la suggestion sĂ©lectionnĂ©e: ouvrir dans l'onglet actuel, ouvrir dans un nouvel onglet de premier plan ou ouvrir dans un nouvel onglet d'arriĂšre-plan. +- {{WebExtAPIRef("omnibox.SuggestResult")}} + - : Objet reprĂ©sentant une suggestion Ă ajouter Ă la liste dĂ©roulante de la barre. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("omnibox.setDefaultSuggestion()")}}</dt> - <dd>DĂ©finit la premiĂšre suggestion qui apparaĂźt dans la liste dĂ©roulante lorsque l'utilisateur entre le mot clĂ© pour votre extension, suivi d'un espace.</dd> -</dl> +- {{WebExtAPIRef("omnibox.setDefaultSuggestion()")}} + - : DĂ©finit la premiĂšre suggestion qui apparaĂźt dans la liste dĂ©roulante lorsque l'utilisateur entre le mot clĂ© pour votre extension, suivi d'un espace. -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt>{{WebExtAPIRef("omnibox.onInputStarted")}}</dt> - <dd>LancĂ© lorsque l'utilisateur met la barre d'adresse en surbrillance et tape le mot clĂ© omnibox de votre extension, suivi d'un espace.</dd> - <dt>{{WebExtAPIRef("omnibox.onInputChanged")}}</dt> - <dd>DĂ©clenchĂ© chaque fois que l'utilisateur change d'entrĂ©e, aprĂšs avoir focalisĂ© la barre d'adresse et tapĂ© le mot clĂ© omnibox de votre extension, suivi d'un espace.</dd> - <dt>{{WebExtAPIRef("omnibox.onInputEntered")}}</dt> - <dd>LancĂ© lorsque l'utilisateur accepte l'une des suggestions de votre extension.</dd> - <dt>{{WebExtAPIRef("omnibox.onInputCancelled")}}</dt> - <dd>LancĂ© lorsque l'utilisateur supprime la liste dĂ©roulante de la barre d'adresse, aprĂšs avoir dĂ©fini la barre d'adresse et tapĂ© le mot clĂ© omnibox de votre extension.</dd> -</dl> +- {{WebExtAPIRef("omnibox.onInputStarted")}} + - : LancĂ© lorsque l'utilisateur met la barre d'adresse en surbrillance et tape le mot clĂ© omnibox de votre extension, suivi d'un espace. +- {{WebExtAPIRef("omnibox.onInputChanged")}} + - : DĂ©clenchĂ© chaque fois que l'utilisateur change d'entrĂ©e, aprĂšs avoir focalisĂ© la barre d'adresse et tapĂ© le mot clĂ© omnibox de votre extension, suivi d'un espace. +- {{WebExtAPIRef("omnibox.onInputEntered")}} + - : LancĂ© lorsque l'utilisateur accepte l'une des suggestions de votre extension. +- {{WebExtAPIRef("omnibox.onInputCancelled")}} + - : LancĂ© lorsque l'utilisateur supprime la liste dĂ©roulante de la barre d'adresse, aprĂšs avoir dĂ©fini la barre d'adresse et tapĂ© le mot clĂ© omnibox de votre extension. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.omnibox")}}</p> +{{Compat("webextensions.api.omnibox")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<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/omnibox"><code>chrome.omnibox</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.omnibox`](https://developer.chrome.com/extensions/omnibox). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputcancelled/index.md b/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputcancelled/index.md index ae1d35560c..ab349a7798 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputcancelled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputcancelled/index.md @@ -12,47 +12,47 @@ tags: - onInputCancelled translation_of: Mozilla/Add-ons/WebExtensions/API/omnibox/onInputCancelled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque l'utilisateur a annulĂ© son interaction avec votre poste (par exemple, en cliquant en dehors de la barre d'adresse).</p> +LancĂ© lorsque l'utilisateur a annulĂ© son interaction avec votre poste (par exemple, en cliquant en dehors de la barre d'adresse). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.omnibox.onInputCancelled.addListener(listener) +```js +browser.omnibox.onInputCancelled.addListener(listener) browser.omnibox.onInputCancelled.removeListener(listener) browser.omnibox.onInputCancelled.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<p>La fonction d'Ă©couteur n'a pas de paramĂštres.</p> +La fonction d'Ă©couteur n'a pas de paramĂštres. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.omnibox.onInputCancelled")}}</p> +{{Compat("webextensions.api.omnibox.onInputCancelled")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">browser.omnibox.onInputCancelled.addListener(() => { +```js +browser.omnibox.onInputCancelled.addListener(() => { console.log("The user cancelled the session."); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/omnibox"><code>chrome.omnibox</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.omnibox`](https://developer.chrome.com/extensions/omnibox). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputchanged/index.md index f40e6ff1b1..b5f94ea189 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputchanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputchanged/index.md @@ -12,63 +12,55 @@ tags: - onInputChanged translation_of: Mozilla/Add-ons/WebExtensions/API/omnibox/onInputChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© chaque fois que l'utilisateur modifie sa saisie, aprĂšs avoir commencĂ© Ă interagir avec votre extension en saisissant son mot-clĂ© dans la barre d'adresse, puis en appuyant sur la touche espace.</p> +LancĂ© chaque fois que l'utilisateur modifie sa saisie, aprĂšs avoir commencĂ© Ă interagir avec votre extension en saisissant son mot-clĂ© dans la barre d'adresse, puis en appuyant sur la touche espace. -<p>C'est l'Ă©vĂ©nement que vous utiliserez pour remplir la liste dĂ©roulante de la barre d'adresse avec des suggestions. L'Ă©couteur d'Ă©vĂ©nement est transmis :</p> +C'est l'Ă©vĂ©nement que vous utiliserez pour remplir la liste dĂ©roulante de la barre d'adresse avec des suggestions. L'Ă©couteur d'Ă©vĂ©nement est transmis : -<ul> - <li>l'entrĂ©e actuelle de l'utilisateur (n'incluant pas le mot-clĂ© lui-mĂȘme ou l'espace aprĂšs)</li> - <li>une fonction de rappel que l'Ă©couteur peut appeler avec un tableau d'objets {{WebExtAPIRef("omnibox.SuggestResult")}}, un pour chaque suggestion. Seules les six premiĂšres suggestions seront affichĂ©es..</li> -</ul> +- l'entrĂ©e actuelle de l'utilisateur (n'incluant pas le mot-clĂ© lui-mĂȘme ou l'espace aprĂšs) +- une fonction de rappel que l'Ă©couteur peut appeler avec un tableau d'objets {{WebExtAPIRef("omnibox.SuggestResult")}}, un pour chaque suggestion. Seules les six premiĂšres suggestions seront affichĂ©es.. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.omnibox.onInputChanged.addListener(listener) +```js +browser.omnibox.onInputChanged.addListener(listener) browser.omnibox.onInputChanged.removeListener(listener) browser.omnibox.onInputChanged.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code>s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true`s'il Ă©coute, sinon `false`. -<h2 id="syntaxe_addListener">syntaxe addListener</h2> +## syntaxe addListener -<p>The listener function will be passed two parameters: a string <code>text</code>, and a callback function <code>suggest</code>.</p> +The listener function will be passed two parameters: a string `text`, and a callback function `suggest`. -<h3 id="Parameters">Parameters</h3> +### Parameters -<dl> - <dt><code>text</code></dt> - <dd> - <p><code>String</code>. L'entrĂ©e actuelle de l'utilisateur dans la barre d'adresse, n'incluant pas le mot-clĂ© de l'extension lui-mĂȘme ou l'espace aprĂšs le mot-clĂ©. Utilisez-le pour dĂ©cider quelles suggestions afficher dans la liste dĂ©roulante.</p> - </dd> - <dt><code>suggest</code></dt> - <dd> - <p><code>Function</code>. Une fonction de rappel que l'Ă©couteur d'Ă©vĂ©nement peut appeler pour fournir des suggestions pour la liste dĂ©roulante de la barre d'adresse. La fonction de rappel s'attend Ă recevoir un tableau d'objets {{WebExtAPIRef("omnibox.SuggestResult")}} un pour chaque suggestion. Seules les six premiĂšres suggestions seront affichĂ©es.</p> - </dd> -</dl> +- `text` + - : `String`. L'entrĂ©e actuelle de l'utilisateur dans la barre d'adresse, n'incluant pas le mot-clĂ© de l'extension lui-mĂȘme ou l'espace aprĂšs le mot-clĂ©. Utilisez-le pour dĂ©cider quelles suggestions afficher dans la liste dĂ©roulante. +- `suggest` + - : `Function`. Une fonction de rappel que l'Ă©couteur d'Ă©vĂ©nement peut appeler pour fournir des suggestions pour la liste dĂ©roulante de la barre d'adresse. La fonction de rappel s'attend Ă recevoir un tableau d'objets {{WebExtAPIRef("omnibox.SuggestResult")}} un pour chaque suggestion. Seules les six premiĂšres suggestions seront affichĂ©es. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.omnibox.onInputStarted")}}</p> +{{Compat("webextensions.api.omnibox.onInputStarted")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple interprĂšte l'entrĂ©e de l'utilisateur en tant que nom de propriĂ©tĂ© CSS et remplit la liste dĂ©roulante avec un objet {{WebExtAPIRef("omnibox.SuggestResult")}} pour chaque propriĂ©tĂ© CSS correspondant Ă l'entrĂ©e. La <code>description SuggestResult</code> est le nom complet de la propriĂ©tĂ© et le <code>contenu</code> est la page MDN de cette propriĂ©tĂ©.</p> +Cet exemple interprĂšte l'entrĂ©e de l'utilisateur en tant que nom de propriĂ©tĂ© CSS et remplit la liste dĂ©roulante avec un objet {{WebExtAPIRef("omnibox.SuggestResult")}} pour chaque propriĂ©tĂ© CSS correspondant Ă l'entrĂ©e. La `description SuggestResult` est le nom complet de la propriĂ©tĂ© et le `contenu` est la page MDN de cette propriĂ©tĂ©. -<p>L'exemple Ă©coute Ă©galement {{WebExtAPIRef("omnibox.onInputEntered")}}, et ouvre la page MDN correspondant Ă la sĂ©lection, conformĂ©ment Ă l'argument  {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}}.</p> +L'exemple Ă©coute Ă©galement {{WebExtAPIRef("omnibox.onInputEntered")}}, et ouvre la page MDN correspondant Ă la sĂ©lection, conformĂ©ment Ă l'argument  {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}}. -<pre class="brush: js">browser.omnibox.setDefaultSuggestion({ +```js +browser.omnibox.setDefaultSuggestion({ description: "Type the name of a CSS property" }); @@ -121,11 +113,11 @@ function getMatchingProperties(input) { return result; } -browser.omnibox.onInputChanged.addListener((input, suggest) => { +browser.omnibox.onInputChanged.addListener((input, suggest) => { suggest(getMatchingProperties(input)); }); -browser.omnibox.onInputEntered.addListener((url, disposition) => { +browser.omnibox.onInputEntered.addListener((url, disposition) => { switch (disposition) { case "currentTab": browser.tabs.update({url}); @@ -138,14 +130,12 @@ browser.omnibox.onInputEntered.addListener((url, disposition) => { break; } }); +``` -</pre> +{{WebExtExamples}} -<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/omnibox"><code>chrome.omnibox</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.omnibox`](https://developer.chrome.com/extensions/omnibox). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputentered/index.md b/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputentered/index.md index 8718f73f4e..1a81fa07c9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputentered/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputentered/index.md @@ -12,63 +12,55 @@ tags: - onInputEntered translation_of: Mozilla/Add-ons/WebExtensions/API/omnibox/onInputEntered --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque l'utilisateur a sĂ©lectionnĂ© l'une des suggestions que votre extension a ajoutĂ©es Ă la liste dĂ©roulante de la barre d'adresse.</p> +LancĂ© lorsque l'utilisateur a sĂ©lectionnĂ© l'une des suggestions que votre extension a ajoutĂ©es Ă la liste dĂ©roulante de la barre d'adresse. -<p>Utilisez cet Ă©vĂ©nement pour gĂ©rer la sĂ©lection de l'utilisateur, gĂ©nĂ©ralement en ouvrant la page correspondante. L'Ă©couteur d'Ă©vĂ©nement est transmis w:</p> +Utilisez cet Ă©vĂ©nement pour gĂ©rer la sĂ©lection de l'utilisateur, gĂ©nĂ©ralement en ouvrant la page correspondante. L'Ă©couteur d'Ă©vĂ©nement est transmis w: -<ul> - <li>la sĂ©lection de l'utilisateur</li> - <li>Un {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}}: utilisez cette option pour dĂ©terminer si vous souhaitez ouvrir la nouvelle page dans l'onglet actuel, dans un nouvel onglet de premier plan ou dans un nouvel onglet d'arriĂšre-plan.</li> -</ul> +- la sĂ©lection de l'utilisateur +- Un {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}}: utilisez cette option pour dĂ©terminer si vous souhaitez ouvrir la nouvelle page dans l'onglet actuel, dans un nouvel onglet de premier plan ou dans un nouvel onglet d'arriĂšre-plan. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.omnibox.onInputEntered.addListener(listener) +```js +browser.omnibox.onInputEntered.addListener(listener) browser.omnibox.onInputEntered.removeListener(listener) browser.omnibox.onInputEntered.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<p>La fonction d'Ă©couteur recevra deux paramĂštres: une chaine de <code>text</code>, et un {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}}.</p> +La fonction d'Ă©couteur recevra deux paramĂštres: une chaine de `text`, et un {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}}. -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>text</code></dt> - <dd> - <p><code>String</code>. C'est la valeur de la propriĂ©tĂ© <code>content</code> de l'objet {{WebExtAPIRef("omnibox.SuggestResult")}} que l'utilisateur a sĂ©lectionnĂ©.</p> - </dd> - <dt><code>disposition</code></dt> - <dd> - <p>{{WebExtAPIRef("omnibox.OnInputEnteredDisposition", "OnInputEnteredDisposition")}}. Une {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}} Ă©numĂ©ration, indiquant si l'extension doit ouvrir la page dans l'onglet en cours, dans un nouvel onglet de premier plan ou dans un nouvel onglet d'arriĂšre-plan.</p> - </dd> -</dl> +- `text` + - : `String`. C'est la valeur de la propriĂ©tĂ© `content` de l'objet {{WebExtAPIRef("omnibox.SuggestResult")}} que l'utilisateur a sĂ©lectionnĂ©. +- `disposition` + - : {{WebExtAPIRef("omnibox.OnInputEnteredDisposition", "OnInputEnteredDisposition")}}. Une {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}} Ă©numĂ©ration, indiquant si l'extension doit ouvrir la page dans l'onglet en cours, dans un nouvel onglet de premier plan ou dans un nouvel onglet d'arriĂšre-plan. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.omnibox.onInputEntered")}}</p> +{{Compat("webextensions.api.omnibox.onInputEntered")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple interprĂšte l'entrĂ©e de l'utilisateur en tant que nom de propriĂ©tĂ© CSS et remplit la liste dĂ©roulante avec un objet {{WebExtAPIRef("omnibox.SuggestResult")}} pour chaque propriĂ©tĂ© CSS correspondant Ă l'entrĂ©e. La <code>description SuggestResult</code> est le nom complet de la propriĂ©tĂ© et le <code>contenu</code> est la page MDN de cette propriĂ©tĂ©.</p> +Cet exemple interprĂšte l'entrĂ©e de l'utilisateur en tant que nom de propriĂ©tĂ© CSS et remplit la liste dĂ©roulante avec un objet {{WebExtAPIRef("omnibox.SuggestResult")}} pour chaque propriĂ©tĂ© CSS correspondant Ă l'entrĂ©e. La `description SuggestResult` est le nom complet de la propriĂ©tĂ© et le `contenu` est la page MDN de cette propriĂ©tĂ©. -<p>L'exemple Ă©coute Ă©galement {{WebExtAPIRef("omnibox.onInputEntered")}}, et ouvre la page MDN correspondant Ă la sĂ©lection, conformĂ©ment Ă l'argument  {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}}.</p> +L'exemple Ă©coute Ă©galement {{WebExtAPIRef("omnibox.onInputEntered")}}, et ouvre la page MDN correspondant Ă la sĂ©lection, conformĂ©ment Ă l'argument  {{WebExtAPIRef("omnibox.OnInputEnteredDisposition")}}. -<pre class="brush: js">browser.omnibox.setDefaultSuggestion({ +```js +browser.omnibox.setDefaultSuggestion({ description: "Type the name of a CSS property" }); @@ -121,11 +113,11 @@ function getMatchingProperties(input) { return result; } -browser.omnibox.onInputChanged.addListener((input, suggest) => { +browser.omnibox.onInputChanged.addListener((input, suggest) => { suggest(getMatchingProperties(input)); }); -browser.omnibox.onInputEntered.addListener((url, disposition) => { +browser.omnibox.onInputEntered.addListener((url, disposition) => { switch (disposition) { case "currentTab": browser.tabs.update({url}); @@ -138,14 +130,12 @@ browser.omnibox.onInputEntered.addListener((url, disposition) => { break; } }); +``` -</pre> +{{WebExtExamples}} -<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/omnibox"><code>chrome.omnibox</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.omnibox`](https://developer.chrome.com/extensions/omnibox). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputentereddisposition/index.md b/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputentereddisposition/index.md index ac85acdc7c..001b5a3a18 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputentereddisposition/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputentereddisposition/index.md @@ -12,32 +12,29 @@ tags: - omnibox translation_of: Mozilla/Add-ons/WebExtensions/API/omnibox/OnInputEnteredDisposition --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <strong><code>omnibox.OnInputEnteredDisposition</code></strong> dĂ©crit comment l'extension doit gĂ©rer une sĂ©lection d'utilisateur Ă partir des suggestions dans la liste dĂ©roulante de la barre d'adresse.</p> +Le type **`omnibox.OnInputEnteredDisposition`** dĂ©crit comment l'extension doit gĂ©rer une sĂ©lection d'utilisateur Ă partir des suggestions dans la liste dĂ©roulante de la barre d'adresse. -<p>Il est passĂ© dans l'Ă©couteur {{WebExtAPIRef("omnibox.onInputEntered")}} avec la sĂ©lection elle-mĂȘme.</p> +Il est passĂ© dans l'Ă©couteur {{WebExtAPIRef("omnibox.onInputEntered")}} avec la sĂ©lection elle-mĂȘme. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Ils peuvent prendre l'une des valeurs suivantes :</p> +Les valeurs de ce type sont des chaĂźnes. Ils peuvent prendre l'une des valeurs suivantes : -<dl> - <dt>"currentTab"</dt> - <dd>Ouvrez la sĂ©lection dans l'onglet actuel.</dd> - <dt>"newForegroundTab"</dt> - <dd>Ouvrez la sĂ©lection dans un nouvel onglet et placez ce nouvel onglet au premier plan.</dd> - <dt>"newBackgroundTab"</dt> - <dd>Ouvrez la sĂ©lection dans un nouvel onglet d'arriĂšre-plan, en conservant l'onglet en cours au premier plan.</dd> -</dl> +- "currentTab" + - : Ouvrez la sĂ©lection dans l'onglet actuel. +- "newForegroundTab" + - : Ouvrez la sĂ©lection dans un nouvel onglet et placez ce nouvel onglet au premier plan. +- "newBackgroundTab" + - : Ouvrez la sĂ©lection dans un nouvel onglet d'arriĂšre-plan, en conservant l'onglet en cours au premier plan. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.omnibox.OnInputEnteredDisposition")}}</p> +{{Compat("webextensions.api.omnibox.OnInputEnteredDisposition")}} -<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/omnibox"><code>chrome.omnibox</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.omnibox`](https://developer.chrome.com/extensions/omnibox). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md b/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md index 28864166eb..9f13c9d417 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/omnibox/oninputstarted/index.md @@ -12,57 +12,52 @@ tags: - onInputStarted translation_of: Mozilla/Add-ons/WebExtensions/API/omnibox/onInputStarted --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque l'utilisateur commence Ă interagir avec votre extension en entrant son mot-clĂ© dans la barre d'adresse, puis en appuyant sur la touche espace.</p> +LancĂ© lorsque l'utilisateur commence Ă interagir avec votre extension en entrant son mot-clĂ© dans la barre d'adresse, puis en appuyant sur la touche espace. -<p>Cela sera envoyĂ© avant tout Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputChanged")}} events.</p> +Cela sera envoyĂ© avant tout Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputChanged")}} events. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.omnibox.onInputStarted.addListener(listener) +```js +browser.omnibox.onInputStarted.addListener(listener) browser.omnibox.onInputStarted.removeListener(listener) browser.omnibox.onInputStarted.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction sera passĂ©e sans arguments.</p> - </dd> -</dl> +- `callback` + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction sera passĂ©e sans arguments. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.omnibox.onInputStarted")}}</p> +{{Compat("webextensions.api.omnibox.onInputStarted")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">browser.omnibox.onInputStarted.addListener(() => { +```js +browser.omnibox.onInputStarted.addListener(() => {  console.log("User has started interacting with me.") }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/omnibox"><code>chrome.omnibox</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.omnibox`](https://developer.chrome.com/extensions/omnibox). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/omnibox/setdefaultsuggestion/index.md b/files/fr/mozilla/add-ons/webextensions/api/omnibox/setdefaultsuggestion/index.md index b6fd07b42e..c7deca0551 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/omnibox/setdefaultsuggestion/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/omnibox/setdefaultsuggestion/index.md @@ -12,45 +12,45 @@ tags: - setDefaultSuggestion translation_of: Mozilla/Add-ons/WebExtensions/API/omnibox/setDefaultSuggestion --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finissez la suggestion par dĂ©faut Ă afficher dans la liste dĂ©roulante de la barre d'adresse lorsque l'utilisateur commence Ă interagir avec votre extension.</p> +DĂ©finissez la suggestion par dĂ©faut Ă afficher dans la liste dĂ©roulante de la barre d'adresse lorsque l'utilisateur commence Ă interagir avec votre extension. -<p>Une fois que l'utilisateur a entrĂ© votre mot clĂ© et a commencĂ© Ă interagir avec votre extension, la suggestion par dĂ©faut apparaĂźt toujours en premier dans la liste dĂ©roulante. Contrairement aux suggestions que vous fournissez dans {{WebExtAPIRef("omnibox.onInputChanged")}}, cet Ă©lĂ©ment ne peut pas ĂȘtre sĂ©lectionnĂ©. Utilisez-le pour fournir Ă l'utilisateur des conseils sur ce qu'il doit taper et sur ce qu'il peut s'attendre Ă voir quand il le fait.</p> +Une fois que l'utilisateur a entrĂ© votre mot clĂ© et a commencĂ© Ă interagir avec votre extension, la suggestion par dĂ©faut apparaĂźt toujours en premier dans la liste dĂ©roulante. Contrairement aux suggestions que vous fournissez dans {{WebExtAPIRef("omnibox.onInputChanged")}}, cet Ă©lĂ©ment ne peut pas ĂȘtre sĂ©lectionnĂ©. Utilisez-le pour fournir Ă l'utilisateur des conseils sur ce qu'il doit taper et sur ce qu'il peut s'attendre Ă voir quand il le fait. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.omnibox.setDefaultSuggestion( +```js +browser.omnibox.setDefaultSuggestion( suggestion // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>suggestion</code></dt> - <dd><code>object</code>. Un objet contenant une <code>description</code> de propriĂ©tĂ© de chaĂźne unique, qui sera affichĂ©e en tant que premier Ă©lĂ©ment dans la liste dĂ©roulante lorsque l'utilisateur commence Ă interagir avec votre extension.</dd> -</dl> +- `suggestion` + - : `object`. Un objet contenant une `description` de propriĂ©tĂ© de chaĂźne unique, qui sera affichĂ©e en tant que premier Ă©lĂ©ment dans la liste dĂ©roulante lorsque l'utilisateur commence Ă interagir avec votre extension. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p>None.</p> +None. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.omnibox.setDefaultSuggestion")}}</p> +{{Compat("webextensions.api.omnibox.setDefaultSuggestion")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">browser.omnibox.setDefaultSuggestion({ +```js +browser.omnibox.setDefaultSuggestion({ description: "Type the name of a CSS property" -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/omnibox"><code>chrome.omnibox</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.omnibox`](https://developer.chrome.com/extensions/omnibox). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/omnibox/suggestresult/index.md b/files/fr/mozilla/add-ons/webextensions/api/omnibox/suggestresult/index.md index 78101027b3..dba71ed5a4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/omnibox/suggestresult/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/omnibox/suggestresult/index.md @@ -12,30 +12,27 @@ tags: - omnibox translation_of: Mozilla/Add-ons/WebExtensions/API/omnibox/SuggestResult --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <strong><code>omnibox.SuggestResult</code></strong> dĂ©finit une suggestion unique que l'extension peut ajouter Ă la liste dĂ©roulante de la barre d'adresse.</p> +Le type **`omnibox.SuggestResult`** dĂ©finit une suggestion unique que l'extension peut ajouter Ă la liste dĂ©roulante de la barre d'adresse. -<p>L'Ă©couteur d'Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputChanged")}} de l'extension reçoit un rappel. Pour remplir la liste dĂ©roulante de la barre d'adresse en rĂ©ponse Ă l'entrĂ©e de l'utilisateur, l'extension peut transmettre un tableau d'objets <code>omnibox.SuggestResult</code> dans ce rappel.</p> +L'Ă©couteur d'Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputChanged")}} de l'extension reçoit un rappel. Pour remplir la liste dĂ©roulante de la barre d'adresse en rĂ©ponse Ă l'entrĂ©e de l'utilisateur, l'extension peut transmettre un tableau d'objets `omnibox.SuggestResult` dans ce rappel. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils ont les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils ont les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>content</code></dt> - <dd>C'est la valeur qui apparaĂźtra dans la barre d'adresse elle-mĂȘme lorsque l'utilisateur mettra cette suggestion en Ă©vidence dans la liste dĂ©roulante. C'est Ă©galement la chaĂźne envoyĂ©e Ă l'Ă©couteur d'Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputEntered")}} si l'utilisateur sĂ©lectionne cette suggestion. Si la chaĂźne est la mĂȘme que celle que l'utilisateur a dĂ©jĂ tapĂ©e, cette entrĂ©e n'apparaĂźtra pas dans la liste dĂ©roulante.</dd> - <dt><code>description</code></dt> - <dd>C'est la chaĂźne qui est affichĂ©e dans la liste dĂ©roulante de la barre d'adresse.</dd> -</dl> +- `content` + - : C'est la valeur qui apparaĂźtra dans la barre d'adresse elle-mĂȘme lorsque l'utilisateur mettra cette suggestion en Ă©vidence dans la liste dĂ©roulante. C'est Ă©galement la chaĂźne envoyĂ©e Ă l'Ă©couteur d'Ă©vĂ©nement {{WebExtAPIRef("omnibox.onInputEntered")}} si l'utilisateur sĂ©lectionne cette suggestion. Si la chaĂźne est la mĂȘme que celle que l'utilisateur a dĂ©jĂ tapĂ©e, cette entrĂ©e n'apparaĂźtra pas dans la liste dĂ©roulante. +- `description` + - : C'est la chaĂźne qui est affichĂ©e dans la liste dĂ©roulante de la barre d'adresse. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.omnibox.SuggestResult")}}</p> +{{Compat("webextensions.api.omnibox.SuggestResult")}} -<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/omnibox"><code>chrome.omnibox</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.omnibox`](https://developer.chrome.com/extensions/omnibox). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/pageaction/getpopup/index.md b/files/fr/mozilla/add-ons/webextensions/api/pageaction/getpopup/index.md index 4be85d9766..7fdc1dad1d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pageaction/getpopup/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pageaction/getpopup/index.md @@ -13,44 +13,43 @@ tags: - pageAction translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/getPopup --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient l'URL d'un document HTML en tant que popup pour cette action de page.</p> +Obtient l'URL d'un document HTML en tant que popup pour cette action de page. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingPopup = browser.pageAction.getPopup( +```js +var gettingPopup = browser.pageAction.getPopup( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dont vous souhaitez obtenir la fenĂȘtre contextuelle.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera accompli avec une chaĂźne contenant l'URL du popup.</p> + - `tabId` + - : `integer`. ID de l'onglet dont vous souhaitez obtenir la fenĂȘtre contextuelle. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.pageAction.getPopup")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera accompli avec une chaĂźne contenant l'URL du popup. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Ajoutez un Ă©lĂ©ment de menu contextuel qui enregistre l'URL contextuelle de l'onglet en cours. Notez que vous aurez besoin de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>contextMenus</code> dans votre <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest</a> pour crĂ©er des Ă©lĂ©ments de menu contextuel.</p> +{{Compat("webextensions.api.pageAction.getPopup")}} -<pre class="brush: js">function gotPopup(popupURL) { +## Exemples + +Ajoutez un Ă©lĂ©ment de menu contextuel qui enregistre l'URL contextuelle de l'onglet en cours. Notez que vous aurez besoin de la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `contextMenus` dans votre [manifest](/fr/Add-ons/WebExtensions/manifest.json) pour crĂ©er des Ă©lĂ©ments de menu contextuel. + +```js +function gotPopup(popupURL) { console.log(popupURL); } @@ -64,19 +63,18 @@ browser.contextMenus.onClicked.addListener(function(info, tab) { var gettingPopup = browser.pageAction.getPopup({tabId: tab.id}); gettingPopup.then(gotPopup); } -});</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/pageAction"><code>chrome.pageAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.json"><code>page_action.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.pageAction`](https://developer.chrome.com/extensions/pageAction). Cette documentation est dĂ©rivĂ©e de [`page_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.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 @@ -103,5 +101,4 @@ browser.contextMenus.onClicked.addListener(function(info, tab) { // 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/pageaction/gettitle/index.md b/files/fr/mozilla/add-ons/webextensions/api/pageaction/gettitle/index.md index 338d9f106e..4d209a7aad 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pageaction/gettitle/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pageaction/gettitle/index.md @@ -13,65 +13,63 @@ tags: - pageAction translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/getTitle --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient le titre de la page action.</p> +Obtient le titre de la page action. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingTitle = browser.pageAction.getTitle( +```js +var gettingTitle = browser.pageAction.getTitle( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet contenant l'action page dont vous voulez obtenir le titre.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera accomplie avec une chaĂźne contenant le titre de l'action de la page.</p> + - `tabId` + - : `integer`. L'ID de l'onglet contenant l'action page dont vous voulez obtenir le titre. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.pageAction.getTitle")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera accomplie avec une chaĂźne contenant le titre de l'action de la page. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Cet exemple enregistre le titre de l'action de la page lorsque l'utilisateur clique sur son icĂŽne :</p> +{{Compat("webextensions.api.pageAction.getTitle")}} -<pre class="brush: js">function gotTitle(title) { +## Exemples + +Cet exemple enregistre le titre de l'action de la page lorsque l'utilisateur clique sur son icĂŽne : + +```js +function gotTitle(title) { console.log(`Title ${title}`); } -browser.pageAction.onClicked.addListener((tab) => { +browser.pageAction.onClicked.addListener((tab) => { var gettingTitle = browser.pageAction.getTitle({ tabId: tab.id }); gettingTitle.then(gotTitle); -});</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/pageAction"><code>chrome.pageAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.json"><code>page_action.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.pageAction`](https://developer.chrome.com/extensions/pageAction). Cette documentation est dĂ©rivĂ©e de [`page_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.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 @@ -98,5 +96,4 @@ browser.pageAction.onClicked.addListener((tab) => { // 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/pageaction/hide/index.md b/files/fr/mozilla/add-ons/webextensions/api/pageaction/hide/index.md index fb48b2c4ad..4289d313b5 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pageaction/hide/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pageaction/hide/index.md @@ -13,49 +13,48 @@ tags: - pageAction translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/hide --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Masque l'action de page pour un onglet donnĂ©.</p> +Masque l'action de page pour un onglet donnĂ©. -<p><code>hide()</code> remplace la correspondance de motifs, de sorte que l'action page ne sera pas affichĂ©e dans l'onglet spĂ©cifiĂ© mĂȘme si son URL est associĂ©e Ă <a href="/Add-ons/WebExtensions/manifest.json/page_action"><code>show_matches</code></a>.</p> +`hide()` remplace la correspondance de motifs, de sorte que l'action page ne sera pas affichĂ©e dans l'onglet spĂ©cifiĂ© mĂȘme si son URL est associĂ©e Ă [`show_matches`](/Add-ons/WebExtensions/manifest.json/page_action). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.pageAction.hide( +```js +browser.pageAction.hide( tabId // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet pour lequel vous souhaitez masquer l'action de la page.</dd> -</dl> +- `tabId` + - : `integer`. L'ID de l'onglet pour lequel vous souhaitez masquer l'action de la page. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.pageAction.hide")}}</p> +{{Compat("webextensions.api.pageAction.hide")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Masquez l'action de la page pour l'onglet en cours lorsque l'utilisateur clique dessus :</p> +Masquez l'action de la page pour l'onglet en cours lorsque l'utilisateur clique dessus : -<pre class="brush: js">browser.pageAction.onClicked.addListener((tab) => { +```js +browser.pageAction.onClicked.addListener((tab) => { browser.pageAction.hide(tab.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.pageAction`](https://developer.chrome.com/extensions/pageAction). Cette documentation est dĂ©rivĂ©e de [`page_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.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/pageAction"><code>chrome.pageAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.json"><code>page_action.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 @@ -82,5 +81,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/hide // 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/pageaction/imagedatatype/index.md b/files/fr/mozilla/add-ons/webextensions/api/pageaction/imagedatatype/index.md index 57119e284f..1f0257e55c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pageaction/imagedatatype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pageaction/imagedatatype/index.md @@ -13,29 +13,27 @@ tags: - pageAction translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/ImageDataType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DonnĂ©es en pixel pour une image.</p> +DonnĂ©es en pixel pour une image. -<h2 id="Type">Type</h2> +## Type -<p>Un objet <code><a href="/fr/docs/Web/API/ImageData">ImageData</a></code> , par exemple Ă partir d'un Ă©lĂ©ment {{htmlelement("canvas")}}.</p> +Un objet [`ImageData`](/fr/docs/Web/API/ImageData) , par exemple Ă partir d'un Ă©lĂ©ment {{htmlelement("canvas")}}. -<h2 id="Browser_compatibility">Browser compatibility</h2> +## Browser compatibility -<p>{{Compat("webextensions.api.pageAction.ImageDataType")}}</p> +{{Compat("webextensions.api.pageAction.ImageDataType")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.pageAction`](https://developer.chrome.com/extensions/pageAction). Cette documentation est dĂ©rivĂ©e de [`page_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.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/pageAction"><code>chrome.pageAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.json"><code>page_action.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 @@ -62,5 +60,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/ImageDataType // 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/pageaction/index.md b/files/fr/mozilla/add-ons/webextensions/api/pageaction/index.md index e9edd3861a..74b556d77d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pageaction/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pageaction/index.md @@ -12,76 +12,64 @@ tags: - pageAction translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Une <a href="/fr/Add-ons/WebExtensions/Page_actions">action de page</a> est une icĂŽne cliquable dans la barre d'adresse du navigateur.</p> +Une [action de page](/fr/Add-ons/WebExtensions/Page_actions) est une icĂŽne cliquable dans la barre d'adresse du navigateur. -<p><img alt="" src="page-action.png"></p> +![](page-action.png) -<p>Vous pouvez Ă©couter les clics sur l'icĂŽne, ou spĂ©cifiĂ© une <a href="/fr/Add-ons/WebExtensions/Popups">fenĂȘtre contextuelle </a>qui s'ouvre lorsque l'icone est cliquĂ©e.</p> +Vous pouvez Ă©couter les clics sur l'icĂŽne, ou spĂ©cifiĂ© une [fenĂȘtre contextuelle ](/fr/Add-ons/WebExtensions/Popups)qui s'ouvre lorsque l'icone est cliquĂ©e. -<p>Si vous spĂ©cifiez une fenĂȘtre contextuelle, vous pouvez dĂ©finir son contenu et son comportement en utilisant HTML, CSS et JavaScript, tout comme une page Web normale. Le JavaScript s'exĂ©cutant dans la fenĂȘtre contextuelle accĂšde Ă toutes les mĂȘmes API WebExtension que vos scripts d'arriĂšre-plan.</p> +Si vous spĂ©cifiez une fenĂȘtre contextuelle, vous pouvez dĂ©finir son contenu et son comportement en utilisant HTML, CSS et JavaScript, tout comme une page Web normale. Le JavaScript s'exĂ©cutant dans la fenĂȘtre contextuelle accĂšde Ă toutes les mĂȘmes API WebExtension que vos scripts d'arriĂšre-plan. -<p>Vous pouvez dĂ©finir la plupart des propriĂ©tĂ©s d'une action de page de maniĂšre dĂ©clarative Ă l'aide de la <a href="/fr/Add-ons/WebExtensions/manifest.json/page_action">clef page_action</a> dans votre <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json">manifest.json</a>, mais Ă©galement les redĂ©finir par programmation en utilisant cette API.</p> +Vous pouvez dĂ©finir la plupart des propriĂ©tĂ©s d'une action de page de maniĂšre dĂ©clarative Ă l'aide de la [clef page_action](/fr/Add-ons/WebExtensions/manifest.json/page_action) dans votre [manifest.json](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json), mais Ă©galement les redĂ©finir par programmation en utilisant cette API. -<p>Les actions de page sont pour des actions qui ne sont pertinentes que pour des pages particuliĂšres (comme "favoris dans l'onglet courrant"). S'ils sont pertinents pour le navigateur dans son ensemble (par exemple, "Afficher tous les favoris"), utilisez plutĂŽt une action du navigateur.</p> +Les actions de page sont pour des actions qui ne sont pertinentes que pour des pages particuliĂšres (comme "favoris dans l'onglet courrant"). S'ils sont pertinents pour le navigateur dans son ensemble (par exemple, "Afficher tous les favoris"), utilisez plutĂŽt une action du navigateur. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("pageAction.ImageDataType")}}</dt> - <dd>DonnĂ©es en pixel pour une image.</dd> -</dl> +- {{WebExtAPIRef("pageAction.ImageDataType")}} + - : DonnĂ©es en pixel pour une image. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("pageAction.show()")}}</dt> - <dd>Affiche l'action de la page pour un onglet donnĂ©.</dd> - <dt>{{WebExtAPIRef("pageAction.hide()")}}</dt> - <dd>Caches l'action de la page pour un onglet donnĂ©.</dd> - <dt>{{WebExtAPIRef("pageAction.isShown()")}}</dt> - <dd>VĂ©rifie si l'action de la page est affichĂ©e ou non.</dd> - <dt>{{WebExtAPIRef("pageAction.setTitle()")}}</dt> - <dd>DĂ©finit le titre de l'action de la page. Ceci est affichĂ© dans une info-bulle sur l'action de la page.</dd> - <dt>{{WebExtAPIRef("pageAction.getTitle()")}}</dt> - <dd>Obtient le titre de l'action de la page</dd> - <dt>{{WebExtAPIRef("pageAction.setIcon()")}}</dt> - <dd>DĂ©finit l'icĂŽne de l'action de la page.</dd> - <dt>{{WebExtAPIRef("pageAction.setPopup()")}}</dt> - <dd>DĂ©finit l'URL de la fenĂȘtre contextuelle de l'action de la page.</dd> - <dt>{{WebExtAPIRef("pageAction.getPopup()")}}</dt> - <dd>Obtient l'URL de la fenĂȘtre d'action de la page.</dd> - <dt>{{WebExtAPIRef("pageAction.openPopup()")}}</dt> - <dd>Ouvre la fenĂȘtre contextuelle de l'action de la page.</dd> -</dl> +- {{WebExtAPIRef("pageAction.show()")}} + - : Affiche l'action de la page pour un onglet donnĂ©. +- {{WebExtAPIRef("pageAction.hide()")}} + - : Caches l'action de la page pour un onglet donnĂ©. +- {{WebExtAPIRef("pageAction.isShown()")}} + - : VĂ©rifie si l'action de la page est affichĂ©e ou non. +- {{WebExtAPIRef("pageAction.setTitle()")}} + - : DĂ©finit le titre de l'action de la page. Ceci est affichĂ© dans une info-bulle sur l'action de la page. +- {{WebExtAPIRef("pageAction.getTitle()")}} + - : Obtient le titre de l'action de la page +- {{WebExtAPIRef("pageAction.setIcon()")}} + - : DĂ©finit l'icĂŽne de l'action de la page. +- {{WebExtAPIRef("pageAction.setPopup()")}} + - : DĂ©finit l'URL de la fenĂȘtre contextuelle de l'action de la page. +- {{WebExtAPIRef("pageAction.getPopup()")}} + - : Obtient l'URL de la fenĂȘtre d'action de la page. +- {{WebExtAPIRef("pageAction.openPopup()")}} + - : Ouvre la fenĂȘtre contextuelle de l'action de la page. -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt>{{WebExtAPIRef("pageAction.onClicked")}}</dt> - <dd>ActivĂ© lorsqu'une icĂŽne d'action de page est cliquĂ©e. Cet Ă©vĂ©nement ne se dĂ©clenchera pas si l'action de la page comporte une fenĂȘtre contextuelle.</dd> -</dl> +- {{WebExtAPIRef("pageAction.onClicked")}} + - : ActivĂ© lorsqu'une icĂŽne d'action de page est cliquĂ©e. Cet Ă©vĂ©nement ne se dĂ©clenchera pas si l'action de la page comporte une fenĂȘtre contextuelle. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.pageAction")}} +{{WebExtExamples("h2")}} -<p>{{Compat("webextensions.api.pageAction")}}</p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.pageAction`](https://developer.chrome.com/extensions/pageAction). Cette documentation est dĂ©rivĂ©e de [`page_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.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>{{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/pageAction"><code>chrome.pageAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.json"><code>page_action.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 @@ -108,5 +96,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction // 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/pageaction/isshown/index.md b/files/fr/mozilla/add-ons/webextensions/api/pageaction/isshown/index.md index 8cf57feea5..c6b6144c27 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pageaction/isshown/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pageaction/isshown/index.md @@ -12,46 +12,43 @@ tags: - pageAction translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/isShown --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Renvoie <code>true</code> si l'action de la page est affichĂ©e pour l'onglet donnĂ©..</p> +Renvoie `true` si l'action de la page est affichĂ©e pour l'onglet donnĂ©.. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">let gettingIsShown = browser.pageAction.isShown( +```js +let gettingIsShown = browser.pageAction.isShown( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Un objet contenant le <code>tabId</code> Ă vĂ©rifier.</p> - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet Ă vĂ©rifier.</dd> - </dl> - </dd> -</dl> +- `details` + - : `object`. Un objet contenant le `tabId` Ă vĂ©rifier. + - `tabId` + - : `integer`. ID de l'onglet Ă vĂ©rifier. -<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 <code>true</code> si l'action de page de l'extension est affichĂ©e pour l'onglet donnĂ©, et <code>false</code> dans le cas contraire.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec `true` si l'action de page de l'extension est affichĂ©e pour l'onglet donnĂ©, et `false` dans le cas contraire. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.pageAction.isShown")}}</p> +{{Compat("webextensions.api.pageAction.isShown")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>VĂ©rifiez l'Ă©tat de l'onglet actuellement actif :</p> +VĂ©rifiez l'Ă©tat de l'onglet actuellement actif : -<pre class="brush: js">async function shownInActiveTab() { +```js +async function shownInActiveTab() {  let tabs = await browser.tabs.query({ currentWindow:true, active: true @@ -60,6 +57,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/isShown tabId: tabs[0].id });  console.log(shown); -}</pre> +} +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md b/files/fr/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md index 39e8c38f7b..17f5b8c81b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pageaction/onclicked/index.md @@ -13,75 +13,69 @@ tags: - pageAction translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/onClicked --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>LancĂ© quand l'icĂŽne de la page action est cliquĂ©e. Cet Ă©vĂ©nement ne se dĂ©clenchera pas si l'action de la page comporte une fenĂȘtre contextuelle.</p> +LancĂ© quand l'icĂŽne de la page action est cliquĂ©e. Cet Ă©vĂ©nement ne se dĂ©clenchera pas si l'action de la page comporte une fenĂȘtre contextuelle. -<p>Pour dĂ©finir une action de clic droit, utilisez l'API {{WebExtAPIRef('contextMenus')}} avec l'Ă©lĂ©ment "page_action" {{WebExtAPIRef('contextMenus/ContextType', 'context type', '', 'nocode')}}.</p> +Pour dĂ©finir une action de clic droit, utilisez l'API {{WebExtAPIRef('contextMenus')}} avec l'Ă©lĂ©ment "page_action" {{WebExtAPIRef('contextMenus/ContextType', 'context type', '', 'nocode')}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.pageAction.onClicked.addListener(listener) +```js +browser.pageAction.onClicked.addListener(listener) browser.pageAction.onClicked.removeListener(listener) browser.pageAction.onClicked.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez l'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Retourne <code>true</code> s'il Ă©coute, <code>false</code> sinon.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez l'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si un `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Retourne `true` s'il Ă©coute, `false` sinon. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>tab</code></dt> - <dd>Un objet {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant l'onglet dont l'action de la page a Ă©tĂ© cliquĂ©e.</dd> - </dl> - </dd> -</dl> + - : Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `tab` + - : Un objet {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant l'onglet dont l'action de la page a Ă©tĂ© cliquĂ©e. -<p>{{Compat("webextensions.api.pageAction.onClicked")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.pageAction.onClicked")}} -<p>Lorsque l'utilisateur clique sur l'action de la page, masquez-lĂ et naviguez dans l'onglet actif pour "<a href="http://chilloutandwatchsomecatgifs.com/">http://chilloutandwatchsomecatgifs.com/</a>" :</p> +## Exemples -<pre class="brush: js">var CATGIFS = "http://chilloutandwatchsomecatgifs.com/"; +Lorsque l'utilisateur clique sur l'action de la page, masquez-lĂ et naviguez dans l'onglet actif pour "<http://chilloutandwatchsomecatgifs.com/>" : -browser.pageAction.onClicked.addListener((tab) => { +```js +var CATGIFS = "http://chilloutandwatchsomecatgifs.com/"; + +browser.pageAction.onClicked.addListener((tab) => { browser.pageAction.hide(tab.id); browser.tabs.update({url: CATGIFS}); }); browser.pageAction.onClicked.addListener(function () { -});</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/pageAction"><code>chrome.pageAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.json"><code>page_action.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.pageAction`](https://developer.chrome.com/extensions/pageAction). Cette documentation est dĂ©rivĂ©e de [`page_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.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 @@ -108,5 +102,4 @@ browser.pageAction.onClicked.addListener(function () { // 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/pageaction/openpopup/index.md b/files/fr/mozilla/add-ons/webextensions/api/pageaction/openpopup/index.md index 6e087d05f0..690fedfa0f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pageaction/openpopup/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pageaction/openpopup/index.md @@ -12,45 +12,42 @@ tags: - sidebarAction translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/openPopup --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Ouvrez le menu contextuel de l'action de la page. -<div>Ouvrez le menu contextuel de l'action de la page.</div> +Vous pouvez uniquement appeler cette fonction Ă partir du gestionnaire pour une [action utilisateur](/fr/Add-ons/WebExtensions/User_actions). -<div></div> +## Syntaxe -<div> -<p>Vous pouvez uniquement appeler cette fonction Ă partir du gestionnaire pour une <a href="/fr/Add-ons/WebExtensions/User_actions">action utilisateur</a>.</p> -</div> +```js +browser.pageAction.openPopup() +``` -<h2 id="Syntaxe">Syntaxe</h2> +### ParamĂštres -<pre class="brush: js">browser.pageAction.openPopup() -</pre> +None. -<h3 id="ParamĂštres">ParamĂštres</h3> +### Valeur retournĂ© -<p>None.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est rĂ©solue sans arguments. -<h3 id="Valeur_retournĂ©">Valeur retournĂ©</h3> +## CompatibilitĂ© du navigateur -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui est rĂ©solue sans arguments.</p> +{{Compat("webextensions.api.pageAction.openPopup", 10)}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## Exemples -<p>{{Compat("webextensions.api.pageAction.openPopup", 10)}}</p> +Ouvrez la fenĂȘtre contextuelle lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu contextuel : -<h2 id="Exemples">Exemples</h2> - -<p>Ouvrez la fenĂȘtre contextuelle lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu contextuel :</p> - -<pre class="brush: js">browser.menus.create({ +```js +browser.menus.create({ id: "open-popup", title: "open popup", contexts: ["all"] }); -browser.menus.onClicked.addListener(() => { +browser.menus.onClicked.addListener(() => { browser.pageAction.openPopup(); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/pageaction/setpopup/index.md b/files/fr/mozilla/add-ons/webextensions/api/pageaction/setpopup/index.md index 1309004f5a..d6881d7a17 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pageaction/setpopup/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pageaction/setpopup/index.md @@ -13,40 +13,39 @@ tags: - setPopup translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/setPopup --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit le document HTML Ă ouvrir en tant que fenĂȘtre contextuelle lorsque l'utilisateur clique sur l'icĂŽne de l'action de la page.</p> +DĂ©finit le document HTML Ă ouvrir en tant que fenĂȘtre contextuelle lorsque l'utilisateur clique sur l'icĂŽne de l'action de la page. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.pageAction.setPopup( +```js +browser.pageAction.setPopup( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet pour lequel vous souhaitez dĂ©finir la fenĂȘtre contextuelle.</dd> - <dt><code>popup</code></dt> - <dd><code>string</code>. URL vers le fichier HTML Ă afficher dans un popup. Si elle est dĂ©finie sur une chaĂźne vide (''), aucune fenĂȘtre contextuelle n'est affichĂ©e.</dd> - </dl> - </dd> -</dl> +- `details` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : `object`. -<p>{{Compat("webextensions.api.pageAction.setPopup")}}</p> + - `tabId` + - : `integer`. L'ID de l'onglet pour lequel vous souhaitez dĂ©finir la fenĂȘtre contextuelle. + - `popup` + - : `string`. URL vers le fichier HTML Ă afficher dans un popup. Si elle est dĂ©finie sur une chaĂźne vide (''), aucune fenĂȘtre contextuelle n'est affichĂ©e. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Ecoutez les Ă©vĂ©nements {{WebExtAPIRef("tabs.onUpdated")}} et basculez le popup si le statut de chargement change :</p> +{{Compat("webextensions.api.pageAction.setPopup")}} -<pre class="brush: js">browser.tabs.onUpdated.addListener((tabId, changeInfo, tabInfo) => { +## Exemples + +Ecoutez les Ă©vĂ©nements {{WebExtAPIRef("tabs.onUpdated")}} et basculez le popup si le statut de chargement change : + +```js +browser.tabs.onUpdated.addListener((tabId, changeInfo, tabInfo) => { if (changeInfo.status) { browser.pageAction.show(tabId); if (changeInfo.status == "loading") { @@ -61,19 +60,18 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/setPopup }); } } -});</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/pageAction"><code>chrome.pageAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.json"><code>page_action.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.pageAction`](https://developer.chrome.com/extensions/pageAction). Cette documentation est dĂ©rivĂ©e de [`page_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.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 +98,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/setPopup // 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/pageaction/settitle/index.md b/files/fr/mozilla/add-ons/webextensions/api/pageaction/settitle/index.md index 49e71850de..7678267fb7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pageaction/settitle/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pageaction/settitle/index.md @@ -13,59 +13,56 @@ tags: - setTitle translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/setTitle --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit le titre de la page action. Le titre est affichĂ© dans une info-bulle lorsque l'utilisateur survole l'action de la page</p> +DĂ©finit le titre de la page action. Le titre est affichĂ© dans une info-bulle lorsque l'utilisateur survole l'action de la page -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.pageAction.setTitle( +```js +browser.pageAction.setTitle( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet dont vous voulez dĂ©finir le titre.</dd> - <dt><code>title</code></dt> - <dd><code>string</code>. Le texte de l'info-bulle.</dd> - </dl> - </dd> -</dl> +- `details` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : `object`. -<p>{{Compat("webextensions.api.pageAction.setTitle")}}</p> + - `tabId` + - : `integer`. L'ID de l'onglet dont vous voulez dĂ©finir le titre. + - `title` + - : `string`. Le texte de l'info-bulle. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Chaque fois qu'un onglet est mis Ă jour, affichez l'action de la page pour cet onglet et dĂ©finissez son titre pour afficher l'ID de l'onglet :</p> +{{Compat("webextensions.api.pageAction.setTitle")}} -<pre class="brush: js">browser.tabs.onUpdated.addListener((tabId, changeInfo, tabInfo) => { +## Exemples + +Chaque fois qu'un onglet est mis Ă jour, affichez l'action de la page pour cet onglet et dĂ©finissez son titre pour afficher l'ID de l'onglet : + +```js +browser.tabs.onUpdated.addListener((tabId, changeInfo, tabInfo) => { browser.pageAction.show(tabId); browser.pageAction.setTitle({ tabId: tabId, title: "Tab ID: " + tabId }); }); -</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/pageAction"><code>chrome.pageAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.json"><code>page_action.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.pageAction`](https://developer.chrome.com/extensions/pageAction). Cette documentation est dĂ©rivĂ©e de [`page_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.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 @@ -92,5 +89,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/setTitle // 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/pageaction/show/index.md b/files/fr/mozilla/add-ons/webextensions/api/pageaction/show/index.md index f526b3a358..6e342b56dd 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pageaction/show/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pageaction/show/index.md @@ -13,41 +13,41 @@ tags: - show translation_of: Mozilla/Add-ons/WebExtensions/API/pageAction/show --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Affiche l'action de la page pour un onglet donnĂ©. L'action de la page est affichĂ©e chaque fois que l'onglet donnĂ© est l'onglet actif.</p> +Affiche l'action de la page pour un onglet donnĂ©. L'action de la page est affichĂ©e chaque fois que l'onglet donnĂ© est l'onglet actif. -<p><code>show()</code> remplace la correspondance de motifs, de sorte que l'action page sera affichĂ©e dans l'onglet spĂ©cifiĂ© mĂȘme si <a href="/Add-ons/WebExtensions/manifest.json/page_action"><code>show_matches</code></a> e correspond pas Ă l'URL ou si <a href="/Add-ons/WebExtensions/manifest.json/page_action"><code>hide_matches</code></a> ne correspond pas.</p> +`show()` remplace la correspondance de motifs, de sorte que l'action page sera affichĂ©e dans l'onglet spĂ©cifiĂ© mĂȘme si [`show_matches`](/Add-ons/WebExtensions/manifest.json/page_action) e correspond pas Ă l'URL ou si [`hide_matches`](/Add-ons/WebExtensions/manifest.json/page_action) ne correspond pas. -<p>Notez que l'appel Ă Â <code>show()</code> n'a aucun effet sur un onglet sans contenu chargĂ©.</p> +Notez que l'appel Ă Â `show()` n'a aucun effet sur un onglet sans contenu chargĂ©. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.pageAction.show( +```js +browser.pageAction.show( tabId // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet pour lequel vous souhaitez afficher l'action de la page.</dd> -</dl> +- `tabId` + - : `integer`. L'ID de l'onglet pour lequel vous souhaitez afficher l'action de la page. -<h3 id="Valeur_renvoyĂ©e">Valeur renvoyĂ©e</h3> +### Valeur renvoyĂ©e -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec <code>undefined</code>.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec `undefined`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.pageAction.show")}}</p> +{{Compat("webextensions.api.pageAction.show")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cette exemple montre l'action de la page pour l'onglet actif lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu contextuel. Notez que vous aurez besoin de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>contextMenus</code> dans votre <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest</a> pour crĂ©er des Ă©lĂ©ments de menu contextuel.</p> +Cette exemple montre l'action de la page pour l'onglet actif lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu contextuel. Notez que vous aurez besoin de la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `contextMenus` dans votre [manifest](/fr/Add-ons/WebExtensions/manifest.json) pour crĂ©er des Ă©lĂ©ments de menu contextuel. -<pre class="brush: js">browser.contextMenus.create({ +```js +browser.contextMenus.create({ id: "show", title: "Show page action" }); @@ -57,19 +57,17 @@ browser.contextMenus.onClicked.addListener(function(info, tab) { browser.pageAction.show(tab.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.pageAction`](https://developer.chrome.com/extensions/pageAction). Cette documentation est dĂ©rivĂ©e de [`page_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.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/pageAction"><code>chrome.pageAction</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/page_action.json"><code>page_action.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 @@ -96,5 +94,4 @@ browser.contextMenus.onClicked.addListener(function(info, tab) { // 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/permissions/contains/index.md b/files/fr/mozilla/add-ons/webextensions/api/permissions/contains/index.md index f20d169299..81a6787d86 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/permissions/contains/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/permissions/contains/index.md @@ -11,39 +11,39 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/permissions/contains --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>VĂ©rifiez si l'extension a les permissions listĂ©es dans l'objet {{WebExtAPIRef("permissions.Permissions")}}.</p> +VĂ©rifiez si l'extension a les permissions listĂ©es dans l'objet {{WebExtAPIRef("permissions.Permissions")}}. -<p>L'argument <code>Permissions</code> peut contenir une propriĂ©tĂ© origine, qui est un tableau de <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions hĂŽtes</a>, ou une propriĂ©tĂ©Â <code>permissions</code> , qui est un tableau de <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permissions API</a>, ou les deux.</p> +L'argument `Permissions` peut contenir une propriĂ©tĂ© origine, qui est un tableau de [permissions hĂŽtes](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions), ou une propriĂ©tĂ©Â `permissions` , qui est un tableau de [permissions API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions), ou les deux. -<p>Il s'agit d'une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promesse</a></code>. La promesse est remplie avec true  seulement si toute l'extension possĂšde actuellement toutes les permissions donnĂ©es. Pour les permissions d'hĂŽtes, si le modĂšle de permissions if the extension's permissions <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">pattern-match</a> the permissions listed in <code>origins</code>, then they are considered to match.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promesse`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise). La promesse est remplie avec true  seulement si toute l'extension possĂšde actuellement toutes les permissions donnĂ©es. Pour les permissions d'hĂŽtes, si le modĂšle de permissions if the extension's permissions [pattern-match](/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns) the permissions listed in `origins`, then they are considered to match. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var getContains = browser.permissions.contains( +```js +var getContains = browser.permissions.contains( permissions // Permissions object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>permissions</code></dt> - <dd>Un objet {{WebExtAPIRef("permissions.Permissions")}} .</dd> -</dl> +- `permissions` + - : Un objet {{WebExtAPIRef("permissions.Permissions")}} . -<h3 id="Valeur_renvoyĂ©e">Valeur renvoyĂ©e</h3> +### Valeur renvoyĂ©e -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promesse</a></code> qui sera remplie avec <code>true</code> si l'extension possĂšde dĂ©jĂ toutes les permissions listĂ©es dans l'argument des <code>permissions</code> , ou <code>false</code> dans le cas contraire.</p> +Une [`Promesse`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise) qui sera remplie avec `true` si l'extension possĂšde dĂ©jĂ toutes les permissions listĂ©es dans l'argument des `permissions` , ou `false` dans le cas contraire. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.permissions.contains")}}</p> +{{Compat("webextensions.api.permissions.contains")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">// Extension permissions are: +```js +// Extension permissions are: // "webRequest", "tabs", "*://*.mozilla.org/*" var testPermissions1 = { @@ -51,7 +51,7 @@ var testPermissions1 = { permissions: ["tabs"] }; -browser.permissions.contains(testPermissions1).then((result) => { +browser.permissions.contains(testPermissions1).then((result) => { console.log(result); // true }); @@ -60,7 +60,7 @@ var testPermissions2 = {  permissions: ["tabs", "alarms"] }; -browser.permissions.contains(testPermissions2).then((result) => { +browser.permissions.contains(testPermissions2).then((result) => { console.log(result); // false, "alarms" doesn't match }); @@ -69,7 +69,7 @@ var testPermissions3 = {  permissions: ["tabs", "webRequest"] }; -browser.permissions.contains(testPermissions3).then((result) => { +browser.permissions.contains(testPermissions3).then((result) => { console.log(result); // true: "https://developer.mozilla.org/" }); // matches: "*://*.mozilla.org/*" @@ -77,17 +77,15 @@ var testPermissions4 = {  origins: ["https://example.org/"] }; -browser.permissions.contains(testPermissions4).then((result) => { +browser.permissions.contains(testPermissions4).then((result) => { console.log(result); // false, "https://example.org/" }); // does not match +``` -</pre> +{{WebExtExamples}} -<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/permissions"><code>chrome.permissions</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.permissions`](https://developer.chrome.com/extensions/permissions). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/permissions/getall/index.md b/files/fr/mozilla/add-ons/webextensions/api/permissions/getall/index.md index 91b771ad2d..c94e86081f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/permissions/getall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/permissions/getall/index.md @@ -11,44 +11,46 @@ tags: - getAll translation_of: Mozilla/Add-ons/WebExtensions/API/permissions/getAll --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>RĂ©cupĂšre un objet {{WebExtAPIRef("permissions.Permissions")}} contenant toutes les permissions actuellement acccordĂ©es Ă l'extension.</p> +RĂ©cupĂšre un objet {{WebExtAPIRef("permissions.Permissions")}} contenant toutes les permissions actuellement acccordĂ©es Ă l'extension. -<p>Il s'agit d'une fonction asynchrone qui retourne une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +Il s'agit d'une fonction asynchrone qui retourne une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var gettingAll = browser.permissions.getAll() -</pre> +```js +var gettingAll = browser.permissions.getAll() +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<p>None.</p> +None. -<h3 id="Valeur_renvoyĂ©e">Valeur renvoyĂ©e</h3> +### Valeur renvoyĂ©e -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet {{WebExtAPIRef("permissions.Permissions")}} contenant toutes les permissions actuellement accordĂ©es Ă l'extensions. Cela inclut toutes les permissions que l'extension Ă rĂ©pertoriĂ©es dans la clĂ© de <code><a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permissions</a></code> , et toutes les permissions rĂ©pertoriĂ©es dans <code><a href="/fr/Add-ons/WebExtensions/manifest.json/optional_permissions">optional_permissions</a></code> que l'extension a Ă©tĂ© accordĂ©e en appelant {{WebExtAPIRef("permissions.request()")}}.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef("permissions.Permissions")}} contenant toutes les permissions actuellement accordĂ©es Ă l'extensions. Cela inclut toutes les permissions que l'extension Ă rĂ©pertoriĂ©es dans la clĂ© de [`permissions`](/fr/Add-ons/WebExtensions/manifest.json/permissions) , et toutes les permissions rĂ©pertoriĂ©es dans [`optional_permissions`](/fr/Add-ons/WebExtensions/manifest.json/optional_permissions) que l'extension a Ă©tĂ© accordĂ©e en appelant {{WebExtAPIRef("permissions.request()")}}. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.permissions.getAll")}}</p> +{{Compat("webextensions.api.permissions.getAll")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">// Extension permissions are: +```js +// Extension permissions are: // "webRequest", "tabs", "*://*.mozilla.org/*" -browser.permissions.getAll().then((result) => { +browser.permissions.getAll().then((result) => { console.log(result.permissions); // [ "webRequest", "tabs" ] console.log(result.origins) // [ "*://*.mozilla.org/*" ] -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/permissions"><code>chrome.permissions</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.permissions`](https://developer.chrome.com/extensions/permissions). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/permissions/index.md b/files/fr/mozilla/add-ons/webextensions/api/permissions/index.md index f203ff60ac..da3ae2f299 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/permissions/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/permissions/index.md @@ -10,75 +10,54 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/permissions --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}}Permet aux extensions de demander des permissions supplĂ©mentaires lors de l'exĂ©cution, aprĂšs leur installation. -<div>Permet aux extensions de demander des permissions supplĂ©mentaires lors de l'exĂ©cution, aprĂšs leur installation.</div> +Les extensions ont besoin de permissions pour accĂ©der aux nombreuses API WebExtension les plus puissantes. Ils peuvent demander des permissions lors de l'installation en incluant les permissions dont ils ont besoin dans la clĂ© du manifesst.json des [`permissions`](/fr/Add-ons/WebExtensions/manifest.json/permissions). Les principaux avantages de demander des permissions au moment de l'installation sont les suivants: -<div> </div> +- L'utilisateur est seulement demandĂ© une fois, donc il est moins perturbateur pour eux et une dĂ©cision plus simple +- L'extension peut compter sur l'accĂšs aux API dont elle a besoin, car si elle est en cours d'exĂ©cution, les permissions ont Ă©tĂ© accordĂ©es. -<p>Les extensions ont besoin de permissions pour accĂ©der aux nombreuses API WebExtension les plus puissantes. Ils peuvent demander des permissions lors de l'installation en incluant les permissions dont ils ont besoin dans la clĂ© du manifesst.json des <code><a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permissions</a></code>. Les principaux avantages de demander des permissions au moment de l'installation sont les suivants:</p> +Il n'y a pas encore d'interface graphique simple permettant aux utilisateurs d'afficher les permissions des modules complĂ©mentaires WebExtensions installĂ©s. Les utilisateurs doivent utiliser about:debugging, puis allez dans la section des modules complĂ©mentaires, puis utilisez le lien "Manifest Url" pour le module complĂ©mentaire. Cela montrera le json brut, qui inclut un bloc "permissions" qui montre les permissions utilisĂ©es par l'addon. -<ul> - <li>L'utilisateur est seulement demandĂ© une fois, donc il est moins perturbateur pour eux et une dĂ©cision plus simple</li> - <li>L'extension peut compter sur l'accĂšs aux API dont elle a besoin, car si elle est en cours d'exĂ©cution, les permissions ont Ă©tĂ© accordĂ©es.</li> -</ul> +Avec l'API de permissions, une extension peut demander des permissions supplĂ©mentaires lors de l'exĂ©cution. Ces permissions doivent ĂȘtre listĂ©es dans la clĂ© [`optional_permissions`](/fr/Add-ons/WebExtensions/manifest.json/optional_permissions) du manifest.json. Notez que certaines permissions ne sont pas autorisĂ©es dans `optional_permissions`. Les principaux avantages de ceci sont : -<p>Il n'y a pas encore d'interface graphique simple permettant aux utilisateurs d'afficher les permissions des modules complĂ©mentaires WebExtensions installĂ©s. Les utilisateurs doivent utiliser about:debugging, puis allez dans la section des modules complĂ©mentaires, puis utilisez le lien "Manifest Url" pour le module complĂ©mentaire. Cela montrera le json brut, qui inclut un bloc "permissions" qui montre les permissions utilisĂ©es par l'addon.</p> +- L'extension peut s'exĂ©cuter avec un plus petit nombre de permissions, sauf lorsqu'elle en a rĂ©ellement besoin +- L'extension peut gĂ©rer le refus de permission de maniĂšre gracieuse au lieu de prĂ©senter Ă l'utilisateur un choix global "tout ou rien" au moment de l'installation. Vous pouvez toujours obtenir beaucoup de cette carte d'extension sans lui donner accĂšs Ă votre emplacement, par exemple. +- L'extension peut avoir besoin des [permissions hĂŽtes](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions), mais ne sait pas Ă l'installation exactement quelles permissions d'hĂŽte qu'il a besoin. Par exemple, la liste des hĂŽtes peut ĂȘtre un paramĂštre utilisateur. Dans ce scĂ©nario, demander une gamme plus spĂ©cifique d'hĂŽtes au moment de l'exĂ©cution peut ĂȘtre une alternative Ă demander "\<all_urls>" au moment de l'installation. -<p>Avec l'API de permissions, une extension peut demander des permissions supplĂ©mentaires lors de l'exĂ©cution. Ces permissions doivent ĂȘtre listĂ©es dans la clĂ© <code><a href="/fr/Add-ons/WebExtensions/manifest.json/optional_permissions">optional_permissions</a></code> du manifest.json. Notez que certaines permissions ne sont pas autorisĂ©es dans <code>optional_permissions</code>. Les principaux avantages de ceci sont :</p> +Pour utiliser l'API de permissions, dĂ©terminez les permissions que votre extension peut demander lors de l'exĂ©cution, et indiquez-les dans [`optional_permissions`](/fr/Add-ons/WebExtensions/manifest.json/optional_permissions). AprĂšs cela, vous pouvez demander toutes les permissions incluses dans `optional_permissions`. Les demandes peuvent uniquement ĂȘtre effectuĂ©es dans le gestionnaire pour une action de l'utilisateur (par exemple, un gestionnaire de clics). Pour des conseils sur la conception de votre demande d'autorisations d'exĂ©cution, afin de maximiser la probabilitĂ© que les utilisateurs les accordent, consultez la section [Demande de permissions Ă exĂ©cuter](/Add-ons/WebExtensions/demander_les_bonnes_permissions#Demander_les_permissions_%C3%A0_%C3%A9x%C3%A9cuter) -<ul> - <li>L'extension peut s'exĂ©cuter avec un plus petit nombre de permissions, sauf lorsqu'elle en a rĂ©ellement besoin</li> - <li>L'extension peut gĂ©rer le refus de permission de maniĂšre gracieuse au lieu de prĂ©senter Ă l'utilisateur un choix global "tout ou rien" au moment de l'installation. Vous pouvez toujours obtenir beaucoup de cette carte d'extension sans lui donner accĂšs Ă votre emplacement, par exemple.</li> - <li> - <p>L'extension peut avoir besoin des <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions hĂŽtes</a>, mais ne sait pas Ă l'installation exactement quelles permissions d'hĂŽte qu'il a besoin. Par exemple, la liste des hĂŽtes peut ĂȘtre un paramĂštre utilisateur. Dans ce scĂ©nario, demander une gamme plus spĂ©cifique d'hĂŽtes au moment de l'exĂ©cution peut ĂȘtre une alternative Ă demander "<all_urls>" au moment de l'installation.</p> - </li> -</ul> +## Types -<div>Pour utiliser l'API de permissions, dĂ©terminez les permissions que votre extension peut demander lors de l'exĂ©cution, et indiquez-les dans <code><a href="/fr/Add-ons/WebExtensions/manifest.json/optional_permissions">optional_permissions</a></code>. AprĂšs cela, vous pouvez demander toutes les permissions incluses dans <code>optional_permissions</code>. Les demandes peuvent uniquement ĂȘtre effectuĂ©es dans le gestionnaire pour une action de l'utilisateur (par exemple, un gestionnaire de clics).</div> +- {{WebExtAPIRef("permissions.Permissions")}} + - : ReprĂ©sente un ensemble de permissions. -<div> </div> +## MĂ©thodes -<div>Pour des conseils sur la conception de votre demande d'autorisations d'exĂ©cution, afin de maximiser la probabilitĂ© que les utilisateurs les accordent, consultez la section <a href="/Add-ons/WebExtensions/demander_les_bonnes_permissions#Demander_les_permissions_%C3%A0_%C3%A9x%C3%A9cuter">Demande de permissions Ă exĂ©cuter</a></div> +- {{WebExtAPIRef("permissions.contains()")}} + - : DĂ©couvrez si l'extensions a le jeu de permissions donnĂ©. +- {{WebExtAPIRef("permissions.getAll()")}} + - : Obtenez toutes les permissions que cette extension a actuellement. +- {{WebExtAPIRef("permissions.remove()")}} + - : Renoncer Ă un ensemble de permissions. +- {{WebExtAPIRef("permissions.request()")}} + - : Demander un ensemble de permissions. -<h2 id="Types">Types</h2> +## Event handlers -<dl> - <dt>{{WebExtAPIRef("permissions.Permissions")}}</dt> - <dd>ReprĂ©sente un ensemble de permissions.</dd> -</dl> +- {{WebExtAPIRef("permissions.onAdded")}} + - : ActivĂ© lorsqu'une nouvelle permission est accordĂ©e. +- {{WebExtAPIRef("permissions.onRemoved")}} + - : DĂ©clenchĂ© lorsque une permission est supprimĂ©e. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +## CompatibilitĂ© du navigateur -<dl> - <dt>{{WebExtAPIRef("permissions.contains()")}}</dt> - <dd>DĂ©couvrez si l'extensions a le jeu de permissions donnĂ©.</dd> - <dt>{{WebExtAPIRef("permissions.getAll()")}}</dt> - <dd>Obtenez toutes les permissions que cette extension a actuellement.</dd> - <dt>{{WebExtAPIRef("permissions.remove()")}}</dt> - <dd>Renoncer Ă un ensemble de permissions.</dd> - <dt>{{WebExtAPIRef("permissions.request()")}}</dt> - <dd>Demander un ensemble de permissions.</dd> -</dl> +{{Compat("webextensions.api.permissions")}} -<h2 id="Event_handlers">Event handlers</h2> +{{WebExtExamples("h2")}} -<dl> - <dt>{{WebExtAPIRef("permissions.onAdded")}}</dt> - <dd>ActivĂ© lorsqu'une nouvelle permission est accordĂ©e.</dd> - <dt>{{WebExtAPIRef("permissions.onRemoved")}}</dt> - <dd>DĂ©clenchĂ© lorsque une permission est supprimĂ©e.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.permissions")}}</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/permissions"><code>chrome.permissions</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.permissions`](https://developer.chrome.com/extensions/permissions). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/permissions/onadded/index.md b/files/fr/mozilla/add-ons/webextensions/api/permissions/onadded/index.md index c677fac013..759ff8cb6d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/permissions/onadded/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/permissions/onadded/index.md @@ -11,63 +11,57 @@ tags: - onAdded translation_of: Mozilla/Add-ons/WebExtensions/API/permissions/onAdded --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>ActivĂ© lorsque l'extension a accordĂ© de nouvelles permissions.</p> +ActivĂ© lorsque l'extension a accordĂ© de nouvelles permissions. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.permissions.onAdded.addListener(listener) +```js +browser.permissions.onAdded.addListener(listener) browser.permissions.onAdded.removeListener(listener) browser.permissions.onAdded.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>Ajoute une Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifier si le <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Retourne <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute une Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifier si le `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Retourne `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction passera les arguments suivants :</p> +- `callback` - <dl> - <dt><code>permissions</code></dt> - <dd>Objet {{WebExtAPIRef("permissions.Permissions")}} contenant les permissions qui ont Ă©tĂ© accordĂ©es.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction passera les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `permissions` + - : Objet {{WebExtAPIRef("permissions.Permissions")}} contenant les permissions qui ont Ă©tĂ© accordĂ©es. -<div>{{Compat("webextensions.api.permissions.onAdded")}}</div> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.permissions.onAdded")}} -<pre class="brush: js">function handleAdded(permissions) { +## Exemples + +```js +function handleAdded(permissions) { console.log(`New API permissions: ${permissions.permissions}`); console.log(`New host permissions: ${permissions.origins}`); } browser.permissions.onAdded.addListener(handleAdded); -</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/permissions"><code>chrome.permissions</code></a>.</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.permissions`](https://developer.chrome.com/extensions/permissions). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/permissions/onremoved/index.md b/files/fr/mozilla/add-ons/webextensions/api/permissions/onremoved/index.md index ab46333c7e..e535785ed0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/permissions/onremoved/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/permissions/onremoved/index.md @@ -11,63 +11,57 @@ tags: - onRemoved translation_of: Mozilla/Add-ons/WebExtensions/API/permissions/onRemoved --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>ActivĂ© lorsque certaines permissions sont supprimĂ©s de l'extension.</p> +ActivĂ© lorsque certaines permissions sont supprimĂ©s de l'extension. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.permissions.onRemoved.addListener(listener) +```js +browser.permissions.onRemoved.addListener(listener) browser.permissions.onRemoved.removeListener(listener) browser.permissions.onRemoved.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur a supprimĂ©e.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© dans l'Ă©vĂ©nement. Retourne <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur a supprimĂ©e. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© dans l'Ă©vĂ©nement. Retourne `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui ne sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e avec les arguments suivants :</p> +- `callback` - <dl> - <dt><code>permissions</code></dt> - <dd>L'objet {{WebExtAPIRef("permissions.Permissions")}} contenant les permissions qui ont Ă©tĂ© supprimĂ©es.</dd> - </dl> - </dd> -</dl> + - : Fonction qui ne sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e avec les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `permissions` + - : L'objet {{WebExtAPIRef("permissions.Permissions")}} contenant les permissions qui ont Ă©tĂ© supprimĂ©es. -<p>{{Compat("webextensions.api.permissions.onRemoved")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.permissions.onRemoved")}} -<pre class="brush: js">function handleRemoved(permissions) { +## Exemples + +```js +function handleRemoved(permissions) { console.log(`Removed API permissions: ${permissions.permissions}`); console.log(`Removed host permissions: ${permissions.origins}`); } browser.permissions.onRemoved.addListener(handleRemoved); -</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/permissions"><code>chrome.permissions</code></a>.</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.permissions`](https://developer.chrome.com/extensions/permissions). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/permissions/permissions/index.md b/files/fr/mozilla/add-ons/webextensions/api/permissions/permissions/index.md index d14a74c498..fa69b9fd40 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/permissions/permissions/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/permissions/permissions/index.md @@ -10,30 +10,27 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/permissions/Permissions --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet <code>Permissions</code> reprĂ©sente une collection de permissions.</p> +Un objet `Permissions` reprĂ©sente une collection de permissions. -<h2 id="Type">Type</h2> +## Type -<p>Un {{jsxref("object")}} avec les propriĂ©tĂ©s suivantes :</p> +Un {{jsxref("object")}} avec les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>origins</code>{{optional_inline}}</dt> - <dd>Un tableau de <a href="/fr/Add-ons/WebExtensions/Match_patterns">modĂšles de correspondance</a>, reprĂ©sentant les <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions de l'hĂŽte</a>.</dd> - <dt><code>permissions</code>{{optional_inline}}</dt> - <dd>Un tableau de permissions nommĂ©es, y compris les <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permissions d'API </a> et les <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Clipboard_access">permissions du presse-papiers</a>.</dd> -</dl> +- `origins`{{optional_inline}} + - : Un tableau de [modĂšles de correspondance](/fr/Add-ons/WebExtensions/Match_patterns), reprĂ©sentant les [permissions de l'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions). +- `permissions`{{optional_inline}} + - : Un tableau de permissions nommĂ©es, y compris les [permissions d'API ](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) et les [permissions du presse-papiers](/fr/Add-ons/WebExtensions/manifest.json/permissions#Clipboard_access). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.permissions.Permissions")}}</p> +{{Compat("webextensions.api.permissions.Permissions")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/permissions"><code>chrome.permissions</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.permissions`](https://developer.chrome.com/extensions/permissions). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/permissions/remove/index.md b/files/fr/mozilla/add-ons/webextensions/api/permissions/remove/index.md index 2e8c7b7463..f8fcf0c0f8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/permissions/remove/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/permissions/remove/index.md @@ -11,58 +11,58 @@ tags: - remove translation_of: Mozilla/Add-ons/WebExtensions/API/permissions/remove --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Demander d'abandonner les permissions listĂ©es dans l'objet {{WebExtAPIRef("permissions.Permissions")}}.</p> +Demander d'abandonner les permissions listĂ©es dans l'objet {{WebExtAPIRef("permissions.Permissions")}}. -<p>L'argument <code>Permissions</code> peut contenir soit une propriĂ©tĂ©Â <code>origins</code> ,qui est un tableau de <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions d'hĂŽte</a> , ou une propriĂ©tĂ© <code>permissions</code>, qui est un tableau de <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permissions d'API</a>, ou les deux. Les permissions doivent provenir de l'ensemble des permissions dĂ©finies dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/optional_permissions">optional_permissions</a></code> du manifest.json.</p> +L'argument `Permissions` peut contenir soit une propriĂ©tĂ©Â `origins` ,qui est un tableau de [permissions d'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) , ou une propriĂ©tĂ© `permissions`, qui est un tableau de [permissions d'API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions), ou les deux. Les permissions doivent provenir de l'ensemble des permissions dĂ©finies dans la clĂ© [`optional_permissions`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/optional_permissions) du manifest.json. -<p>Il s'agit d'une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promesse</a></code>.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promesse`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var removing = browser.permissions.remove( +```js +var removing = browser.permissions.remove( permissions // Permissions object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>permissions</code></dt> - <dd>Un objet {{WebExtAPIRef("permissions.Permissions")}}.</dd> -</dl> +- `permissions` + - : Un objet {{WebExtAPIRef("permissions.Permissions")}}. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promesse</a></code> qui sera remplie avec <code>true</code> si les permissions rĂ©pertoriĂ©es dans l'argument <code>permissions</code> ont Ă©tĂ© supprimĂ©es, ou <code>false</code> dans le cas contraire.</p> +Une [`Promesse`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise) qui sera remplie avec `true` si les permissions rĂ©pertoriĂ©es dans l'argument `permissions` ont Ă©tĂ© supprimĂ©es, ou `false` dans le cas contraire. -<h2 id="Browser_compatibility">Browser compatibility</h2> +## Browser compatibility -<p>{{Compat("webextensions.api.permissions.remove")}}</p> +{{Compat("webextensions.api.permissions.remove")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code ajoute un gestionnaire de clic qui supprime une permission donnĂ©e.</p> +Ce code ajoute un gestionnaire de clic qui supprime une permission donnĂ©e. -<pre class="brush: js">const permissionToRemove = { +```js +const permissionToRemove = { permissions: ["history"] } function remove() { console.log("removing"); - browser.permissions.remove(permissionToRemove).then(result => { + browser.permissions.remove(permissionToRemove).then(result => { console.log(result); }); } -document.querySelector("#remove").addEventListener("click", remove);</pre> +document.querySelector("#remove").addEventListener("click", remove); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/permissions"><code>chrome.permissions</code></a>.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.permissions`](https://developer.chrome.com/extensions/permissions). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/permissions/request/index.md b/files/fr/mozilla/add-ons/webextensions/api/permissions/request/index.md index 82ddc6cfea..aa1f14cc3f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/permissions/request/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/permissions/request/index.md @@ -11,47 +11,47 @@ tags: - request translation_of: Mozilla/Add-ons/WebExtensions/API/permissions/request --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Demandez l'ensemble des permissions rĂ©pertoriĂ©es dans l'objet {{WebExtAPIRef("permissions.Permissions")}}.</p> +Demandez l'ensemble des permissions rĂ©pertoriĂ©es dans l'objet {{WebExtAPIRef("permissions.Permissions")}}. -<p>L'argument <code>Permissions</code> peut contenir soit une propriĂ©tĂ©Â <code>origins</code> , qui est un tableau de <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions d'hĂŽte</a>, soit une propriĂ©tĂ© <code>permissions</code> , qui est un tableau de <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permissions d'API</a>, ou les deux. Les permissions doivent provenir de l'ensemble des permissions dĂ©finies dans la clĂ©Â <code><a href="/fr/Add-ons/WebExtensions/manifest.json/optional_permissions">optional_permissions</a></code> du manifest.json. La propriĂ©tĂ© <code>origins</code> qui correspondent Ă un sous-ensemble des hĂŽtes correspondant Ă une permission facultative : par exemple, si optional_permissions inclut "*://mozilla.org/", alors <code>permissions.origins</code> peut inclure "https://developer.mozilla.org/".</p> +L'argument `Permissions` peut contenir soit une propriĂ©tĂ©Â `origins` , qui est un tableau de [permissions d'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions), soit une propriĂ©tĂ© `permissions` , qui est un tableau de [permissions d'API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions), ou les deux. Les permissions doivent provenir de l'ensemble des permissions dĂ©finies dans la clĂ©Â [`optional_permissions`](/fr/Add-ons/WebExtensions/manifest.json/optional_permissions) du manifest.json. La propriĂ©tĂ© `origins` qui correspondent Ă un sous-ensemble des hĂŽtes correspondant Ă une permission facultative : par exemple, si optional_permissions inclut "\*://mozilla.org/", alors `permissions.origins` peut inclure "https\://developer.mozilla.org/". -<p>La demande ne peut ĂȘtre faite qu'Ă l'intĂ©rieur du gestionnaire pour une <a href="/fr/Add-ons/WebExtensions/User_actions">action utilisateur</a>.</p> +La demande ne peut ĂȘtre faite qu'Ă l'intĂ©rieur du gestionnaire pour une [action utilisateur](/fr/Add-ons/WebExtensions/User_actions). -<p>Selon les circonstances, le navigateur traitera probablement la demande en demandant Ă l'utilisateur s'il doit accorder les permissions demandĂ©es. Une seule requĂȘte est faite pour toutes les permissions demandĂ©es: donc toutes les permissions sont accordĂ©es ou aucune d'entre elles ne l'est.</p> +Selon les circonstances, le navigateur traitera probablement la demande en demandant Ă l'utilisateur s'il doit accorder les permissions demandĂ©es. Une seule requĂȘte est faite pour toutes les permissions demandĂ©es: donc toutes les permissions sont accordĂ©es ou aucune d'entre elles ne l'est. -<p>Toutes les autorisations accordĂ©es sont conservĂ©es par l'extension, mĂȘme en cas de mise Ă niveau et de dĂ©sactivation / activation du cycle.</p> +Toutes les autorisations accordĂ©es sont conservĂ©es par l'extension, mĂȘme en cas de mise Ă niveau et de dĂ©sactivation / activation du cycle. -<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 requesting = browser.permissions.request( +```js +var requesting = browser.permissions.request( permissions // Permissions object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>permissions</code></dt> - <dd>Un objet {{WebExtAPIRef("permissions.Permissions")}}</dd> -</dl> +- `permissions` + - : Un objet {{WebExtAPIRef("permissions.Permissions")}} -<h3 id="Return_value">Return value</h3> +### Return value -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec <code>true</code> si l'extension a reçu toutes les permissions rĂ©pertoriĂ©es dans l'argument des <code>permissions</code> , ou <code>false</code> dans le cas contraire.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec `true` si l'extension a reçu toutes les permissions rĂ©pertoriĂ©es dans l'argument des `permissions` , ou `false` dans le cas contraire. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.permissions.request")}}</p> +{{Compat("webextensions.api.permissions.request")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code ajoute un gestionnaire de clics qui demande diverses permissions, puis enregistre le rĂ©sultat de la demande et les permissions de l'extension une fois la requĂȘte terminĂ©e.</p> +Ce code ajoute un gestionnaire de clics qui demande diverses permissions, puis enregistre le rĂ©sultat de la demande et les permissions de l'extension une fois la requĂȘte terminĂ©e. -<pre class="brush: js">const permissionsToRequest = { +```js +const permissionsToRequest = { permissions: ["bookmarks", "history"], origins: ["https://developer.mozilla.org/"] } @@ -69,20 +69,20 @@ function requestPermissions() { browser.permissions.request(permissionsToRequest) .then(onResponse) - .then((currentPermissions) => { + .then((currentPermissions) => { console.log(`Current permissions:`, currentPermissions); }); } -document.querySelector("#request").addEventListener("click", requestPermissions);</pre> +document.querySelector("#request").addEventListener("click", requestPermissions); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> - -<p>Actuellement un <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1411873">bug avec la demande d'origines</a> et la <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1382953">demande des permissions sur la page about:addons</a>.</p> - -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/permissions"><code>chrome.permissions</code></a>.</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> +> **Note :** +> +> Actuellement un [bug avec la demande d'origines](https://bugzilla.mozilla.org/show_bug.cgi?id=1411873) et la [demande des permissions sur la page about:addons](https://bugzilla.mozilla.org/show_bug.cgi?id=1382953). +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.permissions`](https://developer.chrome.com/extensions/permissions). +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/pkcs11/getmoduleslots/index.md b/files/fr/mozilla/add-ons/webextensions/api/pkcs11/getmoduleslots/index.md index f86cb8b8b1..423eee92ed 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pkcs11/getmoduleslots/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pkcs11/getmoduleslots/index.md @@ -12,65 +12,61 @@ tags: - pkcs11 translation_of: Mozilla/Add-ons/WebExtensions/API/pkcs11/getModuleSlots --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>EnumĂ©rer les emplacements d'un module. Cette fonction renvoie un tableau contenant une entrĂ©e pour chaque emplacement. Chaque entrĂ©e contient le nom de l'emplacement et, si l'emplacement contient un jeton, des informations sur le jeton.</p> +EnumĂ©rer les emplacements d'un module. Cette fonction renvoie un tableau contenant une entrĂ©e pour chaque emplacement. Chaque entrĂ©e contient le nom de l'emplacement et, si l'emplacement contient un jeton, des informations sur le jeton. -<p>Vous ne pouvez appeler cela que pour un module installĂ© dans Firefox</p> +Vous ne pouvez appeler cela que pour un module installĂ© dans Firefox -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 getting = browser.pkcs11.getModuleSlots( +```js +var getting = browser.pkcs11.getModuleSlots( name // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>name</code></dt> - <dd><code>string</code>. Nom du module. Cela doit correspondre Ă la propriĂ©tĂ© <code>name</code> dans le <a href="/fr/Add-ons/WebExtensions/Native_manifests#PKCS_11_manifests">manifest PKCS #11</a> pour le module.</dd> -</dl> +- `name` + - : `string`. Nom du module. Cela doit correspondre Ă la propriĂ©tĂ© `name` dans le [manifest PKCS #11](/fr/Add-ons/WebExtensions/Native_manifests#PKCS_11_manifests) pour le module. -<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 tableau d'objets, un pour chaque emplacement auquel le module donne accĂšs. Chaque objet a deux propriĂ©tĂ©s :</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un tableau d'objets, un pour chaque emplacement auquel le module donne accĂšs. Chaque objet a deux propriĂ©tĂ©s : -<ul> - <li><code>name</code>: le nom de l'emplacement</li> - <li><code>token</code>: si un jeton est prĂ©sent dans cet emplacement, un objet <code>Token</code>. Si aucun le jeton n'est prĂ©sent dans l'emplacement, la propriĂ©tĂ© est <code>null</code>.</li> -</ul> +- `name`: le nom de l'emplacement +- `token`: si un jeton est prĂ©sent dans cet emplacement, un objet `Token`. Si aucun le jeton n'est prĂ©sent dans l'emplacement, la propriĂ©tĂ© est `null`. -<p><code>Token</code> Les objets ont les propriĂ©tĂ©s suivantes :</p> +`Token` Les objets ont les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>name</code></dt> - <dd><code>string</code>. Nom du jeton.</dd> - <dt><code>manufacturer</code></dt> - <dd><code>string</code>. Nom du jeton fabriquĂ©.</dd> - <dt><code>HWVersion</code></dt> - <dd><code>string</code>. Version matĂ©rielle, en tant que numĂ©ro de version PKCS #11 (deux entiers 32-bit sĂ©parĂ©s par un point, comme "1.0".</dd> - <dt><code>FWVersion</code></dt> - <dd><code>string</code>. Version du micrologiciel, en tant que numĂ©ro de version PKCS #11 (deux 32-bit sĂ©parĂ©s par un point, comme "1.0".</dd> - <dt><code>serial</code></dt> - <dd><code>string</code>. NumĂ©ro de sĂ©rie, dont le format est dĂ©fini par la spĂ©cification de jeton.</dd> - <dt><code>isLoggedIn</code></dt> - <dd><code>boolean</code>: <code>true</code> si le jeton est dĂ©jĂ connectĂ©, <code>false</code> sinon.</dd> -</dl> +- `name` + - : `string`. Nom du jeton. +- `manufacturer` + - : `string`. Nom du jeton fabriquĂ©. +- `HWVersion` + - : `string`. Version matĂ©rielle, en tant que numĂ©ro de version PKCS #11 (deux entiers 32-bit sĂ©parĂ©s par un point, comme "1.0". +- `FWVersion` + - : `string`. Version du micrologiciel, en tant que numĂ©ro de version PKCS #11 (deux 32-bit sĂ©parĂ©s par un point, comme "1.0". +- `serial` + - : `string`. NumĂ©ro de sĂ©rie, dont le format est dĂ©fini par la spĂ©cification de jeton. +- `isLoggedIn` + - : `boolean`: `true` si le jeton est dĂ©jĂ connectĂ©, `false` sinon. -<p>Si le module n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promise sera rejetĂ©e avec un message d'erreur.</p> +Si le module n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.pkcs11.getModuleSlots")}}</p> +{{Compat("webextensions.api.pkcs11.getModuleSlots")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Installe un module, puis dresse la liste de ses emplacements et liste des jetons qu'ils contiennent :</p> +Installe un module, puis dresse la liste de ses emplacements et liste des jetons qu'ils contiennent : -<pre class="brush: js">function onInstalled() { +```js +function onInstalled() { return browser.pkcs11.getModuleSlots("my_module"); } @@ -87,6 +83,7 @@ function onGotSlots(slots) { browser.pkcs11.installModule("my_module") .then(onInstalled) -.then(onGotSlots);</pre> +.then(onGotSlots); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/pkcs11/index.md b/files/fr/mozilla/add-ons/webextensions/api/pkcs11/index.md index 1a3d2319bd..61c1b5231d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pkcs11/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pkcs11/index.md @@ -10,81 +10,57 @@ tags: - pkcs11 translation_of: Mozilla/Add-ons/WebExtensions/API/pkcs11 --- -<div>{{AddonSidebar}}</div> - -<p>L'API <code>pkcs11</code> permet Ă une extension d'Ă©numĂ©rer les modules de sĂ©curitĂ© <a href="https://en.wikipedia.org/wiki/PKCS_11">PKCS #11</a>, et de rendre accessibles au navigateur en tant que sources clĂ©s et de certificats.</p> - -<p>Pour utiliser cette API, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "pkcs11".</p> - -<h2 id="Utilisation_de_la_boĂźte_de_dialogue_PrĂ©fĂ©rences_Firefox_pour_installer_les_modules_PKCS_11">Utilisation de la boĂźte de dialogue PrĂ©fĂ©rences Firefox pour installer les modules PKCS #11</h2> - -<p>Effectuez les Ă©tapes suivantes :</p> - -<ol> - <li> - <p>Sauvegardez le module PKCS #11 dans un emplacement permanent sur votre ordinateur local</p> - </li> - <li> - <p>SĂ©lectonnez <strong>Outils > Options</strong> ou sĂ©lectionnez le <strong>menu Firefox</strong> puis <strong>Options</strong></p> - </li> - <li> - <p>Une fois la page Options ouverte, sĂ©lectionnez <strong>Vie privĂ©e & SĂ©curitĂ©</strong></p> - </li> - <li> - <p>Faites dĂ©filer vers le bas de la page et sous <strong>Certificats</strong> ou tapez sur <strong>Dispositifs de sĂ©curitĂ©...<br> - <img alt="" src="device_manager.png"></strong></p> - </li> - <li> - <p>Cliquez ou appuyez sur le bouton <strong>Charger</strong><br> - <img alt="" src="load_device_driver.png"></p> - </li> - <li> - <p>Entrez un nom pour le module de sĂ©curitĂ©, tel que "<em>Ma Base de donnĂ©es Client</em>"</p> - - <div class="warning"> - <p><strong>Attention :</strong> il y a actuellement un bogue dans Firefox oĂč les caractĂšres internationaux peuvent causer des problĂšmes.</p> - </div> - </li> - <li> - <p>Choisir <strong>Parcourir...</strong> pour trouver l'emplacement du module PKCS #11 sur votre ordinateur local, puis cliquez ou appuyez sur <strong>OK</strong> pour confirmer.</p> - </li> -</ol> - -<ol> -</ol> - -<h2 id="Provisionnement_des_modules_PKCS_11">Provisionnement des modules PKCS #11</h2> - -<div class="blockIndicator note"> -<p><strong>Note:</strong> A partir de Firefox 58, les extensions peuvent utiliser l'API <a href="/fr/Add-ons/WebExtensions/API/pkcs11">pkcs11</a> pour Ă©numĂ©rer les modules PKCS #11 et les rendre accessibles au navigateur comme sources de clĂ©s et certificats.</p> -</div> - -<p>Il y a 2 prĂ©-requis pour pouvoir utiliser cette API:</p> - -<ul> - <li>un ou plusieurs modules PKCS # 11 doivent ĂȘtre installĂ©s sur l'ordinateur de l'utilisateur</li> - <li>pour chaque module PKCS # 11 installĂ©, il doit y avoir un fichier <a href="/fr/Add-ons/WebExtensions/manifests_native">manifest natif</a> qui permet au navigateur de localiser le module.</li> -</ul> - -<p>TrĂšs probablement, l'utilisateur ou l'administrateur du pĂ©riphĂ©rique installerait le module <code>PKCS #11</code>, et son installateur installerait le fichier de manifeste natif en mĂȘme temps.</p> - -<p>Cependant, le module et le manifeste ne peuvent pas ĂȘtre installĂ©s dans le cadre du processus d'installation de l'extension.</p> - -<p>Pour plus de dĂ©tails sur le contenu et l'emplacement du fichier de manifeste, voir <a href="/fr/Add-ons/WebExtensions/Native_manifests">Manifest natifs</a>.</p> - -<h2 id="Fonctions">Fonctions</h2> - -<dl> - <dt>{{WebExtAPIRef("pkcs11.getModuleSlots()")}}</dt> - <dd>Pour chaque emplacement dans un module, obtenez son nom et s'il contient un jeton.</dd> - <dt>{{WebExtAPIRef("pkcs11.installModule()")}}</dt> - <dd>Installe le module PKCS # 11 nommĂ©</dd> - <dt>{{WebExtAPIRef("pkcs11.isModuleInstalled()")}}</dt> - <dd>VĂ©rifie si le module PKCS # 11 nommĂ© est installĂ©.</dd> - <dt>{{WebExtAPIRef("pkcs11.uninstallModule()")}}</dt> - <dd>DĂ©sinstalle le module PKCS # 11 nommĂ©.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.pkcs11", 1, 1)}} {{WebExtExamples("h2")}}</p> +{{AddonSidebar}} + +L'API `pkcs11` permet Ă une extension d'Ă©numĂ©rer les modules de sĂ©curitĂ© [PKCS #11](https://en.wikipedia.org/wiki/PKCS_11), et de rendre accessibles au navigateur en tant que sources clĂ©s et de certificats. + +Pour utiliser cette API, vous devez avoir la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "pkcs11". + +## Utilisation de la boĂźte de dialogue PrĂ©fĂ©rences Firefox pour installer les modules PKCS #11 + +Effectuez les Ă©tapes suivantes : + +1. Sauvegardez le module PKCS #11 dans un emplacement permanent sur votre ordinateur local +2. SĂ©lectonnez **Outils > Options** ou sĂ©lectionnez le **menu Firefox** puis **Options** +3. Une fois la page Options ouverte, sĂ©lectionnez **Vie privĂ©e & SĂ©curitĂ©** +4. Faites dĂ©filer vers le bas de la page et sous **Certificats** ou tapez sur **Dispositifs de sĂ©curitĂ©... + ![](device_manager.png)** +5. Cliquez ou appuyez sur le bouton **Charger** + ![](load_device_driver.png) +6. Entrez un nom pour le module de sĂ©curitĂ©, tel que "_Ma Base de donnĂ©es Client_" + + > **Attention :** il y a actuellement un bogue dans Firefox oĂč les caractĂšres internationaux peuvent causer des problĂšmes. + +7. Choisir **Parcourir...** pour trouver l'emplacement du module PKCS #11 sur votre ordinateur local, puis cliquez ou appuyez sur **OK** pour confirmer. + +<!----> + +## Provisionnement des modules PKCS #11 + +> **Note :** A partir de Firefox 58, les extensions peuvent utiliser l'API [pkcs11](/fr/Add-ons/WebExtensions/API/pkcs11) pour Ă©numĂ©rer les modules PKCS #11 et les rendre accessibles au navigateur comme sources de clĂ©s et certificats. + +Il y a 2 prĂ©-requis pour pouvoir utiliser cette API: + +- un ou plusieurs modules PKCS # 11 doivent ĂȘtre installĂ©s sur l'ordinateur de l'utilisateur +- pour chaque module PKCS # 11 installĂ©, il doit y avoir un fichier [manifest natif](/fr/Add-ons/WebExtensions/manifests_native) qui permet au navigateur de localiser le module. + +TrĂšs probablement, l'utilisateur ou l'administrateur du pĂ©riphĂ©rique installerait le module `PKCS #11`, et son installateur installerait le fichier de manifeste natif en mĂȘme temps. + +Cependant, le module et le manifeste ne peuvent pas ĂȘtre installĂ©s dans le cadre du processus d'installation de l'extension. + +Pour plus de dĂ©tails sur le contenu et l'emplacement du fichier de manifeste, voir [Manifest natifs](/fr/Add-ons/WebExtensions/Native_manifests). + +## Fonctions + +- {{WebExtAPIRef("pkcs11.getModuleSlots()")}} + - : Pour chaque emplacement dans un module, obtenez son nom et s'il contient un jeton. +- {{WebExtAPIRef("pkcs11.installModule()")}} + - : Installe le module PKCS # 11 nommĂ© +- {{WebExtAPIRef("pkcs11.isModuleInstalled()")}} + - : VĂ©rifie si le module PKCS # 11 nommĂ© est installĂ©. +- {{WebExtAPIRef("pkcs11.uninstallModule()")}} + - : DĂ©sinstalle le module PKCS # 11 nommĂ©. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.pkcs11", 1, 1)}} {{WebExtExamples("h2")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/pkcs11/installmodule/index.md b/files/fr/mozilla/add-ons/webextensions/api/pkcs11/installmodule/index.md index a70fee644d..2622aadd2c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pkcs11/installmodule/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pkcs11/installmodule/index.md @@ -12,44 +12,44 @@ tags: - pkcs11 translation_of: Mozilla/Add-ons/WebExtensions/API/pkcs11/installModule --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Installe le module PKCS # 11 nommĂ©, le rendant disponible pour Firefox</p> +Installe le module PKCS # 11 nommĂ©, le rendant disponible pour Firefox -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 installing = browser.pkcs11.installModule( +```js +var installing = browser.pkcs11.installModule( name, // string flags // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>name</code></dt> - <dd><code>string</code>. Nom du module Ă installer. Cela doit correspondre Ă la propriĂ©tĂ© <code>name</code> property dans le <a href="/fr/Add-ons/WebExtensions/Native_manifests#PKCS_11_manifests">manifest PKCS #11</a> pour le module.</dd> - <dt><code>flags</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Drapeaux Ă transmettre au module.</dd> -</dl> +- `name` + - : `string`. Nom du module Ă installer. Cela doit correspondre Ă la propriĂ©tĂ© `name` property dans le [manifest PKCS #11](/fr/Add-ons/WebExtensions/Native_manifests#PKCS_11_manifests) pour le module. +- `flags`{{optional_inline}} + - : `integer`. Drapeaux Ă transmettre au module. -<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 accompli sans arguments une fois le module installĂ©.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera accompli sans arguments une fois le module installĂ©. -<p>Si le module n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promise sera rejetĂ©e avec un message d'erreur.</p> +Si le module n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="Browser_compatibility">Browser compatibility</h2> +## Browser compatibility -<p>{{Compat("webextensions.api.pkcs11.installModule", 10)}}</p> +{{Compat("webextensions.api.pkcs11.installModule", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Installe un module, puis dresse la liste de ses emplacements et liste les jetons qu'ils contiennent :</p> +Installe un module, puis dresse la liste de ses emplacements et liste les jetons qu'ils contiennent : -<pre class="brush: js">function onInstalled() { +```js +function onInstalled() { return browser.pkcs11.getModuleSlots("my_module"); } @@ -66,6 +66,7 @@ function onGotSlots(slots) { browser.pkcs11.installModule("my_module") .then(onInstalled) -.then(onGotSlots);</pre> +.then(onGotSlots); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/pkcs11/ismoduleinstalled/index.md b/files/fr/mozilla/add-ons/webextensions/api/pkcs11/ismoduleinstalled/index.md index db549d86f7..99ed1fcb8b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pkcs11/ismoduleinstalled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pkcs11/ismoduleinstalled/index.md @@ -12,44 +12,45 @@ tags: - pkcs11 translation_of: Mozilla/Add-ons/WebExtensions/API/pkcs11/isModuleInstalled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>VĂ©rifie si le module PKCS #11 nommĂ© est actuellement installĂ© dans Firefox.</p> +VĂ©rifie si le module PKCS #11 nommĂ© est actuellement installĂ© dans Firefox. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 checking = browser.pkcs11.isModuleInstalled( +```js +var checking = browser.pkcs11.isModuleInstalled( name // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>name</code></dt> - <dd><code>string</code>. Nom du module Ă vĂ©rifier.</dd> -</dl> +- `name` + - : `string`. Nom du module Ă vĂ©rifier. -<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 <code>true</code> si le module est installĂ©, <code>false</code> sinon.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec `true` si le module est installĂ©, `false` sinon. -<p>Si une erreur se produit dans le module, la promise sera rejetĂ©e avec un message d'erreur.</p> +Si une erreur se produit dans le module, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.pkcs11.isModuleInstalled", 10)}}</p> +{{Compat("webextensions.api.pkcs11.isModuleInstalled", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>VĂ©rifie sir le module nommĂ©e "pkcs11_module" est installĂ© :</p> +VĂ©rifie sir le module nommĂ©e "pkcs11_module" est installĂ© : -<pre class="brush: js">function logIsInstalled(isInstalled) { +```js +function logIsInstalled(isInstalled) { console.log(`Module is installed: ${isInstalled}`); } -browser.pkcs11.isModuleInstalled("pkcs11_module").then(logIsInstalled);</pre> +browser.pkcs11.isModuleInstalled("pkcs11_module").then(logIsInstalled); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/pkcs11/uninstallmodule/index.md b/files/fr/mozilla/add-ons/webextensions/api/pkcs11/uninstallmodule/index.md index 4d76345947..43e5922bbd 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/pkcs11/uninstallmodule/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/pkcs11/uninstallmodule/index.md @@ -12,40 +12,41 @@ tags: - uninstallModule translation_of: Mozilla/Add-ons/WebExtensions/API/pkcs11/uninstallModule --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©sinstalle le module PKCS #11 nommĂ© de Firefox.</p> +DĂ©sinstalle le module PKCS #11 nommĂ© de Firefox. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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.pkcs11.uninstallModule( +```js +var uninstalling = browser.pkcs11.uninstallModule( name // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>name</code></dt> - <dd><code>string</code>. Nom du module Ă dĂ©sinstaller. Cela doit correspondre Ă la propriĂ©tĂ© <code>name</code> dans le <a href="/fr/Add-ons/WebExtensions/Native_manifests#PKCS_11_manifests">manifest PKCS #11</a> pour le module.</dd> -</dl> +- `name` + - : `string`. Nom du module Ă dĂ©sinstaller. Cela doit correspondre Ă la propriĂ©tĂ© `name` dans le [manifest PKCS #11](/fr/Add-ons/WebExtensions/Native_manifests#PKCS_11_manifests) pour le module. -<h3 id="Return_value">Return value</h3> +### Return value -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera accompli sans arguments une fois le module dĂ©sinstallĂ©e.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera accompli sans arguments une fois le module dĂ©sinstallĂ©e. -<p>Si le module n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promise sera rejetĂ©e avec un message d'erreur.</p> +Si le module n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promise sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.pkcs11.uninstallModule", 10)}}</p> +{{Compat("webextensions.api.pkcs11.uninstallModule", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©sinstalle le module nommĂ© "pkcs11_module" :</p> +DĂ©sinstalle le module nommĂ© "pkcs11_module" : -<pre class="brush: js">browser.pkcs11.uninstallModule("pkcs11_module");</pre> +```js +browser.pkcs11.uninstallModule("pkcs11_module"); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/privacy/index.md b/files/fr/mozilla/add-ons/webextensions/api/privacy/index.md index 1cb748bb23..95dd66b414 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/privacy/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/privacy/index.md @@ -10,36 +10,32 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/privacy --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>AccĂ©dez et modifiez les diffĂ©rents paramĂštres du navigateur liĂ©s Ă la vie privĂ©e.</p> +AccĂ©dez et modifiez les diffĂ©rents paramĂštres du navigateur liĂ©s Ă la vie privĂ©e. -<p>Pour utiliser l'API de confidentialitĂ©, vous devez avoir <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">l'autorisation de l'API</a> "privacy".</p> +Pour utiliser l'API de confidentialitĂ©, vous devez avoir [l'autorisation de l'API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "privacy". -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> +## PropriĂ©tĂ©s -<dl> - <dt>{{WebExtAPIRef("privacy.network")}}</dt> - <dd>AccĂšs et modification des paramĂštres de confidentialitĂ© relatifs au rĂ©seau.</dd> - <dt>{{WebExtAPIRef("privacy.services")}}</dt> - <dd>AccĂšs et modification des paramĂštres de confidentialitĂ© relatifs aux services fournis par le navigateur ou les tiers.</dd> - <dt>{{WebExtAPIRef("privacy.websites")}}</dt> - <dd>AccĂšs et modification des paramĂštres de confidentialitĂ© relatifs aux comportements des sites Web.</dd> -</dl> +- {{WebExtAPIRef("privacy.network")}} + - : AccĂšs et modification des paramĂštres de confidentialitĂ© relatifs au rĂ©seau. +- {{WebExtAPIRef("privacy.services")}} + - : AccĂšs et modification des paramĂštres de confidentialitĂ© relatifs aux services fournis par le navigateur ou les tiers. +- {{WebExtAPIRef("privacy.websites")}} + - : AccĂšs et modification des paramĂštres de confidentialitĂ© relatifs aux comportements des sites Web. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.privacy", 10, 1)}}</p> +{{Compat("webextensions.api.privacy", 10, 1)}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.privacy`](https://developer.chrome.com/extensions/privacy). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/privacy"><code>chrome.privacy</code></a>.</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 @@ -66,5 +62,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/privacy // 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/privacy/network/index.md b/files/fr/mozilla/add-ons/webextensions/api/privacy/network/index.md index c3cfea2903..1f9407f755 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/privacy/network/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/privacy/network/index.md @@ -12,35 +12,32 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/privacy/network --- -<div>{{AddonSidebar}} -<p>La propriĂ©tĂ© {{WebExtAPIRef("privacy.network")}} contient des paramĂštres de configuration du rĂ©seau liĂ©s Ă la vie privĂ©e. Chaque propriĂ©tĂ© est un objet {{WebExtAPIRef("types.BrowserSetting")}}.</p> +{{AddonSidebar}} -<p>Les valeurs par dĂ©faut de ces propriĂ©tĂ©s peuvent varier selon les navigateurs.</p> +La propriĂ©tĂ© {{WebExtAPIRef("privacy.network")}} contient des paramĂštres de configuration du rĂ©seau liĂ©s Ă la vie privĂ©e. Chaque propriĂ©tĂ© est un objet {{WebExtAPIRef("types.BrowserSetting")}}. -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> +Les valeurs par dĂ©faut de ces propriĂ©tĂ©s peuvent varier selon les navigateurs. -<dl> - <dt><code>networkPredictionEnabled</code></dt> - <dd>Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur contenue est un boolĂ©en. Si il est dĂ©fini Ă <code>true</code>, le navigateur tente d'accĂ©lĂ©rer la navigation Web avec la prĂ©-rĂ©solution des entrĂ©es DNS, le prĂ©-chargement des sites (en utilisant, par exemple, <code><link rel='prefetch' ...></code>), et en ouvrant de maniĂšre prĂ©emptive les connexions TCP et SSL aux serveurs.</dd> - <dt><code>peerConnectionEnabled</code></dt> - <dd>Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur contenue est un boolĂ©en. Si il est dĂ©fini Ă <code>false</code>, l'interface<code><a href="/fr/docs/Web/API/RTCPeerConnection">RTCPeerConnection</a></code> est dĂ©sactivĂ©e. Notez que <code><a href="/fr/docs/Web/API/MediaDevices/getUserMedia">getUserMedia()</a></code> n'est pas affectĂ©e par ce paramĂštre.</dd> - <dt><code>webRTCIPHandlingPolicy</code></dt> - <dd>Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur contenue est une chaĂźne de caractĂšres. Ce paramĂštre permet aux utilisateurs de spĂ©cifier les compromissions de performance / confidentialitĂ© des mĂ©dias qui affectent la façon dont le trafic WebRTC sera acheminĂ© et la quantitĂ© d'informations d'adresse locale exposĂ©es. Il peut prendre l'une des valeurs suivantes :<br> - <code>"default"<br> - "default_public_and_private_interfaces"<br> - "default_public_interface_only"<br> - "disable_non_proxied_udp"</code></dd> -</dl> +## PropriĂ©tĂ©s -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- `networkPredictionEnabled` + - : Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur contenue est un boolĂ©en. Si il est dĂ©fini Ă `true`, le navigateur tente d'accĂ©lĂ©rer la navigation Web avec la prĂ©-rĂ©solution des entrĂ©es DNS, le prĂ©-chargement des sites (en utilisant, par exemple, `<link rel='prefetch' ...>`), et en ouvrant de maniĂšre prĂ©emptive les connexions TCP et SSL aux serveurs. +- `peerConnectionEnabled` + - : Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur contenue est un boolĂ©en. Si il est dĂ©fini Ă `false`, l'interface[`RTCPeerConnection`](/fr/docs/Web/API/RTCPeerConnection) est dĂ©sactivĂ©e. Notez que [`getUserMedia()`](/fr/docs/Web/API/MediaDevices/getUserMedia) n'est pas affectĂ©e par ce paramĂštre. +- `webRTCIPHandlingPolicy` + - : Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur contenue est une chaĂźne de caractĂšres. Ce paramĂštre permet aux utilisateurs de spĂ©cifier les compromissions de performance / confidentialitĂ© des mĂ©dias qui affectent la façon dont le trafic WebRTC sera acheminĂ© et la quantitĂ© d'informations d'adresse locale exposĂ©es. Il peut prendre l'une des valeurs suivantes : + `"default" "default_public_and_private_interfaces" "default_public_interface_only" "disable_non_proxied_udp"` -<p>{{Compat("webextensions.api.privacy.network")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.privacy.network")}} -<p>DĂ©finissez la propriĂ©tĂ© <code>webRTCIPHandlingPolicy</code> :</p> +## Exemples -<pre class="brush: js">function onSet(result) { +DĂ©finissez la propriĂ©tĂ© `webRTCIPHandlingPolicy` : + +```js +function onSet(result) { if (result) { console.log("success"); } else { @@ -48,10 +45,10 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/privacy/network } } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { var getting = browser.privacy.network.webRTCIPHandlingPolicy.get({}); - getting.then((got) => { + getting.then((got) => { console.log(got.value); if ((got.levelOfControl === "controlled_by_this_extension") || (got.levelOfControl === "controllable_by_this_extension")) { @@ -65,20 +62,17 @@ browser.browserAction.onClicked.addListener(() => { }); }); +``` -</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/privacy"><code>chrome.privacy</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/privacy.json"><code>privacy.json</code></a> dans le code de Chromium.</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.privacy`](https://developer.chrome.com/extensions/privacy). Cette documentation est dĂ©rivĂ©e de [`privacy.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/privacy.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -105,6 +99,4 @@ browser.browserAction.onClicked.addListener(() => { // 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> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/privacy/services/index.md b/files/fr/mozilla/add-ons/webextensions/api/privacy/services/index.md index 4bc13840b6..07e8f2fd55 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/privacy/services/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/privacy/services/index.md @@ -11,25 +11,25 @@ tags: - Services translation_of: Mozilla/Add-ons/WebExtensions/API/privacy/services --- -<div>{{AddonSidebar}} -<p>La propriĂ©tĂ© {{WebExtAPIRef("privacy.services")}} contient des paramĂštres liĂ©s Ă la vie privĂ©e contrĂŽlant les services offerts par le navigateur ou par des tiers. Chaque propriĂ©tĂ© est un objet {{WebExtAPIRef("types.BrowserSetting")}}.</p> +{{AddonSidebar}} -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> +La propriĂ©tĂ© {{WebExtAPIRef("privacy.services")}} contient des paramĂštres liĂ©s Ă la vie privĂ©e contrĂŽlant les services offerts par le navigateur ou par des tiers. Chaque propriĂ©tĂ© est un objet {{WebExtAPIRef("types.BrowserSetting")}}. -<dl> - <dt><code>passwordSavingEnabled</code></dt> - <dd>Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur contenue est un boolĂ©en. Si il est dĂ©fini Ă <code>true</code>, le gestionnaire de mot de passe du navigateur proposera de stocker des mots de passe lorsque l'utilisateur les entrera. La valeur par dĂ©faut est : <code>true</code>.</dd> -</dl> +## PropriĂ©tĂ©s -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- `passwordSavingEnabled` + - : Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur contenue est un boolĂ©en. Si il est dĂ©fini Ă `true`, le gestionnaire de mot de passe du navigateur proposera de stocker des mots de passe lorsque l'utilisateur les entrera. La valeur par dĂ©faut est : `true`. -<p>{{Compat("webextensions.api.privacy.services", 10)}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.privacy.services", 10)}} -<p>DĂ©sactivation, si possible, du gestionnaire de mot de passe.</p> +## Exemples -<pre class="brush: js">function onSet(result) { +DĂ©sactivation, si possible, du gestionnaire de mot de passe. + +```js +function onSet(result) { if (result) { console.log("success"); } else { @@ -38,7 +38,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/privacy/services } var getting = browser.privacy.services.passwordSavingEnabled.get({}); - getting.then((got) => { + getting.then((got) => { console.log(got.value); if ((got.levelOfControl === "controlled_by_this_extension") || (got.levelOfControl === "controllable_by_this_extension")) { @@ -49,12 +49,11 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/privacy/services } else { console.log("Not able to set passwordSavingEnabled"); } - });</pre> - -<p>{{WebExtExamples}}</p> + }); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/privacy"><code>chrome.privacy</code></a>.</p> -</div> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.privacy`](https://developer.chrome.com/extensions/privacy). diff --git a/files/fr/mozilla/add-ons/webextensions/api/privacy/websites/index.md b/files/fr/mozilla/add-ons/webextensions/api/privacy/websites/index.md index f35271b733..65e06381cd 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/privacy/websites/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/privacy/websites/index.md @@ -12,81 +12,74 @@ tags: - websites translation_of: Mozilla/Add-ons/WebExtensions/API/privacy/websites --- -<div>{{AddonSidebar}} -<p>La propriĂ©tĂ© {{WebExtAPIRef("privacy.websites")}} contient les paramĂštres liĂ©s Ă la vie privĂ©e qui contrĂŽlent la façon dont le navigateur interargit avec les sites web. Chaque propriĂ©tĂ© est un objet {{WebExtAPIRef("types.BrowserSetting")}}.</p> - -<p>Les valeurs par dĂ©faut de ces propriĂ©tĂ©s ont tendance Ă varier selon les navigateurs.</p> - -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> - -<dl> - <dt><code>cookieConfig</code></dt> - <dd> - <p>Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un objet.</p> - - <p>L'objet a deux propriĂ©tĂ©s :</p> - - <ul> - <li><code>behavior</code>: une chaĂźne qui peut prendre l'une des valeurs suivantes: - - <ul> - <li>"allow_all": accepte tous les cookies</li> - <li>"reject_all": rejeter tous les cookies</li> - <li>"reject_third_party": rejeter tous les cookies tiers</li> - <li>"allow_visited" : accepte un cookie tiers uniquement si le domaine de premier niveau du cookie contient dĂ©jĂ au moins un cookie.</li> - <li>"reject_trackers": rejeter les cookies de suivi</li> - </ul> - </li> - <li><code>nonPersistentCookies</code>: un boolĂ©en. Si la valeur est true, tous les cookies seront traitĂ©s comme des cookies de session.</li> - </ul> - </dd> - <dt><code>firstPartyIsolate</code></dt> - <dd> - <p>Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en.</p> - - <p>SI <code>true</code>, la prĂ©fĂ©rence <code>firstPartyIsolate</code> permet au navigateur d'associer toutes les donnĂ©es (y compris les cookies, les donnĂ©es HSTS, les images mises en cache, etc.) pour tous les domaines tiers avec le domaine dans la barre d'adresse. Cela empĂȘche les suiveurs tiers d'utiliser directement les informations stockĂ©es pour identifier l'utilisateur sur diffĂ©rents sites Web, mais peut interrompre les sites Web dans lesquels l'utilisateur se connecte avec un compte tiers (tel qu'un compte Facebook ou Google).</p> - - <p>Par dĂ©faut Ă <code>false</code>.</p> - </dd> - <dt><code>hyperlinkAuditingEnabled</code></dt> - <dd>Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. Si <code>true</code>, le navigateur envoie des pings d'audit lorsqu'un site web utilise l'attribut <code>ping</code> pour les demander.</dd> - <dt><code>protectedContentEnabled</code></dt> - <dd>Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. Disponible uniquement sur Windows. Si<code>true</code>, le navigateur fournit un ID unique aux plugins afin d'exĂ©cuter le contenu protĂ©gĂ©.</dd> - <dt><code>referrersEnabled</code></dt> - <dd>Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. Si activĂ©, le navigateur envoie les en-tĂȘtes de <a href="/fr/docs/Web/HTTP/Headers/Referer">rĂ©fĂ©rence</a> avec vos demandes.</dd> - <dt><code>resistFingerprinting</code></dt> - <dd> - <p>Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en.</p> - - <p>Les empreintes digitales des navigateurs sont la pratique par laquelle les sites Web utilisent les API Web pour collecter des donnĂ©es d'Ă©tat ou de configuration associĂ©es au navigateur ou Ă l'appareil sur lequel il s'exĂ©cute. En faisant cela, ils peuvent construire une empreinte numĂ©rique qu'ils peuvent utiliser pour identifier et suivre un utilisateur particulier.</p> - - <p>Si <code>true</code>, la prĂ©fĂ©rence <code>resistFingerprinting</code> signale au navigateur des informations usurpĂ©es gĂ©nĂ©riques pour les donnĂ©es couramment utilisĂ©es pour les empreintes digitales. Ces donnĂ©es incluent le nombre de cĆurs de processeur, la prĂ©cision des temporisateurs JavaScript et le fuseau horaire local. Il dĂ©sactive Ă©galement les fonctionnalitĂ©s utilisĂ©es pour la prise d'empreintes digitales, telles que la prise en charge de GamePad et les API WebSpeech et Navigator.</p> - - <p>Par dĂ©faut Ă <code>false</code>.</p> - </dd> - <dt><code>thirdPartyCookiesAllowed</code></dt> - <dd>Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. Si <code>false</code>, le navigateur bloque les <a href="/fr/docs/Web/HTTP/Cookies#Third-party_cookies">cookies tiers</a>.</dd> - <dt><code>trackingProtectionMode</code></dt> - <dd> - <p>La "protection de suivi" est une fonctionnalitĂ© de navigateur qui bloque les requĂȘtes faites sur des domaines qui sont connus pour s'engager dans le suivi multi-sites des utilisateurs. Les sites qui suivent les utilisateurs sont gĂ©nĂ©ralement des sites publicitaires et analytiques tiers. Ce paramĂštre est un objet {{WebExtAPIRef("types.BrowserSetting")}} qui dĂ©termine si le navigateur doit activer la protection de suivi. Sa valeur sous-jacente est une chaĂźne qui peut prendre l'une des trois valeurs :</p> - - <ul> - <li><code>"always"</code>: La protection de suivi est activĂ©e.</li> - <li><code>"never"</code>: La protection de suivi est dĂ©sactivĂ©e.</li> - <li><code>"private_browsing"</code>: La protection de suivi est activĂ©e uniquement dans les fenĂȘtres de navigation privĂ©e.</li> - </ul> - </dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.privacy.websites")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>DĂ©finissez la propriĂ©tĂ© <code>hyperlinkAuditingEnabled</code> .</p> - -<pre class="brush: js">function onSet(result) { +{{AddonSidebar}} + +La propriĂ©tĂ© {{WebExtAPIRef("privacy.websites")}} contient les paramĂštres liĂ©s Ă la vie privĂ©e qui contrĂŽlent la façon dont le navigateur interargit avec les sites web. Chaque propriĂ©tĂ© est un objet {{WebExtAPIRef("types.BrowserSetting")}}. + +Les valeurs par dĂ©faut de ces propriĂ©tĂ©s ont tendance Ă varier selon les navigateurs. + +## PropriĂ©tĂ©s + +- `cookieConfig` + + - : Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un objet. + + L'objet a deux propriĂ©tĂ©s : + + - `behavior`: une chaĂźne qui peut prendre l'une des valeurs suivantes: + + - "allow_all": accepte tous les cookies + - "reject_all": rejeter tous les cookies + - "reject_third_party": rejeter tous les cookies tiers + - "allow_visited" : accepte un cookie tiers uniquement si le domaine de premier niveau du cookie contient dĂ©jĂ au moins un cookie. + - "reject_trackers": rejeter les cookies de suivi + + - `nonPersistentCookies`: un boolĂ©en. Si la valeur est true, tous les cookies seront traitĂ©s comme des cookies de session. + +- `firstPartyIsolate` + + - : Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. + + SI `true`, la prĂ©fĂ©rence `firstPartyIsolate` permet au navigateur d'associer toutes les donnĂ©es (y compris les cookies, les donnĂ©es HSTS, les images mises en cache, etc.) pour tous les domaines tiers avec le domaine dans la barre d'adresse. Cela empĂȘche les suiveurs tiers d'utiliser directement les informations stockĂ©es pour identifier l'utilisateur sur diffĂ©rents sites Web, mais peut interrompre les sites Web dans lesquels l'utilisateur se connecte avec un compte tiers (tel qu'un compte Facebook ou Google). + + Par dĂ©faut Ă `false`. + +- `hyperlinkAuditingEnabled` + - : Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. Si `true`, le navigateur envoie des pings d'audit lorsqu'un site web utilise l'attribut `ping` pour les demander. +- `protectedContentEnabled` + - : Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. Disponible uniquement sur Windows. Si`true`, le navigateur fournit un ID unique aux plugins afin d'exĂ©cuter le contenu protĂ©gĂ©. +- `referrersEnabled` + - : Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. Si activĂ©, le navigateur envoie les en-tĂȘtes de [rĂ©fĂ©rence](/fr/docs/Web/HTTP/Headers/Referer) avec vos demandes. +- `resistFingerprinting` + + - : Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. + + Les empreintes digitales des navigateurs sont la pratique par laquelle les sites Web utilisent les API Web pour collecter des donnĂ©es d'Ă©tat ou de configuration associĂ©es au navigateur ou Ă l'appareil sur lequel il s'exĂ©cute. En faisant cela, ils peuvent construire une empreinte numĂ©rique qu'ils peuvent utiliser pour identifier et suivre un utilisateur particulier. + + Si `true`, la prĂ©fĂ©rence `resistFingerprinting` signale au navigateur des informations usurpĂ©es gĂ©nĂ©riques pour les donnĂ©es couramment utilisĂ©es pour les empreintes digitales. Ces donnĂ©es incluent le nombre de cĆurs de processeur, la prĂ©cision des temporisateurs JavaScript et le fuseau horaire local. Il dĂ©sactive Ă©galement les fonctionnalitĂ©s utilisĂ©es pour la prise d'empreintes digitales, telles que la prise en charge de GamePad et les API WebSpeech et Navigator. + + Par dĂ©faut Ă `false`. + +- `thirdPartyCookiesAllowed` + - : Un objet {{WebExtAPIRef("types.BrowserSetting")}} dont la valeur sous-jacente est un boolĂ©en. Si `false`, le navigateur bloque les [cookies tiers](/fr/docs/Web/HTTP/Cookies#Third-party_cookies). +- `trackingProtectionMode` + + - : La "protection de suivi" est une fonctionnalitĂ© de navigateur qui bloque les requĂȘtes faites sur des domaines qui sont connus pour s'engager dans le suivi multi-sites des utilisateurs. Les sites qui suivent les utilisateurs sont gĂ©nĂ©ralement des sites publicitaires et analytiques tiers. Ce paramĂštre est un objet {{WebExtAPIRef("types.BrowserSetting")}} qui dĂ©termine si le navigateur doit activer la protection de suivi. Sa valeur sous-jacente est une chaĂźne qui peut prendre l'une des trois valeurs : + + - `"always"`: La protection de suivi est activĂ©e. + - `"never"`: La protection de suivi est dĂ©sactivĂ©e. + - `"private_browsing"`: La protection de suivi est activĂ©e uniquement dans les fenĂȘtres de navigation privĂ©e. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.privacy.websites")}} + +## Exemples + +DĂ©finissez la propriĂ©tĂ© `hyperlinkAuditingEnabled` . + +```js +function onSet(result) { if (result) { console.log("success"); } else { @@ -94,10 +87,10 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/privacy/websites } } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { var getting = browser.privacy.websites.hyperlinkAuditingEnabled.get({}); - getting.then((got) => { + getting.then((got) => { console.log(got.value); if ((got.levelOfControl === "controlled_by_this_extension") || (got.levelOfControl === "controllable_by_this_extension")) { @@ -110,19 +103,18 @@ browser.browserAction.onClicked.addListener(() => { } }); -});</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/privacy"><code>chrome.privacy</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/privacy.json"><code>privacy.json</code></a> dans le code de Chromium.</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.privacy`](https://developer.chrome.com/extensions/privacy). Cette documentation est dĂ©rivĂ©e de [`privacy.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/privacy.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -149,6 +141,4 @@ browser.browserAction.onClicked.addListener(() => { // 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> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/index.md index 00d4ca9642..fc9725aef9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/index.md @@ -8,61 +8,50 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/proxy --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<div class="warning"> -<p><strong>Attention :</strong></p> - <p>Vous ne devez pas utiliser la fonction {{WebExtAPIRef("proxy.register()")}} ou la fonction {{WebExtAPIRef("proxy.unregister()")}} pour enregistrer et supprimer le fichier <a href="/fr/Add-ons/WebExtensions/API/proxy/register#PAC_file_specification">Proxy Auto-Configuration (PAC)</a>. Cette API Ă©tait dĂ©prĂ©ciĂ©e dans Firefox 68 et sera supprimĂ©e de Firefox 71.</p> -</div> +> **Attention :** +> +> Vous ne devez pas utiliser la fonction {{WebExtAPIRef("proxy.register()")}} ou la fonction {{WebExtAPIRef("proxy.unregister()")}} pour enregistrer et supprimer le fichier [Proxy Auto-Configuration (PAC)](/fr/Add-ons/WebExtensions/API/proxy/register#PAC_file_specification). Cette API Ă©tait dĂ©prĂ©ciĂ©e dans Firefox 68 et sera supprimĂ©e de Firefox 71. -<p>Utilisez l'API proxy pour les requĂȘtes Web proxy. Vous pouvez utiliser l'Ă©couteur d'Ă©vĂ©nement {{WebExtAPIRef("proxy.onRequest")}}} pour intercepter les requĂȘtes web, et retourner un objet qui dĂ©crit si et comment les proxyer.</p> +Utilisez l'API proxy pour les requĂȘtes Web proxy. Vous pouvez utiliser l'Ă©couteur d'Ă©vĂ©nement {{WebExtAPIRef("proxy.onRequest")}}} pour intercepter les requĂȘtes web, et retourner un objet qui dĂ©crit si et comment les proxyer. -<p>L'avantage de l'approche <code>proxy.onRequest</code> est que le code qui implĂ©mente votre stratĂ©gie de proxy s'exĂ©cute dans le script d'arriĂšre-plan de votre extension pour accĂ©der aux API WebExtension disponibles pour votre extension (y compris, par exemple, l'accĂšs au <code><a href="/fr/Add-ons/WebExtensions/API/storage">stockage</a></code> et au rĂ©seau de votre extension APIs comme <code><a href="/fr/Add-ons/WebExtensions/API/dns">dns</a></code>).</p> +L'avantage de l'approche `proxy.onRequest` est que le code qui implĂ©mente votre stratĂ©gie de proxy s'exĂ©cute dans le script d'arriĂšre-plan de votre extension pour accĂ©der aux API WebExtension disponibles pour votre extension (y compris, par exemple, l'accĂšs au [`stockage`](/fr/Add-ons/WebExtensions/API/storage) et au rĂ©seau de votre extension APIs comme [`dns`](/fr/Add-ons/WebExtensions/API/dns)). -<p>En dehors de cette API, les extensions peuvent Ă©galement utiliser la propriĂ©tĂ©Â <code><a href="/fr/Add-ons/WebExtensions/API/browserSettings/proxyConfig">browserSettings.proxyConfig</a></code> pour configurer les paramĂštres proxy globaux.</p> +En dehors de cette API, les extensions peuvent Ă©galement utiliser la propriĂ©tĂ©Â [`browserSettings.proxyConfig`](/fr/Add-ons/WebExtensions/API/browserSettings/proxyConfig) pour configurer les paramĂštres proxy globaux. -<p>Google Chrome fournit <a href="https://developer.chrome.com/extensions/proxy">une API d'extension Ă©galement appelĂ©e "proxy"</a> qui est fonctionnellement similaire Ă cette API, dans la mesure oĂč les extensions peuvent l'utiliser pour implĂ©menter une politique de proxy. Cependant, la conception de l'API Chrome est complĂštement diffĂ©rente de cette API. Ătant donnĂ© que cette API est incompatible avec l'API de <code>proxy</code> Chrome, cette API est uniquement disponible via l'espace de noms du <code>navigateur</code>.</p> +Google Chrome fournit [une API d'extension Ă©galement appelĂ©e "proxy"](https://developer.chrome.com/extensions/proxy) qui est fonctionnellement similaire Ă cette API, dans la mesure oĂč les extensions peuvent l'utiliser pour implĂ©menter une politique de proxy. Cependant, la conception de l'API Chrome est complĂštement diffĂ©rente de cette API. Ătant donnĂ© que cette API est incompatible avec l'API de `proxy` Chrome, cette API est uniquement disponible via l'espace de noms du `navigateur`. -<p>Pour utiliser cette API, vous devez disposer de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "proxy". De plus, lorsque vous voulez intercepter des requĂȘtes, vous avez Ă©galement besoin de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permission de l'hĂŽte</a> pour les URL des requĂȘtes interceptĂ©es</p> +Pour utiliser cette API, vous devez disposer de la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "proxy". De plus, lorsque vous voulez intercepter des requĂȘtes, vous avez Ă©galement besoin de la [permission de l'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) pour les URL des requĂȘtes interceptĂ©es -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("proxy.ProxyInfo")}}</dt> - <dd>DĂ©crit un proxy.</dd> - <dt>{{WebExtAPIRef("proxy.RequestDetails")}}</dt> - <dd> - <p>Contient des informations sur une requĂȘte Web que le navigateur est sur le point de faire.</p> - </dd> -</dl> +- {{WebExtAPIRef("proxy.ProxyInfo")}} + - : DĂ©crit un proxy. +- {{WebExtAPIRef("proxy.RequestDetails")}} + - : Contient des informations sur une requĂȘte Web que le navigateur est sur le point de faire. -<h2 id="Properties">Properties</h2> +## Properties -<dl> - <dt>{{WebExtAPIRef("proxy.settings")}}</dt> - <dd>Obtenir et dĂ©finir les paramĂštres de proxy.</dd> -</dl> +- {{WebExtAPIRef("proxy.settings")}} + - : Obtenir et dĂ©finir les paramĂštres de proxy. -<h2 id="Functions">Functions</h2> +## Functions -<dl> - <dt>{{WebExtAPIRef("proxy.register()")}}</dt> - <dd>Enregistre le script proxy donnĂ©.</dd> - <dt>{{WebExtAPIRef("proxy.unregister()")}}</dt> - <dd>Annule l'inscription du script proxy.</dd> -</dl> +- {{WebExtAPIRef("proxy.register()")}} + - : Enregistre le script proxy donnĂ©. +- {{WebExtAPIRef("proxy.unregister()")}} + - : Annule l'inscription du script proxy. -<h2 id="Events">Events</h2> +## Events -<dl> - <dt>{{WebExtAPIRef("proxy.onError")}}</dt> - <dd>LancĂ© lorsque le systĂšme rencontre une erreur lors de l'exĂ©cution du script PAC ou de l'Ă©couteur <code>onRequest</code>.</dd> - <dt>{{WebExtAPIRef("proxy.onRequest")}}</dt> - <dd>DĂ©clenchĂ© lorsqu'une requĂȘte Web est sur le point d'ĂȘtre effectuĂ©e, ce qui donne Ă l'extension l'opportunitĂ© de l'utiliser comme proxy.</dd> -</dl> +- {{WebExtAPIRef("proxy.onError")}} + - : LancĂ© lorsque le systĂšme rencontre une erreur lors de l'exĂ©cution du script PAC ou de l'Ă©couteur `onRequest`. +- {{WebExtAPIRef("proxy.onRequest")}} + - : DĂ©clenchĂ© lorsqu'une requĂȘte Web est sur le point d'ĂȘtre effectuĂ©e, ce qui donne Ă l'extension l'opportunitĂ© de l'utiliser comme proxy. -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.proxy")}}</p> +{{Compat("webextensions.api.proxy")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/onerror/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/onerror/index.md index 136451dc85..ae309570bb 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/onerror/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/onerror/index.md @@ -12,48 +12,42 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/onError original_slug: Mozilla/Add-ons/WebExtensions/API/proxy/onProxyError --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© en cas d'erreur lors de l'Ă©valuation du fichier PAC ou l'Ă©couteur <code>onRequest</code>.</p> +LancĂ© en cas d'erreur lors de l'Ă©valuation du fichier PAC ou l'Ă©couteur `onRequest`. -<p>L'erreur peut ĂȘtre dĂ©clenchĂ©e en lançant ou renvoyant une valeur invalide dans le gestionnaire d'Ă©vĂ©nements proxy.onRequest.</p> +L'erreur peut ĂȘtre dĂ©clenchĂ©e en lançant ou renvoyant une valeur invalide dans le gestionnaire d'Ă©vĂ©nements proxy.onRequest. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.proxy.onError.addListener(listener) +```js +browser.proxy.onError.addListener(listener) browser.proxy.onError.removeListener(listener) browser.proxy.onError.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si l'<code>Ă©couteur</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si l'`Ă©couteur` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>newState</code></dt> - <dd><code>Object</code>. Un objet <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Error">Error</a> reprĂ©sentant l'erreur.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<p>{{WebExtExamples}}</p> + - `newState` + - : `Object`. Un objet [Error](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Error) reprĂ©sentant l'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{WebExtExamples}} -<p>{{Compat("webextensions.api.proxy.onError")}}</p> +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.proxy.onError")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/onrequest/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/onrequest/index.md index 209b532f15..90a46bbe63 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/onrequest/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/onrequest/index.md @@ -12,83 +12,77 @@ tags: - onRequest translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/onRequest --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©clenchĂ© lorsqu'une requĂȘte Web est sur le point d'ĂȘtre effectuĂ©e, pour donner Ă l'extension la possibilitĂ© de l'utiliser comme proxy.</p> +DĂ©clenchĂ© lorsqu'une requĂȘte Web est sur le point d'ĂȘtre effectuĂ©e, pour donner Ă l'extension la possibilitĂ© de l'utiliser comme proxy. -<p>Cet Ă©vĂ©nement est Ă©troitement modĂ©lisĂ© sur les Ă©vĂ©nements dĂ©finis dans l'API <code><a href="/fr/Add-ons/WebExtensions/API/webRequest">webRequest</a></code> Comme ces Ă©vĂ©nements, sa fonction <code>addListener()</code> prend trois arguments :</p> +Cet Ă©vĂ©nement est Ă©troitement modĂ©lisĂ© sur les Ă©vĂ©nements dĂ©finis dans l'API [`webRequest`](/fr/Add-ons/WebExtensions/API/webRequest) Comme ces Ă©vĂ©nements, sa fonction `addListener()` prend trois arguments : -<ul> - <li>l'Ă©couteur qui sera appelĂ© lorsque l'Ă©vĂ©nement est dĂ©clenchĂ©.</li> - <li>Un objet <code><a href="/fr/Add-ons/WebExtensions/API/webRequest/RequestFilter">RequestFilter</a></code> contrĂŽlant quelles requĂȘtes provoquent le dĂ©clenchement de l'Ă©vĂ©nement.</li> - <li>un tableau de chaĂźnes pour contrĂŽler d'autres aspects du comportement de l'Ă©vĂ©nement.</li> -</ul> +- l'Ă©couteur qui sera appelĂ© lorsque l'Ă©vĂ©nement est dĂ©clenchĂ©. +- Un objet [`RequestFilter`](/fr/Add-ons/WebExtensions/API/webRequest/RequestFilter) contrĂŽlant quelles requĂȘtes provoquent le dĂ©clenchement de l'Ă©vĂ©nement. +- un tableau de chaĂźnes pour contrĂŽler d'autres aspects du comportement de l'Ă©vĂ©nement. -<p>L'Ă©vĂ©nement est dĂ©clenchĂ© avant l'un des Ă©vĂ©nements <code>webRequest</code> pour la mĂȘme demande.</p> +L'Ă©vĂ©nement est dĂ©clenchĂ© avant l'un des Ă©vĂ©nements `webRequest` pour la mĂȘme demande. -<p>Lorsque l'Ă©vĂ©nement est dĂ©clenchĂ©, l'Ă©couteur est appelĂ© avec un objet contenant des informations sur la requĂȘte. L'Ă©couteur renvoie un objet {{WebExtAPIRef("proxy.ProxyInfo")}} reprĂ©sentant un proxy Ă utiliser (ou un tableau de tels objets, permettant au navigateur de basculer si un proxy est inaccessible).</p> +Lorsque l'Ă©vĂ©nement est dĂ©clenchĂ©, l'Ă©couteur est appelĂ© avec un objet contenant des informations sur la requĂȘte. L'Ă©couteur renvoie un objet {{WebExtAPIRef("proxy.ProxyInfo")}} reprĂ©sentant un proxy Ă utiliser (ou un tableau de tels objets, permettant au navigateur de basculer si un proxy est inaccessible). -<p>Pour utiliser <code>proxy.onRequest</code>, une extension doit avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission API</a> "proxy" , ainsi que la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permission d'hĂŽte</a> pour les URL des requĂȘtes qu'elle intercepte - ela signifie essentiellement que les modĂšles de correspondance de l'argument <code>filter</code> doivent ĂȘtre un sous-ensemble de l'extension autorisations de l'hĂŽte.</p> +Pour utiliser `proxy.onRequest`, une extension doit avoir la [permission API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "proxy" , ainsi que la [permission d'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) pour les URL des requĂȘtes qu'elle intercepte - ela signifie essentiellement que les modĂšles de correspondance de l'argument `filter` doivent ĂȘtre un sous-ensemble de l'extension autorisations de l'hĂŽte. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.proxy.onRequest.addListener( +```js +browser.proxy.onRequest.addListener( listener, // function filter, // object extraInfoSpec // optional array of strings ) browser.proxy.onRequest.removeListener(listener) browser.proxy.onRequest.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(listener, filter, extraInfoSpec)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener, filter, extraInfoSpec)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>listener</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction passera un seul argument, qui est un objet {{WebExtAPIRef("proxy.RequestDetails")}} contenant les dĂ©tails de la requĂȘte.</p> +- `listener` - <p>L'Ă©couteur peut renvoyer l'un des Ă©lĂ©ments suivants:</p> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction passera un seul argument, qui est un objet {{WebExtAPIRef("proxy.RequestDetails")}} contenant les dĂ©tails de la requĂȘte. - <ul> - <li>un objet {{WebExtAPIRef("proxy.ProxyInfo")}}</li> - <li>un tableau d'objets <code>proxy.ProxyInfo</code></li> - <li>Une <code>Promise</code> qui se rĂ©sout en un objet <code>ProxyInfo</code></li> - <li>Une <code>Promise</code> qui rĂ©sout en un tableau d'objets <code>ProxyInfo</code>.</li> - </ul> + L'Ă©couteur peut renvoyer l'un des Ă©lĂ©ments suivants: - <p>Si l'Ă©couteur renvoie un tableau, ou une Promesse qui se rĂ©sout en un tableau, alors tous les objets<code>ProxyInfo</code> aprĂšs le premier reprĂ©sentent les basculements: si le proxy Ă la position N dans le tableau n'est pas accessible quand son <code>ProxyInfo.failoverTimeout</code> alors le navigateur essayez le proxy Ă la position N+1.</p> + - un objet {{WebExtAPIRef("proxy.ProxyInfo")}} + - un tableau d'objets `proxy.ProxyInfo` + - Une `Promise` qui se rĂ©sout en un objet `ProxyInfo` + - Une `Promise` qui rĂ©sout en un tableau d'objets `ProxyInfo`. - <p>S'il y a une erreur spĂ©cifiant les objets <code>proxy.ProxyInfo</code> objects, alors {{WebExtAPIRef("proxy.onError")}} sera appelĂ©.</p> - </dd> - <dt><code>filter</code></dt> - <dd>{{WebExtAPIRef('webRequest.RequestFilter')}}. Un ensemble de filtres qui limite les Ă©vĂ©nements qui seront envoyĂ©s Ă cet Ă©couteur.</dd> - <dt><code>extraInfoSpec</code> {{optional_inline}}</dt> - <dd><code>array</code> de <code>string</code>. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous pouvez passer une seule valeur, <code>"requestHeaders"</code>, pour inclure les en-tĂȘtes de demande dans l'objet de <code>details</code> transmis Ă l'Ă©couteur.</dd> -</dl> + Si l'Ă©couteur renvoie un tableau, ou une Promesse qui se rĂ©sout en un tableau, alors tous les objets`ProxyInfo` aprĂšs le premier reprĂ©sentent les basculements: si le proxy Ă la position N dans le tableau n'est pas accessible quand son `ProxyInfo.failoverTimeout` alors le navigateur essayez le proxy Ă la position N+1. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + S'il y a une erreur spĂ©cifiant les objets `proxy.ProxyInfo` objects, alors {{WebExtAPIRef("proxy.onError")}} sera appelĂ©. -<p>{{Compat("webextensions.api.proxy.onRequest", 10)}}</p> +- `filter` + - : {{WebExtAPIRef('webRequest.RequestFilter')}}. Un ensemble de filtres qui limite les Ă©vĂ©nements qui seront envoyĂ©s Ă cet Ă©couteur. +- `extraInfoSpec` {{optional_inline}} + - : `array` de `string`. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous pouvez passer une seule valeur, `"requestHeaders"`, pour inclure les en-tĂȘtes de demande dans l'objet de `details` transmis Ă l'Ă©couteur. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Ce code intercepte les requĂȘtes Ă <code><all_urls></code>, et les envoie par procuration si elles ne sont pas destinĂ©es Ă un cadre de premier niveau.</p> +{{Compat("webextensions.api.proxy.onRequest", 10)}} -<pre class="brush: js">function shouldProxyRequest(requestInfo) { +## Exemples + +Ce code intercepte les requĂȘtes Ă `<all_urls>`, et les envoie par procuration si elles ne sont pas destinĂ©es Ă un cadre de premier niveau. + +```js +function shouldProxyRequest(requestInfo) { return requestInfo.parentFrameId != -1; } @@ -100,6 +94,7 @@ function handleProxyRequest(requestInfo) { return {type: "direct"}; } -browser.proxy.onRequest.addListener(handleProxyRequest, {urls: ["<all_urls>"]});</pre> +browser.proxy.onRequest.addListener(handleProxyRequest, {urls: ["<all_urls>"]}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/proxyinfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/proxyinfo/index.md index 2bc4fd359b..42a8cf4a5d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/proxyinfo/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/proxyinfo/index.md @@ -10,52 +10,50 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/ProxyInfo --- -<div>{{AddonSidebar()}}</div> - -<p>Contient des informations sur un proxy. Cet objet, ou un tableau de ces objets, est renvoyĂ© par le programme d'Ă©coute Ă {{WebExtAPIRef("proxy.onRequest")}}. Il indique au navigateur si la requĂȘte doit ĂȘtre mandatĂ©e et, dans l'affirmative, quel proxy utiliser.</p> - -<h2 id="Type">Type</h2> - -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> - -<dl> - <dt><code>type</code></dt> - <dd> - <p><code>string</code>. Cela indique s'il faut utiliser un proxy et, dans l'affirmative, quel type de proxy utiliser. Il peut prendre l'une des valeurs suivantes :</p> - - <ul> - <li><code>"direct"</code>: ne pas utiliser la requĂȘte par procuration. Si cette valeur est donnĂ©e, toutes les autres propriĂ©tĂ©s de cet objet sont ignorĂ©es.</li> - <li><code>"http"</code>: HTTP proxy (ou SSL CONNECT pour HTTPS)</li> - <li><code>"https"</code>: HTTP proxying via TLS connection au proxy</li> - <li><code>"socks"</code>: proxy SOCKS v5</li> - <li><code>"socks4"</code>: proxy SOCKS v4</li> - </ul> - </dd> - <dt><code>host</code></dt> - <dd><code>string</code>. Le nom d'hĂŽte du serveur proxy. Obligatoire sauf si le <code>type</code> est <code>"direct"</code>.</dd> - <dt><code>port</code></dt> - <dd><code>string</code>. e numĂ©ro de port du serveur proxy. Obligatoire sauf si le <code>type</code> est <code>"direct"</code>.</dd> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur pour le service proxy. Ceci est utilisable avec "socks".  Pour les autorisations de proxy HTTP, utilisez <a href="/fr/Add-ons/WebExtensions/API/webRequest/onAuthRequired"><code>webRequest.onAuthRequired</code></a>.</dd> - <dt><code>password</code></dt> - <dd><code>string</code>. Mot de passe pour le service proxy. Ceci est utilisable avec "socks". FPour les autorisations de proxy HTTP, utilisez <a href="/fr/Add-ons/WebExtensions/API/webRequest/onAuthRequired"><code>webRequest.onAuthRequired</code></a>.</dd> - <dt><code>proxyDNS</code></dt> - <dd><code>boolean</code>. Si vrai, le serveur proxy est utilisĂ© pour rĂ©soudre certaines requĂȘtes DNS (uniquement utilisable avec <code>"socks4"</code> et <code>"socks"</code>).  Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>failoverTimeout</code></dt> - <dd><code>number</code>:  DĂ©lais de basculement en secondes. Si la connexion ne parvient pas Ă connecter le serveur proxy aprĂšs ce nombre de secondes, le serveur proxy suivant dans le tableau renvoyĂ© par l'Ă©couteur <code>proxy.onRequest</code> sera utilisĂ©.</dd> -</dl> - -<dl> - <dt><code>proxyAuthorizationHeader</code></dt> - <dd><code>string.</code> Cette chaĂźne, si elle est dĂ©finie sur non-vide, est passĂ©e directement en valeur Ă l'en-tĂȘte de requĂȘte {{httpheader("Proxy-Authorization")}} envoyĂ© aux proxies HTTP dans le cadre des requĂȘtes HTTP ordinaires et des requĂȘtes CONNECT. Simplement dit, ceci peut ĂȘtre utilisĂ© pour s'authentifier directement sur les proxies HTTP nĂ©cessitant une authentification (non contestable).<br> - <br> - Par exemple, si vous voulez envoyer "nom d'utilisateur" et "mot de passe" pour l'authentification "basique", vous pouvez dĂ©finir la propriĂ©tĂ© <code>proxyAuthorizationHeader</code> Ă <code>Basic dXNlcm5hbWU6cGFzc3dvcmQ=</code></dd> - <dt><code>connectionIsolationKey </code> {{optional_inline}}</dt> - <dd><code>string.</code> Une clĂ© optionnelle utilisĂ©e pour l'isolation supplĂ©mentaire de cette connexion proxy.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.proxy.ProxyInfo")}}</p> - -<p>{{WebExtExamples}}</p> +{{AddonSidebar()}} + +Contient des informations sur un proxy. Cet objet, ou un tableau de ces objets, est renvoyĂ© par le programme d'Ă©coute Ă {{WebExtAPIRef("proxy.onRequest")}}. Il indique au navigateur si la requĂȘte doit ĂȘtre mandatĂ©e et, dans l'affirmative, quel proxy utiliser. + +## Type + +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : + +- `type` + + - : `string`. Cela indique s'il faut utiliser un proxy et, dans l'affirmative, quel type de proxy utiliser. Il peut prendre l'une des valeurs suivantes : + + - `"direct"`: ne pas utiliser la requĂȘte par procuration. Si cette valeur est donnĂ©e, toutes les autres propriĂ©tĂ©s de cet objet sont ignorĂ©es. + - `"http"`: HTTP proxy (ou SSL CONNECT pour HTTPS) + - `"https"`: HTTP proxying via TLS connection au proxy + - `"socks"`: proxy SOCKS v5 + - `"socks4"`: proxy SOCKS v4 + +- `host` + - : `string`. Le nom d'hĂŽte du serveur proxy. Obligatoire sauf si le `type` est `"direct"`. +- `port` + - : `string`. e numĂ©ro de port du serveur proxy. Obligatoire sauf si le `type` est `"direct"`. +- `username` + - : `string`. Nom d'utilisateur pour le service proxy. Ceci est utilisable avec "socks".  Pour les autorisations de proxy HTTP, utilisez [`webRequest.onAuthRequired`](/fr/Add-ons/WebExtensions/API/webRequest/onAuthRequired). +- `password` + - : `string`. Mot de passe pour le service proxy. Ceci est utilisable avec "socks". FPour les autorisations de proxy HTTP, utilisez [`webRequest.onAuthRequired`](/fr/Add-ons/WebExtensions/API/webRequest/onAuthRequired). +- `proxyDNS` + - : `boolean`. Si vrai, le serveur proxy est utilisĂ© pour rĂ©soudre certaines requĂȘtes DNS (uniquement utilisable avec `"socks4"` et `"socks"`).  Par dĂ©faut Ă `false`. +- `failoverTimeout` + - : `number`:  DĂ©lais de basculement en secondes. Si la connexion ne parvient pas Ă connecter le serveur proxy aprĂšs ce nombre de secondes, le serveur proxy suivant dans le tableau renvoyĂ© par l'Ă©couteur `proxy.onRequest` sera utilisĂ©. + +<!----> + +- `proxyAuthorizationHeader` + + - : `string.` Cette chaĂźne, si elle est dĂ©finie sur non-vide, est passĂ©e directement en valeur Ă l'en-tĂȘte de requĂȘte {{httpheader("Proxy-Authorization")}} envoyĂ© aux proxies HTTP dans le cadre des requĂȘtes HTTP ordinaires et des requĂȘtes CONNECT. Simplement dit, ceci peut ĂȘtre utilisĂ© pour s'authentifier directement sur les proxies HTTP nĂ©cessitant une authentification (non contestable). + + Par exemple, si vous voulez envoyer "nom d'utilisateur" et "mot de passe" pour l'authentification "basique", vous pouvez dĂ©finir la propriĂ©tĂ© `proxyAuthorizationHeader` Ă `Basic dXNlcm5hbWU6cGFzc3dvcmQ=` + +- `connectionIsolationKey `{{optional_inline}} + - : `string.` Une clĂ© optionnelle utilisĂ©e pour l'isolation supplĂ©mentaire de cette connexion proxy. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.proxy.ProxyInfo")}} + +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/register/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/register/index.md index 8fe80e8891..8db820818f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/register/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/register/index.md @@ -13,35 +13,34 @@ tags: - registerProxyScript translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/register --- -<p>{{AddonSidebar()}} {{deprecated_header}}</p> +{{AddonSidebar()}} {{deprecated_header}} -<p>Cette mĂ©thode Ă©tait obsolĂšte dans Firefox 68 et sera supprimĂ©e de Firefox 71. Dans Firefox 68 ou une version ultĂ©rieure, l'appel de cette mĂ©thode enregistre un message d'erreur sur la console :</p> +Cette mĂ©thode Ă©tait obsolĂšte dans Firefox 68 et sera supprimĂ©e de Firefox 71. Dans Firefox 68 ou une version ultĂ©rieure, l'appel de cette mĂ©thode enregistre un message d'erreur sur la console : -<p><img alt="" src="proxy_register_warning.png"></p> +![](proxy_register_warning.png) -<p>Enregistre un <a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file">fichier PAC (Proxy Auto-Configuration)</a>. Le fichier est exĂ©cutĂ© immĂ©diatement, et sa fonction <code>FindProxyForURL()</code> sera appelĂ©e pour toutes les demandes HTTP, HTTPS ou FTP.</p> +Enregistre un [fichier PAC (Proxy Auto-Configuration)](/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file). Le fichier est exĂ©cutĂ© immĂ©diatement, et sa fonction `FindProxyForURL()` sera appelĂ©e pour toutes les demandes HTTP, HTTPS ou FTP. -<p>Si les fichiers PAC sont enregistrĂ©s par plusieurs extensions, les demandes seront initialement transmises Ă celle qui a Ă©tĂ© enregistrĂ©e en premier.</p> +Si les fichiers PAC sont enregistrĂ©s par plusieurs extensions, les demandes seront initialement transmises Ă celle qui a Ă©tĂ© enregistrĂ©e en premier. -<ul> - <li>Si la fonction <code>FindProxyForURL()</code> dans le premier PAC renvoie "DIRECT" pour une demande, alors la demande sera transmise inchangĂ©e Ă la fonction <code>FindProxyForURL()</code> dans le prochain PAC.</li> - <li>Si la fonction <code>FindProxyForURL()</code> dans le premier PAC transfĂšre la requĂȘte en renvoyant "PROXY" ou une autre valeur proxy, l'URL du proxy sera transmise Ă la fonction <code>FindProxyForURL()</code> dans le prochain PAC.</li> -</ul> +- Si la fonction `FindProxyForURL()` dans le premier PAC renvoie "DIRECT" pour une demande, alors la demande sera transmise inchangĂ©e Ă la fonction `FindProxyForURL()` dans le prochain PAC. +- Si la fonction `FindProxyForURL()` dans le premier PAC transfĂšre la requĂȘte en renvoyant "PROXY" ou une autre valeur proxy, l'URL du proxy sera transmise Ă la fonction `FindProxyForURL()` dans le prochain PAC. -<p>Chaque extension ne peut enregistrer qu'un seul fichier PAC : si vous appelez <code>register()</code> deux fois, le second fichier PACremplacera le premier.</p> +Chaque extension ne peut enregistrer qu'un seul fichier PAC : si vous appelez `register()` deux fois, le second fichier PACremplacera le premier. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Communiquez_avec_les_fichiers_PAC">Communiquez avec les fichiers PAC</h2> +## Communiquez avec les fichiers PAC -<p>Vous pouvez Ă©changer des messages entre le fichier PAC et la page d'arriĂšre-plan de votre extension (ou toute autre page privilĂ©giĂ©e, comme les pages contextuelles) en utilisant <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage">runtime.sendMessage()</a></code> et <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage">runtime.onMessage</a></code>.</p> +Vous pouvez Ă©changer des messages entre le fichier PAC et la page d'arriĂšre-plan de votre extension (ou toute autre page privilĂ©giĂ©e, comme les pages contextuelles) en utilisant [`runtime.sendMessage()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage) et [`runtime.onMessage`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage). -<p>Pour envoyer un message au fichier PAC, vous devez dĂ©finir l'option <code>toProxyScript</code> :</p> +Pour envoyer un message au fichier PAC, vous devez dĂ©finir l'option `toProxyScript` : -<pre class="brush: js">// background.js +```js +// background.js // Log any messages from the proxy. -browser.runtime.onMessage.addListener((message, sender) => { +browser.runtime.onMessage.addListener((message, sender) => { if (sender.url === browser.extension.getURL(proxyScriptURL)) { console.log(message); } @@ -53,31 +52,35 @@ let messageToProxy = { bar: 1234 }; -browser.runtime.sendMessage(messageToProxy, {toProxyScript: true});</pre> +browser.runtime.sendMessage(messageToProxy, {toProxyScript: true}); +``` -<pre class="brush: js">// pac.js +```js +// pac.js -browser.runtime.onMessage.addListener((message) => { +browser.runtime.onMessage.addListener((message) => { if (message.enabled) { browser.runtime.sendMessage("I'm enabled!"); } -});</pre> +}); +``` -<h2 id="SpĂ©cification_de_fichier_PAC">SpĂ©cification de fichier PAC</h2> +## SpĂ©cification de fichier PAC -<p>La syntaxe de base du fichier PAC est dĂ©crite dans la <a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file">documentation PAC</a>, mais l'implĂ©mentation utilisĂ©e par l'API proxy diffĂšre de la conception PAC standard de diffĂ©rentes maniĂšres, dĂ©crites dans cette section.</p> +La syntaxe de base du fichier PAC est dĂ©crite dans la [documentation PAC](</fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file>), mais l'implĂ©mentation utilisĂ©e par l'API proxy diffĂšre de la conception PAC standard de diffĂ©rentes maniĂšres, dĂ©crites dans cette section. -<h3 id="Valeur_retournĂ©e_FindProxyForURL">Valeur retournĂ©e FindProxyForURL()</h3> +### Valeur retournĂ©e FindProxyForURL() -<p>La norme <code>FindProxyForURL()</code> <a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file#Return_value_format">renvoie une chaĂźne</a>. Dans Firefox 55 et 56, le fichier PAC utilisĂ© avec l'API proxy renvoie Ă©galement une chaĂźne. Dans Firefox 55 <em>seulement</em>, vous devez passer un argument Ă la valeur de retour "DIRECT", mĂȘme s'il n'a pas besoin d'argument.</p> +La norme `FindProxyForURL()` [renvoie une chaĂźne](/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file#Return_value_format). Dans Firefox 55 et 56, le fichier PAC utilisĂ© avec l'API proxy renvoie Ă©galement une chaĂźne. Dans Firefox 55 _seulement_, vous devez passer un argument Ă la valeur de retour "DIRECT", mĂȘme s'il n'a pas besoin d'argument. -<p>Ă partir de Firefox 57, <code>FindProxyForURL()</code> peut toujours renvoyer une chaĂźne, mais peut Ă©galement (et de prĂ©fĂ©rence) renvoyer un tableau d'objets {{WebExtAPIRef("proxy.ProxyInfo")}}.</p> +Ă partir de Firefox 57, `FindProxyForURL()` peut toujours renvoyer une chaĂźne, mais peut Ă©galement (et de prĂ©fĂ©rence) renvoyer un tableau d'objets {{WebExtAPIRef("proxy.ProxyInfo")}}. -<p>Si le tableau contient plus d'un objet, alors tous les objets <code>ProxyInfo</code> aprĂšs le premier reprĂ©sentent les basculements : si le proxy Ă la position N dans le tableau n'est pas accessible quand son <code>ProxyInfo.failoverTimeout</code> expire, alors le navigateur essaiera le proxy Ă la position N + 1.</p> +Si le tableau contient plus d'un objet, alors tous les objets `ProxyInfo` aprĂšs le premier reprĂ©sentent les basculements : si le proxy Ă la position N dans le tableau n'est pas accessible quand son `ProxyInfo.failoverTimeout` expire, alors le navigateur essaiera le proxy Ă la position N + 1. -<p>Par exemple :</p> +Par exemple : -<pre class="brush: js">const proxySpecification = [ +```js +const proxySpecification = [ { type: "socks", host: "foo.com", @@ -90,28 +93,30 @@ browser.runtime.onMessage.addListener((message) => { host: "bar.com", port: 1060, } -];</pre> +]; +``` -<p>Le premier proxy dans le tableau sera essayĂ© en premier. S'il ne rĂ©pond pas dans <code>failoverTimeout</code> secondes, le prochain sera essayĂ©, jusqu'Ă ce que la fin du tableau est atteint.</p> +Le premier proxy dans le tableau sera essayĂ© en premier. S'il ne rĂ©pond pas dans `failoverTimeout` secondes, le prochain sera essayĂ©, jusqu'Ă ce que la fin du tableau est atteint. -<h3 id="Environnement_du_fichier_PAC">Environnement du fichier PAC</h3> +### Environnement du fichier PAC -<p>Les fonctions globales d'assistance gĂ©nĂ©ralement disponibles pour les fichiers PAC (<code><a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file#isPlainHostName()_2">isPlainHostName()</a></code>, <code><a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file#dnsDomainIs()">dnsDomainIs()</a></code>, etc) ne sont pas disponibles.</p> +Les fonctions globales d'assistance gĂ©nĂ©ralement disponibles pour les fichiers PAC ([`isPlainHostName()`](</fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file#isPlainHostName()_2>), [`dnsDomainIs()`](</fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file#dnsDomainIs()>), etc) ne sont pas disponibles. -<p>Le code qui s'exĂ©cute dans le fichier PAC n'a pas accĂšs Ă :</p> +Le code qui s'exĂ©cute dans le fichier PAC n'a pas accĂšs Ă : -<ul> - <li>outes les fonctions DOM (par exemple, <a href="/fr/docs/Web/API/Window">window</a> ou l'une de ses propriĂ©tĂ©s)</li> - <li>les API WebExtension sauf <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage">runtime.sendMessage()</a></code> et <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage">runtime.onMessage</a></code></li> - <li>l' <a href="/fr/docs/Web/API/Console">API console</a> - pour consigner les messages d'un PAC, envoyez un message au script d'arriĂšre-plan :</li> -</ul> +- outes les fonctions DOM (par exemple, [window](/fr/docs/Web/API/Window) ou l'une de ses propriĂ©tĂ©s) +- les API WebExtension sauf [`runtime.sendMessage()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage) et [`runtime.onMessage`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage) +- l' [API console](/fr/docs/Web/API/Console) - pour consigner les messages d'un PAC, envoyez un message au script d'arriĂšre-plan : -<pre class="brush: js">// pac.js +```js +// pac.js // send the log message to the background script -browser.runtime.sendMessage(`Proxy-blocker: blocked ${url}`);</pre> +browser.runtime.sendMessage(`Proxy-blocker: blocked ${url}`); +``` -<pre class="brush: js">// background-script.js +```js +// background-script.js function handleMessage(message, sender) { // only handle messages from the proxy script @@ -121,39 +126,40 @@ function handleMessage(message, sender) { console.log(message); } -browser.runtime.onMessage.addListener(handleMessage);</pre> +browser.runtime.onMessage.addListener(handleMessage); +``` -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var registering = browser.proxy.register( +```js +var registering = browser.proxy.register( url // string ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> +``` -<dl> - <dt><code>url</code></dt> - <dd><code>String</code>. URL pointant vers le fichier PAC Ă charger. Les fichiers PAC doivent ĂȘtre groupĂ©s avec l'extension, et l'<code>url</code> doit ĂȘtre relative au fichier <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a> de l'extension.</dd> -</dl> +### ParamĂštres -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +- `url` + - : `String`. URL pointant vers le fichier PAC Ă charger. Les fichiers PAC doivent ĂȘtre groupĂ©s avec l'extension, et l'`url` doit ĂȘtre relative au fichier [manifest.json](/fr/Add-ons/WebExtensions/manifest.json) de l'extension. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans argument lorsque le fichier PAC a Ă©tĂ© enregistrĂ© ou rejetĂ©e en cas d'erreur.</p> +### Valeur retournĂ©e -<h2 id="Exemples">Exemples</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque le fichier PAC a Ă©tĂ© enregistrĂ© ou rejetĂ©e en cas d'erreur. -<pre class="brush: js">const proxyScriptURL = "proxy/proxy-script.js"; +## Exemples -browser.proxy.register(proxyScriptURL);</pre> +```js +const proxyScriptURL = "proxy/proxy-script.js"; -<p>{{WebExtExamples}}</p> +browser.proxy.register(proxyScriptURL); +``` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{WebExtExamples}} -<p>{{Compat("webextensions.api.proxy.register")}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.proxy.register")}} -<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 :** +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/requestdetails/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/requestdetails/index.md index 08561e5845..507194e870 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/requestdetails/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/requestdetails/index.md @@ -10,49 +10,47 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/RequestDetails --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Contient des informations sur une requĂȘte Web que le navigateur est sur le point de faire. Une instance de cet objet est passĂ©e dans l'Ă©couteur {{WebExtAPIRef("proxy.onRequest")}}.</p> +Contient des informations sur une requĂȘte Web que le navigateur est sur le point de faire. Une instance de cet objet est passĂ©e dans l'Ă©couteur {{WebExtAPIRef("proxy.onRequest")}}. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>cookieStoreId</code></dt> - <dd><code>string</code>. L'ID de magasin de cookies du contexte actuel.</dd> - <dt><code>documentUrl</code></dt> - <dd><code>string</code>. URL de la page dans laquelle la ressource demandĂ©e sera chargĂ©e.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. ZĂ©ro si la requĂȘte se produit dans le cadre principal; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'une (sous-)frame est chargĂ© (<code>type</code> est <code>main_frame</code> ou <code>sub_frame</code>), <code>frameId</code> indique l'ID de cette trame, pas l'ID de la trame externe. Les ID de cadre sont uniques dans un onglet.</dd> - <dt><code>fromCache</code></dt> - <dd><code>boolean</code>. Indique si cette rĂ©ponse sera rĂ©cupĂ©rĂ©e du cache disque.</dd> - <dt><code>incognito</code></dt> - <dd><code>boolean</code> <code>true</code> pour les demandes de navigation privĂ©es</dd> - <dt><code>ip</code></dt> - <dd>L'adresse IP du serveur Ă laquelle la demande sera envoyĂ©e. Notez qu'il peut s'agir d'une adresse IPv6 littĂ©rale.</dd> - <dt><code>method</code></dt> - <dd><code>string</code>. MĂ©thode HTTP standard: par exemple, "GET" ou "POST".</dd> - <dt><code>originUrl</code></dt> - <dd><code>string</code>. URL de la ressource qui a dĂ©clenchĂ© cette demande. Notez que ceci peut ne pas ĂȘtre le mĂȘme que l'URL de la page dans laquelle la ressource demandĂ©e sera chargĂ©e. Par exemple, si un document dĂ©clenche un chargement dans une fenĂȘtre diffĂ©rente l'<a href="/fr/docs/Web/HTML/Element/a#attr-target">attribut cible d'un lien</a>, ou d'un document CSS inclut une image utilisant la <a href="/fr/docs/Web/CSS/url#The_url()_functional_notation"><code>notation fonctionnelle url()</code></a>, alors ce sera l'URL du document original ou du document CSS, respectivement.</dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. ID de l'image qui contient l'image qui a envoyĂ© la demande. DĂ©fini sur -1 si aucun cadre parent n'existe.</dd> - <dt><code>requestId</code></dt> - <dd><code>string</code>. L'ID de la demande Les ID de demande sont uniques dans une session de navigateur, vous pouvez donc les utiliser pour associer diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme demande.</dd> - <dt><code>requestHeaders</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de requĂȘte HTTP qui vont ĂȘtre envoyĂ©s avec cette requĂȘte. Notez que ceci n'est inclus que si l'option <code>"requestHeaders"</code> a Ă©tĂ© passĂ©e dans <code>addListener()</code>.</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dans lequel la requĂȘte a lieu. DĂ©fini sur -1 si la requĂȘte n'est pas liĂ©e Ă un onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ© : par exemple, "image", "script", "stylesheet".</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. Cible de la demande.</dd> -</dl> +- `cookieStoreId` + - : `string`. L'ID de magasin de cookies du contexte actuel. +- `documentUrl` + - : `string`. URL de la page dans laquelle la ressource demandĂ©e sera chargĂ©e. +- `frameId` + - : `integer`. ZĂ©ro si la requĂȘte se produit dans le cadre principal; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'une (sous-)frame est chargĂ© (`type` est `main_frame` ou `sub_frame`), `frameId` indique l'ID de cette trame, pas l'ID de la trame externe. Les ID de cadre sont uniques dans un onglet. +- `fromCache` + - : `boolean`. Indique si cette rĂ©ponse sera rĂ©cupĂ©rĂ©e du cache disque. +- `incognito` + - : `boolean` `true` pour les demandes de navigation privĂ©es +- `ip` + - : L'adresse IP du serveur Ă laquelle la demande sera envoyĂ©e. Notez qu'il peut s'agir d'une adresse IPv6 littĂ©rale. +- `method` + - : `string`. MĂ©thode HTTP standard: par exemple, "GET" ou "POST". +- `originUrl` + - : `string`. URL de la ressource qui a dĂ©clenchĂ© cette demande. Notez que ceci peut ne pas ĂȘtre le mĂȘme que l'URL de la page dans laquelle la ressource demandĂ©e sera chargĂ©e. Par exemple, si un document dĂ©clenche un chargement dans une fenĂȘtre diffĂ©rente l'[attribut cible d'un lien](/fr/docs/Web/HTML/Element/a#attr-target), ou d'un document CSS inclut une image utilisant la [`notation fonctionnelle url()`](</fr/docs/Web/CSS/url#The_url()_functional_notation>), alors ce sera l'URL du document original ou du document CSS, respectivement. +- `parentFrameId` + - : `integer`. ID de l'image qui contient l'image qui a envoyĂ© la demande. DĂ©fini sur -1 si aucun cadre parent n'existe. +- `requestId` + - : `string`. L'ID de la demande Les ID de demande sont uniques dans une session de navigateur, vous pouvez donc les utiliser pour associer diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme demande. +- `requestHeaders`{{optional_inline}} + - : {{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de requĂȘte HTTP qui vont ĂȘtre envoyĂ©s avec cette requĂȘte. Notez que ceci n'est inclus que si l'option `"requestHeaders"` a Ă©tĂ© passĂ©e dans `addListener()`. +- `tabId` + - : `integer`. ID de l'onglet dans lequel la requĂȘte a lieu. DĂ©fini sur -1 si la requĂȘte n'est pas liĂ©e Ă un onglet. +- `timeStamp` + - : `number`. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `type` + - : {{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ© : par exemple, "image", "script", "stylesheet". +- `url` + - : `string`. Cible de la demande. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.proxy.RequestDetails")}}</p> +{{Compat("webextensions.api.proxy.RequestDetails")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/settings/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/settings/index.md index a2ca638f71..9f5c803494 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/settings/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/settings/index.md @@ -13,56 +13,54 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/settings original_slug: Mozilla/Add-ons/WebExtensions/API/browserSettings/proxyConfig --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour modifier les paramĂštres de proxy du navigateur.</p> +Un objet {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} qui peut ĂȘtre utilisĂ© pour modifier les paramĂštres de proxy du navigateur. -<div class="note"> -<p><strong>Note :</strong> La possibilitĂ© de modifier les paramĂštres de proxy nĂ©cessite un accĂšs Ă une fenĂȘtre privĂ©e car les paramĂštres de proxy affectent Ă la fois les fenĂȘtres privĂ©es et non privĂ©es. Par consĂ©quent, si une extension n'a pas reçu l'autorisation de fenĂȘtre privĂ©e, les appels Ă <code>proxy.settings.set()</code> lanceront une exception.</p> -</div> +> **Note :** La possibilitĂ© de modifier les paramĂštres de proxy nĂ©cessite un accĂšs Ă une fenĂȘtre privĂ©e car les paramĂštres de proxy affectent Ă la fois les fenĂȘtres privĂ©es et non privĂ©es. Par consĂ©quent, si une extension n'a pas reçu l'autorisation de fenĂȘtre privĂ©e, les appels Ă `proxy.settings.set()` lanceront une exception. -<p>La valeur sous-jacente est un objet avec les propriĂ©tĂ©s Ă©numĂ©rĂ©es ci-dessous.</p> +La valeur sous-jacente est un objet avec les propriĂ©tĂ©s Ă©numĂ©rĂ©es ci-dessous. -<p>Lors de la dĂ©finition de cet objet, toutes les propriĂ©tĂ©s sont facultatives. Notez que les propriĂ©tĂ©s omises seront rĂ©initialisĂ©es Ă leur valeur par dĂ©faut.</p> +Lors de la dĂ©finition de cet objet, toutes les propriĂ©tĂ©s sont facultatives. Notez que les propriĂ©tĂ©s omises seront rĂ©initialisĂ©es Ă leur valeur par dĂ©faut. -<dl> - <dt><code>autoConfigUrl</code>{{optional_inline}}</dt> - <dd><code>string</code>. Une URL Ă utiliser pour configurer le proxy.</dd> - <dt><code>autoLogin</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Ne pas demander l'authentification si le mot de passe est enregistrĂ©. Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>ftp</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse du proxy FTP. Peut inclure un port.</dd> - <dt><code>http</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse du proxy HTTP. Peut inclure un port.</dd> - <dt><code>httpProxyAll</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Utilisez le serveur proxy HTTP pour tous les protocoles. Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>passthrough</code>{{optional_inline}}</dt> - <dd><code>string</code>. Une liste d'hĂŽtes sĂ©parĂ©s par des virgules qui ne doivent pas ĂȘtre mandatĂ©s. La valeur par dĂ©faut est "localhost, 127.0.0.1".</dd> - <dt><code>proxyDNS</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. DNS proxy lors de l'utilisation de SOCKS5. Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>proxyType</code>{{optional_inline}}</dt> - <dd><code>string</code>. Le type de proxy Ă utiliser. Cela peut prendre l'une des valeurs suivantes : "none", "autoDetect", "system", "manual", "autoConfig". Par dĂ©faut Ă "system".</dd> - <dt><code>socks</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse du proxy SOCKS. Peut inclure un port.</dd> - <dt><code>socksVersion</code>{{optional_inline}}</dt> - <dd><code>integer</code>. La version du proxy SOCKS. Peut ĂȘtre 4 ou 5. Par dĂ©faut Ă 5.</dd> - <dt><code>ssl</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse du proxy SSL. Peut inclure un port.</dd> -</dl> +- `autoConfigUrl`{{optional_inline}} + - : `string`. Une URL Ă utiliser pour configurer le proxy. +- `autoLogin`{{optional_inline}} + - : `boolean`. Ne pas demander l'authentification si le mot de passe est enregistrĂ©. Par dĂ©faut Ă `false`. +- `ftp`{{optional_inline}} + - : `string`. L'adresse du proxy FTP. Peut inclure un port. +- `http`{{optional_inline}} + - : `string`. L'adresse du proxy HTTP. Peut inclure un port. +- `httpProxyAll`{{optional_inline}} + - : `boolean`. Utilisez le serveur proxy HTTP pour tous les protocoles. Par dĂ©faut Ă `false`. +- `passthrough`{{optional_inline}} + - : `string`. Une liste d'hĂŽtes sĂ©parĂ©s par des virgules qui ne doivent pas ĂȘtre mandatĂ©s. La valeur par dĂ©faut est "localhost, 127.0.0.1". +- `proxyDNS`{{optional_inline}} + - : `boolean`. DNS proxy lors de l'utilisation de SOCKS5. Par dĂ©faut Ă `false`. +- `proxyType`{{optional_inline}} + - : `string`. Le type de proxy Ă utiliser. Cela peut prendre l'une des valeurs suivantes : "none", "autoDetect", "system", "manual", "autoConfig". Par dĂ©faut Ă "system". +- `socks`{{optional_inline}} + - : `string`. L'adresse du proxy SOCKS. Peut inclure un port. +- `socksVersion`{{optional_inline}} + - : `integer`. La version du proxy SOCKS. Peut ĂȘtre 4 ou 5. Par dĂ©faut Ă 5. +- `ssl`{{optional_inline}} + - : `string`. L'adresse du proxy SSL. Peut inclure un port. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">let proxySettings = { +```js +let proxySettings = { proxyType: "manual", http: "http://proxy.org:8080", socksVersion: 4, passthrough: ".example.org" }; -browser.proxy.settings.set({value: proxySettings});</pre> +browser.proxy.settings.set({value: proxySettings}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.proxy.settings", 10)}}</p> +{{Compat("webextensions.api.proxy.settings", 10)}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/proxy/unregister/index.md b/files/fr/mozilla/add-ons/webextensions/api/proxy/unregister/index.md index 7331de1f79..8aab0c3b6f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/proxy/unregister/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/proxy/unregister/index.md @@ -12,42 +12,42 @@ tags: - unregister translation_of: Mozilla/Add-ons/WebExtensions/API/proxy/unregister --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}{{deprecated_header}} -<div>{{deprecated_header}}</div> +Cette mĂ©thode Ă©tait obsolĂšte dans Firefox 68 et sera supprimĂ©e de Firefox 71. Dans Firefox 68 ou une version ultĂ©rieure, l'appel de cette mĂ©thode enregistre un message d'erreur sur la console: -<p>Cette mĂ©thode Ă©tait obsolĂšte dans Firefox 68 et sera supprimĂ©e de Firefox 71. Dans Firefox 68 ou une version ultĂ©rieure, l'appel de cette mĂ©thode enregistre un message d'erreur sur la console:</p> +![](proxy_unregister_warning.png) -<p><img alt="" src="proxy_unregister_warning.png"></p> +Annule l'inscription d'un [fichier Proxy Auto-Configuration (PAC)](/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file). Cela a Ă©tĂ© enregistrĂ© par un appel prĂ©cĂ©dent Ă {{WebExtAPIRef("proxy.register()")}}. -<p>Annule l'inscription d'un <a href="/fr/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_%28PAC%29_file">fichier Proxy Auto-Configuration (PAC)</a>. Cela a Ă©tĂ© enregistrĂ© par un appel prĂ©cĂ©dent Ă {{WebExtAPIRef("proxy.register()")}}.</p> +C'est une fonction asynchrome qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<p>C'est une fonction asynchrome qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +## Syntaxe -<h2 id="Syntaxe">Syntaxe</h2> +```js +var unregistering = browser.proxy.unregister() +``` -<pre class="brush: js">var unregistering = browser.proxy.unregister() -</pre> +### ParamĂštres -<h3 id="ParamĂštres">ParamĂštres</h3> +None. -<p>None.</p> +### Valeur retournĂ©e -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments lorsque le fichier PAC a Ă©tĂ© dĂ©sinscrit. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans arguments lorsque le fichier PAC a Ă©tĂ© dĂ©sinscrit.</p> +## Exemples -<h2 id="Exemples">Exemples</h2> +```js +browser.proxy.unregister(); +``` -<pre class="brush: js">browser.proxy.unregister();</pre> +{{WebExtExamples}} -<p>{{WebExtExamples}}</p> +## CompatibilitĂ© du navigateur -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{Compat("webextensions.api.proxy.unregister")}} -<p>{{Compat("webextensions.api.proxy.unregister")}}</p> - -<div class="note"><p><strong>Note :</strong></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> +> **Note :** +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/runtime/connect/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/connect/index.md index 0049b13556..a7b8ae1879 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/connect/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/connect/index.md @@ -13,64 +13,57 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/connect --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div></div> +CrĂ©er une connexion pour plusieurs cas d'utilisation pout votre extension. -<p>CrĂ©er une connexion pour plusieurs cas d'utilisation pout votre extension.</p> +Vous pouvez utiliser cette facilitĂ© dans les situations suivantes: -<p>Vous pouvez utiliser cette facilitĂ© dans les situations suivantes:</p> +- Dans un script de contenu, pour Ă©tablir une connexion avec le script d'arriĂšre plan (ou tout script priviligiĂ©, comme les scripts de popup ou scripts de page d'option) +- Dans un script d'arriĂšre plan (ou script priviligiĂ© Ă©quivalent), pour Ă©tablir une connexion avec une extension diffĂ©rente. -<ul> - <li>Dans un script de contenu, pour Ă©tablir une connexion avec le script d'arriĂšre plan (ou tout script priviligiĂ©, comme les scripts de popup ou scripts de page d'option)</li> - <li>Dans un script d'arriĂšre plan (ou script priviligiĂ© Ă©quivalent), pour Ă©tablir une connexion avec une extension diffĂ©rente.</li> -</ul> +Attention, vous ne pouvez pas utiliser cette fonctionnalitĂ© pour connecter une extension Ă son script de contenu. Pour rĂ©aliser cette opĂ©ration, il vaut mieux utiliser {{WebExtAPIRef('tabs.connect()')}}. -<p>Attention, vous ne pouvez pas utiliser cette fonctionnalitĂ© pour connecter une extension Ă son script de contenu. Pour rĂ©aliser cette opĂ©ration, il vaut mieux utiliser {{WebExtAPIRef('tabs.connect()')}}.</p> +## Syntaxe -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">var port = browser.runtime.connect( +```js +var port = browser.runtime.connect( extensionId, // optional string connectInfo // optional object ) -</pre> +``` + +### ParamĂštres + +- `extensionId`{{optional_inline}} + - : `string`. L'ID de l'extension Ă laquelle se connecter. Si la cible Ă dĂ©fini un ID dans la clĂ© [applications](/fr/Add-ons/WebExtensions/manifest.json/applications) du fichier manifest.json, alors `extensionId` doit avoir cette valeur. Autrement, il doit avoir l'ID qui a Ă©tĂ© gĂ©nĂ©rĂ© pour la cible. +- `connectInfo`{{optional_inline}} -<h3 id="ParamĂštres">ParamĂštres</h3> + - : `object`. DĂ©tails de la connexion: -<dl> - <dt><code>extensionId</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'ID de l'extension Ă laquelle se connecter. Si la cible Ă dĂ©fini un ID dans la clĂ© <a href="/fr/Add-ons/WebExtensions/manifest.json/applications">applications</a> du fichier manifest.json, alors <code>extensionId</code> doit avoir cette valeur. Autrement, il doit avoir l'ID qui a Ă©tĂ© gĂ©nĂ©rĂ© pour la cible.</dd> - <dt><code>connectInfo</code>{{optional_inline}}</dt> - <dd><p><code>object</code>. DĂ©tails de la connexion:</p> - <dl> - <dt><code>name</code>{{optional_inline}}</dt> - <dd><code>string</code>. Sera passĂ© dans {{WebExtAPIRef("runtime.onConnect")}} pour les processus qui Ă©coutent un Ă©vĂšnement de type connexion.</dd> - <dt><code>includeTlsChannelId</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. indique si l'ID du canal TLS sera transmis Ă Â {{WebExtAPIRef("runtime.onConnectExternal")}} pour le processus qui Ă©coutent l'Ă©vĂ©nement de connexion.</dd> - </dl> - </dd> -</dl> + - `name`{{optional_inline}} + - : `string`. Sera passĂ© dans {{WebExtAPIRef("runtime.onConnect")}} pour les processus qui Ă©coutent un Ă©vĂšnement de type connexion. + - `includeTlsChannelId`{{optional_inline}} + - : `boolean`. indique si l'ID du canal TLS sera transmis Ă Â {{WebExtAPIRef("runtime.onConnectExternal")}} pour le processus qui Ă©coutent l'Ă©vĂ©nement de connexion. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p>{{WebExtAPIRef('runtime.Port')}}. Port Ă travers lequel les messages peuvent ĂȘtre envoyĂ©s et reçus. L'Ă©vĂ©nement <code>onDisconnect</code> du port est dĂ©clenchĂ© si l'extension n'existe pas.</p> +{{WebExtAPIRef('runtime.Port')}}. Port Ă travers lequel les messages peuvent ĂȘtre envoyĂ©s et reçus. L'Ă©vĂ©nement `onDisconnect` du port est dĂ©clenchĂ© si l'extension n'existe pas. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.connect")}}</p> +{{Compat("webextensions.api.runtime.connect")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Le script de contenu :</p> +Le script de contenu : -<ul> - <li>se connecte au script d'arriĂšre-plan et stocke le port dans une variable appelĂ©e <code>myPort</code>.</li> - <li>Ecoute les messages sur <code>myPort</code> et les enregistre</li> - <li>Envoie des messages au script d'arriĂšre pla, en utilisant <code>myPort</code>, lorsque l'utilisateur clique sur le document.</li> -</ul> +- se connecte au script d'arriĂšre-plan et stocke le port dans une variable appelĂ©e `myPort`. +- Ecoute les messages sur `myPort` et les enregistre +- Envoie des messages au script d'arriĂšre pla, en utilisant `myPort`, lorsque l'utilisateur clique sur le document. -<pre class="brush: js">// content-script.js +```js +// content-script.js var myPort = browser.runtime.connect({name:"port-from-cs"}); myPort.postMessage({greeting: "hello from content script"}); @@ -82,23 +75,22 @@ myPort.onMessage.addListener(function(m) { document.body.addEventListener("click", function() { myPort.postMessage({greeting: "they clicked the page!"}); -});</pre> +}); +``` + +Les scripts d'arriĂšre plan correspondant : -<p>Les scripts d'arriĂšre plan correspondant :</p> +- Ecoute les tentatives de connexion du script de contenu. +- Quand il reçoit une tentative de connexion : -<ul> - <li>Ecoute les tentatives de connexion du script de contenu.</li> - <li>Quand il reçoit une tentative de connexion : - <ul> - <li>Stocke le port dans une variable nommĂ© <code>portFromCS</code>.</li> - <li>envoie un message au script de contenu en utiliant le port.</li> - <li>Commence Ă Ă©couter les messages reçus sur le port, et les enregistre.</li> - </ul> - </li> - <li>Envoie des messages au script de contenu, Ă l'aide de <code>portFromCS</code>, lorsque l'utilisateur clique sur l'action du navigateur de l'extension.</li> -</ul> + - Stocke le port dans une variable nommĂ© `portFromCS`. + - envoie un message au script de contenu en utiliant le port. + - Commence Ă Ă©couter les messages reçus sur le port, et les enregistre. -<pre class="brush: js">// background-script.js +- Envoie des messages au script de contenu, Ă l'aide de `portFromCS`, lorsque l'utilisateur clique sur l'action du navigateur de l'extension. + +```js +// background-script.js var portFromCS; @@ -115,19 +107,18 @@ browser.runtime.onConnect.addListener(connected); browser.browserAction.onClicked.addListener(function() { portFromCS.postMessage({greeting: "they clicked the button!"}); -});</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/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -154,5 +145,4 @@ browser.browserAction.onClicked.addListener(function() { // 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/runtime/connectnative/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/connectnative/index.md index e4a04221e2..a538d7c7cd 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/connectnative/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/connectnative/index.md @@ -13,53 +13,37 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/connectNative --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Connecte l'extension Ă une appplication native sur l'ordinateur de l'utilisateur.Cela prend le nom d'une application native en tant que paramĂštre. Il dĂ©marre l'application native et retourne un objet {{WebExtAPIRef("runtime.Port")}} Ă l'appelant.L'appelant peut utiliser le `Port` pour Ă©changer des messages avec l'application native utilisant `Port.postMessage()` et `port.onMessage`.L'application native s'exĂ©cute jusqu'Ă ce qu'elle se termine, ou l'appelant appelle `Port.disconnect()`, ou la page qui a crĂ©Ă© le `Port` est dĂ©truite. Une fois le `Port` est dĂ©connectĂ©, le navigateur mettra quelques secondes Ă se terminer pour quitter le processus, puis le dĂ©sactiver s'il ne s'est pas arrĂȘtĂ©. -<div>Connecte l'extension Ă une appplication native sur l'ordinateur de l'utilisateur.</div> +Pour plus d'informations, voir [messagerie native](/fr/Add-ons/WebExtensions/Native_messaging). -<div></div> +## Syntaxe -<div>Cela prend le nom d'une application native en tant que paramĂštre. Il dĂ©marre l'application native et retourne un objet {{WebExtAPIRef("runtime.Port")}} Ă l'appelant.</div> - -<div></div> - -<div>L'appelant peut utiliser le <code>Port</code> pour Ă©changer des messages avec l'application native utilisant <code>Port.postMessage()</code> et <code>port.onMessage</code>.</div> - -<div></div> - -<div>L'application native s'exĂ©cute jusqu'Ă ce qu'elle se termine, ou l'appelant appelle <code>Port.disconnect()</code>, ou la page qui a crĂ©Ă© le <code>Port</code> est dĂ©truite. Une fois le <code>Port</code> est dĂ©connectĂ©, le navigateur mettra quelques secondes Ă se terminer pour quitter le processus, puis le dĂ©sactiver s'il ne s'est pas arrĂȘtĂ©.</div> - -<div></div> - -<p>Pour plus d'informations, voir <a href="/fr/Add-ons/WebExtensions/Native_messaging">messagerie native</a>.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">var port = browser.runtime.connectNative( +```js +var port = browser.runtime.connectNative( application // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>application</code></dt> - <dd><code>string</code>. Le nom de l'application native Ă laquelle se connecter. Cela doit correspondre Ă la propriĂ©tĂ© "name" dans le <a href="/fr/Add-ons/WebExtensions/Native_messaging#App_manifest">fichier manifest de l'application native</a>.</dd> -</dl> +- `application` + - : `string`. Le nom de l'application native Ă laquelle se connecter. Cela doit correspondre Ă la propriĂ©tĂ© "name" dans le [fichier manifest de l'application native](/fr/Add-ons/WebExtensions/Native_messaging#App_manifest). -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p>Un objet {{WebExtAPIRef('runtime.Port')}}. Le port que l'appelant peut utiliser pour Ă©changer des messages avec l'application native.</p> +Un objet {{WebExtAPIRef('runtime.Port')}}. Le port que l'appelant peut utiliser pour Ă©changer des messages avec l'application native. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.connectNative")}}</p> +{{Compat("webextensions.api.runtime.connectNative")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple se connecte Ă l'appplication native "ping_pong" et commence Ă en Ă©couter les messages. Il envoie Ă©galement un message Ă l'application native lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur :</p> +Cet exemple se connecte Ă l'appplication native "ping_pong" et commence Ă en Ă©couter les messages. Il envoie Ă©galement un message Ă l'application native lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur : -<pre class="brush: js">/* +```js +/* On startup, connect to the "ping_pong" app. */ var port = browser.runtime.connectNative("ping_pong"); @@ -67,29 +51,28 @@ var port = browser.runtime.connectNative("ping_pong"); /* Listen for messages from the app. */ -port.onMessage.addListener((response) => { +port.onMessage.addListener((response) => { console.log("Received: " + response); }); /* On a click on the browser action, send the app a message. */ -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { console.log("Sending: ping"); port.postMessage("ping"); -});</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/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -116,5 +99,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/runtime/getbackgroundpage/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/getbackgroundpage/index.md index 1c3fb7e932..2ecb790918 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/getbackgroundpage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/getbackgroundpage/index.md @@ -13,50 +13,54 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getBackgroundPage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>RĂ©cupĂšre l'objet <code><a href="/fr/docs/Web/API/Window">Window</a></code> pour la page d'arriĂšre-plan qui s'exĂ©cute dans l'extension en cours.</p> +RĂ©cupĂšre l'objet [`Window`](/fr/docs/Web/API/Window) pour la page d'arriĂšre-plan qui s'exĂ©cute dans l'extension en cours. -<p>Cela consiste un moyen pratique pour d'autres scripts d'extension privilĂ©giĂ©s d'accĂ©der directement Ă la portĂ©e du script d'arriĂšre plan. Cela leur permet d'accĂ©der aux variables ou aux fonctions d'appel dĂ©finies dans cette portĂ©e. Le "script privilĂ©giĂ©" inclut ici les scripts s'exĂ©cutant dans les <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Options_pages">pages d'options</a>, ou les scripts s'exĂ©cutant dans les fenĂȘtres d'<a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2">action du navigateur</a> ou d'<a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Page_actions">action page</a>, mais n'inclut pas les <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Content_scripts">scripts de contenu</a>.</p> +Cela consiste un moyen pratique pour d'autres scripts d'extension privilĂ©giĂ©s d'accĂ©der directement Ă la portĂ©e du script d'arriĂšre plan. Cela leur permet d'accĂ©der aux variables ou aux fonctions d'appel dĂ©finies dans cette portĂ©e. Le "script privilĂ©giĂ©" inclut ici les scripts s'exĂ©cutant dans les [pages d'options](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Options_pages), ou les scripts s'exĂ©cutant dans les fenĂȘtres d'[action du navigateur](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2) ou d'[action page](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Page_actions), mais n'inclut pas les [scripts de contenu](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Content_scripts). -<p>Notez que les variables dĂ©clarĂ©es Ă l'aide de <code><a href="/fr/docs/Web/JavaScript/Reference/Instructions/const">const</a></code> ou <code><a href="/fr/docs/Web/JavaScript/Reference/Instructions/let">let</a></code> n'apparaissaient pas dans l'objet window retournĂ© par cette fonction.</p> +Notez que les variables dĂ©clarĂ©es Ă l'aide de [`const`](/fr/docs/Web/JavaScript/Reference/Instructions/const) ou [`let`](/fr/docs/Web/JavaScript/Reference/Instructions/let) n'apparaissaient pas dans l'objet window retournĂ© par cette fonction. -<p><strong>Notez Ă©galement que cette mĂ©thode ne peut pas ĂȘtre utilisĂ©e dans une fenĂȘtre privĂ©e dans Firefox</strong>âElle renvoie toujours <code>null</code>. Pour plus d'informations voir le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1329304">bug liĂ© Ă bugzilla</a>.</p> +**Notez Ă©galement que cette mĂ©thode ne peut pas ĂȘtre utilisĂ©e dans une fenĂȘtre privĂ©e dans Firefox**âElle renvoie toujours `null`. Pour plus d'informations voir le [bug liĂ© Ă bugzilla](https://bugzilla.mozilla.org/show_bug.cgi?id=1329304). -<p>Si la page d'arriĂšre plan est une page Ă©vĂ©nement, le systĂšme s'assuera qu'il est chargĂ© avant de rĂ©soudre la promise.</p> +Si la page d'arriĂšre plan est une page Ă©vĂ©nement, le systĂšme s'assuera qu'il est chargĂ© avant de rĂ©soudre la promise. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingPage = browser.runtime.getBackgroundPage() -</pre> +```js +var gettingPage = browser.runtime.getBackgroundPage() +``` -<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 remplie avec l'objet <a href="/fr/docs/User%3Amaybe/webidl_mdn/Window">Window</a> pour la page d'arriĂšre plan, s'il y en a une. Si l'extension n'inclut pas de page d'arriĂšre-plan, la promise est rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec l'objet [Window](/fr/docs/User%3Amaybe/webidl_mdn/Window) pour la page d'arriĂšre plan, s'il y en a une. Si l'extension n'inclut pas de page d'arriĂšre-plan, la promise est rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.getBackgroundPage")}}</p> +{{Compat("webextensions.api.runtime.getBackgroundPage")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supposons un <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts">script d'arriĂšre-plan</a> dĂ©finisse une fonction <code>foo()</code>:</p> +Supposons un [script d'arriĂšre-plan](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts) dĂ©finisse une fonction `foo()`: -<pre class="brush: js">// background.js +```js +// background.js function foo() { console.log("I'm defined in background.js"); -}</pre> +} +``` -<p>Un script exĂ©cutĂ© dans un <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2">popup</a> peut appeler cette fonction directement comme ceci :</p> +Un script exĂ©cutĂ© dans un [popup](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2) peut appeler cette fonction directement comme ceci : -<pre class="brush: js">// popup.js +```js +// popup.js function onGot(page) { page.foo(); @@ -67,44 +71,42 @@ function onError(error) { } var getting = browser.runtime.getBackgroundPage(); -getting.then(onGot, onError);</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/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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> +getting.then(onGot, onError); +``` + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. +> +> <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/runtime/getbrowserinfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/getbrowserinfo/index.md index 72b7ebc953..2bf3b7be90 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/getbrowserinfo/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/getbrowserinfo/index.md @@ -12,52 +12,50 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getBrowserInfo --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Renvoie les informations sur le navigateur dans lequel l'extension est installĂ©e.</p> +Renvoie les informations sur le navigateur dans lequel l'extension est installĂ©e. -<p>Il s'agit d'une fonction asynchrone qui renvoie une {{JSxRef("Promise")}}.</p> +Il s'agit d'une fonction asynchrone qui renvoie une {{JSxRef("Promise")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var gettingInfo = browser.runtime.getBrowserInfo() -</pre> +```js +var gettingInfo = browser.runtime.getBrowserInfo() +``` -<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 remplie avec un objet qui a les propriĂ©tĂ©s suivantes :</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet qui a les propriĂ©tĂ©s suivantes : -<ul> - <li><strong><code>name</code></strong>: Valeur de chaĂźne reprĂ©sentant le nom du navigateur, par exemple "Firefox".</li> - <li><strong><code>vendor</code></strong>: Valeur de chaĂźne reprĂ©sentant le fournisseur du navigateur, par exemple "Mozilla".</li> - <li><strong><code>version</code></strong>: ChaĂźne reprĂ©sentant la version du navigateur, par exemple "51.0" or "51.0a2".</li> - <li><strong><code>buildID</code></strong>: Chaine reprĂ©sentant la version spĂ©cifique du navigateur, par exemple "20161018004015".</li> -</ul> +- **`name`**: Valeur de chaĂźne reprĂ©sentant le nom du navigateur, par exemple "Firefox". +- **`vendor`**: Valeur de chaĂźne reprĂ©sentant le fournisseur du navigateur, par exemple "Mozilla". +- **`version`**: ChaĂźne reprĂ©sentant la version du navigateur, par exemple "51.0" or "51.0a2". +- **`buildID`**: Chaine reprĂ©sentant la version spĂ©cifique du navigateur, par exemple "20161018004015". -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.runtime.getBrowserInfo")}} +## Exemples -<p>{{Compat("webextensions.api.runtime.getBrowserInfo")}}</p> +Obtenir et enregistrer le nom du navigateur : -<h2 id="Exemples">Exemples</h2> - -<p>Obtenir et enregistrer le nom du navigateur :</p> - -<pre class="brush: js">function gotBrowserInfo(info) { +```js +function gotBrowserInfo(info) { console.log(info.name); } var gettingInfo = browser.runtime.getBrowserInfo(); -gettingInfo.then(gotBrowserInfo);</pre> - -<p>{{WebExtExamples}}</p> +gettingInfo.then(gotBrowserInfo); +``` -<div class="note"><p><strong>Note :</strong></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 :** +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.md index 6182f11708..b550eb4664 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/getmanifest/index.md @@ -13,47 +13,44 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getManifest --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Obtenez le fichier [manifest.json](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json) complet, sĂ©rialisĂ© Ă un objet JSON. -<div>Obtenez le fichier <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json">manifest.json</a> complet, sĂ©rialisĂ© Ă un objet JSON.</div> +## Syntaxe -<div></div> +```js +browser.runtime.getManifest() +``` -<h2 id="Syntaxe">Syntaxe</h2> +### ParamĂštres -<pre class="brush: js">browser.runtime.getManifest() -</pre> +None. -<h3 id="ParamĂštres">ParamĂštres</h3> +### Valeur retournĂ©e -<p>None.</p> +Un `object` JSON reprĂ©sentant le manifest. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +## CompatibilitĂ© du navigateur -<p>Un <code>object</code> JSON reprĂ©sentant le manifest.</p> +{{Compat("webextensions.api.runtime.getManifest")}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## Exemples -<p>{{Compat("webextensions.api.runtime.getManifest")}}</p> +RĂ©cupĂšre le manifest et consignez la propriĂ©tĂ© "name" : -<h2 id="Exemples">Exemples</h2> +```js +var manifest = browser.runtime.getManifest(); +console.log(manifest.name); +``` -<p>RĂ©cupĂšre le manifest et consignez la propriĂ©tĂ© "name" :</p> +{{WebExtExamples}} -<pre class="brush: js">var manifest = browser.runtime.getManifest(); -console.log(manifest.name);</pre> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -80,5 +77,4 @@ console.log(manifest.name);</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/runtime/getpackagedirectoryentry/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/getpackagedirectoryentry/index.md index 6468c165c2..ac507d7715 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/getpackagedirectoryentry/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/getpackagedirectoryentry/index.md @@ -13,49 +13,50 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getPackageDirectoryEntry --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Renvoie un objet <code>DirectoryEntry</code> reprĂ©sentant le rĂ©pertoire du package.</p> +Renvoie un objet `DirectoryEntry` reprĂ©sentant le rĂ©pertoire du package. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingEntry = browser.runtime.getPackageDirectoryEntry() -</pre> +```js +var gettingEntry = browser.runtime.getPackageDirectoryEntry() +``` -<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 remplie avec un objet <code>DirectoryEntry</code> reprĂ©sentant le rĂ©pertoire du package.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet `DirectoryEntry` reprĂ©sentant le rĂ©pertoire du package. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.getPackageDirectoryEntry")}}</p> +{{Compat("webextensions.api.runtime.getPackageDirectoryEntry")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function gotDirectoryEntry(directoryEntry) { +```js +function gotDirectoryEntry(directoryEntry) { console.log(directoryEntry); } var gettingEntry = browser.runtime.getPackageDirectoryEntry(); -gettingEntry.then(gotDirectoryEntry);</pre> +gettingEntry.then(gotDirectoryEntry); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -82,5 +83,4 @@ gettingEntry.then(gotDirectoryEntry);</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/runtime/getplatforminfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/getplatforminfo/index.md index 1af9d51e7e..f07321263f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/getplatforminfo/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/getplatforminfo/index.md @@ -13,51 +13,52 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getPlatformInfo --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Renvoies des informations sur la plate-forme actuelle. Ceci ne peut ĂȘtre appelĂ© que dans le contexte du script d'arriĂšre-plan.</p> +Renvoies des informations sur la plate-forme actuelle. Ceci ne peut ĂȘtre appelĂ© que dans le contexte du script d'arriĂšre-plan. -<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 getting = browser.runtime.getPlatformInfo() -</pre> +```js +var getting = browser.runtime.getPlatformInfo() +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<p>None.</p> +None. -<h3 id="Valeur_rentournĂ©e">Valeur rentournĂ©e</h3> +### Valeur rentournĂ©e -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec une valeur {{WebExtAPIRef('runtime.PlatformInfo')}} reprĂ©sentant la plate-forme actuelle.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec une valeur {{WebExtAPIRef('runtime.PlatformInfo')}} reprĂ©sentant la plate-forme actuelle. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.getPlatformInfo")}}</p> +{{Compat("webextensions.api.runtime.getPlatformInfo")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Obtenez et consignez le systĂšme d'exploitation de la plateforme :</p> +Obtenez et consignez le systĂšme d'exploitation de la plateforme : -<pre class="brush: js">function gotPlatformInfo(info) { +```js +function gotPlatformInfo(info) { console.log(info.os); } var gettingInfo = browser.runtime.getPlatformInfo(); -gettingInfo.then(gotPlatformInfo);</pre> +gettingInfo.then(gotPlatformInfo); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ gettingInfo.then(gotPlatformInfo);</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/runtime/geturl/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/geturl/index.md index 3b29aadb83..de18ab4799 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/geturl/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/geturl/index.md @@ -13,58 +13,49 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/getURL --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Etant donnĂ© un chemin relatif de [manifest.json](/fr/Add-ons/WebExtensions/manifest.json) Ă une ressource empaquetĂ©e avec l'extension, renvoyez une URL complĂšte.Cette fonction ne vĂ©rifie pas que la ressource existe rĂ©ellement Ă cette URL. -<div>Etant donnĂ© un chemin relatif de <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a> Ă une ressource empaquetĂ©e avec l'extension, renvoyez une URL complĂšte.</div> +## Syntaxe -<div></div> - -<div>Cette fonction ne vĂ©rifie pas que la ressource existe rĂ©ellement Ă cette URL.</div> - -<div></div> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">browser.runtime.getURL( +```js +browser.runtime.getURL( path // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>path</code></dt> - <dd><code>string</code>. Un chemin relatif de <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a> Ă une ressource empaquetĂ©e avec l'extension.</dd> -</dl> +- `path` + - : `string`. Un chemin relatif de [manifest.json](/fr/Add-ons/WebExtensions/manifest.json) Ă une ressource empaquetĂ©e avec l'extension. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p><code>string</code>. L'URL complĂšte de la ressource.</p> +`string`. L'URL complĂšte de la ressource. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.getURL")}}</p> +{{Compat("webextensions.api.runtime.getURL")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Etant donnĂ© un fichier empaquetĂ© avec l'extension "beasts/frog.html", obtenez l'URL complĂšte comme ceci :</p> +Etant donnĂ© un fichier empaquetĂ© avec l'extension "beasts/frog.html", obtenez l'URL complĂšte comme ceci : -<pre class="brush: js">var fullURL = browser.runtime.getURL("beasts/frog.html"); +```js +var fullURL = browser.runtime.getURL("beasts/frog.html"); console.log(fullURL); // Returns something like: -// moz-extension://2c127fa4-62c7-7e4f-90e5-472b45eecfdc/beasts/frog.html</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +// moz-extension://2c127fa4-62c7-7e4f-90e5-472b45eecfdc/beasts/frog.html +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -91,5 +82,4 @@ console.log(fullURL); // 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/runtime/id/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/id/index.md index 1c76b09fe0..aeb1806ce9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/id/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/id/index.md @@ -13,31 +13,31 @@ tags: - §ID translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/id --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'ID de l'extension</p> +L'ID de l'extension -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var myAddonId = browser.runtime.id;</pre> +```js +var myAddonId = browser.runtime.id; +``` -<h3 id="Value">Value</h3> +### Value -<p>Une <code>chaĂźne</code> reprĂ©sentant l'ID du module complĂ©mentaire. Si l'extension a spĂ©cifiĂ© un ID dans la clĂ© manifest.json de ses <a href="/fr/Add-ons/WebExtensions/manifest.json/applications">applications</a>, <code>runtime.id</code> contiendra la valeur. SInon <code>runtime.id</code> contiendra l'ID gĂ©nĂ©rĂ© pour l'extension.</p> +Une `chaĂźne` reprĂ©sentant l'ID du module complĂ©mentaire. Si l'extension a spĂ©cifiĂ© un ID dans la clĂ© manifest.json de ses [applications](/fr/Add-ons/WebExtensions/manifest.json/applications), `runtime.id` contiendra la valeur. SInon `runtime.id` contiendra l'ID gĂ©nĂ©rĂ© pour l'extension. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.id")}}</p> +{{Compat("webextensions.api.runtime.id")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.json</code></a> dans le code de Chromium code.</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 @@ -64,5 +64,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/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/runtime/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/index.md index 0d69ad6128..fad7f0742b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/index.md @@ -12,135 +12,111 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime --- -<div>{{AddonSidebar}}</div> - -<p>Ce module fournit des informations sur votre extension et l'environnement dans lequel elle fonctionne.</p> - -<p>Il fournit Ă©galement des API de messagerie vous permettant de:</p> - -<ul> - <li>Communiquer entre les diffĂ©rentes parties de votre extension.</li> - <li>Communiquer avec d'autres extensions.</li> - <li>Communiquer avec les applications natives.</li> -</ul> - -<h2 id="Types">Types</h2> - -<dl> - <dt>{{WebExtAPIRef("runtime.Port")}}</dt> - <dd>ReprĂ©sente une extrĂ©mitĂ© d'une connexion entre deux contextes spĂ©cifiques, qui peut ĂȘtre utilisĂ©e pour Ă©changer des messages.</dd> - <dt>{{WebExtAPIRef("runtime.MessageSender")}}</dt> - <dd> - <p>Contient des informations sur l'expĂ©diteur d'un message ou d'une demande de connexion.</p> - </dd> - <dt>{{WebExtAPIRef("runtime.PlatformOs")}}</dt> - <dd>Identifie le systĂšme d'exploitation du navigateur.</dd> - <dt>{{WebExtAPIRef("runtime.PlatformArch")}}</dt> - <dd>Identifie l'architecture du processeur du navigateur.</dd> - <dt>{{WebExtAPIRef("runtime.PlatformInfo")}}</dt> - <dd>Contient des informations sur la plate-forme utilisĂ©e par le navigateur.</dd> - <dt>{{WebExtAPIRef("runtime.RequestUpdateCheckStatus")}}</dt> - <dd>RĂ©sultat d'un appel Ă {{WebExtAPIRef("runtime.requestUpdateCheck()")}}.</dd> - <dt>{{WebExtAPIRef("runtime.OnInstalledReason")}}</dt> - <dd>La raison pour laquelle l'Ă©vĂ©nement {{WebExtAPIRef("runtime.onInstalled")}} est en cours d'envoi.</dd> - <dt>{{WebExtAPIRef("runtime.OnRestartRequiredReason")}}</dt> - <dd>La raison pour laquelle l'Ă©vĂ©nement {{WebExtAPIRef("runtime.onRestartRequired")}} est en cours d'expĂ©dition.</dd> -</dl> - -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> - -<dl> - <dt>{{WebExtAPIRef("runtime.lastError")}}</dt> - <dd>Cette valeur est dĂ©finie lorsqu'une fonction asynchrone a une condition d'erreur qu'elle doit signaler Ă son appelant</dd> - <dt>{{WebExtAPIRef("runtime.id")}}</dt> - <dd>L'ID de l'extension</dd> -</dl> - -<h2 id="Fonctions">Fonctions</h2> - -<dl> - <dt>{{WebExtAPIRef("runtime.getBackgroundPage()")}}</dt> - <dd>RĂ©cupĂšre l'objet <a href="/fr/docs/Web/API/Window">Window</a> pour la page d'arriĂšre-plan qui s'exĂ©cute dans l'extension en cours.</dd> - <dt>{{WebExtAPIRef("runtime.openOptionsPage()")}}</dt> - <dd> - <p>Ouvre une <a href="/fr/Add-ons/WebExtensions/user_interface/Options_pages">page d'options</a> de votre extension.</p> - </dd> - <dt>{{WebExtAPIRef("runtime.getManifest()")}}</dt> - <dd>Obtient le fichier <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a> complet,  sĂ©rialisĂ© en tant qu'objet.</dd> - <dt>{{WebExtAPIRef("runtime.getURL()")}}</dt> - <dd>Etant donnĂ© un chemin relatif de <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a> Ă une ressource empaquetĂ©e avec l'extension, renvoie une URL entiĂšrement qualifiĂ©e.</dd> - <dt>{{WebExtAPIRef("runtime.setUninstallURL()")}}</dt> - <dd>DĂ©finit une URL Ă visiter lorsque l'extension est dĂ©sinstallĂ©e.</dd> - <dt>{{WebExtAPIRef("runtime.reload()")}}</dt> - <dd>Recharge l'extension.</dd> - <dt>{{WebExtAPIRef("runtime.requestUpdateCheck()")}}</dt> - <dd>VĂ©rifie les mises Ă jour de cette extension.</dd> - <dt>{{WebExtAPIRef("runtime.connect()")}}</dt> - <dd>Ătablit une connexion d'un script de contenu au processus d'extension principal ou d'une extension Ă une extension diffĂ©rente.</dd> - <dt>{{WebExtAPIRef("runtime.connectNative()")}}</dt> - <dd> - <div>Connecte l'extension Ă une application native sur l'ordinateur de l'utilisateur.</div> - </dd> - <dt>{{WebExtAPIRef("runtime.sendMessage()")}}</dt> - <dd>Envoie un seul message aux Ă©couteurs d'Ă©vĂ©nement dans votre extension ou une extension diffĂ©rente. Similaire Ă Â {{WebExtAPIRef('runtime.connect')}} mais n'envoie qu'un seul message, avec une rĂ©ponse facultative.</dd> - <dt>{{WebExtAPIRef("runtime.sendNativeMessage()")}}</dt> - <dd>Envoie un seul message d'une extension Ă une application native.</dd> - <dt>{{WebExtAPIRef("runtime.getPlatformInfo()")}}</dt> - <dd>Renvoie des informations sur la plate-forme actuelle.</dd> - <dt>{{WebExtAPIRef("runtime.getBrowserInfo()")}}</dt> - <dd>Renvoie des informations sur le navigateur dans lequel cette extension est installĂ©e.</dd> - <dt>{{WebExtAPIRef("runtime.getPackageDirectoryEntry()")}}</dt> - <dd>Renvoie un DirectoryEntry pour le rĂ©pertoire du package.</dd> -</dl> - -<h2 id="EvĂ©nements">EvĂ©nements</h2> - -<dl> - <dt>{{WebExtAPIRef("runtime.onStartup")}}</dt> - <dd>LancĂ© lorsqu'un premier profil a cette extension installĂ©e. Cet Ă©vĂ©nement n'est pas dĂ©clenchĂ© lorsqu'un profil de navigation privĂ©e est dĂ©marrĂ©.</dd> - <dt>{{WebExtAPIRef("runtime.onInstalled")}}</dt> - <dd>LancĂ© lorsque l'extension est installĂ©e pour la premiĂšre fois, lorsque l'extension est mise Ă jour vers une nouvelle version et lorsque le navigateur est mis Ă jour vers une nouvelle version.</dd> - <dt>{{WebExtAPIRef("runtime.onSuspend")}}</dt> - <dd>EnvoyĂ© sur la page de l'Ă©vĂ©nement juste avant le dĂ©chargement de l'extension. Cela donne Ă l'extension l'opportunitĂ© de faire un peu de nettoyage.</dd> - <dt>{{WebExtAPIRef("runtime.onSuspendCanceled")}}</dt> - <dd>EnvoyĂ© aprĂšs {{WebExtAPIRef("runtime.onSuspend")}} pour indiquer que l'extension ne sera pas dĂ©chargĂ©e aprĂšs tout.</dd> - <dt>{{WebExtAPIRef("runtime.onUpdateAvailable")}}</dt> - <dd>LancĂ© lorsqu'une mise Ă jour est disponible, mais n'est pas installĂ© immĂ©diatement car l'extension est en cours d'exĂ©cution.</dd> - <dt>{{WebExtAPIRef("runtime.onBrowserUpdateAvailable")}} {{deprecated_inline}}</dt> - <dd>LancĂ© lorsqu'une mise Ă jour pour le navigateur est disponible, mais n'est pas installĂ©e immĂ©diatement car un redĂ©marrage du navigateur est requis.</dd> - <dt>{{WebExtAPIRef("runtime.onConnect")}}</dt> - <dd>LancĂ© lorsqu'une connexion est Ă©tablie avec un processus d'extension ou un script de contenu.</dd> - <dt>{{WebExtAPIRef("runtime.onConnectExternal")}}</dt> - <dd>LancĂ© lorsqu'une connexion est Ă©tablie avec une autre extension.</dd> - <dt>{{WebExtAPIRef("runtime.onMessage")}}</dt> - <dd>LancĂ© lorsqu'un message est envoyĂ© par un processus d'extension ou un script de contenu.</dd> - <dt>{{WebExtAPIRef("runtime.onMessageExternal")}}</dt> - <dd>LancĂ© lorsqu'un message est envoyĂ© depuis un autre poste. Ne peut pas ĂȘtre utilisĂ© dans un script de contenu.</dd> - <dt>{{WebExtAPIRef("runtime.onRestartRequired")}}</dt> - <dd>LancĂ© lorsque le pĂ©riphĂ©rique doit ĂȘtre redĂ©marrĂ©.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<div> - - -<p>{{Compat("webextensions.api.runtime")}}</p> - -<div>{{WebExtExamples("h2")}}</div> - -<div></div> -</div> - -<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/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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}} + +Ce module fournit des informations sur votre extension et l'environnement dans lequel elle fonctionne. + +Il fournit Ă©galement des API de messagerie vous permettant de: + +- Communiquer entre les diffĂ©rentes parties de votre extension. +- Communiquer avec d'autres extensions. +- Communiquer avec les applications natives. + +## Types + +- {{WebExtAPIRef("runtime.Port")}} + - : ReprĂ©sente une extrĂ©mitĂ© d'une connexion entre deux contextes spĂ©cifiques, qui peut ĂȘtre utilisĂ©e pour Ă©changer des messages. +- {{WebExtAPIRef("runtime.MessageSender")}} + - : Contient des informations sur l'expĂ©diteur d'un message ou d'une demande de connexion. +- {{WebExtAPIRef("runtime.PlatformOs")}} + - : Identifie le systĂšme d'exploitation du navigateur. +- {{WebExtAPIRef("runtime.PlatformArch")}} + - : Identifie l'architecture du processeur du navigateur. +- {{WebExtAPIRef("runtime.PlatformInfo")}} + - : Contient des informations sur la plate-forme utilisĂ©e par le navigateur. +- {{WebExtAPIRef("runtime.RequestUpdateCheckStatus")}} + - : RĂ©sultat d'un appel Ă {{WebExtAPIRef("runtime.requestUpdateCheck()")}}. +- {{WebExtAPIRef("runtime.OnInstalledReason")}} + - : La raison pour laquelle l'Ă©vĂ©nement {{WebExtAPIRef("runtime.onInstalled")}} est en cours d'envoi. +- {{WebExtAPIRef("runtime.OnRestartRequiredReason")}} + - : La raison pour laquelle l'Ă©vĂ©nement {{WebExtAPIRef("runtime.onRestartRequired")}} est en cours d'expĂ©dition. + +## PropriĂ©tĂ©s + +- {{WebExtAPIRef("runtime.lastError")}} + - : Cette valeur est dĂ©finie lorsqu'une fonction asynchrone a une condition d'erreur qu'elle doit signaler Ă son appelant +- {{WebExtAPIRef("runtime.id")}} + - : L'ID de l'extension + +## Fonctions + +- {{WebExtAPIRef("runtime.getBackgroundPage()")}} + - : RĂ©cupĂšre l'objet [Window](/fr/docs/Web/API/Window) pour la page d'arriĂšre-plan qui s'exĂ©cute dans l'extension en cours. +- {{WebExtAPIRef("runtime.openOptionsPage()")}} + - : Ouvre une [page d'options](/fr/Add-ons/WebExtensions/user_interface/Options_pages) de votre extension. +- {{WebExtAPIRef("runtime.getManifest()")}} + - : Obtient le fichier [manifest.json](/fr/Add-ons/WebExtensions/manifest.json) complet,  sĂ©rialisĂ© en tant qu'objet. +- {{WebExtAPIRef("runtime.getURL()")}} + - : Etant donnĂ© un chemin relatif de [manifest.json](/fr/Add-ons/WebExtensions/manifest.json) Ă une ressource empaquetĂ©e avec l'extension, renvoie une URL entiĂšrement qualifiĂ©e. +- {{WebExtAPIRef("runtime.setUninstallURL()")}} + - : DĂ©finit une URL Ă visiter lorsque l'extension est dĂ©sinstallĂ©e. +- {{WebExtAPIRef("runtime.reload()")}} + - : Recharge l'extension. +- {{WebExtAPIRef("runtime.requestUpdateCheck()")}} + - : VĂ©rifie les mises Ă jour de cette extension. +- {{WebExtAPIRef("runtime.connect()")}} + - : Ătablit une connexion d'un script de contenu au processus d'extension principal ou d'une extension Ă une extension diffĂ©rente. +- {{WebExtAPIRef("runtime.connectNative()")}} + - : Connecte l'extension Ă une application native sur l'ordinateur de l'utilisateur. +- {{WebExtAPIRef("runtime.sendMessage()")}} + - : Envoie un seul message aux Ă©couteurs d'Ă©vĂ©nement dans votre extension ou une extension diffĂ©rente. Similaire Ă Â {{WebExtAPIRef('runtime.connect')}} mais n'envoie qu'un seul message, avec une rĂ©ponse facultative. +- {{WebExtAPIRef("runtime.sendNativeMessage()")}} + - : Envoie un seul message d'une extension Ă une application native. +- {{WebExtAPIRef("runtime.getPlatformInfo()")}} + - : Renvoie des informations sur la plate-forme actuelle. +- {{WebExtAPIRef("runtime.getBrowserInfo()")}} + - : Renvoie des informations sur le navigateur dans lequel cette extension est installĂ©e. +- {{WebExtAPIRef("runtime.getPackageDirectoryEntry()")}} + - : Renvoie un DirectoryEntry pour le rĂ©pertoire du package. + +## EvĂ©nements + +- {{WebExtAPIRef("runtime.onStartup")}} + - : LancĂ© lorsqu'un premier profil a cette extension installĂ©e. Cet Ă©vĂ©nement n'est pas dĂ©clenchĂ© lorsqu'un profil de navigation privĂ©e est dĂ©marrĂ©. +- {{WebExtAPIRef("runtime.onInstalled")}} + - : LancĂ© lorsque l'extension est installĂ©e pour la premiĂšre fois, lorsque l'extension est mise Ă jour vers une nouvelle version et lorsque le navigateur est mis Ă jour vers une nouvelle version. +- {{WebExtAPIRef("runtime.onSuspend")}} + - : EnvoyĂ© sur la page de l'Ă©vĂ©nement juste avant le dĂ©chargement de l'extension. Cela donne Ă l'extension l'opportunitĂ© de faire un peu de nettoyage. +- {{WebExtAPIRef("runtime.onSuspendCanceled")}} + - : EnvoyĂ© aprĂšs {{WebExtAPIRef("runtime.onSuspend")}} pour indiquer que l'extension ne sera pas dĂ©chargĂ©e aprĂšs tout. +- {{WebExtAPIRef("runtime.onUpdateAvailable")}} + - : LancĂ© lorsqu'une mise Ă jour est disponible, mais n'est pas installĂ© immĂ©diatement car l'extension est en cours d'exĂ©cution. +- {{WebExtAPIRef("runtime.onBrowserUpdateAvailable")}} {{deprecated_inline}} + - : LancĂ© lorsqu'une mise Ă jour pour le navigateur est disponible, mais n'est pas installĂ©e immĂ©diatement car un redĂ©marrage du navigateur est requis. +- {{WebExtAPIRef("runtime.onConnect")}} + - : LancĂ© lorsqu'une connexion est Ă©tablie avec un processus d'extension ou un script de contenu. +- {{WebExtAPIRef("runtime.onConnectExternal")}} + - : LancĂ© lorsqu'une connexion est Ă©tablie avec une autre extension. +- {{WebExtAPIRef("runtime.onMessage")}} + - : LancĂ© lorsqu'un message est envoyĂ© par un processus d'extension ou un script de contenu. +- {{WebExtAPIRef("runtime.onMessageExternal")}} + - : LancĂ© lorsqu'un message est envoyĂ© depuis un autre poste. Ne peut pas ĂȘtre utilisĂ© dans un script de contenu. +- {{WebExtAPIRef("runtime.onRestartRequired")}} + - : LancĂ© lorsque le pĂ©riphĂ©rique doit ĂȘtre redĂ©marrĂ©. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.runtime")}} + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. + +<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 @@ -167,5 +143,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime // 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/runtime/lasterror/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/lasterror/index.md index 0384ff364d..7cb6dfd7fc 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/lasterror/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/lasterror/index.md @@ -13,38 +13,33 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/lastError --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Cette valeur est utilisĂ©e pour signaler un message d'erreur provenant d'une API asynchrone, lorsque l'API asynchrone reçoit un rappel. Cela est utile pour les extensions qui utilisent la valeur basĂ©e sur le rappel des API WebExtension.Vpous n'avez pas besoin de vĂ©rifier cette propriĂ©tĂ© si vous utilisez la version basĂ©e sur la promesse des API : Ă la place, passez un gestionnaire d'erreurs Ă la promesse : -<div>Cette valeur est utilisĂ©e pour signaler un message d'erreur provenant d'une API asynchrone, lorsque l'API asynchrone reçoit un rappel. Cela est utile pour les extensions qui utilisent la valeur basĂ©e sur le rappel des API WebExtension.</div> +```js +var gettingCookies = browser.cookies.getAll(); +gettingCookies.then(onGot, onError); +``` -<div></div> +La propriĂ©tĂ© `runtime.lastError` est dĂ©finie lorsqu'une fonction asynchrone a une condition d'erreur qu'elle doit signaler Ă son appelant. -<div>Vpous n'avez pas besoin de vĂ©rifier cette propriĂ©tĂ© si vous utilisez la version basĂ©e sur la promesse des API : Ă la place, passez un gestionnaire d'erreurs Ă la promesse :</div> +Si vous applez une fonction asynchrone qui veut dĂ©finir `lastError`, vous devez vĂ©rifier l'erreur lorsque vous gĂ©rez le rĂ©sultat de la fonction. Si `lastError` a Ă©tĂ© dĂ©fini et que vous ne cochez pas dans la fonction de rappel, une erreur sera gĂ©nĂ©rĂ©e. -<div></div> +## Syntaxe -<pre class="brush: js">var gettingCookies = browser.cookies.getAll(); -gettingCookies.then(onGot, onError);</pre> +```js +var myError = browser.runtime.lastError; // null or Error object +``` -<p>La propriĂ©tĂ© <code>runtime.lastError</code> est dĂ©finie lorsqu'une fonction asynchrone a une condition d'erreur qu'elle doit signaler Ă son appelant.</p> +### Valeur -<div>Si vous applez une fonction asynchrone qui veut dĂ©finir <code>lastError</code>, vous devez vĂ©rifier l'erreur lorsque vous gĂ©rez le rĂ©sultat de la fonction. Si <code>lastError</code> a Ă©tĂ© dĂ©fini et que vous ne cochez pas dans la fonction de rappel, une erreur sera gĂ©nĂ©rĂ©e.</div> +Un objet [Error](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Error) reprĂ©sentant une erreur. La propriĂ©tĂ© [`message`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Error/message) est un `string` avec une description lisible par l'utilisateur de l'erreur. Si `lastError` n'a pas Ă©tĂ© dĂ©fini, la valeur est `null`. -<div></div> +## Examples -<h2 id="Syntaxe">Syntaxe</h2> +DĂ©finir un cookie, utiliser pour enregistrer le nouveau cookie ou signaler une erreur : -<pre class="brush: js">var myError = browser.runtime.lastError; // null or Error object</pre> - -<h3 id="Valeur">Valeur</h3> - -<p>Un objet <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Error">Error</a> reprĂ©sentant une erreur. La propriĂ©tĂ© <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Error/message"><code>message</code></a> est un <code>string</code> avec une description lisible par l'utilisateur de l'erreur. Si <code>lastError</code> n'a pas Ă©tĂ© dĂ©fini, la valeur est <code>null</code>.</p> - -<h2 id="Examples">Examples</h2> - -<p>DĂ©finir un cookie, utiliser pour enregistrer le nouveau cookie ou signaler une erreur :</p> - -<pre class="brush: js">function logCookie(c) { +```js +function logCookie(c) { if (browser.runtime.lastError) { console.error(browser.runtime.lastError); } else { @@ -55,11 +50,13 @@ gettingCookies.then(onGot, onError);</pre> browser.cookies.set( {url: "https://developer.mozilla.org/"}, logCookie -);</pre> +); +``` -<p>La mĂȘme chose, mais en utilisant une promesse de gĂ©rer le rĂ©sultat de <code>setCookie()</code>:</p> +La mĂȘme chose, mais en utilisant une promesse de gĂ©rer le rĂ©sultat de `setCookie()`: -<pre class="brush: js">function logCookie(c) { +```js +function logCookie(c) { console.log(c); } @@ -71,27 +68,24 @@ var setCookie = browser.cookies.set( {url: "https://developer.mozilla.org/"} ); -setCookie.then(logCookie, logError);</pre> - -<div class="note"> -<p><strong>Note :</strong> <code>runtime.lastError</code> est un alias pour {{WebExtAPIRef("extension.lastError")}}: Ils sont ensemble, et la vĂ©rification de l'un fonctionnera.</p> -</div> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +setCookie.then(logCookie, logError); +``` -<p>{{Compat("webextensions.api.runtime.lastError")}}</p> +> **Note :** `runtime.lastError` est un alias pour {{WebExtAPIRef("extension.lastError")}}: Ils sont ensemble, et la vĂ©rification de l'un fonctionnera. -<p>{{WebExtExamples}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.runtime.lastError")}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -118,5 +112,4 @@ setCookie.then(logCookie, logError);</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/runtime/messagesender/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/messagesender/index.md index f9fdd35544..812888e73f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/messagesender/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/messagesender/index.md @@ -13,44 +13,40 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/MessageSender --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet contenant des informations sur l'expĂ©diteur d'un message ou d'une demande de connexion ; ceci est passĂ© Ă l'Ă©couteur {{WebExtAPIRef("runtime.onMessage()")}}.</p> +Un objet contenant des informations sur l'expĂ©diteur d'un message ou d'une demande de connexion ; ceci est passĂ© Ă l'Ă©couteur {{WebExtAPIRef("runtime.onMessage()")}}. -<p>C'est aussi une propriĂ©tĂ© de {{WebExtAPIRef("runtime.Port")}}, mais seulement dans l'instance de <code>Port</code> passĂ©e dans les Ă©couteurs {{WebExtAPIRef("runtime.onConnect()")}} ou {{WebExtAPIRef("runtime.onConnectExternal()")}}.</p> +C'est aussi une propriĂ©tĂ© de {{WebExtAPIRef("runtime.Port")}}, mais seulement dans l'instance de `Port` passĂ©e dans les Ă©couteurs {{WebExtAPIRef("runtime.onConnect()")}} ou {{WebExtAPIRef("runtime.onConnectExternal()")}}. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>tab</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('tabs.Tab')}}. Le {{WebExtAPIRef('tabs.Tab')}} qui a ouvert la connexion. Cette propriĂ©tĂ© ne sera prĂ©sente que lorsque la connexion a Ă©tĂ© ouverte Ă partir d'un onglet (y compris les scripts de contenu).</dd> - <dt><code>frameId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Le cadre qui a ouvert la connexion. ZĂ©ro pour les cadres de haut niveau, positif pour les cadres enfants.  Cela ne sera dĂ©fini que lorsque l'<code>onglet</code> est dĂ©fini.</dd> - <dt><code>id</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'ID de l'extension qui a envoyĂ© le message, si le message a Ă©tĂ© envoyĂ© par une extension. Si l'expĂ©diteur dĂ©finit explicitement un ID Ă l'aide de la clĂ© des <a href="/fr/Add-ons/WebExtensions/manifest.json/applications">applications</a> dans manifest.json, then <code>id</code>  aura cette valeur. Sinon, il aura l'ID qui a Ă©tĂ© gĂ©nĂ©rĂ© pour l'expĂ©diteur. Notez que dans Firefox, avant la version 54, cette valeur Ă©tait l'ID interne de l'extension (c'est-Ă -dire l'<a href="https://en.wikipedia.org/wiki/Universally_unique_identifier">UUID</a> qui apparaĂźt dans l'URL de l'extension).</dd> - <dt><code>url</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'URL de la page ou du cadre hĂ©bergeant le script qui a envoyĂ© le message. Si l'expĂ©diteur est un script s'exĂ©cutant dans une page d'extension (telle qu'une <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts">page d'arriĂšre-plan</a>, une <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Options_pages">page d'options</a>, ou une <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2">action de navigateur</a> ou une <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Page_actions">action contextuelle</a>), l'URL sera au format <code>"moz-extension://<extension-internal-id>/path/to/page.html"</code>. Si l'expĂ©diteur est un script d'arriĂšre-plan et que vous n'avez pas inclus une page d'arriĂšre-plan, ce sera <code>"moz-extension://<extension-internal-id>/_generated_background_page.html"</code>. Si l'expĂ©diteur est un script s'exĂ©cutant sur une page Web (y compris les scripts de contenu et les scripts de page normaux), alors l'<code>url</code> sera l'URL de la page web. Si le script s'exĂ©cute dans un iframe, <code>url</code> sera l'URL de l'iframe.</dd> - <dt><code>tlsChannelId</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'ID de canal TLS de la page ou du cadre qui a ouvert la connexion, si demandĂ© par l'extension, et si disponible.</dd> -</dl> +- `tab`{{optional_inline}} + - : {{WebExtAPIRef('tabs.Tab')}}. Le {{WebExtAPIRef('tabs.Tab')}} qui a ouvert la connexion. Cette propriĂ©tĂ© ne sera prĂ©sente que lorsque la connexion a Ă©tĂ© ouverte Ă partir d'un onglet (y compris les scripts de contenu). +- `frameId`{{optional_inline}} + - : `integer`. Le cadre qui a ouvert la connexion. ZĂ©ro pour les cadres de haut niveau, positif pour les cadres enfants.  Cela ne sera dĂ©fini que lorsque l'`onglet` est dĂ©fini. +- `id`{{optional_inline}} + - : `string`. L'ID de l'extension qui a envoyĂ© le message, si le message a Ă©tĂ© envoyĂ© par une extension. Si l'expĂ©diteur dĂ©finit explicitement un ID Ă l'aide de la clĂ© des [applications](/fr/Add-ons/WebExtensions/manifest.json/applications) dans manifest.json, then `id`  aura cette valeur. Sinon, il aura l'ID qui a Ă©tĂ© gĂ©nĂ©rĂ© pour l'expĂ©diteur. Notez que dans Firefox, avant la version 54, cette valeur Ă©tait l'ID interne de l'extension (c'est-Ă -dire l'[UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) qui apparaĂźt dans l'URL de l'extension). +- `url`{{optional_inline}} + - : `string`. L'URL de la page ou du cadre hĂ©bergeant le script qui a envoyĂ© le message. Si l'expĂ©diteur est un script s'exĂ©cutant dans une page d'extension (telle qu'une [page d'arriĂšre-plan](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts), une [page d'options](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Options_pages), ou une [action de navigateur](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2) ou une [action contextuelle](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Page_actions)), l'URL sera au format `"moz-extension://<extension-internal-id>/path/to/page.html"`. Si l'expĂ©diteur est un script d'arriĂšre-plan et que vous n'avez pas inclus une page d'arriĂšre-plan, ce sera `"moz-extension://<extension-internal-id>/_generated_background_page.html"`. Si l'expĂ©diteur est un script s'exĂ©cutant sur une page Web (y compris les scripts de contenu et les scripts de page normaux), alors l'`url` sera l'URL de la page web. Si le script s'exĂ©cute dans un iframe, `url` sera l'URL de l'iframe. +- `tlsChannelId`{{optional_inline}} + - : `string`. L'ID de canal TLS de la page ou du cadre qui a ouvert la connexion, si demandĂ© par l'extension, et si disponible. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.MessageSender")}}</p> +{{Compat("webextensions.api.runtime.MessageSender")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -77,5 +73,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/MessageSender // 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/runtime/onbrowserupdateavailable/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onbrowserupdateavailable/index.md index 3319ee6867..dd7976c44c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onbrowserupdateavailable/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onbrowserupdateavailable/index.md @@ -13,64 +13,59 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onBrowserUpdateAvailable --- -<p>{{AddonSidebar}}{{Deprecated_header}}</p> +{{AddonSidebar}}{{Deprecated_header}} -<p>LancĂ© lorsqu'une mise Ă jour pour le navigateur est disponible, mais qu'elle n'est pas installĂ©e immĂ©diatement car un redĂ©marrage du navigateur est requi.</p> +LancĂ© lorsqu'une mise Ă jour pour le navigateur est disponible, mais qu'elle n'est pas installĂ©e immĂ©diatement car un redĂ©marrage du navigateur est requi. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.runtime.onBrowserUpdateAvailable.addListener(listener) +```js +browser.runtime.onBrowserUpdateAvailable.addListener(listener) browser.runtime.onBrowserUpdateAvailable.removeListener(listener) browser.runtime.onBrowserUpdateAvailable.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>Arrestez d'Ă©couter un Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>Ă©couteur</code> est enregistrĂ© pour cet Ă©vĂ©nement. Retourne <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : Arrestez d'Ă©couter un Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si un `Ă©couteur` est enregistrĂ© pour cet Ă©vĂ©nement. Retourne `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>function</code></dt> - <dd> - <p>Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira.</p> - </dd> -</dl> +- `function` + - : Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.onBrowserUpdateAvailable")}}</p> +{{Compat("webextensions.api.runtime.onBrowserUpdateAvailable")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ecoutez cet Ă©vĂ©nement :</p> +Ecoutez cet Ă©vĂ©nement : -<pre class="brush: js">function handleBrowserUpdateAvailable() { +```js +function handleBrowserUpdateAvailable() { // handle event } -browser.runtime.onBrowserUpdateAvailable.addListener(handleBrowserUpdateAvailable);</pre> +browser.runtime.onBrowserUpdateAvailable.addListener(handleBrowserUpdateAvailable); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -97,5 +92,4 @@ browser.runtime.onBrowserUpdateAvailable.addListener(handleBrowserUpdateAvailabl // 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/runtime/onconnect/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.md index d77c14c446..30b40610aa 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnect/index.md @@ -13,59 +13,52 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onConnect --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© quand une connexion est Ă©tablie avec un processus d'extension ou un script de contenu.</p> +LancĂ© quand une connexion est Ă©tablie avec un processus d'extension ou un script de contenu. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.runtime.onConnect.addListener(listener) +```js +browser.runtime.onConnect.addListener(listener) browser.runtime.onConnect.removeListener(listener) browser.runtime.onConnect.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'<code>Ă©couteur</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>Ă©couteur</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'`Ă©couteur` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si un `Ă©couteur` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>fonction</code></dt> - <dd> - <p>Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction recevra les arguments suivants:</p> +- `fonction` - <dl> - <dt><code>port</code></dt> - <dd>Un objet {{WebExtAPIRef('runtime.Port')}} connectant le script courant Ă l'autre contexte auquel il se connecte.</dd> - </dl> - </dd> -</dl> + - : Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction recevra les arguments suivants: -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `port` + - : Un objet {{WebExtAPIRef('runtime.Port')}} connectant le script courant Ă l'autre contexte auquel il se connecte. -<p>{{Compat("webextensions.api.runtime.onConnect")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.runtime.onConnect")}} -<p>Ce script de contenu :</p> +## Exemples -<ul> - <li>Se connecte au script d'arriĂšre-plan et stocke le <code>Port</code> dans une variable <code>myPort</code></li> - <li>Ecoute les messages sur <code>myPort</code>, et les enregistre</li> - <li>Envoie des messages au script d'arriĂšre-plan, en utilisant <code>myPort</code>, lorsque l'utilisateur clique sur le document</li> -</ul> +Ce script de contenu : -<pre class="brush: js">// content-script.js +- Se connecte au script d'arriĂšre-plan et stocke le `Port` dans une variable `myPort` +- Ecoute les messages sur `myPort`, et les enregistre +- Envoie des messages au script d'arriĂšre-plan, en utilisant `myPort`, lorsque l'utilisateur clique sur le document + +```js +// content-script.js var myPort = browser.runtime.connect({name:"port-from-cs"}); myPort.postMessage({greeting: "hello from content script"}); @@ -77,23 +70,22 @@ myPort.onMessage.addListener(function(m) { document.body.addEventListener("click", function() { myPort.postMessage({greeting: "they clicked the page!"}); -});</pre> +}); +``` + +Le script d'arriĂšre-plan correspondant : + +- Ecoute les tentatives de connexion de script de contenu +- Quand il reçoit une tentative de connexion : -<p>Le script d'arriĂšre-plan correspondant :</p> + - Stocke le port dans une variable nommĂ©e `portFromCS` + - Envoie un message au script de contenu en utilisant le port + - Commence Ă Ă©couter les messages reçus sur le port et les enregistre -<ul> - <li>Ecoute les tentatives de connexion de script de contenu</li> - <li>Quand il reçoit une tentative de connexion : - <ul> - <li>Stocke le port dans une variable nommĂ©e <code>portFromCS</code></li> - <li>Envoie un message au script de contenu en utilisant le port</li> - <li>Commence Ă Ă©couter les messages reçus sur le port et les enregistre</li> - </ul> - </li> - <li>Envoie des messages au script de contenu, en utilisant <code>portFromCS</code>, quand l'utilisateur clique sur l'action du navigateur de l'extension</li> -</ul> +- Envoie des messages au script de contenu, en utilisant `portFromCS`, quand l'utilisateur clique sur l'action du navigateur de l'extension -<pre class="brush: js">// background-script.js +```js +// background-script.js var portFromCS; @@ -110,19 +102,18 @@ browser.runtime.onConnect.addListener(connected); browser.browserAction.onClicked.addListener(function() { portFromCS.postMessage({greeting: "they clicked the button!"}); -});</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/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -149,5 +140,4 @@ browser.browserAction.onClicked.addListener(function() { // 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/runtime/onconnectexternal/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnectexternal/index.md index 82de77f179..22afb6866d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnectexternal/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onconnectexternal/index.md @@ -13,101 +13,95 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onConnectExternal --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'une extension reçoit une demande de connexion d'une extension diffĂ©rente.</p> +LancĂ© lorsqu'une extension reçoit une demande de connexion d'une extension diffĂ©rente. -<p>Pour envoyer un message qui sera reçu par le programme d'Ă©coute <code>onConnectExternal</code>, utilisez {{WebExtAPIRef("runtime.connect()")}}, en transmettant l'ID du destinataire dans le paramĂštre <code>extensionId</code>.</p> +Pour envoyer un message qui sera reçu par le programme d'Ă©coute `onConnectExternal`, utilisez {{WebExtAPIRef("runtime.connect()")}}, en transmettant l'ID du destinataire dans le paramĂštre `extensionId`. -<p>L'Ă©couteur reçoit un objet {{WebExtAPIRef('runtime.Port')}} qu'il peut ensuite utiliser pour envoyer et recevoir des messages. L'objet <code>Port</code> contient Ă©galement une propriĂ©tĂ©<code>sender</code>, qui est un objet {{WebExtAPIRef("runtime.MessageSender")}},  et que le destinataire peut utiliser pour vĂ©rifier l'ID de l'expĂ©diteur.</p> +L'Ă©couteur reçoit un objet {{WebExtAPIRef('runtime.Port')}} qu'il peut ensuite utiliser pour envoyer et recevoir des messages. L'objet `Port` contient Ă©galement une propriĂ©tĂ©`sender`, qui est un objet {{WebExtAPIRef("runtime.MessageSender")}},  et que le destinataire peut utiliser pour vĂ©rifier l'ID de l'expĂ©diteur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.runtime.onConnectExternal.addListener(listener) +```js +browser.runtime.onConnectExternal.addListener(listener) browser.runtime.onConnectExternal.removeListener(listener) browser.runtime.onConnectExternal.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Retourne <code>true</code> s'il Ă©coute, <code>false</code> sinon.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si un `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Retourne `true` s'il Ă©coute, `false` sinon. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>fonction</code></dt> - <dd> - <p>Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction recevra les arguments suivants :</p> +- `fonction` - <dl> - <dt><code>port</code></dt> - <dd>Un objet {{WebExtAPIRef('runtime.Port')}} connectant le script en cours Ă l'autre extension Ă laquelle il se connecte.</dd> - </dl> - </dd> -</dl> + - : Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `port` + - : Un objet {{WebExtAPIRef('runtime.Port')}} connectant le script en cours Ă l'autre extension Ă laquelle il se connecte. -<p>{{Compat("webextensions.api.runtime.onConnectExternal")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.runtime.onConnectExternal")}} -<p>Dans cet exemple, l'extension Hansel se connecte Ă l'extension Gretel :</p> +## Exemples -<pre class="brush: js">console.log("connecting to Gretel"); +Dans cet exemple, l'extension Hansel se connecte Ă l'extension Gretel : + +```js +console.log("connecting to Gretel"); var myPort = browser.runtime.connect( "gretel@mozilla.org" ); -myPort.onMessage.addListener((message) => { +myPort.onMessage.addListener((message) => { console.log(`From Gretel: ${message.content}`); }); -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { myPort.postMessage({content: "Hello from Hansel"}); -});</pre> +}); +``` -<p>Gretel Ă©coute la connexion et vĂ©rifie que l'expĂ©diteur est vraiment Hansel:</p> +Gretel Ă©coute la connexion et vĂ©rifie que l'expĂ©diteur est vraiment Hansel: -<pre class="brush: js">var portFromHansel; +```js +var portFromHansel; -browser.runtime.onConnectExternal.addListener((port) => { +browser.runtime.onConnectExternal.addListener((port) => { console.log(port); if (port.sender.id === "hansel@mozilla.org") { console.log("connection attempt from Hansel"); portFromHansel = port; - portFromHansel.onMessage.addListener((message) => { + portFromHansel.onMessage.addListener((message) => { console.log(`From Hansel: ${message.content}`); }); } }); -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { portFromHansel.postMessage({content: "Message from Gretel"}); }); +``` -</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/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -134,5 +128,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/runtime/oninstalled/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalled/index.md index 72b6f011f6..4f7a42e9fe 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalled/index.md @@ -13,85 +13,78 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onInstalled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque l'extension est installĂ©e pour la premiĂšre fois, lorsque l'extension est mise Ă jour vers une nouvelle version et lorsque le navigateur est mis Ă jour vers une nouvelle version.</p> +LancĂ© lorsque l'extension est installĂ©e pour la premiĂšre fois, lorsque l'extension est mise Ă jour vers une nouvelle version et lorsque le navigateur est mis Ă jour vers une nouvelle version. -<p>Notez que <code>runtime.onInstalled</code> n'est pas la mĂȘme chose {{WebExtAPIRef("management.onInstalled")}}. L'Ă©vĂ©nement <code>runtime.onInstalled</code> est dĂ©clenchĂ© uniquement pour votre extension. L'Ă©vĂ©nement <code>browser.management.onInstalled</code> est dĂ©clenchĂ© pour toutes les extensions.</p> +Notez que `runtime.onInstalled` n'est pas la mĂȘme chose {{WebExtAPIRef("management.onInstalled")}}. L'Ă©vĂ©nement `runtime.onInstalled` est dĂ©clenchĂ© uniquement pour votre extension. L'Ă©vĂ©nement `browser.management.onInstalled` est dĂ©clenchĂ© pour toutes les extensions. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.runtime.onInstalled.addListener(listener) +```js +browser.runtime.onInstalled.addListener(listener) browser.runtime.onInstalled.removeListener(listener) browser.runtime.onInstalled.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajouterun Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©coutercet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>Ă©couteur</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, <code>false</code> sinon.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>function</code></dt> - <dd> - <p>La fonction de rappel appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> - - <dl> - <dt><code>details</code></dt> - <dd><p>Un objet avec les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>id</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'ID de l'extension de module partagĂ© importĂ© mise Ă jour. Ceci n'est prĂ©sent que si la valeur de <code>raison</code> est <code>shared_module_update</code>.</dd> - <dt><code>previousVersion</code>{{optional_inline}}</dt> - <dd><code>string</code>. La version prĂ©cĂ©dente de l'extension vient d'ĂȘtre mise Ă jour. Ceci n'est pas prĂ©sent si la valeur de <code>raison</code> est <code>mise Ă jour</code>.</dd> - <dt><code>reason</code></dt> - <dd>Une valeur {{WebExtAPIRef('runtime.OnInstalledReason')}}, indiquant la raison pour laquelle cet Ă©vĂ©nement est distribuĂ©.</dd> - <dt><code>temporary</code></dt> - <dd><code>boolean</code>. Vrai si le module complĂ©mentaire a Ă©tĂ© installĂ© temporairement. Par exemple, en utilisant la page "about:debugging" dans Firefox ou en utilisant <a href="/fr/Add-ons/WebExtensions/Getting_started_with_web-ext">web-ext run</a>. Sinon faux.</dd> - </dl> - </dd> - </dl> - </dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.runtime.onInstalled", 10)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Lorsque l'extensin est installĂ©, connectez-vous Ă la raison de l'installon et ouvrez <a href="https://www.reddit.com/r/CatGifs/">https://www.reddit.com/r/CatGifs/</a>:</p> - -<pre class="brush: js">function handleInstalled(details) { +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback)` + - : Ajouterun Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©coutercet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si un `Ă©couteur` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, `false` sinon. + +## Syntaxe addListener + +### ParamĂštres + +- `function` + + - : La fonction de rappel appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : + + - `details` + + - : Un objet avec les propriĂ©tĂ©s suivantes : + + - `id`{{optional_inline}} + - : `string`. L'ID de l'extension de module partagĂ© importĂ© mise Ă jour. Ceci n'est prĂ©sent que si la valeur de `raison` est `shared_module_update`. + - `previousVersion`{{optional_inline}} + - : `string`. La version prĂ©cĂ©dente de l'extension vient d'ĂȘtre mise Ă jour. Ceci n'est pas prĂ©sent si la valeur de `raison` est `mise Ă jour`. + - `reason` + - : Une valeur {{WebExtAPIRef('runtime.OnInstalledReason')}}, indiquant la raison pour laquelle cet Ă©vĂ©nement est distribuĂ©. + - `temporary` + - : `boolean`. Vrai si le module complĂ©mentaire a Ă©tĂ© installĂ© temporairement. Par exemple, en utilisant la page "about:debugging" dans Firefox ou en utilisant [web-ext run](/fr/Add-ons/WebExtensions/Getting_started_with_web-ext). Sinon faux. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.runtime.onInstalled", 10)}} + +## Exemples + +Lorsque l'extensin est installĂ©, connectez-vous Ă la raison de l'installon et ouvrez <https://www.reddit.com/r/CatGifs/>: + +```js +function handleInstalled(details) { console.log(details.reason); browser.tabs.create({ url: "http://chilloutandwatchsomecatgifs.com/" }); } -browser.runtime.onInstalled.addListener(handleInstalled);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.runtime.onInstalled.addListener(handleInstalled); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -118,5 +111,4 @@ browser.runtime.onInstalled.addListener(handleInstalled);</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/runtime/oninstalledreason/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalledreason/index.md index 1e02e04511..0737c3b1d8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalledreason/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/oninstalledreason/index.md @@ -13,40 +13,36 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/OnInstalledReason --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Les valeurs pour laquelle l'Ă©vĂ©nement {{WebExtAPIRef("runtime.onInstalled")}} est en cours d'envoi.</p> +Les valeurs pour laquelle l'Ă©vĂ©nement {{WebExtAPIRef("runtime.onInstalled")}} est en cours d'envoi. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<dl> - <dt><code>"install"</code></dt> - <dd>L'extension a Ă©tĂ© installĂ©e.</dd> - <dt><code>"update"</code></dt> - <dd>L'extension a Ă©tĂ© mise Ă jour vers une nouvelle version.</dd> - <dt><code>"browser_update"</code></dt> - <dd>Le navigateur a Ă©tĂ© mise Ă jour vers une nouvelle version.</dd> - <dt><code>"shared_module_update"</code></dt> - <dd>Une autre extension, qui contient un module utilisĂ© par cette extension, a Ă©tĂ© mise Ă jour.</dd> -</dl> +- `"install"` + - : L'extension a Ă©tĂ© installĂ©e. +- `"update"` + - : L'extension a Ă©tĂ© mise Ă jour vers une nouvelle version. +- `"browser_update"` + - : Le navigateur a Ă©tĂ© mise Ă jour vers une nouvelle version. +- `"shared_module_update"` + - : Une autre extension, qui contient un module utilisĂ© par cette extension, a Ă©tĂ© mise Ă jour. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.OnInstalledReason")}}</p> +{{Compat("webextensions.api.runtime.OnInstalledReason")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -73,5 +69,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/OnInstalledReason // 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/runtime/onmessage/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.md index f946a74336..42036b3073 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessage/index.md @@ -13,148 +13,128 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onMessage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Utilisez cet Ă©vĂ©nement pour Ă©couter les messages dâune autre partie de votre extension.</p> +Utilisez cet Ă©vĂ©nement pour Ă©couter les messages dâune autre partie de votre extension. -<p>Voici quelques exemples de cas d'utilisation :</p> +Voici quelques exemples de cas d'utilisation : -<ul> - <li><strong>dans un <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#content_scripts">script de contenu</a></strong>, pour Ă©couter les messages dâun <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#background_scripts">script dâarriĂšre-plan</a> ;</li> - <li><strong>dans un script dâarriĂšre-plan</strong>, pour Ă©couter les messages dâun script de contenuâŻ;</li> - <li><strong>dans une <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#options_pages">page dâoptions</a> ou un script de <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/User_interface_components#popups">popup</a></strong>, pour Ă©couter les messages dâun script dâarriĂšre-planâŻ;</li> - <li><strong>dans un script dâarriĂšre-plan</strong>, pour Ă©couter les messages dâune page dâoptions ou dâun script de popup.</li> -</ul> +- **dans un [script de contenu](/fr/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#content_scripts)**, pour Ă©couter les messages dâun [script dâarriĂšre-plan](/fr/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#background_scripts) ; +- **dans un script dâarriĂšre-plan**, pour Ă©couter les messages dâun script de contenuâŻ; +- **dans une [page dâoptions](/fr/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#options_pages) ou un script de [popup](/fr/docs/Mozilla/Add-ons/WebExtensions/User_interface_components#popups)**, pour Ă©couter les messages dâun script dâarriĂšre-planâŻ; +- **dans un script dâarriĂšre-plan**, pour Ă©couter les messages dâune page dâoptions ou dâun script de popup. -<p>Pour envoyer un message reçu par l'Ă©couteur <code>onMessage</code>, utilisez {{WebExtAPIRef("runtime.sendMessage()")}} ou (pour envoyer un message Ă un script de contenu) {{WebExtAPIRef("tabs.sendMessage()")}}.</p> +Pour envoyer un message reçu par l'Ă©couteur `onMessage`, utilisez {{WebExtAPIRef("runtime.sendMessage()")}} ou (pour envoyer un message Ă un script de contenu) {{WebExtAPIRef("tabs.sendMessage()")}}. -<div class="note"> -<p><strong>Note :</strong> Ăvitez de crĂ©er plusieurs Ă©couteurs <code>onMessage</code> pour le mĂȘme type de message, car l'ordre de dĂ©clenchement des diffĂ©rents Ă©couteurs ne sera pas garanti.</p> +> **Note :** Ăvitez de crĂ©er plusieurs Ă©couteurs `onMessage` pour le mĂȘme type de message, car l'ordre de dĂ©clenchement des diffĂ©rents Ă©couteurs ne sera pas garanti. +> +> Lorsque vous voulez garantir la livraison d'un message Ă une terminaison spĂ©cifique, utilisez l'[approche basĂ©e sur la connexion pour Ă©changer des messages](/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#les_messages_en_flux_continu). -<p>Lorsque vous voulez garantir la livraison d'un message Ă une terminaison spĂ©cifique, utilisez l'<a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#les_messages_en_flux_continu">approche basĂ©e sur la connexion pour Ă©changer des messages</a>.</p> -</div> +En plus du message, lâĂ©couteur reçoit en paramĂštresâŻ: -<p>En plus du message, lâĂ©couteur reçoit en paramĂštresâŻ:</p> +- Un objet `sender` donnant les dĂ©tails sur lâexpĂ©diteur du messageâŻ; +- Une fonction `sendResponse()` qui peut ĂȘtre utilisĂ©e pour renvoyer une rĂ©ponse Ă l'expĂ©diteur. -<ul> - <li>Un objet <code>sender</code> donnant les dĂ©tails sur lâexpĂ©diteur du messageâŻ;</li> - <li>Une fonction <code>sendResponse()</code> qui peut ĂȘtre utilisĂ©e pour renvoyer une rĂ©ponse Ă l'expĂ©diteur.</li> -</ul> +Vous pouvez envoyer une rĂ©ponse synchrone au message en appelant la fonction `sendResponse()` dans votre Ă©couteur. [Voir un exemple](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage#sending_a_synchronous_response). -<p>Vous pouvez envoyer une rĂ©ponse synchrone au message en appelant la fonction <code>sendResponse()</code> dans votre Ă©couteur. <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage#sending_a_synchronous_response">Voir un exemple</a>.</p> +Pour envoyer une rĂ©ponse asynchrone, il existe deux optionsâŻ: -<p>Pour envoyer une rĂ©ponse asynchrone, il existe deux optionsâŻ:</p> +- Renvoyer `true` Ă partir de lâĂ©couteur dâĂ©vĂ©nement. Cela permet de conserver la fonction `sendResponse()` aprĂšs le retour de lâĂ©couteur pour Ă©ventuellement l'appeler plus tard. [Voir un exemple](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage#sending_an_asynchronous_response_using_sendresponse). +- Renvoyer une `Promise` depuis lâĂ©couteur dâĂ©vĂ©nement, et la rĂ©soudre lorsque vous avez la rĂ©ponse (ou la rejeter en cas dâerreur). [Voir un exemple](/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage#sending_an_asynchronous_response_using_a_promise). -<ul> - <li>Renvoyer <code>true</code> Ă partir de lâĂ©couteur dâĂ©vĂ©nement. Cela permet de conserver la fonction <code>sendResponse()</code> aprĂšs le retour de lâĂ©couteur pour Ă©ventuellement l'appeler plus tard. <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage#sending_an_asynchronous_response_using_sendresponse">Voir un exemple</a>.</li> - <li>Renvoyer une <code>Promise</code> depuis lâĂ©couteur dâĂ©vĂ©nement, et la rĂ©soudre lorsque vous avez la rĂ©ponse (ou la rejeter en cas dâerreur). <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage#sending_an_asynchronous_response_using_a_promise">Voir un exemple</a>.</li> -</ul> +> **Attention :** Retourner une promesse ([`Promise`](fr/docs/Web/JavaScript/Reference/Global_Objects/Promise)) est dĂ©sormais la mĂ©thode Ă privilĂ©gier car `sendResponse()` [sera retirĂ©e de la spĂ©cification W3C](https://github.com/mozilla/webextension-polyfill/issues/16#issuecomment-296693219). +> +> La bibliothĂšque populaire [webextension-polyfill](https://github.com/mozilla/webextension-polyfill) a dĂ©jĂ supprimĂ© cette fonction de son implĂ©mentation. -<div class="warning"> -<p><strong>Attention :</strong> Retourner une promesse (<a href="fr/docs/Web/JavaScript/Reference/Global_Objects/Promise"><code>Promise</code></a>) est dĂ©sormais la mĂ©thode Ă privilĂ©gier car <code>sendResponse()</code> <a href="https://github.com/mozilla/webextension-polyfill/issues/16#issuecomment-296693219">sera retirĂ©e de la spĂ©cification W3C</a>.</p> +> **Note :** Vous pouvez Ă©galement utiliser une [approche basĂ©e sur la connexion pour Ă©changer des messages](/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#connection-based_messaging). -<p>La bibliothĂšque populaire <a href="https://github.com/mozilla/webextension-polyfill">webextension-polyfill</a> a dĂ©jĂ supprimĂ© cette fonction de son implĂ©mentation.</p> -</div> +## Syntaxe -<div class="note"> -<p><strong>Note :</strong> Vous pouvez Ă©galement utiliser une <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#connection-based_messaging">approche basĂ©e sur la connexion pour Ă©changer des messages</a>.</p> -</div> +```js +browser.runtime.onMessage.addListener(listener) +browser.runtime.onMessage.removeListener(listener) +browser.runtime.onMessage.hasListener(listener) +``` -<h2 id="Syntaxe">Syntaxe</h2> +Les Ă©vĂ©nements ont trois fonctionsâŻ: -<pre class="brush:js">browser.runtime.onMessage.addListener(<var>listener</var>) -browser.runtime.onMessage.removeListener(<var>listener</var>) -browser.runtime.onMessage.hasListener(<var>listener</var>) -</pre> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : Cesse dâĂ©couter cet Ă©vĂ©nement. Lâargument `listener` est lâĂ©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si un `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Retourne `true` sâil Ă©coute, `false` sinon. -<p>Les Ă©vĂ©nements ont trois fonctionsâŻ:</p> +## Syntaxe de addListener -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>Cesse dâĂ©couter cet Ă©vĂ©nement. Lâargument <code>listener</code> est lâĂ©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Retourne <code>true</code> sâil Ă©coute, <code>false</code> sinon.</dd> -</dl> +### ParamĂštres -<h2 id="Syntaxe_de_addListener">Syntaxe de addListener</h2> +- _`listener`_ -<h3 id="ParamĂštres">ParamĂštres</h3> + - : Une fonction dâĂ©coute qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction recevra les arguments suivantsâŻ: -<dl> - <dt><em><code>listener</code></em></dt> - <dd> - <p>Une fonction dâĂ©coute qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction recevra les arguments suivantsâŻ:</p> + - _`message`_ + - : Un objet qui est le message lui-mĂȘme. Câest un objet sĂ©rialisable (voir [l'algorithme de clonage de donnĂ©es](/fr/docs/Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities#data_cloning_algorithm)). - <dl> - <dt><em><code>message</code></em></dt> - <dd>Un objet qui est le message lui-mĂȘme. Câest un objet sĂ©rialisable (voir <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities#data_cloning_algorithm">l'algorithme de clonage de donnĂ©es</a>).</dd> - </dl> + <!----> - <dl> - <dt><em><code>sender</code></em></dt> - <dd>Un objet {{WebExtAPIRef("runtime.MessageSender")}} reprĂ©sentant lâexpĂ©diteur du message.</dd> - </dl> + - _`sender`_ + - : Un objet {{WebExtAPIRef("runtime.MessageSender")}} reprĂ©sentant lâexpĂ©diteur du message. - <dl> - <dt><code>s<em>endResponse</em></code></dt> - <dd> - <p>Une fonction Ă appeler, au plus une fois, pour envoyer une rĂ©ponse au <code><var>message</var></code>. La fonction prend un seul argument, qui peut ĂȘtre n'importe quel objet sĂ©rialisable (voir <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities#data_cloning_algorithm">l'algorithme de clonage de donnĂ©es</a>). Cet argument est renvoyĂ© Ă l'expĂ©diteur du message.</p> + <!----> - <p>Si vous avez plus d'un Ă©couteur <code>onMessage()</code> dans le mĂȘme document, alors un seul peut envoyer une rĂ©ponse.</p> + - `sendResponse` - <p>Pour envoyer une rĂ©ponse de maniĂšre synchrone, appelez <code>sendResponse()</code> avant le retour de la fonction d'Ă©coute.</p> + - : Une fonction Ă appeler, au plus une fois, pour envoyer une rĂ©ponse au `message`. La fonction prend un seul argument, qui peut ĂȘtre n'importe quel objet sĂ©rialisable (voir [l'algorithme de clonage de donnĂ©es](/fr/docs/Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities#data_cloning_algorithm)). Cet argument est renvoyĂ© Ă l'expĂ©diteur du message. - <p>Pour envoyer une rĂ©ponse de maniĂšre asynchrone :</p> + Si vous avez plus d'un Ă©couteur `onMessage()` dans le mĂȘme document, alors un seul peut envoyer une rĂ©ponse. - <ul> - <li>soit on gardera une rĂ©fĂ©rence Ă l'argument <code>sendResponse()</code> et on retournera <code>true</code> depuis la fonction listenener. <code>sendResponse()</code> pourra ĂȘtre appelĂ©e aprĂšs le retour de la fonction d'Ă©coute.</li> - <li>ou on retournera {{jsxref("Promise")}} Ă partir de la fonction d'Ă©coute et on rĂ©soudra la promesse lorsque la rĂ©ponse sera prĂȘte. C'est la mĂ©thode Ă privilĂ©gier.</li> - </ul> - </dd> - </dl> + Pour envoyer une rĂ©ponse de maniĂšre synchrone, appelez `sendResponse()` avant le retour de la fonction d'Ă©coute. - <p>La fonction <code><var>listener</var></code> peut renvoyer un boolĂ©en ou une {{jsxref("Promise")}}.</p> + Pour envoyer une rĂ©ponse de maniĂšre asynchrone : - <div class="note"> - <p><strong>Note :</strong> N'appelez pas <code>addListener()</code> en utilisant une fonction <code>async</code> :</p> + - soit on gardera une rĂ©fĂ©rence Ă l'argument `sendResponse()` et on retournera `true` depuis la fonction listenener. `sendResponse()` pourra ĂȘtre appelĂ©e aprĂšs le retour de la fonction d'Ă©coute. + - ou on retournera {{jsxref("Promise")}} Ă partir de la fonction d'Ă©coute et on rĂ©soudra la promesse lorsque la rĂ©ponse sera prĂȘte. C'est la mĂ©thode Ă privilĂ©gier. - <pre class="brush: js example-bad">// ne faites pas ça -browser.runtime.onMessage.addListener( - async (data, sender) => { - if (data.type === 'handle_me') { return 'done'; } - } -); -</pre> - - <p>L'Ă©couteur consommera ainsi chaque message qu'il reçoit, ce qui empĂȘchera effectivement tous les autres Ă©couteurs de recevoir et de traiter des messages.</p> + La fonction `listener` peut renvoyer un boolĂ©en ou une {{jsxref("Promise")}}. - <p>Si vous souhaitez adopter une approche asynchrone, utilisez plutĂŽt une <code>Promise</code>, comme ceci :</p> - - <pre class="brush: js example-good">browser.runtime.onMessage.addListener( - (data, sender) => { - if (data.type === 'handle_me') { - return Promise.resolve('done'); - } - } -); -</pre> - </div> - </dd> -</dl> + > **Note :** N'appelez pas `addListener()` en utilisant une fonction `async` : + > + > ```js example-bad + > // ne faites pas ça + > browser.runtime.onMessage.addListener( + > async (data, sender) => { + > if (data.type === 'handle_me') { return 'done'; } + > } + > ); + > ``` + > + > L'Ă©couteur consommera ainsi chaque message qu'il reçoit, ce qui empĂȘchera effectivement tous les autres Ă©couteurs de recevoir et de traiter des messages. + > + > Si vous souhaitez adopter une approche asynchrone, utilisez plutĂŽt une `Promise`, comme ceci : + > + > ```js example-good + > browser.runtime.onMessage.addListener( + > (data, sender) => { + > if (data.type === 'handle_me') { + > return Promise.resolve('done'); + > } + > } + > ); + > ``` -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> +## CompatibilitĂ© des navigateurs -<p>{{Compat("webextensions.api.runtime.onMessage")}}</p> +{{Compat("webextensions.api.runtime.onMessage")}} -<h2 id="Examples">Exemples</h2> +## Exemples -<h3 id="Simple_example">Exemple simple</h3> +### Exemple simple -<p>Ce script de contenu Ă©coute les Ă©vĂ©nements clic dans la page web. Si le clic a eu lieu sur un lien, il envoie un message Ă la page dâarriĂšre-plan avec lâURL cibleâŻ:</p> +Ce script de contenu Ă©coute les Ă©vĂ©nements clic dans la page web. Si le clic a eu lieu sur un lien, il envoie un message Ă la page dâarriĂšre-plan avec lâURL cibleâŻ: -<pre class="brush: js">// content-script.js +```js +// content-script.js window.addEventListener("click", notifyExtension); @@ -163,11 +143,13 @@ function notifyExtension(e) { return; } browser.runtime.sendMessage({"url": e.target.href}); -}</pre> +} +``` -<p>Le script dâarriĂšre-plan Ă©coute ces messages et affiche une notification Ă lâaide de lâAPI <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/notifications">notifications</a></code>.</p> +Le script dâarriĂšre-plan Ă©coute ces messages et affiche une notification Ă lâaide de lâAPI [`notifications`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/notifications). -<pre class="brush: js">// background-script.js +```js +// background-script.js browser.runtime.onMessage.addListener(notify); @@ -178,13 +160,15 @@ function notify(message) { "title": "Vous avez cliquĂ© sur un lien !", "message": message.url }); -}</pre> +} +``` -<h3 id="Sending_a_synchronous_response">Envoyer une rĂ©ponse synchrone</h3> +### Envoyer une rĂ©ponse synchrone -<p>Le script de contenu suivant envoie un message au script dâarriĂšre-plan lorsque lâutilisateur ou lâutilisatrice clique sur la page. Il enregistre Ă©galement toute rĂ©ponse envoyĂ©e par le script dâarriĂšre-planâŻ:</p> +Le script de contenu suivant envoie un message au script dâarriĂšre-plan lorsque lâutilisateur ou lâutilisatrice clique sur la page. Il enregistre Ă©galement toute rĂ©ponse envoyĂ©e par le script dâarriĂšre-planâŻ: -<pre class="brush: js">// content-script.js +```js +// content-script.js function handleResponse(message) { console.log(`le script dâarriĂšre-plan a rĂ©pondu : ${message.response}`); @@ -199,51 +183,59 @@ function sendMessage(e) { sending.then(handleResponse, handleError); } -window.addEventListener("click", sendMessage);</pre> +window.addEventListener("click", sendMessage); +``` -<p>Voici une version du script dâarriĂšre-plan correspondant, qui envoie une rĂ©ponse de maniĂšre synchrone depuis lâintĂ©rieur de lâĂ©couteurâŻ:</p> +Voici une version du script dâarriĂšre-plan correspondant, qui envoie une rĂ©ponse de maniĂšre synchrone depuis lâintĂ©rieur de lâĂ©couteurâŻ: -<pre class="brush: js">// background-script.js +```js +// background-script.js function handleMessage(request, sender, sendResponse) { console.log(`le script de contenu a envoyĂ© un message : ${request.content}`); sendResponse({response: "rĂ©ponse du script dâarriĂšre-plan"}); } -browser.runtime.onMessage.addListener(handleMessage);</pre> +browser.runtime.onMessage.addListener(handleMessage); +``` -<p>Et voici une autre version, qui utilise {{jsxref("Promise.resolve()")}}âŻ:</p> +Et voici une autre version, qui utilise {{jsxref("Promise.resolve()")}}âŻ: -<pre class="brush: js">// background-script.js +```js +// background-script.js function handleMessage(request, sender, sendResponse) { console.log(`le script de contenu a envoyĂ© un message : ${request.content}`); return Promise.resolve({response: "rĂ©ponse du script dâarriĂšre-plan"}); } -browser.runtime.onMessage.addListener(handleMessage);</pre> +browser.runtime.onMessage.addListener(handleMessage); +``` -<h3 id="Sending_an_asynchronous_response_using_sendResponse">Envoi dâune rĂ©ponse asynchrone Ă lâaide de sendResponse</h3> +### Envoi dâune rĂ©ponse asynchrone Ă lâaide de sendResponse -<p>Voici une autre version du script dâarriĂšre-plan de lâexemple prĂ©cĂ©dent. Il envoie une rĂ©ponse de maniĂšre asynchrone, aprĂšs le retour de lâĂ©couteur. Remarquez le <code>return true;</code> dans lâĂ©couteurâŻ: cela indique au navigateur que vous avez lâintention dâutiliser lâargument <code>sendResponse()</code> aprĂšs le retour de lâĂ©couteur.</p> +Voici une autre version du script dâarriĂšre-plan de lâexemple prĂ©cĂ©dent. Il envoie une rĂ©ponse de maniĂšre asynchrone, aprĂšs le retour de lâĂ©couteur. Remarquez le `return true;` dans lâĂ©couteurâŻ: cela indique au navigateur que vous avez lâintention dâutiliser lâargument `sendResponse()` aprĂšs le retour de lâĂ©couteur. -<pre class="brush: js">// background-script.js +```js +// background-script.js function handleMessage(request, sender, sendResponse) { console.log(`le script de contenu a envoyĂ© un message : ${request.content}`); - setTimeout(() => { + setTimeout(() => { sendResponse({response: "rĂ©ponse asynchrone du script dâarriĂšre-plan"}); }, 1000); return true; } -browser.runtime.onMessage.addListener(handleMessage);</pre> +browser.runtime.onMessage.addListener(handleMessage); +``` -<h3 id="Sending_an_asynchronous_response_using_a_Promise">Envoi dâune rĂ©ponse asynchrone Ă lâaide dâune promesse</h3> +### Envoi dâune rĂ©ponse asynchrone Ă lâaide dâune promesse -<p>Ce script de contenu reçoit le premier lien <code><a></code> dans la page, et envoie un message demandant si lâemplacement du lien fait partie des marque-pages. Il attend comme rĂ©ponse un {{jsxref("Boolean", "boolĂ©en")}}âŻ: <code>true</code> si lâemplacement est dans les marque-pages, <code>false</code> sinon.</p> +Ce script de contenu reçoit le premier lien `<a>` dans la page, et envoie un message demandant si lâemplacement du lien fait partie des marque-pages. Il attend comme rĂ©ponse un {{jsxref("Boolean", "boolĂ©en")}}âŻ: `true` si lâemplacement est dans les marque-pages, `false` sinon. -<pre class="brush: js">// content-script.js +```js +// content-script.js const firstLink = document.querySelector("a"); @@ -255,47 +247,50 @@ function handleResponse(isBookmarked) { browser.runtime.sendMessage({ url: firstLink.href -}).then(handleResponse);</pre> +}).then(handleResponse); +``` -<p>Voici le script dâarriĂšre-plan. Il utilise <code>{{WebExtAPIRef("bookmarks.search()")}}</code> pour voir si le lien est dans les marque-pages, ce qui renvoie une {{jsxref("Promise", "promesse")}}âŻ:</p> +Voici le script dâarriĂšre-plan. Il utilise `{{WebExtAPIRef("bookmarks.search()")}}` pour voir si le lien est dans les marque-pages, ce qui renvoie une {{jsxref("Promise", "promesse")}}âŻ: -<pre class="brush: js">// background-script.js +```js +// background-script.js function isBookmarked(message, sender, response) { return browser.bookmarks.search({ url: message.url }).then(function(results) { - return results.length > 0; + return results.length > 0; }); } -browser.runtime.onMessage.addListener(isBookmarked);</pre> +browser.runtime.onMessage.addListener(isBookmarked); +``` -<p>Si le gestionnaire asynchrone ne renvoie pas de promesse, vous pouvez explicitement construire une promesse. Cet exemple plutĂŽt artificiel envoie une rĂ©ponse aprĂšs un dĂ©lai dâune seconde, en utilisant <code><a href="/fr/docs/Web/API/WindowOrWorkerGlobalScope/setTimeout">Window.setTimeout()</a></code>âŻ:</p> +Si le gestionnaire asynchrone ne renvoie pas de promesse, vous pouvez explicitement construire une promesse. Cet exemple plutĂŽt artificiel envoie une rĂ©ponse aprĂšs un dĂ©lai dâune seconde, en utilisant [`Window.setTimeout()`](/fr/docs/Web/API/WindowOrWorkerGlobalScope/setTimeout)âŻ: -<pre class="brush: js">// background-script.js +```js +// background-script.js function handleMessage(request, sender, sendResponse) { - return new Promise(resolve => { - setTimeout(() => { + return new Promise(resolve => { + setTimeout(() => { resolve({response: "rĂ©ponse asynchrone du script dâarriĂšre-plan"}); }, 1000); }); } -browser.runtime.onMessage.addListener(handleMessage);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.runtime.onMessage.addListener(handleMessage); +``` -<p>Cette API est basĂ©e sur lâAPI Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -322,5 +317,4 @@ browser.runtime.onMessage.addListener(handleMessage);</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/runtime/onmessageexternal/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessageexternal/index.md index 497fcab12a..4438204323 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessageexternal/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onmessageexternal/index.md @@ -13,97 +13,83 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onMessageExternal --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Utilisez cet Ă©vĂ©nement pour Ă©couter les messages d'une autre extension. -<div> -<div>Utilisez cet Ă©vĂ©nement pour Ă©couter les messages d'une autre extension.</div> +Pour envoyer un message qui sera reçu par le module d'Ă©coute `onMessageExternal`, utilisez {{WebExtAPIRef("runtime.sendMessage()")}}, en transmettant l'ID du destinataire dans le paramĂštre `extensionId`. -<div></div> +Avec le message lui-mĂȘme, l'Ă©couteur est transmis : -<p>Pour envoyer un message qui sera reçu par le module d'Ă©coute <code>onMessageExternal</code>, utilisez {{WebExtAPIRef("runtime.sendMessage()")}}, en transmettant l'ID du destinataire dans le paramĂštre <code>extensionId</code>.</p> +- un objet `sender` donnant des dĂ©tails sur l'expĂ©diteur du message +- une fonction `sendResponse` qu'elle peut utiliser pour renvoyer une rĂ©ponse Ă l'expĂ©diteur. -<p>Avec le message lui-mĂȘme, l'Ă©couteur est transmis :</p> +Cette API ne peut pas ĂȘtre utilisĂ©e dans un script de contenu. -<ul> - <li>un objet <code>sender</code> donnant des dĂ©tails sur l'expĂ©diteur du message</li> - <li>une fonction <code>sendResponse</code> qu'elle peut utiliser pour renvoyer une rĂ©ponse Ă l'expĂ©diteur.</li> -</ul> -</div> +## Syntax -<p>Cette API ne peut pas ĂȘtre utilisĂ©e dans un script de contenu.</p> - -<h2 id="Syntax">Syntax</h2> - -<pre class="brush: js">browser.runtime.onMessageExternal.addListener() +```js +browser.runtime.onMessageExternal.addListener() browser.runtime.onMessageExternal.removeListener(listener) browser.runtime.onMessageExternal.hasListener(listener) -</pre> +``` + +Les Ă©vĂ©nements ont trois fonctions: + +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si un `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, `false` sinon. -<p>Les Ă©vĂ©nements ont trois fonctions:</p> +## Syntaxe addListener -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, <code>false</code> sinon.</dd> -</dl> +### ParamĂštres -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +- `function` -<h3 id="ParamĂštres">ParamĂštres</h3> + - : Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction recevra les arguments suivants : -<dl> - <dt><code>function</code></dt> - <dd> - <p>Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction recevra les arguments suivants :</p> + - `message` + - : `object`. Le message lui-mĂȘme. C'est un objet JSON-ifiable. - <dl> - <dt><code>message</code></dt> - <dd><code>object</code>. Le message lui-mĂȘme. C'est un objet JSON-ifiable.</dd> - </dl> + <!----> - <dl> - <dt><code>sender</code></dt> - <dd>Un objet {{WebExtAPIRef('runtime.MessageSender')}} reprĂ©sentant l'expĂ©diteur du message.</dd> - </dl> + - `sender` + - : Un objet {{WebExtAPIRef('runtime.MessageSender')}} reprĂ©sentant l'expĂ©diteur du message. - <dl> - <dt><code>sendResponse</code></dt> - <dd> - <p>Une fonction Ă appeler, au plus une fois, pour envoyer une rĂ©ponse au message. La fonction prend un seul argument, qui peut ĂȘtre n'importe quel objet JSON-ifiable. Cet argument est renvoyĂ© Ă l'expĂ©diteur du message.</p> + <!----> - <p>Si vous avez plus d'un Ă©couteur <code>onMessageExternal</code> dans le mĂȘme document, un seul peut envoyer une rĂ©ponse.</p> + - `sendResponse` - <p>To send a response synchronously, call <code>sendResponse</code> before the listener function returns. To send a response asynchronously:</p> + - : Une fonction Ă appeler, au plus une fois, pour envoyer une rĂ©ponse au message. La fonction prend un seul argument, qui peut ĂȘtre n'importe quel objet JSON-ifiable. Cet argument est renvoyĂ© Ă l'expĂ©diteur du message. - <ul> - <li>Soit garder une rĂ©fĂ©rence Ă l'argumen <code>sendResponse</code> et retourne <code>true</code> Ă partir de la fonction d'Ă©couteur. Vous pourrez ensuite appeler <code>sendResponse</code> aprĂšs le retour de la fonction d'Ă©couteur..</li> - <li>ou retourne une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> de la fonction d'Ă©couteur et rĂ©soudre la promesse lorsque la rĂ©ponse est prĂȘte.</li> - </ul> - </dd> - </dl> - </dd> -</dl> + Si vous avez plus d'un Ă©couteur `onMessageExternal` dans le mĂȘme document, un seul peut envoyer une rĂ©ponse. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + To send a response synchronously, call `sendResponse` before the listener function returns. To send a response asynchronously: -<p>{{Compat("webextensions.api.runtime.onMessageExternal")}}</p> + - Soit garder une rĂ©fĂ©rence Ă l'argumen `sendResponse` et retourne `true` Ă partir de la fonction d'Ă©couteur. Vous pourrez ensuite appeler `sendResponse` aprĂšs le retour de la fonction d'Ă©couteur.. + - ou retourne une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) de la fonction d'Ă©couteur et rĂ©soudre la promesse lorsque la rĂ©ponse est prĂȘte. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Dans cet exemple, l'extension "blue@mozilla.org" envoie un message à l'extension "red@mozilla.org":</p> +{{Compat("webextensions.api.runtime.onMessageExternal")}} -<pre class="brush: js">// sender: browser.runtime.id == "blue@mozilla.org" +## Exemples + +Dans cet exemple, l'extension "blue\@mozilla.org" envoie un message à l'extension "red\@mozilla.org": + +```js +// sender: browser.runtime.id == "blue@mozilla.org" // Send a message to the extension whose ID is "red@mozilla.org" browser.runtime.sendMessage( "red@mozilla.org", "my message" - );</pre> + ); +``` -<pre class="brush: js">// recipient: browser.runtime.id == "red@mozilla.org" +```js +// recipient: browser.runtime.id == "red@mozilla.org" function handleMessage(message, sender) { // check that the message is from "blue@mozilla.org" @@ -112,19 +98,18 @@ function handleMessage(message, sender) { } } -browser.runtime.onMessageExternal.addListener(handleMessage);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.runtime.onMessageExternal.addListener(handleMessage); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -151,5 +136,4 @@ browser.runtime.onMessageExternal.addListener(handleMessage);</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/runtime/onrestartrequired/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequired/index.md index 117554432e..686679465f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequired/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequired/index.md @@ -13,61 +13,53 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onRestartRequired --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'une application ou le pĂ©riphĂ©rique sur lequel elle s'exĂ©cute doit ĂȘtre redĂ©marrĂ©. L'application devrait fermer toutes ses fenĂȘtres dans les meilleurs dĂ©lais pour permettre le redĂ©marrage. Si l'application ne fait rien, un redĂ©marrage sera appliquĂ© aprĂšs une pĂ©riode de grĂące de 24 heures. Actuellement, cet Ă©vĂ©nement est uniquement dĂ©clenchĂ© pour les applications de kiosque Chrome OS.</p> +LancĂ© lorsqu'une application ou le pĂ©riphĂ©rique sur lequel elle s'exĂ©cute doit ĂȘtre redĂ©marrĂ©. L'application devrait fermer toutes ses fenĂȘtres dans les meilleurs dĂ©lais pour permettre le redĂ©marrage. Si l'application ne fait rien, un redĂ©marrage sera appliquĂ© aprĂšs une pĂ©riode de grĂące de 24 heures. Actuellement, cet Ă©vĂ©nement est uniquement dĂ©clenchĂ© pour les applications de kiosque Chrome OS. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.runtime.onRestartRequired.addListener(listener) +```js +browser.runtime.onRestartRequired.addListener(listener) browser.runtime.onRestartRequired.removeListener(listener) browser.runtime.onRestartRequired.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>Ajouter un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, <code>false</code> sinon.</dd> -</dl> +- `addListener(callback)` + - : Ajouter un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si un `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, `false` sinon. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>fonction </code></dt> - <dd> - <p>Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction recevra les arguments suivants :</p> +- `fonction` - <dl> - <dt><code>raison</code></dt> - <dd>Une valeur {{WebExtAPIRef('runtime.OnRestartRequiredReason')}} â La raison pour laquelle l'Ă©vĂ©nemtn est envoyĂ©.</dd> - </dl> - </dd> -</dl> + - : Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `raison` + - : Une valeur {{WebExtAPIRef('runtime.OnRestartRequiredReason')}} â La raison pour laquelle l'Ă©vĂ©nemtn est envoyĂ©. -<p>{{Compat("webextensions.api.runtime.onRestartRequired")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.runtime.onRestartRequired")}} -<p>{{WebExtExamples}}</p> +## Exemples -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.json</code></a> dans le code de Chromium code.</p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -94,5 +86,4 @@ browser.runtime.onRestartRequired.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/runtime/onrestartrequiredreason/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequiredreason/index.md index 4f7806847c..ea09c4206a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequiredreason/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onrestartrequiredreason/index.md @@ -13,35 +13,31 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/OnRestartRequiredReason --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La raison pour laquelle l'Ă©vĂ©nement {{WebExtAPIRef("runtime.onRestartRequired", "onRestartRequired")}} est en cours d'exĂ©cution.</p> +La raison pour laquelle l'Ă©vĂ©nement {{WebExtAPIRef("runtime.onRestartRequired", "onRestartRequired")}} est en cours d'exĂ©cution. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<ul> - <li><code>"app_update"</code>: L'application en cours de mise Ă jour vers une version plus rĂ©cente.</li> - <li><code>"os_update"</code>: Le navigateur / SystĂšme d'exploitation est mise Ă jour vers une nouvelle verion plus rĂ©cente.</li> - <li><code>"periodic"</code>: Le systĂšme a fonctionnĂ© pendant plus logntemps que la durĂ©e de disponibilitĂ© autorisĂ©e dans la stratĂ©gie d'entreprise.</li> -</ul> +- `"app_update"`: L'application en cours de mise Ă jour vers une version plus rĂ©cente. +- `"os_update"`: Le navigateur / SystĂšme d'exploitation est mise Ă jour vers une nouvelle verion plus rĂ©cente. +- `"periodic"`: Le systĂšme a fonctionnĂ© pendant plus logntemps que la durĂ©e de disponibilitĂ© autorisĂ©e dans la stratĂ©gie d'entreprise. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.OnRestartRequiredReason")}}</p> +{{Compat("webextensions.api.runtime.OnRestartRequiredReason")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -68,5 +64,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/OnRestartRequiredReaso // 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/runtime/onstartup/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onstartup/index.md index 039bb149a4..11c53d6e58 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onstartup/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onstartup/index.md @@ -13,57 +13,55 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onStartup --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© quand un profil ayant cette extension installĂ©e dĂ©marre une session. Cet Ă©vĂ©nement n'est pas dĂ©clenchĂ© lorsqu'une navigation privĂ©e / profil privĂ© est dĂ©marrĂ©, mĂȘme si cette extension fonctionne en mode de navigation privĂ©e 'split'.</p> +LancĂ© quand un profil ayant cette extension installĂ©e dĂ©marre une session. Cet Ă©vĂ©nement n'est pas dĂ©clenchĂ© lorsqu'une navigation privĂ©e / profil privĂ© est dĂ©marrĂ©, mĂȘme si cette extension fonctionne en mode de navigation privĂ©e 'split'. -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.runtime.onStartup.addListener(listener) +```js +browser.runtime.onStartup.addListener(listener) browser.runtime.onStartup.removeListener(listener) browser.runtime.onStartup.hasListener(listener) -</pre> +``` -<h3 id="event_functions">Fonctions des Ă©vĂ©nements</h3> +### Fonctions des Ă©vĂ©nements -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un Ă©couteur Ă Ă©couteur.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘte d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>Ă©couteur</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă Ă©couteur. +- `removeListener(listener)` + - : ArrĂȘte d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si un `Ă©couteur` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h3 id="parameters">Parameters</h3> +### Parameters -<dl> - <dt><code>callback</code></dt> - <dd>Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit.</dd> -</dl> +- `callback` + - : Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. -<h2 id="examples">Exemples</h2> +## Exemples -<p>Ouvre <a href="http://chilloutandwatchsomecatgifs.com/">http://chilloutandwatchsomecatgifs.com/</a> quand le navigateur dĂ©marre :</p> +Ouvre <http://chilloutandwatchsomecatgifs.com/> quand le navigateur dĂ©marre : -<pre class="brush: js">function handleStartup() { +```js +function handleStartup() { browser.tabs.create({ url: "http://chilloutandwatchsomecatgifs.com/" }); } -browser.runtime.onStartup.addListener(handleStartup);</pre> +browser.runtime.onStartup.addListener(handleStartup); +``` -<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/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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,9 +88,8 @@ browser.runtime.onStartup.addListener(handleStartup);</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> -<h2 id="browser_compatibility">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.onStartup")}}</p> +{{Compat("webextensions.api.runtime.onStartup")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspend/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspend/index.md index 28d601ead7..d1c0dd149c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspend/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspend/index.md @@ -13,69 +13,62 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onSuspend --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>EnvoyĂ© sur la page de l'Ă©vĂ©nement juste avant son dĂ©chargement. Cela donne Ă l'extension l'opportunitĂ© de faire un peu de nettoyage. Notez que, comme la page est en cours de dĂ©chargement, les opĂ©rations asynchrones dĂ©marrĂ©es lors de la gestion de cet Ă©vĂ©nement ne sont pas garanties.</p> +EnvoyĂ© sur la page de l'Ă©vĂ©nement juste avant son dĂ©chargement. Cela donne Ă l'extension l'opportunitĂ© de faire un peu de nettoyage. Notez que, comme la page est en cours de dĂ©chargement, les opĂ©rations asynchrones dĂ©marrĂ©es lors de la gestion de cet Ă©vĂ©nement ne sont pas garanties. -<div class="note"> -<p><strong>Note :</strong> Si quelque chose empĂȘche le dĂ©chargement de la page d'Ă©vĂ©nement, l'Ă©vĂ©nement {{WebExtAPIRef("runtime.onSuspendCanceled")}} sera envoyĂ© et la page ne sera pas dĂ©chargĂ©e.</p> -</div> +> **Note :** Si quelque chose empĂȘche le dĂ©chargement de la page d'Ă©vĂ©nement, l'Ă©vĂ©nement {{WebExtAPIRef("runtime.onSuspendCanceled")}} sera envoyĂ© et la page ne sera pas dĂ©chargĂ©e. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.runtime.onSuspend.addListener(listener) +```js +browser.runtime.onSuspend.addListener(listener) browser.runtime.onSuspend.removeListener(listener) browser.runtime.onSuspend.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>Ă©couteur</code> est enregistrĂ© pour cet Ă©vĂ©nement. Retourne <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si un `Ă©couteur` est enregistrĂ© pour cet Ă©vĂ©nement. Retourne `true` s'il est Ă©coutĂ©, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction dui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit</p> - </dd> -</dl> +- `callback` + - : Fonction dui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.onSuspend")}}</p> +{{Compat("webextensions.api.runtime.onSuspend")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ecoutez les Ă©vĂ©nements suspendus :</p> +Ecoutez les Ă©vĂ©nements suspendus : -<pre class="brush: js">function handleSuspend() { +```js +function handleSuspend() { console.log("Suspending event page"); // handle cleanup } -browser.runtime.onSuspend.addListener(handleSuspend);</pre> +browser.runtime.onSuspend.addListener(handleSuspend); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -102,5 +95,4 @@ browser.runtime.onSuspend.addListener(handleSuspend);</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/runtime/onsuspendcanceled/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspendcanceled/index.md index 1e38dbd73f..53ad367711 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspendcanceled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onsuspendcanceled/index.md @@ -13,64 +13,59 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onSuspendCanceled --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>EnvoyĂ© aprĂšs {{WebExtAPIRef("runtime.onSuspend")}} pour indiquer que l'application ne sera pas dĂ©chargĂ©e aprĂšs tout.</p> +EnvoyĂ© aprĂšs {{WebExtAPIRef("runtime.onSuspend")}} pour indiquer que l'application ne sera pas dĂ©chargĂ©e aprĂšs tout. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.runtime.onSuspendCanceled.addListener(listener) +```js +browser.runtime.onSuspendCanceled.addListener(listener) browser.runtime.onSuspendCanceled.removeListener(listener) browser.runtime.onSuspendCanceled.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>Ajouter un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est un Ă©couteur Ă suppriimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un <code>Ă©couteur</code> est enregistrĂ© pour cet Ă©vĂ©nement. Retourne <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajouter un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est un Ă©couteur Ă suppriimer. +- `hasListener(listener)` + - : VĂ©rifie si un `Ă©couteur` est enregistrĂ© pour cet Ă©vĂ©nement. Retourne `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit.</p> - </dd> -</dl> +- `callback` + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.onSuspendCanceled")}}</p> +{{Compat("webextensions.api.runtime.onSuspendCanceled")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ecoutez les Ă©vĂ©nements <code>SuspendCanceled</code> :</p> +Ecoutez les Ă©vĂ©nements `SuspendCanceled` : -<pre class="brush: js">function handleSuspendCanceled() { +```js +function handleSuspendCanceled() { console.log("Suspend canceled"); } -browser.runtime.onSuspendCanceled.addListener(handleSuspendCanceled);</pre> +browser.runtime.onSuspendCanceled.addListener(handleSuspendCanceled); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -97,5 +92,4 @@ browser.runtime.onSuspendCanceled.addListener(handleSuspendCanceled);</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/runtime/onupdateavailable/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/onupdateavailable/index.md index c30803e06f..3a4252657a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/onupdateavailable/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/onupdateavailable/index.md @@ -13,77 +13,69 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/onUpdateAvailable --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©clenchĂ© quand une mise Ă jour de l'extension est disponible. Cet Ă©vĂ©nement permet Ă une extension de retarder une mise Ă jour : par exemple, car elle est au milieu d'une opĂ©ration qui ne doit pas ĂȘtre interrompue.</p> +DĂ©clenchĂ© quand une mise Ă jour de l'extension est disponible. Cet Ă©vĂ©nement permet Ă une extension de retarder une mise Ă jour : par exemple, car elle est au milieu d'une opĂ©ration qui ne doit pas ĂȘtre interrompue. -<p>Si l'extension n'Ă©coute pas cet Ă©vĂ©nement lorsqu'une mise Ă jour est disponible, l'extension est rechargĂ©e immĂ©diatement et la mise Ă jour est appliquĂ©e. Si l'extension est Ă l'Ă©coute, la mise Ă jour sera appliquĂ©e la prochaine fois que l'extension sera rechargĂ©e. Cela arrive si :</p> +Si l'extension n'Ă©coute pas cet Ă©vĂ©nement lorsqu'une mise Ă jour est disponible, l'extension est rechargĂ©e immĂ©diatement et la mise Ă jour est appliquĂ©e. Si l'extension est Ă l'Ă©coute, la mise Ă jour sera appliquĂ©e la prochaine fois que l'extension sera rechargĂ©e. Cela arrive si : -<ul> - <li>Le navigateur est redĂ©marrĂ©</li> - <li>L'extension est dĂ©sactivĂ©e et rĂ©activĂ©e</li> - <li>L'extension se recharge explicitement en appelant {{WebExtAPIRef('runtime.reload()')}}.</li> -</ul> +- Le navigateur est redĂ©marrĂ© +- L'extension est dĂ©sactivĂ©e et rĂ©activĂ©e +- L'extension se recharge explicitement en appelant {{WebExtAPIRef('runtime.reload()')}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.runtime.onUpdateAvailable.addListener() +```js +browser.runtime.onUpdateAvailable.addListener() browser.runtime.onUpdateAvailable.removeListener(listener) browser.runtime.onUpdateAvailable.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>Ajouter un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument<code>listener</code> est un Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie que l'<code>Ă©couteur</code> est enregistrĂ© pour cet Ă©vĂ©nement. Retourne <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajouter un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument`listener` est un Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie que l'`Ă©couteur` est enregistrĂ© pour cet Ă©vĂ©nement. Retourne `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e quand cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>details</code></dt> - <dd><code>object</code>. Contient une seule propriĂ©tĂ©, une chaĂźne nommĂ©e <code>version</code>, qui reprĂ©sente le numĂ©ro de version de la mise Ă jour.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e quand cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `details` + - : `object`. Contient une seule propriĂ©tĂ©, une chaĂźne nommĂ©e `version`, qui reprĂ©sente le numĂ©ro de version de la mise Ă jour. -<p>{{Compat("webextensions.api.runtime.onUpdateAvailable")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.runtime.onUpdateAvailable")}} -<p>Ecoutez les Ă©vĂ©nements <code>UpdateAvailable</code>:</p> +## Exemples -<pre class="brush: js">function handleUpdateAvailable(details) { +Ecoutez les Ă©vĂ©nements `UpdateAvailable`: + +```js +function handleUpdateAvailable(details) { console.log(details.version); } -browser.runtime.onUpdateAvailable.addListener(handleUpdateAvailable);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.runtime.onUpdateAvailable.addListener(handleUpdateAvailable); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -110,5 +102,4 @@ browser.runtime.onUpdateAvailable.addListener(handleUpdateAvailable);</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/runtime/openoptionspage/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.md index 1c83d24be8..85034e0d22 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/openoptionspage/index.md @@ -3,36 +3,34 @@ title: runtime.openOptionsPage() slug: Mozilla/Add-ons/WebExtensions/API/runtime/openOptionsPage translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/openOptionsPage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Si votre extension a dĂ©fini une [page d'options](/fr/Add-ons/WebExtensions/user_interface/Options_pages), cette mĂ©thode l'ouvre. -<div>Si votre extension a dĂ©fini une <a href="/fr/Add-ons/WebExtensions/user_interface/Options_pages">page d'options</a>, cette mĂ©thode l'ouvre.</div> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<div></div> +## Syntaxe -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +```js +var openingPage = browser.runtime.openOptionsPage() +``` -<h2 id="Syntaxe">Syntaxe</h2> +### ParamĂštres -<pre class="brush: js">var openingPage = browser.runtime.openOptionsPage() -</pre> +None. -<h3 id="ParamĂštres">ParamĂštres</h3> +### valeur retournĂ©e -<p>None.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque la page d'options a Ă©tĂ© crĂ©Ă©e avec succĂ©s, ou rejetĂ©e avec un message d'erreur si l'opĂ©ration a Ă©chouĂ©. -<h3 id="valeur_retournĂ©e">valeur retournĂ©e</h3> +## CompatibilitĂ© du navigateur -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans argument lorsque la page d'options a Ă©tĂ© crĂ©Ă©e avec succĂ©s, ou rejetĂ©e avec un message d'erreur si l'opĂ©ration a Ă©chouĂ©.</p> +{{Compat("webextensions.api.runtime.openOptionsPage")}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## Exemples -<p>{{Compat("webextensions.api.runtime.openOptionsPage")}}</p> +Ouvrez une page d'options lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur : -<h2 id="Exemples">Exemples</h2> - -<p>Ouvrez une page d'options lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur :</p> - -<pre class="brush: js">function onOpened() { +```js +function onOpened() { console.log(`Options page opened`); } @@ -41,19 +39,18 @@ function onError(error) { } var opening = browser.runtime.openOptionsPage(); -opening.then(onOpened, onError);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +opening.then(onOpened, onError); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -80,5 +77,4 @@ opening.then(onOpened, onError);</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/runtime/platformarch/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformarch/index.md index 8ae2611d5d..537d83b3f7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/platformarch/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformarch/index.md @@ -13,38 +13,34 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformArch --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'architecture du processeur de la machine.</p> +L'architecture du processeur de la machine. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possible sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possible sont : -<dl> - <dt><code>"arm"</code></dt> - <dd>La plateforme est basĂ©e sur l'architecture des bras.</dd> - <dt><code>"x86-32"</code></dt> - <dd>La plateforme est basĂ© sur l'architecture x86 32-bits.</dd> - <dt><code>"x86-64"</code></dt> - <dd>La plateforme est basĂ© sur l'architecture x86 64-bits.</dd> -</dl> +- `"arm"` + - : La plateforme est basĂ©e sur l'architecture des bras. +- `"x86-32"` + - : La plateforme est basĂ© sur l'architecture x86 32-bits. +- `"x86-64"` + - : La plateforme est basĂ© sur l'architecture x86 64-bits. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.PlatformArch")}}</p> +{{Compat("webextensions.api.runtime.PlatformArch")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -71,5 +67,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformArch // 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/runtime/platforminfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/platforminfo/index.md index 0955150051..b955aeb915 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/platforminfo/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/platforminfo/index.md @@ -13,38 +13,34 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformInfo --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet contenant des informations sur la plate-forme actuelle.</p> +Un objet contenant des informations sur la plate-forme actuelle. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets qui contiennent les propriĂ©tĂ©s suivantes:</p> +Les valeurs de ce type sont des objets qui contiennent les propriĂ©tĂ©s suivantes: -<dl> - <dt><code>os</code></dt> - <dd>{{WebExtAPIRef('runtime.PlatformOs')}}. Le systĂšme d'exploitation de la plateforme.</dd> - <dt><code>arch</code></dt> - <dd>{{WebExtAPIRef('runtime.PlatformArch')}}. L'architecture du processeur de la plateforme.</dd> - <dt><code>nacl_arch</code></dt> - <dd>{{WebExtAPIRef('runtime.PlatformNaclArch')}}. L'architecture du client natif Cela peut ĂȘtre diffĂ©rent de <code>arch</code> sur certaines plates-formes.</dd> -</dl> +- `os` + - : {{WebExtAPIRef('runtime.PlatformOs')}}. Le systĂšme d'exploitation de la plateforme. +- `arch` + - : {{WebExtAPIRef('runtime.PlatformArch')}}. L'architecture du processeur de la plateforme. +- `nacl_arch` + - : {{WebExtAPIRef('runtime.PlatformNaclArch')}}. L'architecture du client natif Cela peut ĂȘtre diffĂ©rent de `arch` sur certaines plates-formes. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.PlatformInfo")}}</p> +{{Compat("webextensions.api.runtime.PlatformInfo")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -71,5 +67,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformInfo // 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/runtime/platformnaclarch/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformnaclarch/index.md index 6ea89d7dca..754072f550 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/platformnaclarch/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformnaclarch/index.md @@ -13,29 +13,27 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformNaclArch --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>L'architecture du client natif. Cela peut-etre diffĂ©rent de arch sur certaines plate-formes.</p> +L'architecture du client natif. Cela peut-etre diffĂ©rent de arch sur certaines plate-formes. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de type sont des chaĂźnes. Les valeurs possible sont : <code>"arm"</code>, <code>"x86-32"</code>, <code>"x86-64"</code>.</p> +Les valeurs de type sont des chaĂźnes. Les valeurs possible sont : `"arm"`, `"x86-32"`, `"x86-64"`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.PlatformNaclArch")}}</p> +{{Compat("webextensions.api.runtime.PlatformNaclArch")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -62,5 +60,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformNaclArch // 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/runtime/platformos/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformos/index.md index d193759c72..6021637fe0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/platformos/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/platformos/index.md @@ -13,44 +13,40 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformOs --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le systĂšme d'exploitation sur lequel le navigateur fonctionne.</p> +Le systĂšme d'exploitation sur lequel le navigateur fonctionne. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont:</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont: -<dl> - <dt><code>"mac"</code></dt> - <dd>Le systĂšme d'exploitation est sous Mac OS X.</dd> - <dt><code>"win"</code></dt> - <dd>Le systĂšme d'exploitation est sous Windows.</dd> - <dt><code>"android"</code></dt> - <dd>Le systĂšme d'exploitation est sous Android.</dd> - <dt><code>"cros"</code></dt> - <dd>Le systĂšme d'exploitation est sous Chrome OS.</dd> - <dt><code>"linux"</code></dt> - <dd>Le systĂšme d'exploitation est sous Linux.</dd> - <dt><code>"openbsd"</code></dt> - <dd>Le systĂšme d'exploitation est sous Open/FreeBSD.</dd> -</dl> +- `"mac"` + - : Le systĂšme d'exploitation est sous Mac OS X. +- `"win"` + - : Le systĂšme d'exploitation est sous Windows. +- `"android"` + - : Le systĂšme d'exploitation est sous Android. +- `"cros"` + - : Le systĂšme d'exploitation est sous Chrome OS. +- `"linux"` + - : Le systĂšme d'exploitation est sous Linux. +- `"openbsd"` + - : Le systĂšme d'exploitation est sous Open/FreeBSD. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.PlatformOs")}}</p> +{{Compat("webextensions.api.runtime.PlatformOs")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -77,5 +73,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/PlatformOs // 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/runtime/port/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/port/index.md index 0d5f60172d..c79a6fb7db 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/port/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/port/index.md @@ -13,104 +13,76 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/Port --- -<div>{{AddonSidebar()}}</div> - -<p>Un objet <code>Port</code> represente une extrĂ©mitĂ© d'une connexion entre deux contextes spĂ©cifiques, qui peut-ĂȘtre utilisĂ©e pour Ă©changer des messages.</p> - -<p>Un cĂŽtĂ© initie la connexion Ă l'aide d'une API <code>connect()</code>. Cela retourne un objet <code>Port</code>. L'autre camp Ă©coute les tentatives de connexion Ă l'aide d'un Ă©couteur <code>onConnect</code>. Ceci est passĂ© un objet <code>Port</code> correspondant.</p> - -<p>Une fois que les deux cĂŽtĂ©s ont des objets <code>Port,</code> ils peuvent Ă©changer des messages JSON en utilisant <code>Port.postMessage()</code> et <code>Port.onMessage</code>. Quand ils sont terminĂ©s, chaque extrĂ©mitĂ© peut se dĂ©connecter en utilisant <code>Port.disconnect()</code>, ce qui gĂ©nĂ©rera un Ă©vĂ©nement <code>Port.onDisconnect</code> Ă l'autre extrĂ©mitĂ©, permettant Ă l'autre extrĂ©mitĂ© de faire le nettoyage requis.</p> - -<p>Vous pouvez utiliser ce modĂšle pour communiquer entre:</p> - -<ul> - <li>diffĂ©rentes parties de votre extension (par exemple, entre les <a href="/fr/Add-ons/WebExtensions/Content_scripts">scripts de contenus</a> et les <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts">scripts d'arriĂšre-plan</a>)</li> - <li>entre votre extension et une <a href="/fr/Add-ons/WebExtensions/Native_messaging">application native s'exĂ©utant sur l'ordinateur de l'utilisateur</a>.</li> - <li>entre votre extension et une extension diffĂ©rente</li> -</ul> - -<p>Vous devez utiliser diffĂ©rentes API de connexion pour diffĂ©rents types de connexions, comme indiquĂ© dans le tableau ci-dessous.</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">type de connection</th> - <th scope="col">Lancer une tentative de connexion</th> - <th scope="col">GĂ©rer la tentative de connexion</th> - </tr> - </thead> - <tbody> - <tr> - <td>Script d'arriĂšre-plan au script de contenu</td> - <td>{{WebExtAPIRef("tabs.connect()")}}</td> - <td>{{WebExtAPIRef("runtime.onConnect")}}</td> - </tr> - <tr> - <td>Script de contenu au script d'arriĂšre-plan</td> - <td>{{WebExtAPIRef("runtime.connect()")}}</td> - <td>{{WebExtAPIRef("runtime.onConnect")}}</td> - </tr> - <tr> - <td>Extension Ă l'application native</td> - <td>{{WebExtAPIRef("runtime.connectNative()")}}</td> - <td>N'est pas applicable (voir <a href="/fr/Add-ons/WebExtensions/Native_messaging">Native messaging</a>).</td> - </tr> - <tr> - <td>Extension Ă l'extension</td> - <td>{{WebExtAPIRef("runtime.connect()")}}</td> - <td>{{WebExtAPIRef("runtime.onConnectExternal")}}</td> - </tr> - </tbody> -</table> - -<h2 id="Type">Type</h2> - -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> - -<dl> - <dt><code>name</code></dt> - <dd><code>string</code>. Le nom du port, dĂ©fini dans {{WebExtAPIRef("runtime.connect()")}} ou {{WebExtAPIRef("tabs.connect()")}} appel qui l'a crĂ©Ă©. Si ce port est connectĂ© Ă une application native, son nom est le nom de l'application native.</dd> - <dt><code>disconnect</code></dt> - <dd><code>function</code>. DĂ©connecte un port. Chaque extrĂ©mitĂ© peut appeler cela quand ils ont fini avec le port. Cela provoquera le dĂ©clenchement de <code>onDisconnect</code> Ă l'autre extrĂ©mitĂ©. Ceci est utile si l'autre extrĂ©mitĂ© maintient un Ă©tat relatif Ă ce port, qui peut ĂȘtre nettoyĂ© lors de la dĂ©connexion. Si ce port est connectĂ© Ă une application native, cette fonction ferme l'application native.</dd> - <dt><code>error</code></dt> - <dd><code>object</code>. Si le port a Ă©tĂ© dĂ©connectĂ© en raison d'une erreur, il sera dĂ©fini sur un objet avec un <code>message</code>, de propriĂ©tĂ© de chaĂźne, vous donnant plus d'informations sur l'erreur. Voir <code>onDisconnect</code>.</dd> - <dt><code>onDisconnect</code></dt> - <dd> - <p><code>object</code>. Cela contient les fonctions <code>addListener()</code> et <code>removeListener()</code> communes Ă tous les Ă©vĂ©nements pour les extensions crĂ©Ă©es Ă l'aide des API. WebExtension. Les fonctions de l'Ă©couteur seront appelĂ©es lorsque l'autre extrĂ©mitĂ© aura appelĂ© <code>Port.disconnect()</code>. Cet Ă©vĂ©nement ne sera dĂ©clenchĂ© qu'une fois pour chaque port. La fonction d'Ă©couteur recevra l'objet <code>Port</code>. Si le port a Ă©tĂ© dĂ©connectĂ© en raison d'une erreur, l'argument <code>Port</code> contiendra une propriĂ©tĂ©Â <code>error</code> donnant plus d'informations sur l'erreur :</p> - - <pre class="brush: js">port.onDisconnect.addListener((p) => { - if (p.error) { - console.log(`Disconnected due to an error: ${p.error.message}`); - } -});</pre> - - <p>Notez que dans Google Chrome <code>port.error</code> n'est pas supportĂ©: utilisez plutĂŽt {{WebExtAPIRef("runtime.lastError")}} pour obtenir le message d'erreur.</p> - </dd> - <dt><code>onMessage</code></dt> - <dd><code>object</code>. Cela contient les fonctions <code>addListener()</code> et <code>removeListener()</code> communes Ă tous les Ă©vĂ©nements pour les extensions crĂ©Ă©es Ă l'aide des API WebExtension. Les fonctions de l'Ă©couteur seront appelĂ©es lorsque l'autre extrĂ©mitĂ© aura envoyĂ© un message Ă ce port. L'Ă©couteur recevra l'objet JSON envoyĂ© par l'autre extrĂ©mitĂ©.</dd> - <dt><code>postMessage</code></dt> - <dd><code>function</code>. Envoyer un message Ă l'autre extrĂ©mitĂ©. Cela prend un argument, qui est un objet JSON reprĂ©sentant le message Ă envoyer. Il sera fourni Ă tout script Ă©coutant l'Ă©vĂ©nement <code>onMessage</code> du port, ou Ă l'application native si ce port est connectĂ© Ă une application native.</dd> - <dt><code>sender</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('runtime.MessageSender')}}. Contient des informations sur l'expĂ©diteur du message. ette propriĂ©tĂ© ne sera prĂ©sente que sur les ports transmis aux Ă©couteurs <code>onConnect</code>/<code>onConnectExternal</code>.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.runtime.Port")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<h3 id="Connecting_from_content_scripts">Connecting from content scripts</h3> - -<p>This content script:</p> - -<ul> - <li>connects to the background script and stores the <code>Port</code> in a variable called <code>myPort</code>.</li> - <li>listens for messages on <code>myPort</code> and logs them.</li> - <li>sends messages to the background script, using <code>myPort</code>, when the user clicks the document.</li> -</ul> - -<pre class="brush: js">// content-script.js +{{AddonSidebar()}} + +Un objet `Port` represente une extrĂ©mitĂ© d'une connexion entre deux contextes spĂ©cifiques, qui peut-ĂȘtre utilisĂ©e pour Ă©changer des messages. + +Un cĂŽtĂ© initie la connexion Ă l'aide d'une API `connect()`. Cela retourne un objet `Port`. L'autre camp Ă©coute les tentatives de connexion Ă l'aide d'un Ă©couteur `onConnect`. Ceci est passĂ© un objet `Port` correspondant. + +Une fois que les deux cĂŽtĂ©s ont des objets `Port,` ils peuvent Ă©changer des messages JSON en utilisant `Port.postMessage()` et `Port.onMessage`. Quand ils sont terminĂ©s, chaque extrĂ©mitĂ© peut se dĂ©connecter en utilisant `Port.disconnect()`, ce qui gĂ©nĂ©rera un Ă©vĂ©nement `Port.onDisconnect` Ă l'autre extrĂ©mitĂ©, permettant Ă l'autre extrĂ©mitĂ© de faire le nettoyage requis. + +Vous pouvez utiliser ce modĂšle pour communiquer entre: + +- diffĂ©rentes parties de votre extension (par exemple, entre les [scripts de contenus](/fr/Add-ons/WebExtensions/Content_scripts) et les [scripts d'arriĂšre-plan](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts)) +- entre votre extension et une [application native s'exĂ©utant sur l'ordinateur de l'utilisateur](/fr/Add-ons/WebExtensions/Native_messaging). +- entre votre extension et une extension diffĂ©rente + +Vous devez utiliser diffĂ©rentes API de connexion pour diffĂ©rents types de connexions, comme indiquĂ© dans le tableau ci-dessous. + +| type de connection | Lancer une tentative de connexion | GĂ©rer la tentative de connexion | +| ------------------------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------- | +| Script d'arriĂšre-plan au script de contenu | {{WebExtAPIRef("tabs.connect()")}} | {{WebExtAPIRef("runtime.onConnect")}} | +| Script de contenu au script d'arriĂšre-plan | {{WebExtAPIRef("runtime.connect()")}} | {{WebExtAPIRef("runtime.onConnect")}} | +| Extension Ă l'application native | {{WebExtAPIRef("runtime.connectNative()")}} | N'est pas applicable (voir [Native messaging](/fr/Add-ons/WebExtensions/Native_messaging)). | +| Extension Ă l'extension | {{WebExtAPIRef("runtime.connect()")}} | {{WebExtAPIRef("runtime.onConnectExternal")}} | + +## Type + +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : + +- `name` + - : `string`. Le nom du port, dĂ©fini dans {{WebExtAPIRef("runtime.connect()")}} ou {{WebExtAPIRef("tabs.connect()")}} appel qui l'a crĂ©Ă©. Si ce port est connectĂ© Ă une application native, son nom est le nom de l'application native. +- `disconnect` + - : `function`. DĂ©connecte un port. Chaque extrĂ©mitĂ© peut appeler cela quand ils ont fini avec le port. Cela provoquera le dĂ©clenchement de `onDisconnect` Ă l'autre extrĂ©mitĂ©. Ceci est utile si l'autre extrĂ©mitĂ© maintient un Ă©tat relatif Ă ce port, qui peut ĂȘtre nettoyĂ© lors de la dĂ©connexion. Si ce port est connectĂ© Ă une application native, cette fonction ferme l'application native. +- `error` + - : `object`. Si le port a Ă©tĂ© dĂ©connectĂ© en raison d'une erreur, il sera dĂ©fini sur un objet avec un `message`, de propriĂ©tĂ© de chaĂźne, vous donnant plus d'informations sur l'erreur. Voir `onDisconnect`. +- `onDisconnect` + + - : `object`. Cela contient les fonctions `addListener()` et `removeListener()` communes Ă tous les Ă©vĂ©nements pour les extensions crĂ©Ă©es Ă l'aide des API. WebExtension. Les fonctions de l'Ă©couteur seront appelĂ©es lorsque l'autre extrĂ©mitĂ© aura appelĂ© `Port.disconnect()`. Cet Ă©vĂ©nement ne sera dĂ©clenchĂ© qu'une fois pour chaque port. La fonction d'Ă©couteur recevra l'objet `Port`. Si le port a Ă©tĂ© dĂ©connectĂ© en raison d'une erreur, l'argument `Port` contiendra une propriĂ©tĂ©Â `error` donnant plus d'informations sur l'erreur : + + ```js + port.onDisconnect.addListener((p) => { + if (p.error) { + console.log(`Disconnected due to an error: ${p.error.message}`); + } + }); + ``` + + Notez que dans Google Chrome `port.error` n'est pas supportĂ©: utilisez plutĂŽt {{WebExtAPIRef("runtime.lastError")}} pour obtenir le message d'erreur. + +- `onMessage` + - : `object`. Cela contient les fonctions `addListener()` et `removeListener()` communes Ă tous les Ă©vĂ©nements pour les extensions crĂ©Ă©es Ă l'aide des API WebExtension. Les fonctions de l'Ă©couteur seront appelĂ©es lorsque l'autre extrĂ©mitĂ© aura envoyĂ© un message Ă ce port. L'Ă©couteur recevra l'objet JSON envoyĂ© par l'autre extrĂ©mitĂ©. +- `postMessage` + - : `function`. Envoyer un message Ă l'autre extrĂ©mitĂ©. Cela prend un argument, qui est un objet JSON reprĂ©sentant le message Ă envoyer. Il sera fourni Ă tout script Ă©coutant l'Ă©vĂ©nement `onMessage` du port, ou Ă l'application native si ce port est connectĂ© Ă une application native. +- `sender`{{optional_inline}} + - : {{WebExtAPIRef('runtime.MessageSender')}}. Contient des informations sur l'expĂ©diteur du message. ette propriĂ©tĂ© ne sera prĂ©sente que sur les ports transmis aux Ă©couteurs `onConnect`/`onConnectExternal`. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.runtime.Port")}} + +## Exemples + +### Connecting from content scripts + +This content script: + +- connects to the background script and stores the `Port` in a variable called `myPort`. +- listens for messages on `myPort` and logs them. +- sends messages to the background script, using `myPort`, when the user clicks the document. + +```js +// content-script.js var myPort = browser.runtime.connect({name:"port-from-cs"}); myPort.postMessage({greeting: "hello from content script"}); @@ -122,23 +94,22 @@ myPort.onMessage.addListener(function(m) { document.body.addEventListener("click", function() { myPort.postMessage({greeting: "they clicked the page!"}); -});</pre> +}); +``` + +The corresponding background script: + +- listens for connection attempts from the content script. +- when it receives a connection attempt: -<p>The corresponding background script:</p> + - stores the port in a variable named `portFromCS`. + - sends the content script a message using the port. + - starts listening to messages received on the port, and logs them. -<ul> - <li>listens for connection attempts from the content script.</li> - <li>when it receives a connection attempt: - <ul> - <li>stores the port in a variable named <code>portFromCS</code>.</li> - <li>sends the content script a message using the port.</li> - <li>starts listening to messages received on the port, and logs them.</li> - </ul> - </li> - <li>sends messages to the content script, using <code>portFromCS</code>, when the user clicks the extension's browser action.</li> -</ul> +- sends messages to the content script, using `portFromCS`, when the user clicks the extension's browser action. -<pre class="brush: js">// background-script.js +```js +// background-script.js var portFromCS; @@ -155,16 +126,15 @@ browser.runtime.onConnect.addListener(connected); browser.browserAction.onClicked.addListener(function() { portFromCS.postMessage({greeting: "they clicked the button!"}); -});</pre> - -<h4 id="Script_Ă _contenu_multiple">Script Ă contenu multiple</h4> +}); +``` -<p>Si plusieurs scripts de contenu communiquent en mĂȘme temps, vous voudrez peut-ĂȘtre stocker chaque connexion dans un tableau.</p> +#### Script Ă contenu multiple -<ul> -</ul> +Si plusieurs scripts de contenu communiquent en mĂȘme temps, vous voudrez peut-ĂȘtre stocker chaque connexion dans un tableau. -<pre class="brush: js">// background-script.js +```js +// background-script.js var ports = [] @@ -176,16 +146,18 @@ function connected(p) { browser.runtime.onConnect.addListener(connected) browser.browserAction.onClicked.addListener(function() { - ports.forEach(p => { + ports.forEach(p => { p.postMessage({greeting: "they clicked the button!"}) }) -});</pre> +}); +``` -<h3 id="Connecting_to_native_applications">Connecting to native applications</h3> +### Connecting to native applications -<p>This example connects to the native application "ping_pong" and starts listening for messages from it. It also sends the native application a message when the user clicks a browser action icon:</p> +This example connects to the native application "ping_pong" and starts listening for messages from it. It also sends the native application a message when the user clicks a browser action icon: -<pre class="brush: js">/* +```js +/* On startup, connect to the "ping_pong" app. */ var port = browser.runtime.connectNative("ping_pong"); @@ -193,29 +165,28 @@ var port = browser.runtime.connectNative("ping_pong"); /* Listen for messages from the app. */ -port.onMessage.addListener((response) => { +port.onMessage.addListener((response) => { console.log("Received: " + response); }); /* On a click on the browser action, send the app a message. */ -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { console.log("Sending: ping"); port.postMessage("ping"); -});</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/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -242,5 +213,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/runtime/reload/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/reload/index.md index 44e83fcfda..686b457feb 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/reload/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/reload/index.md @@ -13,44 +13,45 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/reload --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Recharge une extension.</p> +Recharge une extension. -<p>S'il y a des mises Ă jour en attente pour l'extension, qu'elles ont Ă©tĂ© diffĂ©rĂ©es en Ă©coutant {{WebExtAPIRef("runtime.onUpdateAvailable")}}, elles seront appliquĂ©es en reload.</p> +S'il y a des mises Ă jour en attente pour l'extension, qu'elles ont Ă©tĂ© diffĂ©rĂ©es en Ă©coutant {{WebExtAPIRef("runtime.onUpdateAvailable")}}, elles seront appliquĂ©es en reload. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.runtime.reload() -</pre> +```js +browser.runtime.reload() +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<p>Aucun.</p> +Aucun. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.reload")}}</p> +{{Compat("webextensions.api.runtime.reload")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Rechargez l'extension lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur :</p> +Rechargez l'extension lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur : -<pre class="brush: js">browser.browserAction.onClicked.addListener((tab) => { +```js +browser.browserAction.onClicked.addListener((tab) => { browser.runtime.reload(); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -77,5 +78,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/reload // 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/runtime/requestupdatecheck/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheck/index.md index d3918536f3..1a0eeb9f24 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheck/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheck/index.md @@ -13,46 +13,45 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/requestUpdateCheck --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>VĂ©rifie de voir si un mise Ă jour de l'extension est disponible.</p> +VĂ©rifie de voir si un mise Ă jour de l'extension est disponible. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 requestingCheck = browser.runtime.requestUpdateCheck() -</pre> +```js +var requestingCheck = browser.runtime.requestUpdateCheck() +``` -<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 remplie avec deux arguments :</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec deux arguments : -<dl> - <dt><code>status</code></dt> - <dd>Une valeur {{WebExtAPIRef('runtime.RequestUpdateCheckStatus')}} â Le rĂ©sultat de la vĂ©rification de mise Ă jour.</dd> - <dt><code>details</code>{{optional_inline}}</dt> - <dd><p><code>object</code>. Si le <code>status</code> est <code>update_available</code>, cela contient plus d'informations sur la mise Ă jour. C'est un objet contenant une simple propriĂ©tĂ© :</p> - <dl> - <dt><code>version</code></dt> - <dd><code>string</code>. La version de la mise Ă jour.</dd> - </dl> - </dd> -</dl> +- `status` + - : Une valeur {{WebExtAPIRef('runtime.RequestUpdateCheckStatus')}} â Le rĂ©sultat de la vĂ©rification de mise Ă jour. +- `details`{{optional_inline}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : `object`. Si le `status` est `update_available`, cela contient plus d'informations sur la mise Ă jour. C'est un objet contenant une simple propriĂ©tĂ© : -<p>{{Compat("webextensions.api.runtime.requestUpdateCheck")}}</p> + - `version` + - : `string`. La version de la mise Ă jour. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Demander une mise Ă jour, etenregistrer la nouvelle version si elle est disponible :</p> +{{Compat("webextensions.api.runtime.requestUpdateCheck")}} -<pre class="brush: js">function onRequested(status, details) { +## Exemples + +Demander une mise Ă jour, etenregistrer la nouvelle version si elle est disponible : + +```js +function onRequested(status, details) { console.log(status); if (status === "update_available") { console.log(details.version); @@ -64,19 +63,18 @@ function onError(error) { } var requestingCheck = browser.runtime.requestUpdateCheck(onRequested); -requestingCheck.then(onRequested, onError);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +requestingCheck.then(onRequested, onError); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -103,5 +101,4 @@ requestingCheck.then(onRequested, onError);</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/runtime/requestupdatecheckstatus/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheckstatus/index.md index d6ae317192..e6d5759969 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheckstatus/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/requestupdatecheckstatus/index.md @@ -13,38 +13,34 @@ tags: - runtime translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/RequestUpdateCheckStatus --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>RĂ©sultat d'un appel Ă {{WebExtAPIRef("runtime.requestUpdateCheck()")}}.</p> +RĂ©sultat d'un appel Ă {{WebExtAPIRef("runtime.requestUpdateCheck()")}}. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<dl> - <dt><code>"throttled"</code></dt> - <dd>La mise Ă jour est limitĂ©e.</dd> - <dt><code>"no_update"</code></dt> - <dd>Aucune mise Ă jour n'est disponible.</dd> - <dt><code>"update_available"</code></dt> - <dd>Une mise Ă jour de l'extension est disponible.</dd> -</dl> +- `"throttled"` + - : La mise Ă jour est limitĂ©e. +- `"no_update"` + - : Aucune mise Ă jour n'est disponible. +- `"update_available"` + - : Une mise Ă jour de l'extension est disponible. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.RequestUpdateCheckStatus")}}</p> +{{Compat("webextensions.api.runtime.RequestUpdateCheckStatus")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -71,5 +67,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/RequestUpdateCheckStat // 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/runtime/sendmessage/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.md index 77f451869b..ff709863be 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/sendmessage/index.md @@ -13,87 +13,80 @@ tags: - sendMessage translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/sendMessage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Envoie un simple message aux Ă©couteurs d'Ă©vĂ©nement dans votre extension ou une extension diffĂ©rente.</p> +Envoie un simple message aux Ă©couteurs d'Ă©vĂ©nement dans votre extension ou une extension diffĂ©rente. -<p>Si vous envoyez Ă votre extension, omettez l'argument <code>extensionId</code>. L'Ă©vĂ©nement {{WebExtAPIRef('runtime.onMessage')}} sera dĂ©clenchĂ© dans chaque page de votre extension, Ă l'exception du cadre appelĂ© <code>runtime.sendMessage</code>.</p> +Si vous envoyez Ă votre extension, omettez l'argument `extensionId`. L'Ă©vĂ©nement {{WebExtAPIRef('runtime.onMessage')}} sera dĂ©clenchĂ© dans chaque page de votre extension, Ă l'exception du cadre appelĂ© `runtime.sendMessage`. -<p>Si vous envoyez une extension diffĂ©rente, ajouter l'argument <code>extensionId</code> Ă l'ID de l'autre extension. {{WebExtAPIRef('runtime.onMessageExternal')}} sera dĂ©clenchĂ© dans l'autre extension.</p> +Si vous envoyez une extension diffĂ©rente, ajouter l'argument `extensionId` Ă l'ID de l'autre extension. {{WebExtAPIRef('runtime.onMessageExternal')}} sera dĂ©clenchĂ© dans l'autre extension. -<p>Les extensions ne peuvent pas envoyer de messages aux scripts de contenu en utilisant cette mĂ©thode. Pour envoyer des messages aux scripts de contenu, utilisez {{WebExtAPIRef('tabs.sendMessage')}}.</p> +Les extensions ne peuvent pas envoyer de messages aux scripts de contenu en utilisant cette mĂ©thode. Pour envoyer des messages aux scripts de contenu, utilisez {{WebExtAPIRef('tabs.sendMessage')}}. -<ul> -</ul> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +> **Note :** Vous pouvez Ă©galement utiliser une [approche basĂ©e sur la connexion pour Ă©changer des messages](/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#Communication_avec_les_scripts_darriĂšre-plan). -<div class="note"> -<p><strong>Note :</strong> Vous pouvez Ă©galement utiliser une <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#Communication_avec_les_scripts_darriĂšre-plan">approche basĂ©e sur la connexion pour Ă©changer des messages</a>.</p> -</div> +## Syntaxe -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">var sending = browser.runtime.sendMessage( +```js +var sending = browser.runtime.sendMessage( extensionId, // optional string message, // any options // optional object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>extensionId</code>{{optional_inline}}</dt> - <dd><p><code>string</code>. L'ID de l'extension Ă envoyer le message. Incluez ceci pour envoyer le message Ă une extension diffĂ©rente..Si le destinataire prĂ©vu a dĂ©fini un ID explicitement en utilisant la clĂ© d' <a href="/fr/Add-ons/WebExtensions/manifest.json/applications">applications</a> dans manifest.json, <code>extensionId</code> doit avoir une valeur. Sinon, il devrait avoir l'ID qui a Ă©tĂ© gĂ©nĂ©rĂ© pour le destinataire prĂ©vu.</p> - <p>Si <code>extensionId</code> est omis, le message sera envoyĂ© Ă votre propre extension.</p></dd> - <dt><code>message</code></dt> - <dd><code>any</code>. Un objet qui peut ĂȘtre structurĂ© clone sĂ©rialisĂ©.</dd> - <dt><code>options</code>{{optional_inline}}</dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>includeTlsChannelId</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Indique si l'ID de canal TLS sera transmis Ă {{WebExtAPIRef('runtime.onMessageExternal')}} pour les processus qui Ă©coutent l'Ă©vĂ©nement de connexion.</dd> - <dt><code>toProxyScript{{optional_inline}}</code></dt> - <dd><code>boolean</code>. Doit ĂȘtre True si le message est destinĂ© Ă un fichier PAC chargĂ© Ă l'aide de l'API {{WebExtAPIRef("proxy")}}.</dd> - </dl> - </dd> -</dl> - -<p>En fonction des arguments qui lui sont donnĂ©s, cette API est parfois ambiguĂ«. Les rĂšgles suivantes sont utilisĂ©es :</p> - -<ul> - <li><strong>Si un argument est donnĂ©</strong>, c'est le message Ă envoyer, et le message sera envoyĂ© en interne.</li> - <li><strong>Si deux arguments sont donnĂ©s :</strong> - <ul> - <li>Les arguments sont interprĂ©tĂ©s comme (message, options) et le message est envoyĂ© en interne si le second argument est l'un des suivants : - <ol> - <li>Un objet d'options valide (c'est-Ă -dire un objet qui ne contient que les propriĂ©tĂ©s des options supportĂ©s par le navigateur)</li> - <li>null</li> - <li>indĂ©fini</li> - </ol> - </li> - <li>Sinon, les arguments sont interprĂ©tĂ©s comme <code>(extensionId, message)</code>. Le message sera envoyĂ© Ă l'extension identifiĂ©e par <code>extensionId</code>.</li> - </ul> - </li> - <li><strong>Si trois arguments sont donnĂ©s</strong>, les arguments sont interprĂ©tĂ©s comme <code>(extensionId, message, options)</code>. Le message sera envoyĂ© Ă l'extension identifiĂ©e par <code>extensionId</code>.</li> -</ul> - -<p>Notez qu'avant Firefox 55, le rĂšgles Ă©taient diffĂ©rentes dans le cas des 2 arguments. Sous les anciennes rĂšgles, si le premier argument Ă©tait une chaĂźne, il Ă©tait traitĂ© comme <code>extensionId</code>, avec le message comme deuxiĂšme argument. Cel signifiait que si vous appelez <code>sendMessage()</code> avec des arguments comme <code>("my-message", {})</code>, il enverrait un message vide Ă l'extension identifiĂ©e par "my-message". Sous les nouvelles rĂšgles, avec ces arguments, vous enverriez le message "my-message" en interne, avec un objet options vide.</p> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>. Si le destinataire a envoyĂ© une rĂ©ponse, celle-ci sera remplie avec la rĂ©ponse en tant qu'objet JSON. Sinon, il sera rempli sans arguments. si une erreur survient lors de la connexion Ă l'extension, la promessage sera rejetĂ©e avec un message d'erreur.</p> - -<h2 id="CompatibilitĂ©_du_navitageur">CompatibilitĂ© du navitageur</h2> - -<p>{{Compat("webextensions.api.runtime.sendMessage")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Voici un script de contenu qui envoie un message au script d'arriĂšre-plan lorsque l'utilisateur clique sur la fenĂȘtre de contenu. La charge utile du message est <code>{greeting: "Greeting from the content script"}</code>, et l'expĂ©diteur s'attend Ă©galement Ă recevoir une rĂ©ponse, qui est gĂ©rĂ©e dans la fonction <code>handleResponse</code> :</p> - -<pre class="brush: js">// content-script.js +``` + +### ParamĂštres + +- `extensionId`{{optional_inline}} + + - : `string`. L'ID de l'extension Ă envoyer le message. Incluez ceci pour envoyer le message Ă une extension diffĂ©rente..Si le destinataire prĂ©vu a dĂ©fini un ID explicitement en utilisant la clĂ© d' [applications](/fr/Add-ons/WebExtensions/manifest.json/applications) dans manifest.json, `extensionId` doit avoir une valeur. Sinon, il devrait avoir l'ID qui a Ă©tĂ© gĂ©nĂ©rĂ© pour le destinataire prĂ©vu. + + Si `extensionId` est omis, le message sera envoyĂ© Ă votre propre extension. + +- `message` + - : `any`. Un objet qui peut ĂȘtre structurĂ© clone sĂ©rialisĂ©. +- `options`{{optional_inline}} + + - : `object`. + + - `includeTlsChannelId`{{optional_inline}} + - : `boolean`. Indique si l'ID de canal TLS sera transmis Ă {{WebExtAPIRef('runtime.onMessageExternal')}} pour les processus qui Ă©coutent l'Ă©vĂ©nement de connexion. + - `toProxyScript{{optional_inline}}` + - : `boolean`. Doit ĂȘtre True si le message est destinĂ© Ă un fichier PAC chargĂ© Ă l'aide de l'API {{WebExtAPIRef("proxy")}}. + +En fonction des arguments qui lui sont donnĂ©s, cette API est parfois ambiguĂ«. Les rĂšgles suivantes sont utilisĂ©es : + +- **Si un argument est donnĂ©**, c'est le message Ă envoyer, et le message sera envoyĂ© en interne. +- **Si deux arguments sont donnĂ©s :** + + - Les arguments sont interprĂ©tĂ©s comme (message, options) et le message est envoyĂ© en interne si le second argument est l'un des suivants : + + 1. Un objet d'options valide (c'est-Ă -dire un objet qui ne contient que les propriĂ©tĂ©s des options supportĂ©s par le navigateur) + 2. null + 3. indĂ©fini + + - Sinon, les arguments sont interprĂ©tĂ©s comme `(extensionId, message)`. Le message sera envoyĂ© Ă l'extension identifiĂ©e par `extensionId`. + +- **Si trois arguments sont donnĂ©s**, les arguments sont interprĂ©tĂ©s comme `(extensionId, message, options)`. Le message sera envoyĂ© Ă l'extension identifiĂ©e par `extensionId`. + +Notez qu'avant Firefox 55, le rĂšgles Ă©taient diffĂ©rentes dans le cas des 2 arguments. Sous les anciennes rĂšgles, si le premier argument Ă©tait une chaĂźne, il Ă©tait traitĂ© comme `extensionId`, avec le message comme deuxiĂšme argument. Cel signifiait que si vous appelez `sendMessage()` avec des arguments comme `("my-message", {})`, il enverrait un message vide Ă l'extension identifiĂ©e par "my-message". Sous les nouvelles rĂšgles, avec ces arguments, vous enverriez le message "my-message" en interne, avec un objet options vide. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si le destinataire a envoyĂ© une rĂ©ponse, celle-ci sera remplie avec la rĂ©ponse en tant qu'objet JSON. Sinon, il sera rempli sans arguments. si une erreur survient lors de la connexion Ă l'extension, la promessage sera rejetĂ©e avec un message d'erreur. + +## CompatibilitĂ© du navitageur + +{{Compat("webextensions.api.runtime.sendMessage")}} + +## Exemples + +Voici un script de contenu qui envoie un message au script d'arriĂšre-plan lorsque l'utilisateur clique sur la fenĂȘtre de contenu. La charge utile du message est `{greeting: "Greeting from the content script"}`, et l'expĂ©diteur s'attend Ă©galement Ă recevoir une rĂ©ponse, qui est gĂ©rĂ©e dans la fonction `handleResponse` : + +```js +// content-script.js function handleResponse(message) { console.log(`Message from the background script: ${message.response}`); @@ -110,11 +103,13 @@ function notifyBackgroundPage(e) { sending.then(handleResponse, handleError); } -window.addEventListener("click", notifyBackgroundPage);</pre> +window.addEventListener("click", notifyBackgroundPage); +``` -<p>Le script d'arriĂšre-plan correspondant ressemble Ă ceci :</p> +Le script d'arriĂšre-plan correspondant ressemble Ă ceci : -<pre class="brush: js">// background-script.js +```js +// background-script.js function handleMessage(request, sender, sendResponse) { console.log("Message from the content script: " + @@ -122,19 +117,18 @@ function handleMessage(request, sender, sendResponse) { sendResponse({response: "Response from background script"}); } -browser.runtime.onMessage.addListener(handleMessage);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.runtime.onMessage.addListener(handleMessage); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -161,5 +155,4 @@ browser.runtime.onMessage.addListener(handleMessage);</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/runtime/sendnativemessage/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/sendnativemessage/index.md index 1886bbad5e..c6d4a46fcf 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/sendnativemessage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/sendnativemessage/index.md @@ -13,48 +13,48 @@ tags: - sendNativeMessage translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/sendNativeMessage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Envoie un seul message d'une extension Ă une application native.</p> +Envoie un seul message d'une extension Ă une application native. -<p>Cela prend deux paramĂštres obligatoires : le nom de l'application native et un objet JSON qui est le message Ă envoyer. Le navigateur lancera l'application native et dĂ©livrera le message.</p> +Cela prend deux paramĂštres obligatoires : le nom de l'application native et un objet JSON qui est le message Ă envoyer. Le navigateur lancera l'application native et dĂ©livrera le message. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>. The first message sent by the native application is treated as a response to the <code>sendNativeMessage()</code> call, and the promise will be fulfilled with this message as a parameter. Note that you can't use {{WebExtAPIRef("runtime.onMessage")}} to get responses from the application: you must use the callback function instead.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). The first message sent by the native application is treated as a response to the `sendNativeMessage()` call, and the promise will be fulfilled with this message as a parameter. Note that you can't use {{WebExtAPIRef("runtime.onMessage")}} to get responses from the application: you must use the callback function instead. -<p>Une nouvelle instance de l'application est lancĂ©e pour appel Ă Â <code>runtime.sendNativeMessage()</code>. Le navigateur terminera l'application native aprĂšs avoir reçu une rĂ©ponse. Pour mettre fin Ă une application native, le navigateur ferme le canal, donne au processus quelques secondes pour quitter normalement, puis le tue s'il ne s'est pas arrĂȘtĂ©.</p> +Une nouvelle instance de l'application est lancĂ©e pour appel Ă Â `runtime.sendNativeMessage()`. Le navigateur terminera l'application native aprĂšs avoir reçu une rĂ©ponse. Pour mettre fin Ă une application native, le navigateur ferme le canal, donne au processus quelques secondes pour quitter normalement, puis le tue s'il ne s'est pas arrĂȘtĂ©. -<p>Pour plus d'informations, voir <a href="/fr/Add-ons/WebExtensions/Native_messaging">Native messaging</a>.</p> +Pour plus d'informations, voir [Native messaging](/fr/Add-ons/WebExtensions/Native_messaging). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var sending = browser.runtime.sendNativeMessage( +```js +var sending = browser.runtime.sendNativeMessage( application, // string message // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>application</code></dt> - <dd><code>string</code>. Le nom de l'application native. Cela doit correspondre Ă la propriĂ©tĂ© "name" dans le <a href="/fr/Add-ons/WebExtensions/Native_messaging#App_manifest">fichier manifest de l'application native</a>.</dd> - <dt><code>message</code></dt> - <dd><code>object</code>. Un objet JSON qui sera envoyĂ© Ă l'application native.</dd> -</dl> +- `application` + - : `string`. Le nom de l'application native. Cela doit correspondre Ă la propriĂ©tĂ© "name" dans le [fichier manifest de l'application native](/fr/Add-ons/WebExtensions/Native_messaging#App_manifest). +- `message` + - : `object`. Un objet JSON qui sera envoyĂ© Ă l'application native. -<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>. Si l'expĂ©diteur a envoyĂ© une rĂ©ponse, celle-ci sera remplie avec la rĂ©ponse en tant qu'objet JSON. Sinon, il sera rempli sans arguments. Si une erreur survient lors de la connexion Ă l'application native, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si l'expĂ©diteur a envoyĂ© une rĂ©ponse, celle-ci sera remplie avec la rĂ©ponse en tant qu'objet JSON. Sinon, il sera rempli sans arguments. Si une erreur survient lors de la connexion Ă l'application native, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.sendNativeMessage")}}</p> +{{Compat("webextensions.api.runtime.sendNativeMessage")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Voici un script d'arriĂšre-plan qui envoie un message "ping" Ă l'application "ping_pong" et enregistre la rĂ©ponse, chaque fois que l'utilisateur clique sur l'action du navigateur :</p> +Voici un script d'arriĂšre-plan qui envoie un message "ping" Ă l'application "ping_pong" et enregistre la rĂ©ponse, chaque fois que l'utilisateur clique sur l'action du navigateur : -<pre class="brush: js">function onResponse(response) { +```js +function onResponse(response) { console.log(`Received ${response}`); } @@ -65,23 +65,22 @@ function onError(error) { /* On a click on the browser action, send the app a message. */ -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { console.log("Sending: ping"); var sending = browser.runtime.sendNativeMessage("ping_pong", "ping"); sending.then(onResponse, onError); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -108,5 +107,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/runtime/setuninstallurl/index.md b/files/fr/mozilla/add-ons/webextensions/api/runtime/setuninstallurl/index.md index 94befdc38d..d2f9ff3ff2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/runtime/setuninstallurl/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/runtime/setuninstallurl/index.md @@ -13,37 +13,37 @@ tags: - setUninstallURL translation_of: Mozilla/Add-ons/WebExtensions/API/runtime/setUninstallURL --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit l'URL Ă visiter lorsque l'extension est dĂ©installĂ©e. Cela peut ĂȘtre utilisĂ© pour nettoyer les donnĂ©es cĂŽtĂ© serveur, effectuer des analyses ou implĂ©menter des enquĂȘtes. L'URL peut contenir au maximum 255 caractĂšres.</p> +DĂ©finit l'URL Ă visiter lorsque l'extension est dĂ©installĂ©e. Cela peut ĂȘtre utilisĂ© pour nettoyer les donnĂ©es cĂŽtĂ© serveur, effectuer des analyses ou implĂ©menter des enquĂȘtes. L'URL peut contenir au maximum 255 caractĂšres. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 settingUrl = browser.runtime.setUninstallURL( +```js +var settingUrl = browser.runtime.setUninstallURL( url // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL Ă ouvrir aprĂšs la dĂ©sinstallation de l'extension. Cette URL doit avoir un schĂ©ma <code>http</code> ou <code>https</code>. DĂ©finissez-le sur une chaĂźne vide pour ne pas ouvrir un nouvel onglet lors de la dĂ©sinstallation.</dd> -</dl> +- `url` + - : `string`. L'URL Ă ouvrir aprĂšs la dĂ©sinstallation de l'extension. Cette URL doit avoir un schĂ©ma `http` ou `https`. DĂ©finissez-le sur une chaĂźne vide pour ne pas ouvrir un nouvel onglet lors de la dĂ©sinstallation. -<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 sans argument lorsque l'URL a Ă©tĂ© dĂ©finie ou rejetĂ©e avec un message d'erreur si l'opĂ©ration a Ă©chouĂ©.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque l'URL a Ă©tĂ© dĂ©finie ou rejetĂ©e avec un message d'erreur si l'opĂ©ration a Ă©chouĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.runtime.setUninstallURL")}}</p> +{{Compat("webextensions.api.runtime.setUninstallURL")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function onSetURL() { +```js +function onSetURL() { console.log("set uninstall URL"); } @@ -52,19 +52,18 @@ function onError(error) { } var settingUrl = browser.runtime.setUninstallURL("https://example.org"); -settingUrl.then(onSetURL, onError);</pre> +settingUrl.then(onSetURL, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.runtime`](https://developer.chrome.com/extensions/runtime#event-onConnect). Cette documentation est dĂ©rivĂ©e de [`runtime.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json) dans le code de Chromium code. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/runtime#event-onConnect"><code>chrome.runtime</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/runtime.json"><code>runtime.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 @@ -91,5 +90,4 @@ settingUrl.then(onSetURL, onError);</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/search/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/search/get/index.md index 804ec0e527..9814c2b73b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/search/get/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/search/get/index.md @@ -11,59 +11,54 @@ tags: - get translation_of: Mozilla/Add-ons/WebExtensions/API/search/get --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient un tableau de tous les moteurs de recherche installĂ©s.</p> +Obtient un tableau de tous les moteurs de recherche installĂ©s. -<p>Chaque moteur de recherche renvoyĂ© est identifiĂ© par un nom, que vous pouvez passer dans {{WebExtAPIRef("search.search()")}}} pour utiliser ce moteur particulier pour effectuer une recherche.</p> +Chaque moteur de recherche renvoyĂ© est identifiĂ© par un nom, que vous pouvez passer dans {{WebExtAPIRef("search.search()")}}} pour utiliser ce moteur particulier pour effectuer une recherche. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingEngines = browser.search.get() -</pre> +```js +var gettingEngines = browser.search.get() +``` -<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 <a href="Web/JavaScript/Reference/Global_Objects/array">tableau</a> d'objets de moteur de recherche. Chaque objet de moteur de recherche peut contenir les propriĂ©tĂ©s suivantes :</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un [tableau](Web/JavaScript/Reference/Global_Objects/array) d'objets de moteur de recherche. Chaque objet de moteur de recherche peut contenir les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>name</code></dt> - <dd><code>string</code>. Le nom du moteur de recherche.</dd> - <dt><code>isDefault</code></dt> - <dd> - <p><code>boolean</code>. <code>true</code> si le moteur de recherche est le moteur par dĂ©faut. Un seul moteur de recherche peut ĂȘtre le moteur par dĂ©faut Ă un moment donnĂ©.</p> - </dd> - <dt><code>alias</code>{{optional_inline}}</dt> - <dd> - <p><code>string</code>. Si un moteur de recherche a un alias, l'utilisateur peut effectuer une recherche avec un moteur de recherche particulier en entrant l'alias dans la barre d'adresse avant le terme de recherche. Par exemple, si le moteur Wikipedia a un alias "wk", l'utilisateur peut rechercher des pandas dans Wikipedia en entrant "wk pandas" dans la barre d'adresse. L'alias est parfois aussi appelĂ© "mot-clĂ©".</p> - </dd> - <dt><code>favIconUrl</code>{{optional_inline}}</dt> - <dd> - <p><code>string</code>. L'icĂŽne du moteur de recherche, comme une donnĂ©e : URL.</p> - </dd> -</dl> +- `name` + - : `string`. Le nom du moteur de recherche. +- `isDefault` + - : `boolean`. `true` si le moteur de recherche est le moteur par dĂ©faut. Un seul moteur de recherche peut ĂȘtre le moteur par dĂ©faut Ă un moment donnĂ©. +- `alias`{{optional_inline}} + - : `string`. Si un moteur de recherche a un alias, l'utilisateur peut effectuer une recherche avec un moteur de recherche particulier en entrant l'alias dans la barre d'adresse avant le terme de recherche. Par exemple, si le moteur Wikipedia a un alias "wk", l'utilisateur peut rechercher des pandas dans Wikipedia en entrant "wk pandas" dans la barre d'adresse. L'alias est parfois aussi appelĂ© "mot-clĂ©". +- `favIconUrl`{{optional_inline}} + - : `string`. L'icĂŽne du moteur de recherche, comme une donnĂ©e : URL. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.search.search", 10)}}</p> +{{Compat("webextensions.api.search.search", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Obtenir tous les moteurs de recherche installĂ©s :</p> +Obtenir tous les moteurs de recherche installĂ©s : -<pre class="brush: js">function retrieved(results) { +```js +function retrieved(results) { console.log(`There were: ${results.length} search engines retrieved.`); for (let searchEngine of results) { console.log(JSON.stringify(searchEngine.name)); } } -browser.search.get().then(retrieved);</pre> +browser.search.get().then(retrieved); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/search/index.md b/files/fr/mozilla/add-ons/webextensions/api/search/index.md index b8f4947652..d2e0d438ed 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/search/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/search/index.md @@ -11,21 +11,19 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/search --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>RĂ©cupĂšre les moteurs de recherche et lance une recherche avec un moteur de recherche spĂ©cifique</p> +RĂ©cupĂšre les moteurs de recherche et lance une recherche avec un moteur de recherche spĂ©cifique -<p>Pour utiliser cette API, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "search".</p> +Pour utiliser cette API, vous devez avoir la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "search". -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("search.get()")}}</dt> - <dd>RĂ©cupĂ©rer tous les moteurs de recherche</dd> - <dt>{{WebExtAPIRef("search.search()")}}</dt> - <dd>Recherche Ă l'aide du moteur de recherche spĂ©cifiĂ©.</dd> -</dl> +- {{WebExtAPIRef("search.get()")}} + - : RĂ©cupĂ©rer tous les moteurs de recherche +- {{WebExtAPIRef("search.search()")}} + - : Recherche Ă l'aide du moteur de recherche spĂ©cifiĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.search", 1, 1)}} {{WebExtExamples("h2")}}</p> +{{Compat("webextensions.api.search", 1, 1)}} {{WebExtExamples("h2")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/search/search/index.md b/files/fr/mozilla/add-ons/webextensions/api/search/search/index.md index 7f892b4bb7..a417d24187 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/search/search/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/search/search/index.md @@ -12,69 +12,63 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/search/search --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Effectuer une recherche en utilisant le moteur de recherche spĂ©cifiĂ©, ou le moteur de recherche par dĂ©faut si aucun moteur de recherche n'est spĂ©cifiĂ©.</p> +Effectuer une recherche en utilisant le moteur de recherche spĂ©cifiĂ©, ou le moteur de recherche par dĂ©faut si aucun moteur de recherche n'est spĂ©cifiĂ©. -<p>Les rĂ©sultats seront affichĂ©s dans un nouvel onglet, ou si l'argument tabId est donnĂ©, dans l'onglet identifiĂ© par ceci.</p> +Les rĂ©sultats seront affichĂ©s dans un nouvel onglet, ou si l'argument tabId est donnĂ©, dans l'onglet identifiĂ© par ceci. -<p>Pour utiliser cette fonction dans votre extension, vous devez demander la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission manifest</a> "search".</p> +Pour utiliser cette fonction dans votre extension, vous devez demander la [permission manifest](/fr/Add-ons/WebExtensions/manifest.json/permissions) "search". -<p>Pour obtenir les moteurs de recherche installĂ©s, utilisez {{WebExtAPIRef("search.get()")}}.</p> +Pour obtenir les moteurs de recherche installĂ©s, utilisez {{WebExtAPIRef("search.get()")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.search.search( +```js +browser.search.search( searchProperties // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>searchProperties</code></dt> - <dd> - <p><code>object</code>. Un objet avec les propriĂ©tĂ©s suivantes :</p> +- `searchProperties` - <dl> - <dt><code>query</code></dt> - <dd><code>string</code>. La requĂȘte de recherche.</dd> - <dt><code>engine</code>{{optional_inline}}</dt> - <dd> - <p><code>string</code>. Le nom du moteur de recherche. Si le nom du moteur de recherche que vous spĂ©cifiez n'existe pas, la fonction lance une erreur. Si cette propriĂ©tĂ© est omise, le moteur de recherche par dĂ©faut sera utilisĂ©.</p> - </dd> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd> - <p><code>integer</code>.  Un identificateur facultatif pour l'onglet dans lequel vous voulez exĂ©cuter la recherche. Si cette propriĂ©tĂ© est omise, les rĂ©sultats de la recherche seront affichĂ©s dans un nouvel onglet.</p> - </dd> - </dl> - </dd> -</dl> + - : `object`. Un objet avec les propriĂ©tĂ©s suivantes : -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - `query` + - : `string`. La requĂȘte de recherche. + - `engine`{{optional_inline}} + - : `string`. Le nom du moteur de recherche. Si le nom du moteur de recherche que vous spĂ©cifiez n'existe pas, la fonction lance une erreur. Si cette propriĂ©tĂ© est omise, le moteur de recherche par dĂ©faut sera utilisĂ©. + - `tabId`{{optional_inline}} + - : `integer`.  Un identificateur facultatif pour l'onglet dans lequel vous voulez exĂ©cuter la recherche. Si cette propriĂ©tĂ© est omise, les rĂ©sultats de la recherche seront affichĂ©s dans un nouvel onglet. -<p>Aucune</p> +### Valeur retournĂ©e -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +Aucune -<p>{{Compat("webextensions.api.search.search", 10)}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.search.search", 10)}} -<p>Recherche Ă l'aide du moteur de recherche par dĂ©faut. Les rĂ©sultats seront affichĂ©s dans un nouvel onglet :</p> +## Exemples -<pre class="brush: js">function search() { +Recherche Ă l'aide du moteur de recherche par dĂ©faut. Les rĂ©sultats seront affichĂ©s dans un nouvel onglet : + +```js +function search() { browser.search.search({ query: "styracosaurus" }); } browser.browserAction.onClicked.addListener(search); -</pre> +``` -<p>Recherche Ă l'aide de Wikipedia. Les rĂ©sultats seront affichĂ©s dans un nouvel onglet :</p> +Recherche Ă l'aide de Wikipedia. Les rĂ©sultats seront affichĂ©s dans un nouvel onglet : -<pre class="brush: js">function search() { +```js +function search() { browser.search.search({ query: "styracosaurus", engine: "Wikipedia (en)" @@ -82,11 +76,12 @@ browser.browserAction.onClicked.addListener(search); } browser.browserAction.onClicked.addListener(search); -</pre> +``` -<p>Recherche Ă l'aide de Wikipedia. Les rĂ©sultats seront affichĂ©s dans un nouvel onglet</p> +Recherche Ă l'aide de Wikipedia. Les rĂ©sultats seront affichĂ©s dans un nouvel onglet -<pre class="brush: js">function search(tab) { +```js +function search(tab) { browser.search.search({ query: "styracosaurus", engine: "Wikipedia (en)", @@ -95,6 +90,6 @@ browser.browserAction.onClicked.addListener(search); } browser.browserAction.onClicked.addListener(search); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/filter/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/filter/index.md index aa88a320ee..f0b4b21972 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/filter/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/filter/index.md @@ -13,36 +13,32 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/Filter --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'objet <code>Filter</code> permet de restreindre le nombre d'objets {{WebExtAPIRef("sessions.Session", "Session")}} retournĂ©s par un appel Ă {{WebExtAPIRef("sessions.getRecentlyClosed()")}}.</p> +L'objet `Filter` permet de restreindre le nombre d'objets {{WebExtAPIRef("sessions.Session", "Session")}} retournĂ©s par un appel Ă {{WebExtAPIRef("sessions.getRecentlyClosed()")}}. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les proriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les proriĂ©tĂ©s suivantes : -<dl> - <dt><code>maxResults</code>{{optional_inline}}</dt> - <dd><code>number</code>. Le nombre maximal de rĂ©sultats Ă retourner.</dd> -</dl> +- `maxResults`{{optional_inline}} + - : `number`. Le nombre maximal de rĂ©sultats Ă retourner. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.Filter")}}</p> +{{Compat("webextensions.api.sessions.Filter")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.sessions`](https://developer.chrome.com/extensions/sessions). +> +> 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/sessions"><code>chrome.sessions</code></a>.</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 @@ -69,5 +65,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/Filter // 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/sessions/forgetclosedtab/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedtab/index.md index 5f912ed8cd..3566b219f2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedtab/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedtab/index.md @@ -12,50 +12,42 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedTab --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Supprime un onglet fermĂ© de la liste des onglets rĂ©cemment fermĂ©s du navigateur.Notez que les sites visitĂ©s par cet onglet ne sont pas supprimĂ©s de l'historique du navigateur. Utilisez les API {{WebExtAPIRef("browsingData")}} oo {{WebExtAPIRef("history")}} pour supprimer l'historique. -<div>Supprime un onglet fermĂ© de la liste des onglets rĂ©cemment fermĂ©s du navigateur.</div> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<div></div> +## Syntaxe -<div>Notez que les sites visitĂ©s par cet onglet ne sont pas supprimĂ©s de l'historique du navigateur. Utilisez les API {{WebExtAPIRef("browsingData")}} oo {{WebExtAPIRef("history")}} pour supprimer l'historique.</div> - -<div></div> - -<p>C'est 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 forgettingTab = browser.sessions.forgetClosedTab( +```js +var forgettingTab = browser.sessions.forgetClosedTab( windowId, // integer sessionId // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code></dt> - <dd><code>Integer</code>. L'ID de la fenĂȘtre qui hĂ©berge l'onglet que vous voulez oublier.</dd> - <dt><code>sessionId</code></dt> - <dd><code>String</code>. L'identifiant de la session que vous voulez oublier.</dd> -</dl> +- `windowId` + - : `Integer`. L'ID de la fenĂȘtre qui hĂ©berge l'onglet que vous voulez oublier. +- `sessionId` + - : `String`. L'identifiant de la session que vous voulez oublier. -<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>. Cela sera accompli sans arguments lorsque la session a Ă©tĂ© supprimĂ©e.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Cela sera accompli sans arguments lorsque la session a Ă©tĂ© supprimĂ©e. -<p>Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.forgetClosedTab")}}</p> +{{Compat("webextensions.api.sessions.forgetClosedTab")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code oublie la derniĂšre session fermĂ©e, qu'il s'agisse d'un onglet ou d'une fenĂȘtre :</p> +Ce code oublie la derniĂšre session fermĂ©e, qu'il s'agisse d'un onglet ou d'une fenĂȘtre : -<pre class="brush: js">function forgetMostRecent(sessionInfos) { +```js +function forgetMostRecent(sessionInfos) { if (!sessionInfos.length) { console.log("No sessions found") return; @@ -73,6 +65,7 @@ function onError(error) { } browser.sessions.getRecentlyClosed({maxResults: 1}) -.then(forgetMostRecent, onError);</pre> +.then(forgetMostRecent, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedwindow/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedwindow/index.md index 3f78c9303b..e803fecabb 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedwindow/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedwindow/index.md @@ -12,47 +12,39 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedWindow --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Supprime une fenĂȘtre fermĂ©e de la liste des fenĂȘtres rĂ©cemment fermĂ©es du navigateur.Notez que les sites visitĂ©s par cette fenĂȘtre ne sont pas supprimĂ©s de l'historique du navigateur. Utilisez les API {{WebExtAPIRef("browsingData")}} ou {{WebExtAPIRef("history")}} pour supprimer l'historique. -<div>Supprime une fenĂȘtre fermĂ©e de la liste des fenĂȘtres rĂ©cemment fermĂ©es du navigateur.</div> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<div></div> +## Syntaxe -<div>Notez que les sites visitĂ©s par cette fenĂȘtre ne sont pas supprimĂ©s de l'historique du navigateur. Utilisez les API {{WebExtAPIRef("browsingData")}} ou {{WebExtAPIRef("history")}} pour supprimer l'historique.</div> - -<div></div> - -<p>C'est 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 forgettingWindow = browser.sessions.forgetClosedWindow( +```js +var forgettingWindow = browser.sessions.forgetClosedWindow( sessionId // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>sessionId</code></dt> - <dd><code>String</code>. L'identifiant de la session que vous voulez oublier.</dd> -</dl> +- `sessionId` + - : `String`. L'identifiant de la session que vous voulez oublier. -<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>. Cela sera accompli sans arguments lorsque la session a Ă©tĂ© supprimĂ©e.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Cela sera accompli sans arguments lorsque la session a Ă©tĂ© supprimĂ©e. -<p>Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.forgetClosedWindow")}}</p> +{{Compat("webextensions.api.sessions.forgetClosedWindow")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code oublie la derniĂšre session fermĂ©e, qu'il s'agisse d'un onglet ou d'une fenĂȘtre :</p> +Ce code oublie la derniĂšre session fermĂ©e, qu'il s'agisse d'un onglet ou d'une fenĂȘtre : -<pre class="brush: js">function forgetMostRecent(sessionInfos) { +```js +function forgetMostRecent(sessionInfos) { if (!sessionInfos.length) { console.log("No sessions found") return; @@ -70,6 +62,7 @@ function onError(error) { } browser.sessions.getRecentlyClosed({maxResults: 1}) -.then(forgetMostRecent, onError);</pre> +.then(forgetMostRecent, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/getrecentlyclosed/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/getrecentlyclosed/index.md index be1e181aff..c355b72b82 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/getrecentlyclosed/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/getrecentlyclosed/index.md @@ -13,41 +13,41 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/getRecentlyClosed --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Renvoie un ensemble d'objets {{WebExtAPIRef("sessions.Session", "Session")}}, reprĂ©sentant des fenĂȘtres et des onglets qui ont Ă©tĂ© fermĂ©s dans la session du navigation actuelle (c'est Ă dire l'heure Ă©coulĂ©e depuis le dĂ©marrage du navigateur).</p> +Renvoie un ensemble d'objets {{WebExtAPIRef("sessions.Session", "Session")}}, reprĂ©sentant des fenĂȘtres et des onglets qui ont Ă©tĂ© fermĂ©s dans la session du navigation actuelle (c'est Ă dire l'heure Ă©coulĂ©e depuis le dĂ©marrage du navigateur). -<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 gettingSessions = browser.sessions.getRecentlyClosed( +```js +var gettingSessions = browser.sessions.getRecentlyClosed( filter // optional object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>filter</code>{{optional_inline}}</dt> - <dd><code>object</code>. Un objet {{WebExtAPIRef("sessions.Filter")}} qui limite l'ensemble des sessions renvoyĂ©es.</dd> -</dl> +- `filter`{{optional_inline}} + - : `object`. Un objet {{WebExtAPIRef("sessions.Filter")}} qui limite l'ensemble des sessions renvoyĂ©es. -<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>. Cela sera rempli avec un ensemble d'objets {{WebExtAPIRef("sessions.Session", "Session")}}, un pour chacun des derniers onglets fermĂ©s ou des fenĂȘtres dans la session de navigation actuelle, jusqu'Ă Â {{WebExtAPIRef("sessions.MAX_SESSION_RESULTS")}} ou le nombre inclus dans l'argument du filtre, le plus petit qui soit. Le tableau est donnĂ© Ă l'inverse de l'ordre dans lequel les onglets ou fenĂȘtres ont Ă©tĂ© fermĂ©s, de sorte que le plus rĂ©cemment fermĂ© sera Ă l'index 0.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Cela sera rempli avec un ensemble d'objets {{WebExtAPIRef("sessions.Session", "Session")}}, un pour chacun des derniers onglets fermĂ©s ou des fenĂȘtres dans la session de navigation actuelle, jusqu'Ă Â {{WebExtAPIRef("sessions.MAX_SESSION_RESULTS")}} ou le nombre inclus dans l'argument du filtre, le plus petit qui soit. Le tableau est donnĂ© Ă l'inverse de l'ordre dans lequel les onglets ou fenĂȘtres ont Ă©tĂ© fermĂ©s, de sorte que le plus rĂ©cemment fermĂ© sera Ă l'index 0. -<p>Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.getRecentlyClosed")}}</p> +{{Compat("webextensions.api.sessions.getRecentlyClosed")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Le code restaure la session la plus rĂ©cemment fermĂ©e, qu'il s'agisse d'un onglet ou d'une fenĂȘtre :</p> +Le code restaure la session la plus rĂ©cemment fermĂ©e, qu'il s'agisse d'un onglet ou d'une fenĂȘtre : -<pre class="brush: js">function restoreMostRecent(sessionInfos) { +```js +function restoreMostRecent(sessionInfos) { if (!sessionInfos.length) { console.log("No sessions found") return; @@ -70,19 +70,17 @@ browser.browserAction.onClicked.addListener(function() { }); gettingSessions.then(restoreMostRecent, onError); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.sessions`](https://developer.chrome.com/extensions/sessions). +> +> 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/sessions"><code>chrome.sessions</code></a>.</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 @@ -109,5 +107,4 @@ browser.browserAction.onClicked.addListener(function() { // 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/sessions/gettabvalue/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/gettabvalue/index.md index 2c52bac4fc..4bde501c6f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/gettabvalue/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/gettabvalue/index.md @@ -12,44 +12,44 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/getTabValue --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>RĂ©cupĂšre une valeur prĂ©cĂ©demment stockĂ©e par un appel Ă Â {{WebExtAPIRef("sessions.setTabValue")}}.</p> +RĂ©cupĂšre une valeur prĂ©cĂ©demment stockĂ©e par un appel Ă Â {{WebExtAPIRef("sessions.setTabValue")}}. -<p>Vous pouvez rĂ©cupĂ©rer une valeur d'un onglet mĂȘme au cours d'un cycle de fermeture / restauration: si vous dĂ©finissez une valeur, l'utilisateur ferme l'onglet, puis restaure l'onglet Ă l'aide de la fonction "restaurer l'onglet" du navigateur (par exemple, en appuyant sur Control+Shift+T), then you will be able to retrieve the value from the restored tab. vous pourrez alors rĂ©cupĂ©rer la valeur de l'onglet restaurĂ©. Notez cependant qu'un onglet restaurĂ© n'obtient pas le mĂȘme ID que l'original, donc l'ID que vous passez dans <code>getTabValue()</code> sera diffĂ©rent de l'ID que vous avez passĂ© dans <code>setTabValue()</code>, mĂȘme s'ils font tous deux rĂ©fĂ©rence au mĂȘme onglet.</p> +Vous pouvez rĂ©cupĂ©rer une valeur d'un onglet mĂȘme au cours d'un cycle de fermeture / restauration: si vous dĂ©finissez une valeur, l'utilisateur ferme l'onglet, puis restaure l'onglet Ă l'aide de la fonction "restaurer l'onglet" du navigateur (par exemple, en appuyant sur Control+Shift+T), then you will be able to retrieve the value from the restored tab. vous pourrez alors rĂ©cupĂ©rer la valeur de l'onglet restaurĂ©. Notez cependant qu'un onglet restaurĂ© n'obtient pas le mĂȘme ID que l'original, donc l'ID que vous passez dans `getTabValue()` sera diffĂ©rent de l'ID que vous avez passĂ© dans `setTabValue()`, mĂȘme s'ils font tous deux rĂ©fĂ©rence au mĂȘme onglet. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 retrieving = browser.sessions.getTabValue( +```js +var retrieving = browser.sessions.getTabValue( tabId, // integer key // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dont vous essayez de rĂ©cupĂ©rer les donnĂ©es.</dd> - <dt><code>key</code></dt> - <dd><code>string</code>. ClĂ© identifiant la valeur particuliĂšre Ă rĂ©cupĂ©rer. Cela doit correspondre Ă la clĂ© prĂ©cĂ©demment donnĂ©e dans {{WebExtAPIRef("sessions.setTabValue")}}.</dd> -</dl> +- `tabId` + - : `integer`. ID de l'onglet dont vous essayez de rĂ©cupĂ©rer les donnĂ©es. +- `key` + - : `string`. ClĂ© identifiant la valeur particuliĂšre Ă rĂ©cupĂ©rer. Cela doit correspondre Ă la clĂ© prĂ©cĂ©demment donnĂ©e dans {{WebExtAPIRef("sessions.setTabValue")}}. -<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 rĂ©solue avec la valeur si elle existe, ou <code>undefined</code>. Si elle n'existe pas. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de l'onglet n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rĂ©solue avec la valeur si elle existe, ou `undefined`. Si elle n'existe pas. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de l'onglet n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.getTabValue", 10)}}</p> +{{Compat("webextensions.api.sessions.getTabValue", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Consignez la valeur de "my-key" pour tous les nouveaux onglets crĂ©Ă©s (cela inclura tous les onglets qui ont Ă©tĂ© restaurĂ©s) :</p> +Consignez la valeur de "my-key" pour tous les nouveaux onglets crĂ©Ă©s (cela inclura tous les onglets qui ont Ă©tĂ© restaurĂ©s) : -<pre class="brush: js">function onGetResolved(r) { +```js +function onGetResolved(r) { console.log(`success: ${r}`); } @@ -57,8 +57,9 @@ function onGetRejected(e) { console.log(`error: ${e}`); } -browser.tabs.onCreated.addListener((tab) => { +browser.tabs.onCreated.addListener((tab) => { browser.sessions.getTabValue(tab.id, "my-key").then(onGetResolved, onGetRejected); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/getwindowvalue/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/getwindowvalue/index.md index 093d61dc9f..ed157a296a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/getwindowvalue/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/getwindowvalue/index.md @@ -12,44 +12,44 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/getWindowValue --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>RĂ©cupĂšre une valeur prĂ©cĂ©demment stockĂ©e par un appel Ă {{WebExtAPIRef("sessions.setWindowValue")}}.</p> +RĂ©cupĂšre une valeur prĂ©cĂ©demment stockĂ©e par un appel Ă {{WebExtAPIRef("sessions.setWindowValue")}}. -<p>Vous pouvez rĂ©cupĂ©rer une valeur d'une fenĂȘtre mĂȘme sur un cycle de fermeture / restauration : si vous dĂ©finissez une valeur, l'utilisateur ferme la fenĂȘtre, puis restaure la fenĂȘtre Ă l'aide de la fonction "restaurer la fenĂȘtre" du navigateur (par exemple, en appuyant sur Control+Shift+N),vous pourrez rĂ©cupĂ©rer la valeur de la fenĂȘtre restaurĂ©e. otez cependant qu'une fenĂȘtre restaurĂ©e n'obtient pas le mĂȘme ID que l'original, donc l'ID que vous passez dans <code>getWindowValue()</code> sera diffĂ©rent de l'ID que vous avez passĂ© dans <code>setWindowValue()</code>, mĂȘme s'ils se rĂ©fĂšrent tous les deux Ă la mĂȘme fenĂȘtre.</p> +Vous pouvez rĂ©cupĂ©rer une valeur d'une fenĂȘtre mĂȘme sur un cycle de fermeture / restauration : si vous dĂ©finissez une valeur, l'utilisateur ferme la fenĂȘtre, puis restaure la fenĂȘtre Ă l'aide de la fonction "restaurer la fenĂȘtre" du navigateur (par exemple, en appuyant sur Control+Shift+N),vous pourrez rĂ©cupĂ©rer la valeur de la fenĂȘtre restaurĂ©e. otez cependant qu'une fenĂȘtre restaurĂ©e n'obtient pas le mĂȘme ID que l'original, donc l'ID que vous passez dans `getWindowValue()` sera diffĂ©rent de l'ID que vous avez passĂ© dans `setWindowValue()`, mĂȘme s'ils se rĂ©fĂšrent tous les deux Ă la mĂȘme fenĂȘtre. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 retrieving = browser.sessions.getWindowValue( +```js +var retrieving = browser.sessions.getWindowValue( windowId, // integer key // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. ID de la fenĂȘtre dont vous essayez de rĂ©cupĂ©rer les donnĂ©es.</dd> - <dt><code>key</code></dt> - <dd><code>string</code>. ClĂ© identifiant la valeur particuliĂšre Ă rĂ©cupĂ©rer. Cela doit correspondre Ă la clĂ© prĂ©cĂ©demment donnĂ©e dans {{WebExtAPIRef("sessions.setWindowValue")}}.</dd> -</dl> +- `windowId` + - : `integer`. ID de la fenĂȘtre dont vous essayez de rĂ©cupĂ©rer les donnĂ©es. +- `key` + - : `string`. ClĂ© identifiant la valeur particuliĂšre Ă rĂ©cupĂ©rer. Cela doit correspondre Ă la clĂ© prĂ©cĂ©demment donnĂ©e dans {{WebExtAPIRef("sessions.setWindowValue")}}. -<h3 id="Valeure_retournĂ©e">Valeure retournĂ©e</h3> +### Valeure retournĂ©e -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera rĂ©solue avec la valeur si elle existe, ou <code>undefined</code> si elle n'existe pas. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de la fenĂȘtre n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rĂ©solue avec la valeur si elle existe, ou `undefined` si elle n'existe pas. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de la fenĂȘtre n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.getWindowValue", 10)}}</p> +{{Compat("webextensions.api.sessions.getWindowValue", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Consignez la valeur de "my-key" pour toutes les fenĂȘtres nouvellement crĂ©Ă©es (cela inclura toutes les fenĂȘtres qui ont Ă©tĂ© restaurĂ©es) :</p> +Consignez la valeur de "my-key" pour toutes les fenĂȘtres nouvellement crĂ©Ă©es (cela inclura toutes les fenĂȘtres qui ont Ă©tĂ© restaurĂ©es) : -<pre class="brush: js">function onGetResolved(r) { +```js +function onGetResolved(r) { console.log(`success: ${r}`); } @@ -57,8 +57,9 @@ function onGetRejected(e) { console.log(`error: ${e}`); } -browser.windows.onCreated.addListener((window) => { +browser.windows.onCreated.addListener((window) => { browser.sessions.getWindowValue(window.id, "my-key").then(onGetResolved, onGetRejected); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/index.md index 8cb87b54be..f7b04289f8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/index.md @@ -11,99 +11,71 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions --- -<div>{{AddonSidebar}}</div> - -<p>Utilisez l'API de sessions pour lister et restaurer, les onglets et les fenĂȘtres qui ont Ă©tĂ© fermĂ©s pendant que le navigateur fonctionne.</p> - -<p>La fonction {{WebExtAPIRef("sessions.getRecentlyClosed()")}} renvoie un tableau de {{WebExtAPIRef("tabs.Tab")}} et les objets {{WebExtAPIRef("windows.Window")}}, reprĂ©sente les onglets et les fenĂȘtres qui ont Ă©tĂ© fermĂ©es depuis le fonctionnement du navigateur, jusqu'au maximum dĂ©fini dans {{WebExtAPIRef("sessions.MAX_SESSION_RESULTS")}}.</p> - -<p>Vous pouvez ensuite restaurer une fenĂȘtre ou un onglet en utilisant la fonction {{WebExtAPIRef("sessions.restore()")}}. il restaure Ă©galement l'historique de navigation de l'onglet, de sorte que les boutons arriĂšre / avant fonctionnent.</p> - -<p>Cette API fournit Ă©galement un groupe de fonctions permettant Ă une extension de stocker un Ă©tat supplĂ©mentaire associĂ© Ă un onglet ou une fenĂȘtre. Ensuite, si l'onglet ou la fenĂȘtre est fermĂ© et restaurĂ© ultĂ©rieurement, l'extension peut rĂ©cupĂ©rer l'Ă©tat. Par exemple, une extension de groupe d'onglets peut l'utiliser pour se souvenir du groupe dans lequel se trouve un onglet, afin de le restaurer dans le bon groupe si l'utilisateur restaure l'onglet.</p> - -<p>Pour utiliser l'API des sessions, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission API</a> de "sessions".</p> - -<h2 id="Types">Types</h2> - -<dl> - <dt>{{WebExtAPIRef("sessions.Filter")}}</dt> - <dd>Permet de restreindre le nombre de {{WebExtAPIRef("sessions.Session", "Session")}} objets retournĂ©s par un appel Ă {{WebExtAPIRef("sessions.getRecentlyClosed()")}}.</dd> - <dt>{{WebExtAPIRef("sessions.Session")}}</dt> - <dd> - <p>ReprĂ©sente un onglet ou une fenĂȘtre que l'utilisateur a fermĂ© dans la session de navigation actuelle.</p> - </dd> -</dl> - -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> - -<dl> - <dt>{{WebExtAPIRef("sessions.MAX_SESSION_RESULTS")}}</dt> - <dd>Le nombre maximum de sessions qui seront retournĂ©es par un appel Ă <a href="/fr/Add-ons/WebExtensions/API/sessions/getRecentlyClosed"><code>sessions.getRecentlyClosed()</code></a>.</dd> -</dl> - -<h2 id="Fonctions">Fonctions</h2> - -<dl> - <dt>{{WebExtAPIRef("sessions.forgetClosedTab()")}}</dt> - <dd>Supprime un onglet fermĂ© de la liste des onglets rĂ©cemment fermĂ©s du navigateur.</dd> - <dt>{{WebExtAPIRef("sessions.forgetClosedWindow()")}}</dt> - <dd>Supprime une fenĂȘtre fermĂ©e de la liste des fenĂȘtres rĂ©cemment fermĂ©es du navigateur.</dd> - <dt>{{WebExtAPIRef("sessions.getRecentlyClosed()")}}</dt> - <dd>Renvoie un tableau d'objets {{WebExtAPIRef("sessions.Session", "Session")}}, reprĂ©sentant des fenĂȘtres et des onglets qui ont Ă©tĂ© fermĂ©s dans la session de navigation actuelle (c'est-Ă -dire l'heure Ă©coulĂ©e depuis le dĂ©marrage du navigateur).</dd> - <dt>{{WebExtAPIRef("sessions.restore()")}}</dt> - <dd> - <p>Restaure un onglet ou une fenĂȘtre fermĂ©e.</p> - </dd> - <dt>{{WebExtAPIRef("sessions.setTabValue()")}}</dt> - <dd> - <p>Stocke une paire clĂ©/valeur associĂ©e Ă un onglet donnĂ©.</p> - </dd> - <dt>{{WebExtAPIRef("sessions.getTabValue()")}}</dt> - <dd> - <p>RĂ©cupĂ©rer une valeur prĂ©cĂ©demment enregistrĂ©e pour un onglet donnĂ©, compte tenu de sa clĂ©.</p> - </dd> - <dt>{{WebExtAPIRef("sessions.removeTabValue()")}}</dt> - <dd> - <p>Supprimer une paire clĂ©/valeur d'un onglet donnĂ©.</p> - </dd> - <dt>{{WebExtAPIRef("sessions.setWindowValue()")}}</dt> - <dd> - <p>Stocke une paire clĂ©/valeur associĂ©e Ă une fenĂȘtre donnĂ©e.</p> - </dd> - <dt>{{WebExtAPIRef("sessions.getWindowValue()")}}</dt> - <dd> - <p>RĂ©cupĂ©rer une valeur prĂ©cĂ©demment enregistrĂ©e pour une fenĂȘtre donnĂ©e, compte tenu de sa clĂ©.</p> - </dd> - <dt>{{WebExtAPIRef("sessions.removeWindowValue()")}}</dt> - <dd> - <p>Supprime une paire clĂ©/valeur d'une fenĂȘtre donnĂ©es.</p> - </dd> -</dl> - -<h2 id="EvĂ©nements">EvĂ©nements</h2> - -<dl> - <dt>{{WebExtAPIRef("sessions.onChanged")}}</dt> - <dd> - <p>Mise en place lorsqu'un onglet ou une fenĂȘtre est fermĂ©e.</p> - </dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.sessions")}}</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/sessions"><code>chrome.sessions</code></a>.</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}} + +Utilisez l'API de sessions pour lister et restaurer, les onglets et les fenĂȘtres qui ont Ă©tĂ© fermĂ©s pendant que le navigateur fonctionne. + +La fonction {{WebExtAPIRef("sessions.getRecentlyClosed()")}} renvoie un tableau de {{WebExtAPIRef("tabs.Tab")}} et les objets {{WebExtAPIRef("windows.Window")}}, reprĂ©sente les onglets et les fenĂȘtres qui ont Ă©tĂ© fermĂ©es depuis le fonctionnement du navigateur, jusqu'au maximum dĂ©fini dans {{WebExtAPIRef("sessions.MAX_SESSION_RESULTS")}}. + +Vous pouvez ensuite restaurer une fenĂȘtre ou un onglet en utilisant la fonction {{WebExtAPIRef("sessions.restore()")}}. il restaure Ă©galement l'historique de navigation de l'onglet, de sorte que les boutons arriĂšre / avant fonctionnent. + +Cette API fournit Ă©galement un groupe de fonctions permettant Ă une extension de stocker un Ă©tat supplĂ©mentaire associĂ© Ă un onglet ou une fenĂȘtre. Ensuite, si l'onglet ou la fenĂȘtre est fermĂ© et restaurĂ© ultĂ©rieurement, l'extension peut rĂ©cupĂ©rer l'Ă©tat. Par exemple, une extension de groupe d'onglets peut l'utiliser pour se souvenir du groupe dans lequel se trouve un onglet, afin de le restaurer dans le bon groupe si l'utilisateur restaure l'onglet. + +Pour utiliser l'API des sessions, vous devez avoir la [permission API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) de "sessions". + +## Types + +- {{WebExtAPIRef("sessions.Filter")}} + - : Permet de restreindre le nombre de {{WebExtAPIRef("sessions.Session", "Session")}} objets retournĂ©s par un appel Ă {{WebExtAPIRef("sessions.getRecentlyClosed()")}}. +- {{WebExtAPIRef("sessions.Session")}} + - : ReprĂ©sente un onglet ou une fenĂȘtre que l'utilisateur a fermĂ© dans la session de navigation actuelle. + +## PropriĂ©tĂ©s + +- {{WebExtAPIRef("sessions.MAX_SESSION_RESULTS")}} + - : Le nombre maximum de sessions qui seront retournĂ©es par un appel Ă [`sessions.getRecentlyClosed()`](/fr/Add-ons/WebExtensions/API/sessions/getRecentlyClosed). + +## Fonctions + +- {{WebExtAPIRef("sessions.forgetClosedTab()")}} + - : Supprime un onglet fermĂ© de la liste des onglets rĂ©cemment fermĂ©s du navigateur. +- {{WebExtAPIRef("sessions.forgetClosedWindow()")}} + - : Supprime une fenĂȘtre fermĂ©e de la liste des fenĂȘtres rĂ©cemment fermĂ©es du navigateur. +- {{WebExtAPIRef("sessions.getRecentlyClosed()")}} + - : Renvoie un tableau d'objets {{WebExtAPIRef("sessions.Session", "Session")}}, reprĂ©sentant des fenĂȘtres et des onglets qui ont Ă©tĂ© fermĂ©s dans la session de navigation actuelle (c'est-Ă -dire l'heure Ă©coulĂ©e depuis le dĂ©marrage du navigateur). +- {{WebExtAPIRef("sessions.restore()")}} + - : Restaure un onglet ou une fenĂȘtre fermĂ©e. +- {{WebExtAPIRef("sessions.setTabValue()")}} + - : Stocke une paire clĂ©/valeur associĂ©e Ă un onglet donnĂ©. +- {{WebExtAPIRef("sessions.getTabValue()")}} + - : RĂ©cupĂ©rer une valeur prĂ©cĂ©demment enregistrĂ©e pour un onglet donnĂ©, compte tenu de sa clĂ©. +- {{WebExtAPIRef("sessions.removeTabValue()")}} + - : Supprimer une paire clĂ©/valeur d'un onglet donnĂ©. +- {{WebExtAPIRef("sessions.setWindowValue()")}} + - : Stocke une paire clĂ©/valeur associĂ©e Ă une fenĂȘtre donnĂ©e. +- {{WebExtAPIRef("sessions.getWindowValue()")}} + - : RĂ©cupĂ©rer une valeur prĂ©cĂ©demment enregistrĂ©e pour une fenĂȘtre donnĂ©e, compte tenu de sa clĂ©. +- {{WebExtAPIRef("sessions.removeWindowValue()")}} + - : Supprime une paire clĂ©/valeur d'une fenĂȘtre donnĂ©es. + +## EvĂ©nements + +- {{WebExtAPIRef("sessions.onChanged")}} + - : Mise en place lorsqu'un onglet ou une fenĂȘtre est fermĂ©e. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.sessions")}} + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.sessions`](https://developer.chrome.com/extensions/sessions). +> +> 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 @@ -130,5 +102,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/sessions // 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/sessions/max_session_results/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/max_session_results/index.md index 0b0e17b7f3..4b24332733 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/max_session_results/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/max_session_results/index.md @@ -13,23 +13,21 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/MAX_SESSION_RESULTS --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le nombre maximum de sessions qui seront retournĂ©es par un appel Ă {{WebExtAPIRef("sessions.getRecentlyClosed()")}}. Il est en lecture seule pour le code des WebExtensions, et dĂ©fini Ă 25.</p> +Le nombre maximum de sessions qui seront retournĂ©es par un appel Ă {{WebExtAPIRef("sessions.getRecentlyClosed()")}}. Il est en lecture seule pour le code des WebExtensions, et dĂ©fini Ă 25. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.MAX_SESSION_RESULTS")}}</p> +{{Compat("webextensions.api.sessions.MAX_SESSION_RESULTS")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.sessions`](https://developer.chrome.com/extensions/sessions). +> +> 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/sessions"><code>chrome.sessions</code></a>.</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 @@ -56,5 +54,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/MAX_SESSION_RESULTS // 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/sessions/onchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/onchanged/index.md index d702c852a2..1ec21c30e4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/onchanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/onchanged/index.md @@ -13,48 +13,44 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/onChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Mise en place lorsque une liste d'onglets fermes ou de fenĂȘtre changes.</p> +Mise en place lorsque une liste d'onglets fermes ou de fenĂȘtre changes. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.sessions.onChanged.addListener(listener) +```js +browser.sessions.onChanged.addListener(listener) browser.sessions.onChanged.removeListener(listener) browser.sessions.onChanged.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>Ajoute un auditeur Ă un Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est un auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si l'auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie Vrai s'il Ă©coute. Sinon Faux.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un auditeur Ă un Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est un auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si l'auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie Vrai s'il Ă©coute. Sinon Faux. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. Il ne passe aucun paramĂštre.</p> - </dd> -</dl> +- `callback` + - : Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. Il ne passe aucun paramĂštre. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.onChanged")}}</p> +{{Compat("webextensions.api.sessions.onChanged")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cette extension Ă©coute <code>onChanged</code>, puis restaure immĂ©diatement la derniĂšre session fermĂ©e, ce qui rend impossible de fermer les fenĂȘtres ou les onglets :</p> +Cette extension Ă©coute `onChanged`, puis restaure immĂ©diatement la derniĂšre session fermĂ©e, ce qui rend impossible de fermer les fenĂȘtres ou les onglets : -<pre class="brush: js">function restoreSession(sessionInfos) { +```js +function restoreSession(sessionInfos) { if (!sessionInfos.length) { console.log("No sessions found") return; @@ -78,19 +74,18 @@ function restoreMostRecent() { gettingSessions.then(restoreSession, onError); } -browser.sessions.onChanged.addListener(restoreMostRecent);</pre> +browser.sessions.onChanged.addListener(restoreMostRecent); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.sessions`](https://developer.chrome.com/extensions/sessions). +> +> 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/sessions"><code>chrome.sessions</code></a>.</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 @@ -117,5 +112,4 @@ browser.sessions.onChanged.addListener(restoreMostRecent);</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/sessions/removetabvalue/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/removetabvalue/index.md index c943c5184b..bcdef2fc0c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/removetabvalue/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/removetabvalue/index.md @@ -12,42 +12,42 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/removeTabValue --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime une valeur prĂ©cĂ©demment stockĂ©e par un appel Ă {{WebExtAPIRef("sessions.setTabValue")}}.</p> +Supprime une valeur prĂ©cĂ©demment stockĂ©e par un appel Ă {{WebExtAPIRef("sessions.setTabValue")}}. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.sessions.removeTabValue( +```js +var removing = browser.sessions.removeTabValue( tabId, // integer key // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dont vous essayez de supprimer les donnĂ©es.</dd> - <dt><code>key</code></dt> - <dd><code>string</code>. ClĂ© identifiant la valeur particuliĂšre Ă supprimer. Cela doit correspondre Ă la clĂ© prĂ©cĂ©demment donnĂ©e dans {{WebExtAPIRef("sessions.setTabValue")}}.</dd> -</dl> +- `tabId` + - : `integer`. ID de l'onglet dont vous essayez de supprimer les donnĂ©es. +- `key` + - : `string`. ClĂ© identifiant la valeur particuliĂšre Ă supprimer. Cela doit correspondre Ă la clĂ© prĂ©cĂ©demment donnĂ©e dans {{WebExtAPIRef("sessions.setTabValue")}}. -<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 ne sera rĂ©solue aucun argument si l'Ă©lĂ©ment a Ă©tĂ© supprimĂ© avec succĂšs. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de l'onglet n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui ne sera rĂ©solue aucun argument si l'Ă©lĂ©ment a Ă©tĂ© supprimĂ© avec succĂšs. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de l'onglet n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.removeTabValue", 10)}}</p> +{{Compat("webextensions.api.sessions.removeTabValue", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code ajoute deux Ă©lĂ©ments de menu contextuel: l'un stocke une valeur associĂ©e Ă l'onglet en cours, l'autre le supprime :</p> +Ce code ajoute deux Ă©lĂ©ments de menu contextuel: l'un stocke une valeur associĂ©e Ă l'onglet en cours, l'autre le supprime : -<pre class="brush: js">async function setOnActiveTab() { +```js +async function setOnActiveTab() { let tabArray = await browser.tabs.query({currentWindow: true, active: true}); let tabId = tabArray[0].id; await browser.sessions.setTabValue(tabId, "my-key", "my-value"); @@ -71,12 +71,13 @@ browser.menus.create({ contexts: ["all"] }); -browser.menus.onClicked.addListener((info) => { +browser.menus.onClicked.addListener((info) => { if (info.menuItemId === "add-my-item") { setOnActiveTab(); } else { removeFromActiveTab(); } -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/removewindowvalue/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/removewindowvalue/index.md index ba590fd013..5ba7a40b25 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/removewindowvalue/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/removewindowvalue/index.md @@ -12,42 +12,42 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/removeWindowValue --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime une valeur prĂ©cĂ©demment stockĂ©e par un appel Ă {{WebExtAPIRef("sessions.setWindowValue")}}.</p> +Supprime une valeur prĂ©cĂ©demment stockĂ©e par un appel Ă {{WebExtAPIRef("sessions.setWindowValue")}}. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.sessions.removeWindowValue( +```js +var removing = browser.sessions.removeWindowValue( windowId, // integer key // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. ID de la fenĂȘtre dont vous essayez de supprimer les donnĂ©es.</dd> - <dt><code>key</code></dt> - <dd><code>string</code>. lĂ© identifiant la valeur particuliĂšre Ă supprimer. Cela doit correspondre Ă la clĂ© prĂ©cĂ©demment donnĂ©e dans {{WebExtAPIRef("sessions.setWindowValue")}}.</dd> -</dl> +- `windowId` + - : `integer`. ID de la fenĂȘtre dont vous essayez de supprimer les donnĂ©es. +- `key` + - : `string`. lĂ© identifiant la valeur particuliĂšre Ă supprimer. Cela doit correspondre Ă la clĂ© prĂ©cĂ©demment donnĂ©e dans {{WebExtAPIRef("sessions.setWindowValue")}}. -<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 ne sera rĂ©solue aucun argument si l'Ă©lĂ©ment a Ă©tĂ© supprimĂ© avec succĂšs. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de la fenĂȘtre n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui ne sera rĂ©solue aucun argument si l'Ă©lĂ©ment a Ă©tĂ© supprimĂ© avec succĂšs. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de la fenĂȘtre n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.removeWindowValue", 10)}}</p> +{{Compat("webextensions.api.sessions.removeWindowValue", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code ajoute deux Ă©lĂ©ments de menu contextuel: l'un stocke une valeur associĂ©e Ă la fenĂȘtre courante, l'autre la supprime :</p> +Ce code ajoute deux Ă©lĂ©ments de menu contextuel: l'un stocke une valeur associĂ©e Ă la fenĂȘtre courante, l'autre la supprime : -<pre class="brush: js">async function setOnActiveWindow() { +```js +async function setOnActiveWindow() { let currentWindow = await browser.windows.getLastFocused(); await browser.sessions.setWindowValue(currentWindow.id, "my-key", "my-value"); } @@ -69,12 +69,13 @@ browser.menus.create({ contexts: ["all"] }); -browser.menus.onClicked.addListener((info) => { +browser.menus.onClicked.addListener((info) => { if (info.menuItemId === "add-my-item") { setOnActiveWindow(); } else { removeFromActiveWindow(); } -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/restore/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/restore/index.md index 98eda5f898..62c12f269b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/restore/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/restore/index.md @@ -12,39 +12,39 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/restore --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Restaure un onglet ou une fenĂȘtre fermĂ©e. La restauration ne rĂ©ouvre pas seulement l'onglet ou la fenĂȘtre : elle rĂ©tablit Ă©galement l'historique de navigation de l'onglet afin que les boutons arriĂšre/avant fonctionnent. La restauration d'une fenĂȘtre restaurera tous les onglets que la fenĂȘtre contenait lors de sa fermeture.</p> +Restaure un onglet ou une fenĂȘtre fermĂ©e. La restauration ne rĂ©ouvre pas seulement l'onglet ou la fenĂȘtre : elle rĂ©tablit Ă©galement l'historique de navigation de l'onglet afin que les boutons arriĂšre/avant fonctionnent. La restauration d'une fenĂȘtre restaurera tous les onglets que la fenĂȘtre contenait lors de sa fermeture. -<p>Il s'agit d'une fonction asynchrone que retourne une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +Il s'agit d'une fonction asynchrone que retourne une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var restoringSession = browser.sessions.restore( +```js +var restoringSession = browser.sessions.restore( sessionId // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>sessionId</code></dt> - <dd><code>string</code>. Une chaĂźne contenant l'ID de session pour la fenĂȘtre ou l'onglet Ă restaurer. Cela se trouve dans la propriĂ©tĂ© <code>sessionId</code> de l'objet  {{WebExtAPIRef("tabs.Tab", "Tab")}} ou {{WebExtAPIRef("windows.Window", "Window")}} dans {{WebExtAPIRef("sessions.Session", "Session")}} retournĂ© de {{WebExtAPIRef("sessions.getRecentlyClosed()")}}.</dd> -</dl> +- `sessionId` + - : `string`. Une chaĂźne contenant l'ID de session pour la fenĂȘtre ou l'onglet Ă restaurer. Cela se trouve dans la propriĂ©tĂ© `sessionId` de l'objet  {{WebExtAPIRef("tabs.Tab", "Tab")}} ou {{WebExtAPIRef("windows.Window", "Window")}} dans {{WebExtAPIRef("sessions.Session", "Session")}} retournĂ© de {{WebExtAPIRef("sessions.getRecentlyClosed()")}}. -<h3 id="Valeur_renvoyĂ©e">Valeur renvoyĂ©e</h3> +### Valeur renvoyĂ©e -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>. Cela sera rempli avec un objet {{WebExtAPIRef("sessions.Session", "Session")}} reprĂ©sentant la session qui a Ă©tĂ© restaurĂ©e.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Cela sera rempli avec un objet {{WebExtAPIRef("sessions.Session", "Session")}} reprĂ©sentant la session qui a Ă©tĂ© restaurĂ©e. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.restore")}}</p> +{{Compat("webextensions.api.sessions.restore")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cela restaure la session fermĂ©e la plus rĂ©cente, qu'il s'agisse d'une fenĂȘtre ou d'un onglet :</p> +Cela restaure la session fermĂ©e la plus rĂ©cente, qu'il s'agisse d'une fenĂȘtre ou d'un onglet : -<pre class="brush: js">function restoreMostRecent(sessionInfos) { +```js +function restoreMostRecent(sessionInfos) { if (!sessionInfos.length) { console.log("No sessions found") return; @@ -67,19 +67,17 @@ browser.browserAction.onClicked.addListener(function() { }); gettingSessions.then(restoreMostRecent, onError); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.sessions`](https://developer.chrome.com/extensions/sessions). +> +> 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/sessions"><code>chrome.sessions</code></a>.</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 @@ -106,5 +104,4 @@ browser.browserAction.onClicked.addListener(function() { // 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/sessions/session/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/session/index.md index 389fca9b5f..5541af7be6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/session/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/session/index.md @@ -13,47 +13,41 @@ tags: - sessions translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/Session --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'objet de <code>Session</code> reprĂ©sente un onglet ou une fenĂȘtre que l'utilisateur a fermĂ© dans la session de navigation actuelle.</p> +L'objet de `Session` reprĂ©sente un onglet ou une fenĂȘtre que l'utilisateur a fermĂ© dans la session de navigation actuelle. -<p>Les sessions sont reprĂ©sentĂ©es comme des objets {{WebExtAPIRef("tabs.Tab", "Tab")}} si l'onglet a Ă©tĂ© fermĂ© mais sa fenĂȘtre n'a pas Ă©tĂ© fermĂ©e : par exemple, parce que l'utilisateur a cliquĂ© sur le bouton "fermer l'onglet", et cet onglet n'Ă©tait pas le seul onglet de sa fenĂȘtre.</p> +Les sessions sont reprĂ©sentĂ©es comme des objets {{WebExtAPIRef("tabs.Tab", "Tab")}} si l'onglet a Ă©tĂ© fermĂ© mais sa fenĂȘtre n'a pas Ă©tĂ© fermĂ©e : par exemple, parce que l'utilisateur a cliquĂ© sur le bouton "fermer l'onglet", et cet onglet n'Ă©tait pas le seul onglet de sa fenĂȘtre. -<p>Les sessions sont reprĂ©sentĂ©es par des objets {{WebExtAPIRef("windows.Window", "Window")}} si la fenĂȘtre est fermĂ©e : parce que l'utilisateur a cliquĂ© sur le bouton "Fermer la fenĂȘtre", ou a fermĂ© le seul onglet ouvert dans une fenĂȘtre.</p> +Les sessions sont reprĂ©sentĂ©es par des objets {{WebExtAPIRef("windows.Window", "Window")}} si la fenĂȘtre est fermĂ©e : parce que l'utilisateur a cliquĂ© sur le bouton "Fermer la fenĂȘtre", ou a fermĂ© le seul onglet ouvert dans une fenĂȘtre. -<p>Notez que les diffĂ©rents navigateurs peuvent avoir une idĂ©e diffĂ©rente quand une session est un onglet et quand il s'agit d'une fenĂȘtre. Par exemple :</p> +Notez que les diffĂ©rents navigateurs peuvent avoir une idĂ©e diffĂ©rente quand une session est un onglet et quand il s'agit d'une fenĂȘtre. Par exemple : -<ul> - <li>Dans Chrome une session est enregistrĂ©e comme une fenĂȘtre si l'utilisateur ferme une fenĂȘtre contenant plus d'un onglet. Si l'utilisateur a fermĂ© une fenĂȘtre contenant un seul onglet, ceci est enregistrĂ© sous forme d'onglet.</li> - <li>Dans Firefox, une session est enregistrĂ©e comme une fenĂȘtre si l'utilisateur ferme une fenĂȘtre (ou un onglet qui Ă©tait le dernier onglet de la fenĂȘtre), et un onglet si l'utilisateur ferme un onglet qui n'Ă©tait pas le dernier onglet de sa fenĂȘtre.</li> -</ul> +- Dans Chrome une session est enregistrĂ©e comme une fenĂȘtre si l'utilisateur ferme une fenĂȘtre contenant plus d'un onglet. Si l'utilisateur a fermĂ© une fenĂȘtre contenant un seul onglet, ceci est enregistrĂ© sous forme d'onglet. +- Dans Firefox, une session est enregistrĂ©e comme une fenĂȘtre si l'utilisateur ferme une fenĂȘtre (ou un onglet qui Ă©tait le dernier onglet de la fenĂȘtre), et un onglet si l'utilisateur ferme un onglet qui n'Ă©tait pas le dernier onglet de sa fenĂȘtre. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>lastModified</code></dt> - <dd><code>number</code>. L'heure oĂč l'onglet ou la fenĂȘtre a Ă©tĂ© fermĂ©, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>tab</code>{{optional_inline}}</dt> - <dd><code>object</code>. Si l'objet reprĂ©sente un onglet fermĂ©, cette propriĂ©tĂ© est prĂ©sente et sera un objet {{WebExtAPIRef("tabs.Tab")}}. Cela contiendra <code>url</code>, <code>titre</code>, et <code>favIconUrl</code> uniquement si l'extension possĂšde la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "tabs".</dd> - <dt><code>window</code>{{optional_inline}}</dt> - <dd><code>object</code>. Si l'objet reprĂ©sente une fenĂȘtre fermĂ©e, cette propriĂ©tĂ© est prĂ©sente et sera un objet {{WebExtAPIRef("windows.Window")}}.</dd> -</dl> +- `lastModified` + - : `number`. L'heure oĂč l'onglet ou la fenĂȘtre a Ă©tĂ© fermĂ©, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `tab`{{optional_inline}} + - : `object`. Si l'objet reprĂ©sente un onglet fermĂ©, cette propriĂ©tĂ© est prĂ©sente et sera un objet {{WebExtAPIRef("tabs.Tab")}}. Cela contiendra `url`, `titre`, et `favIconUrl` uniquement si l'extension possĂšde la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "tabs". +- `window`{{optional_inline}} + - : `object`. Si l'objet reprĂ©sente une fenĂȘtre fermĂ©e, cette propriĂ©tĂ© est prĂ©sente et sera un objet {{WebExtAPIRef("windows.Window")}}. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.Session")}}</p> +{{Compat("webextensions.api.sessions.Session")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.sessions`](https://developer.chrome.com/extensions/sessions). +> +> 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/sessions"><code>chrome.sessions</code></a>.</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 @@ -80,5 +74,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/Session // 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/sessions/settabvalue/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/settabvalue/index.md index 64da5c051c..bf94e2cac6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/settabvalue/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/settabvalue/index.md @@ -12,47 +12,47 @@ tags: - setTabValue translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/setTabValue --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Stocke une paire clĂ© / valeur Ă associer Ă un onglet donnĂ©. Vous pouvez ensuite rĂ©cupĂ©rer cette valeur en utilisant {{WebExtAPIRef("sessions.getTabValue")}}.</p> +Stocke une paire clĂ© / valeur Ă associer Ă un onglet donnĂ©. Vous pouvez ensuite rĂ©cupĂ©rer cette valeur en utilisant {{WebExtAPIRef("sessions.getTabValue")}}. -<p>Notez que ces donnĂ©es ne seront visibles que par l'extension qui l'a dĂ©finie, et non par les autres extensions.</p> +Notez que ces donnĂ©es ne seront visibles que par l'extension qui l'a dĂ©finie, et non par les autres extensions. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 storing = browser.sessions.setTabValue( +```js +var storing = browser.sessions.setTabValue( tabId, // integer key, // string value // string or object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet avec lequel vous souhaitez associer les donnĂ©es.</dd> - <dt><code>key</code></dt> - <dd><code>string</code>. ClĂ© que vous pouvez utiliser ultĂ©rieurement pour rĂ©cupĂ©rer cette valeur de donnĂ©es particuliĂšre.</dd> - <dt><code>value</code></dt> - <dd><code>string</code> ou <code>object</code>. S'il s'agit d'un objet, il est <a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify">stringified</a>, donc les mĂ©thodes d'objet, par exemple, seront omises. Si une fonction est donnĂ©e ici, elle sera stockĂ©e sous la forme <code>null</code>.</dd> -</dl> +- `tabId` + - : `integer`. ID de l'onglet avec lequel vous souhaitez associer les donnĂ©es. +- `key` + - : `string`. ClĂ© que vous pouvez utiliser ultĂ©rieurement pour rĂ©cupĂ©rer cette valeur de donnĂ©es particuliĂšre. +- `value` + - : `string` ou `object`. S'il s'agit d'un objet, il est [stringified](/fr/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify), donc les mĂ©thodes d'objet, par exemple, seront omises. Si une fonction est donnĂ©e ici, elle sera stockĂ©e sous la forme `null`. -<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 rĂ©solue sans argument si l'appel a rĂ©ussi. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de l'onglet n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rĂ©solue sans argument si l'appel a rĂ©ussi. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de l'onglet n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.setTabValue", 10)}}</p> +{{Compat("webextensions.api.sessions.setTabValue", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©finissez une valeur sur l'onglet actif lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu. Notez que vous aurez besoin de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "menus" pour exĂ©cuter cet exemple :</p> +DĂ©finissez une valeur sur l'onglet actif lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu. Notez que vous aurez besoin de la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "menus" pour exĂ©cuter cet exemple : -<pre class="brush: js">async function setOnActiveTab() { +```js +async function setOnActiveTab() { let tabArray = await browser.tabs.query({currentWindow: true, active: true}); let tabId = tabArray[0].id; await browser.sessions.setTabValue(tabId, "my-key", "my-value"); @@ -64,6 +64,7 @@ browser.menus.create({ contexts: ["all"] }); -browser.menus.onClicked.addListener(setOnActiveTab);</pre> +browser.menus.onClicked.addListener(setOnActiveTab); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/setwindowvalue/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/setwindowvalue/index.md index c81dbd0ab1..60e60d9249 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/setwindowvalue/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/setwindowvalue/index.md @@ -12,47 +12,47 @@ tags: - setWindowsValue translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/setWindowValue --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Stocke une paire clĂ© / valeur Ă associer Ă une fenĂȘtre donnĂ©e. Vous pouvez ensuite rĂ©cupĂ©rer cette valeur en utilisant {{WebExtAPIRef("sessions.getWindowValue")}}.</p> +Stocke une paire clĂ© / valeur Ă associer Ă une fenĂȘtre donnĂ©e. Vous pouvez ensuite rĂ©cupĂ©rer cette valeur en utilisant {{WebExtAPIRef("sessions.getWindowValue")}}. -<p>Notez que ces donnĂ©es ne seront visibles que par l'extension qui l'a dĂ©finie, et non par les autres extensions..</p> +Notez que ces donnĂ©es ne seront visibles que par l'extension qui l'a dĂ©finie, et non par les autres extensions.. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 storing = browser.sessions.setWindowValue( +```js +var storing = browser.sessions.setWindowValue( windowId, // integer key, // string value // string or object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. ID de la fenĂȘtre avec laquelle vous souhaitez associer les donnĂ©es.</dd> - <dt><code>key</code></dt> - <dd><code>string</code>. ClĂ© que vous pouvez utiliser ultĂ©rieurement pour rĂ©cupĂ©rer cette valeur de donnĂ©es particuliĂšre.</dd> - <dt><code>value</code></dt> - <dd><code>string</code> ou <code>object</code>. S'il s'agit d'un objet, il est <a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify">stringified</a>, donc les mĂ©thodes d'objet, par exemple, seront omises. Si une fonction est donnĂ©e ici, elle sera stockĂ©e sous la valeur <code>null</code>.</dd> -</dl> +- `windowId` + - : `integer`. ID de la fenĂȘtre avec laquelle vous souhaitez associer les donnĂ©es. +- `key` + - : `string`. ClĂ© que vous pouvez utiliser ultĂ©rieurement pour rĂ©cupĂ©rer cette valeur de donnĂ©es particuliĂšre. +- `value` + - : `string` ou `object`. S'il s'agit d'un objet, il est [stringified](/fr/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify), donc les mĂ©thodes d'objet, par exemple, seront omises. Si une fonction est donnĂ©e ici, elle sera stockĂ©e sous la valeur `null`. -<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 rĂ©solue sans argument si l'appel a rĂ©ussi. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de la fenĂȘtre n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rĂ©solue sans argument si l'appel a rĂ©ussi. Si l'appel a Ă©chouĂ© (par exemple, parce que l'ID de la fenĂȘtre n'a pas pu ĂȘtre trouvĂ©), la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sessions.setWindowValue", 10)}}</p> +{{Compat("webextensions.api.sessions.setWindowValue", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©finissez une valeur sur la fenĂȘtre active lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu. Notez que vous aurez besoin de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "menus" pour exĂ©cuter cet exemple :</p> +DĂ©finissez une valeur sur la fenĂȘtre active lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu. Notez que vous aurez besoin de la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "menus" pour exĂ©cuter cet exemple : -<pre class="brush: js">async function setOnActiveWindow() { +```js +async function setOnActiveWindow() { let currentWindow = await browser.windows.getLastFocused(); await browser.sessions.setWindowValue(currentWindow.id, "my-key", "my-value"); } @@ -63,6 +63,7 @@ browser.menus.create({ contexts: ["all"] }); -browser.menus.onClicked.addListener(setOnActiveWindow);</pre> +browser.menus.onClicked.addListener(setOnActiveWindow); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/close/index.md b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/close/index.md index b2427227be..4ffd1a064a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/close/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/close/index.md @@ -12,43 +12,46 @@ tags: - sidebarAction translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/close --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ferme la barre latĂ©rale dans la fenĂȘtre active, s'il s'agit de la barre latĂ©rale de l'extension.</p> +Ferme la barre latĂ©rale dans la fenĂȘtre active, s'il s'agit de la barre latĂ©rale de l'extension. -<p>Vous pouvez uniquement appeler cette fonction Ă l'intĂ©rieur du gestionnaire pour une <a href="/fr/Add-ons/WebExtensions/User_actions">action utilisateur</a>.</p> +Vous pouvez uniquement appeler cette fonction Ă l'intĂ©rieur du gestionnaire pour une [action utilisateur](/fr/Add-ons/WebExtensions/User_actions). -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">browser.sidebarAction.close() -</pre> +```js +browser.sidebarAction.close() +``` -<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 est rĂ©solue sans arguments.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est rĂ©solue sans arguments. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sidebarAction.close", 10)}}</p> +{{Compat("webextensions.api.sidebarAction.close", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Fermez la barre latĂ©rale lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu contextuel :</p> +Fermez la barre latĂ©rale lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu contextuel : -<pre class="brush: js">browser.menus.create({ +```js +browser.menus.create({ id: "close-sidebar", title: "close sidebar", contexts: ["all"] }); -browser.menus.onClicked.addListener(() => { +browser.menus.onClicked.addListener(() => { browser.sidebarAction.close(); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/getpanel/index.md b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/getpanel/index.md index 7fad9684ca..a765683a60 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/getpanel/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/getpanel/index.md @@ -12,70 +12,68 @@ tags: - sidebarAction translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/getPanel --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient une URL vers le document HTML qui dĂ©finit le contenu de la barre latĂ©rale.</p> +Obtient une URL vers le document HTML qui dĂ©finit le contenu de la barre latĂ©rale. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingPanel = browser.sidebarAction.getPanel( +```js +var gettingPanel = browser.sidebarAction.getPanel( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Un objet avec les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Obtenir le panneau pour la barre latĂ©rale spĂ©cifique Ă l'onglet donnĂ©.</dd> - <dt><code>windowId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. Obtenir le panneau pour la barre latĂ©rale spĂ©cifique Ă la fenĂȘtre donnĂ©e.</dd> - </dl> - </dd> -</dl> +- `details` -<ul> - <li>Si <code>windowId</code> et <code>tabId</code>  sont tous deux fournis, la fonction Ă©choue et la promesse qu'elle renvoie est rejetĂ©e.</li> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous les deux omis, le panneau global est renvoyĂ©.</li> -</ul> + - : `object`. Un objet avec les propriĂ©tĂ©s suivantes : -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - `tabId`{{optional_inline}} + - : `integer`. Obtenir le panneau pour la barre latĂ©rale spĂ©cifique Ă l'onglet donnĂ©. + - `windowId` {{optional_inline}} + - : `integer`. Obtenir le panneau pour la barre latĂ©rale spĂ©cifique Ă la fenĂȘtre donnĂ©e. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec une chaĂźne contenant l'URL du document du panel. Ce sera une URL entiĂšrement qualifiĂ©e, telle que :</p> +<!----> -<pre>moz-extension://d1d8a2eb-fe60-f646-af30-a866c5b39942/sidebar.html</pre> +- Si `windowId` et `tabId`  sont tous deux fournis, la fonction Ă©choue et la promesse qu'elle renvoie est rejetĂ©e. +- Si `windowId` et `tabId` sont tous les deux omis, le panneau global est renvoyĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.sidebarAction.getPanel",2)}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec une chaĂźne contenant l'URL du document du panel. Ce sera une URL entiĂšrement qualifiĂ©e, telle que : -<h2 id="Exemples">Exemples</h2> + moz-extension://d1d8a2eb-fe60-f646-af30-a866c5b39942/sidebar.html -<p>Obtenez l'URL du panneau :</p> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function onGot(sidebarUrl) { +{{Compat("webextensions.api.sidebarAction.getPanel",2)}} + +## Exemples + +Obtenez l'URL du panneau : + +```js +function onGot(sidebarUrl) { console.log(sidebarUrl); } var gettingPanel = browser.sidebarAction.getPanel({}); -gettingPanel.then(onGot); </pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +gettingPanel.then(onGot); +``` -<p>Cette API est basĂ©e sur l'API Opera <a href="https://dev.opera.com/extensions/sidebar-action-api/"><code>chrome.sidebarAction</code></a>.</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 Opera [`chrome.sidebarAction`](https://dev.opera.com/extensions/sidebar-action-api/). +> +> 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 @@ -102,5 +100,4 @@ gettingPanel.then(onGot); </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/sidebaraction/gettitle/index.md b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/gettitle/index.md index bc68b38a9f..93d0fc7801 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/gettitle/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/gettitle/index.md @@ -12,53 +12,52 @@ tags: - sidebarAction translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/getTitle --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient le titre de la barre latĂ©rale.</p> +Obtient le titre de la barre latĂ©rale. -<p>Tout comme vous pouvez dĂ©finir le titre par tabulation Ă l'aide de {{WebExtAPIRef("sidebarAction.setTitle()")}},vous pouvez ainsi rĂ©cupĂ©rer un titre spĂ©cifique Ă un onglet en lui transmettant l'ID de l'onglet.</p> +Tout comme vous pouvez dĂ©finir le titre par tabulation Ă l'aide de {{WebExtAPIRef("sidebarAction.setTitle()")}},vous pouvez ainsi rĂ©cupĂ©rer un titre spĂ©cifique Ă un onglet en lui transmettant l'ID de l'onglet. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingTitle = browser.sidebarAction.getTitle( +```js +var gettingTitle = browser.sidebarAction.getTitle( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Un objet avec les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Obtenir le titre de la barre latĂ©rale spĂ©cifique Ă l'onglet donnĂ©.</dd> - <dt><code>windowId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. Obtenir le titre de la barre latĂ©rale spĂ©cifique Ă la fenĂȘtre donnĂ©e.</dd> - </dl> - </dd> -</dl> +- `details` -<ul> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous deux fournis, la fonction Ă©choue et la promesse qu'elle renvoie est rejetĂ©e.</li> - <li>SI <code>windowId</code> et <code>tabId</code> sont tous les deux omis, le titre global est renvoyĂ©.</li> -</ul> + - : `object`. Un objet avec les propriĂ©tĂ©s suivantes : -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - `tabId`{{optional_inline}} + - : `integer`. Obtenir le titre de la barre latĂ©rale spĂ©cifique Ă l'onglet donnĂ©. + - `windowId` {{optional_inline}} + - : `integer`. Obtenir le titre de la barre latĂ©rale spĂ©cifique Ă la fenĂȘtre donnĂ©e. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec une chaĂźne contenant le titre de la barre latĂ©rale.</p> +<!----> -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- Si `windowId` et `tabId` sont tous deux fournis, la fonction Ă©choue et la promesse qu'elle renvoie est rejetĂ©e. +- SI `windowId` et `tabId` sont tous les deux omis, le titre global est renvoyĂ©. -<p>{{Compat("webextensions.api.sidebarAction.getTitle",2)}}</p> +### Valeur retournĂ©e -<h2 id="Exemples">Exemples</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec une chaĂźne contenant le titre de la barre latĂ©rale. -<p>Ce code bascule le titre entre "this" et "that" chaque fois que l'utilisateur clique sur l'action du navigateur</p> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function toggleTitle(title) { +{{Compat("webextensions.api.sidebarAction.getTitle",2)}} + +## Exemples + +Ce code bascule le titre entre "this" et "that" chaque fois que l'utilisateur clique sur l'action du navigateur + +```js +function toggleTitle(title) { if (title == "this") { browser.sidebarAction.setTitle({title: "that"}); } else { @@ -66,23 +65,21 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/getTitle } } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { var gettingTitle = browser.sidebarAction.getTitle({}); gettingTitle.then(toggleTitle); }); -</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +``` -<p>Cette API est basĂ©e sur l'API Opera <a href="https://dev.opera.com/extensions/sidebar-action-api/"><code>chrome.sidebarAction</code></a>.</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 Opera [`chrome.sidebarAction`](https://dev.opera.com/extensions/sidebar-action-api/). +> +> 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 @@ -109,5 +106,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/sidebaraction/imagedatatype/index.md b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/imagedatatype/index.md index fe83bbe7e5..175aa9e7c6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/imagedatatype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/imagedatatype/index.md @@ -12,29 +12,27 @@ tags: - sidebarAction translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/ImageDataType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DonnĂ©es de pixel pour une image. Doit ĂȘtre un objet <code><a href="/fr/docs/Web/API/ImageData">ImageData</a></code> (par exemple, Ă partir d'un Ă©lĂ©ment {{htmlelement("canvas")}}).</p> +DonnĂ©es de pixel pour une image. Doit ĂȘtre un objet [`ImageData`](/fr/docs/Web/API/ImageData) (par exemple, Ă partir d'un Ă©lĂ©ment {{htmlelement("canvas")}}). -<h2 id="Type">Type</h2> +## Type -<p>Un objet <code><a href="/fr/docs/Web/API/ImageData">ImageData</a></code>.</p> +Un objet [`ImageData`](/fr/docs/Web/API/ImageData). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sidebarAction.ImageDataType")}}</p> +{{Compat("webextensions.api.sidebarAction.ImageDataType")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Opera [`chrome.sidebarAction`](https://dev.opera.com/extensions/sidebar-action-api/). +> +> 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 Opera <a href="https://dev.opera.com/extensions/sidebar-action-api/"><code>chrome.sidebarAction</code></a>.</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 @@ -61,5 +59,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/ImageDataType // 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/sidebaraction/index.md b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/index.md index d54988ca12..c9161c53b0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/index.md @@ -11,66 +11,58 @@ tags: - sidebarAction translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Obtient et dĂ©finit les propriĂ©tĂ©s de la barre latĂ©rale d'une extension.</p> +Obtient et dĂ©finit les propriĂ©tĂ©s de la barre latĂ©rale d'une extension. -<p>Une <a href="/fr/Add-ons/WebExtensions/Sidebars">barre latĂ©rale</a> est un volet qui s'affiche Ă gauche ou Ă droite de la fenĂȘtre du navigateur, Ă cĂŽtĂ© de la page Web. Le navigateur fournit une interface utilisateur qui permet Ă l'utilisateur de voir les barres latĂ©rales actuellement disponibles et de sĂ©lectionner une barre latĂ©rale Ă afficher. En utilisant la clĂ© <code><a href="/fr/Add-ons/WebExtensions/manifest.json/sidebar_action">sidebar_action</a></code> manifest.json, une extension peut dĂ©finir sa propre barre latĂ©rale.<br> - En utilisant l'API <code>sidebarAction</code> dĂ©crite ici, une extension peut obtenir et dĂ©finir les propriĂ©tĂ©s de la barre latĂ©rale.</p> +Une [barre latĂ©rale](/fr/Add-ons/WebExtensions/Sidebars) est un volet qui s'affiche Ă gauche ou Ă droite de la fenĂȘtre du navigateur, Ă cĂŽtĂ© de la page Web. Le navigateur fournit une interface utilisateur qui permet Ă l'utilisateur de voir les barres latĂ©rales actuellement disponibles et de sĂ©lectionner une barre latĂ©rale Ă afficher. En utilisant la clĂ© [`sidebar_action`](/fr/Add-ons/WebExtensions/manifest.json/sidebar_action) manifest.json, une extension peut dĂ©finir sa propre barre latĂ©rale. +En utilisant l'API `sidebarAction` dĂ©crite ici, une extension peut obtenir et dĂ©finir les propriĂ©tĂ©s de la barre latĂ©rale. -<p>L'API <code>sidebarAction</code> est Ă©troitement modĂ©lisĂ©e sur l'API {{WebExtAPIRef("browserAction")}}.</p> +L'API `sidebarAction` est Ă©troitement modĂ©lisĂ©e sur l'API {{WebExtAPIRef("browserAction")}}. -<p>L'API sidebarAction est basĂ©e sur l'<a href="https://dev.opera.com/extensions/sidebar-action-api/">API sidebarAction</a> d'OpĂ©ra. Toutefois, notez que les Ă©lĂ©ments suivants ne sont pas encore pris en charge : <code>setBadgeText()</code>, <code>getBadgeText()</code>, <code>setBadgeBackgroundColor()</code>, <code>getBadgeBackgroundColor()</code>, <code>onFocus</code>, <code>onBlur</code>.</p> +L'API sidebarAction est basĂ©e sur l'[API sidebarAction](https://dev.opera.com/extensions/sidebar-action-api/) d'OpĂ©ra. Toutefois, notez que les Ă©lĂ©ments suivants ne sont pas encore pris en charge : `setBadgeText()`, `getBadgeText()`, `setBadgeBackgroundColor()`, `getBadgeBackgroundColor()`, `onFocus`, `onBlur`. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("sidebarAction.ImageDataType")}}</dt> - <dd>DonnĂ©es de pixel pour une image. Doit ĂȘtre un objet <code><a href="/fr/docs/Web/API/ImageData">ImageData</a></code> (par exemple, Ă partir d'un Ă©lĂ©ment {{htmlelement("canvas")}}).</dd> -</dl> +- {{WebExtAPIRef("sidebarAction.ImageDataType")}} + - : DonnĂ©es de pixel pour une image. Doit ĂȘtre un objet [`ImageData`](/fr/docs/Web/API/ImageData) (par exemple, Ă partir d'un Ă©lĂ©ment {{htmlelement("canvas")}}). -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("sidebarAction.close()")}}</dt> - <dd>Ferme la barre latĂ©rale</dd> - <dt>{{WebExtAPIRef("sidebarAction.getPanel()")}}</dt> - <dd>Obtient le panneau de la barre latĂ©rale.</dd> - <dt>{{WebExtAPIRef("sidebarAction.getTitle()")}}</dt> - <dd>Obtient le titre de la barre latĂ©rale.</dd> - <dt>{{WebExtAPIRef("sidebarAction.isOpen()")}}</dt> - <dd>VĂ©rifie si la barre latĂ©rale est ouverte ou non.</dd> - <dt>{{WebExtAPIRef("sidebarAction.open()")}}</dt> - <dd>Ouvre la barre latĂ©rale.</dd> - <dt>{{WebExtAPIRef("sidebarAction.setIcon()")}}</dt> - <dd>DĂ©finit l'icĂŽne de la barre latĂ©rale.</dd> - <dt>{{WebExtAPIRef("sidebarAction.setPanel()")}}</dt> - <dd>DĂ©finit le panneau de la barre latĂ©rale.</dd> - <dt>{{WebExtAPIRef("sidebarAction.setTitle()")}}</dt> - <dd>DĂ©finit le titre de la barre latĂ©rale. Ceci sera affichĂ© dans n'importe quelle interface utilisateur fournie par le navigateur pour lister les barres latĂ©rales, comme un menu.</dd> - <dt>{{WebExtAPIRef("sidebarAction.toggle()")}}</dt> - <dd>Permet de basculer la visibilitĂ© de la barre latĂ©rale.</dd> -</dl> +- {{WebExtAPIRef("sidebarAction.close()")}} + - : Ferme la barre latĂ©rale +- {{WebExtAPIRef("sidebarAction.getPanel()")}} + - : Obtient le panneau de la barre latĂ©rale. +- {{WebExtAPIRef("sidebarAction.getTitle()")}} + - : Obtient le titre de la barre latĂ©rale. +- {{WebExtAPIRef("sidebarAction.isOpen()")}} + - : VĂ©rifie si la barre latĂ©rale est ouverte ou non. +- {{WebExtAPIRef("sidebarAction.open()")}} + - : Ouvre la barre latĂ©rale. +- {{WebExtAPIRef("sidebarAction.setIcon()")}} + - : DĂ©finit l'icĂŽne de la barre latĂ©rale. +- {{WebExtAPIRef("sidebarAction.setPanel()")}} + - : DĂ©finit le panneau de la barre latĂ©rale. +- {{WebExtAPIRef("sidebarAction.setTitle()")}} + - : DĂ©finit le titre de la barre latĂ©rale. Ceci sera affichĂ© dans n'importe quelle interface utilisateur fournie par le navigateur pour lister les barres latĂ©rales, comme un menu. +- {{WebExtAPIRef("sidebarAction.toggle()")}} + - : Permet de basculer la visibilitĂ© de la barre latĂ©rale. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sidebarAction")}}</p> +{{Compat("webextensions.api.sidebarAction")}} -<h2 id="Exemple_extensions">Exemple extensions</h2> +## Exemple extensions -<ul> - <li><a href="https://github.com/mdn/webextensions-examples/tree/master/annotate-page">annotate-page</a></li> -</ul> +- [annotate-page](https://github.com/mdn/webextensions-examples/tree/master/annotate-page) -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Opera [`chrome.sidebarAction`](https://dev.opera.com/extensions/sidebar-action-api/). +> +> 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 Opera <a href="https://dev.opera.com/extensions/sidebar-action-api/"><code>chrome.sidebarAction</code></a>.</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 @@ -97,5 +89,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction // 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/sidebaraction/isopen/index.md b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/isopen/index.md index 2294aeae32..cd491161ad 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/isopen/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/isopen/index.md @@ -12,67 +12,65 @@ tags: - slidebarAction translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/isOpen --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Renvoie <code>true</code> si la barre latĂ©rale de l'extension est ouverte dans une fenĂȘtre donnĂ©e.</p> +Renvoie `true` si la barre latĂ©rale de l'extension est ouverte dans une fenĂȘtre donnĂ©e. -<p>Cette fonction accepte un <code>windowId</code> en paramĂštre :</p> +Cette fonction accepte un `windowId` en paramĂštre : -<ul> - <li>Si vous fournissez <code>windowId</code>, la fonction vĂ©rifie la fenĂȘtre du navigateur.</li> - <li>Si vous omettez <code>windowId</code>, la fonction vĂ©rifie la fenĂȘtre du navigateur la plus haute.</li> -</ul> +- Si vous fournissez `windowId`, la fonction vĂ©rifie la fenĂȘtre du navigateur. +- Si vous omettez `windowId`, la fonction vĂ©rifie la fenĂȘtre du navigateur la plus haute. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">let gettingIsOpen = browser.sidebarAction.isOpen( +```js +let gettingIsOpen = browser.sidebarAction.isOpen( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Un objet contenant Ă©ventuellement le <code>windowId</code> Ă vĂ©rifier.</p> - <dl> - <dt><code>windowId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. ID d'une fenĂȘtre de navigateur Ă vĂ©rifier. Si omis par dĂ©faut, il s'agit de {{WebExtAPIRef("windows.WINDOW_ID_CURRENT")}}, qui fait rĂ©fĂ©rence Ă la fenĂȘtre du navigateur la plus haute.</dd> - </dl> - </dd> -</dl> +- `details` + - : `object`. Un objet contenant Ă©ventuellement le `windowId` Ă vĂ©rifier. + - `windowId` {{optional_inline}} + - : `integer`. ID d'une fenĂȘtre de navigateur Ă vĂ©rifier. Si omis par dĂ©faut, il s'agit de {{WebExtAPIRef("windows.WINDOW_ID_CURRENT")}}, qui fait rĂ©fĂ©rence Ă la fenĂȘtre du navigateur la plus haute. -<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 <code>true</code> si la barre latĂ©rale de l'extension est ouverte dans la fenĂȘtre donnĂ©e, ou <code>false</code> dans le cas contraire.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec `true` si la barre latĂ©rale de l'extension est ouverte dans la fenĂȘtre donnĂ©e, ou `false` dans le cas contraire. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sidebarAction.isOpen",2)}}</p> +{{Compat("webextensions.api.sidebarAction.isOpen",2)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>VĂ©rifiez la fenĂȘtre la plus haute :</p> +VĂ©rifiez la fenĂȘtre la plus haute : -<pre class="brush: js">browser.sidebarAction.isOpen({}).then(result => { +```js +browser.sidebarAction.isOpen({}).then(result => { console.log(result); -});</pre> +}); +``` -<p> VĂ©rifiez toutes les fenĂȘtres ouvertes :</p> +VĂ©rifiez toutes les fenĂȘtres ouvertes : -<pre class="brush: js">async function checkWindow(windowId) { +```js +async function checkWindow(windowId) { let result = await browser.sidebarAction.isOpen({windowId}); console.log(`window: ${windowId} status: ${result}`); } -browser.windows.getAll().then(all => { +browser.windows.getAll().then(all => { for (let {id} of all) { checkWindow(id); } -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/open/index.md b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/open/index.md index b0fbb77d1d..93d1de0eb8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/open/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/open/index.md @@ -11,47 +11,44 @@ tags: - sidebarAction translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/open --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Ouvrez la barre latĂ©rale dans la fenĂȘtre active. -<div>Ouvrez la barre latĂ©rale dans la fenĂȘtre active.</div> +Vous pouvez uniquement appeler cette fonction Ă l'intĂ©rieur du gestionnaire pour une [action utilisateur](/fr/Add-ons/WebExtensions/User_actions). -<div></div> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<div> -<p>Vous pouvez uniquement appeler cette fonction Ă l'intĂ©rieur du gestionnaire pour une <a href="/fr/Add-ons/WebExtensions/User_actions">action utilisateur</a>.</p> +## Syntaxe -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> -</div> +```js +browser.sidebarAction.open() +``` -<h2 id="Syntaxe">Syntaxe</h2> +### ParamĂštres -<pre class="brush: js">browser.sidebarAction.open() -</pre> +Aucun -<h3 id="ParamĂštres">ParamĂštres</h3> +### Valeur retournĂ©e -<p>Aucun</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est rĂ©solue sans arguments.. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +## CompatibilitĂ© du navigateur -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui est rĂ©solue sans arguments..</p> +{{Compat("webextensions.api.sidebarAction.open", 10)}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## Exemples -<p>{{Compat("webextensions.api.sidebarAction.open", 10)}}</p> +Ouvrez la barre latĂ©rale lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu contextuel : -<h2 id="Exemples">Exemples</h2> - -<p>Ouvrez la barre latĂ©rale lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment de menu contextuel :</p> - -<pre class="brush: js">browser.menus.create({ +```js +browser.menus.create({ id: "open-sidebar", title: "open sidebar", contexts: ["all"] }); -browser.menus.onClicked.addListener(() => { +browser.menus.onClicked.addListener(() => { browser.sidebarAction.open(); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/seticon/index.md b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/seticon/index.md index c9cf93f2f1..2e537b4db3 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/seticon/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/seticon/index.md @@ -12,101 +12,104 @@ tags: - sidebarAction translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/setIcon --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit l'icĂŽne de la barre latĂ©rale.</p> +DĂ©finit l'icĂŽne de la barre latĂ©rale. -<p>Vous pouvez spĂ©cifier une icĂŽne unique comme chemin d'accĂšs Ă un fichier image ou un objet {{WebExtAPIRef('sidebarAction.ImageDataType')}}.</p> +Vous pouvez spĂ©cifier une icĂŽne unique comme chemin d'accĂšs Ă un fichier image ou un objet {{WebExtAPIRef('sidebarAction.ImageDataType')}}. -<p>Vous pouvez spĂ©cifier plusieurs icĂŽnes de diffĂ©rentes tailles en fournissant un dictionnaire contenant plusieurs chemins ou objets <code>ImageData</code>. Cela signifie que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixels diffĂ©rente.</p> +Vous pouvez spĂ©cifier plusieurs icĂŽnes de diffĂ©rentes tailles en fournissant un dictionnaire contenant plusieurs chemins ou objets `ImageData`. Cela signifie que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixels diffĂ©rente. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Types_d'icĂŽnes">Types d'icĂŽnes</h2> +## Types d'icĂŽnes -<p>Votre extension doit spĂ©cifier une icĂŽne pour la barre latĂ©rale dans la clĂ© de manifest <a href="/fr/Add-ons/WebExtensions/manifest.json/sidebar_action">sidebar_action</a>. C'est ce qu'on appelle <em>"manifest icon"</em>.</p> +Votre extension doit spĂ©cifier une icĂŽne pour la barre latĂ©rale dans la clĂ© de manifest [sidebar_action](/fr/Add-ons/WebExtensions/manifest.json/sidebar_action). C'est ce qu'on appelle _"manifest icon"_. -<p>Si vous ne spĂ©cifiez pas d'icĂŽne dans la clĂ© sidebar_action, vous obtenez l'icĂŽne par dĂ©faut du navigateur. C'est ce qu'on appelle <em>"default icon"</em>.</p> +Si vous ne spĂ©cifiez pas d'icĂŽne dans la clĂ© sidebar_action, vous obtenez l'icĂŽne par dĂ©faut du navigateur. C'est ce qu'on appelle _"default icon"_. -<p>Si vous dĂ©finissez une nouvelle icĂŽne en utilisant <code>setIcon()</code>, et incluez l'option <code>tabId</code> , l'icĂŽne est dĂ©finie uniquement pour l'onglet donnĂ©. C'est ce qu'on appelle <em>"tab-specific icon"</em>.</p> +Si vous dĂ©finissez une nouvelle icĂŽne en utilisant `setIcon()`, et incluez l'option `tabId` , l'icĂŽne est dĂ©finie uniquement pour l'onglet donnĂ©. C'est ce qu'on appelle _"tab-specific icon"_. -<p>Si vous dĂ©finissez une nouvelle icĂŽne en utilisant <code>setIcon()</code>, et incluez l'option <code>windowId</code>, alors l'icĂŽne n'est dĂ©finie que pour la fenĂȘtre donnĂ©e. Cette icĂŽne est appelĂ©e <em>"icĂŽne spĂ©cifique Ă la fenĂȘtre"</em>, et apparaĂźtra dans tous les onglets de cette fenĂȘtre qui n'ont pas de jeu d'icĂŽnes spĂ©cifiques aux onglets.</p> +Si vous dĂ©finissez une nouvelle icĂŽne en utilisant `setIcon()`, et incluez l'option `windowId`, alors l'icĂŽne n'est dĂ©finie que pour la fenĂȘtre donnĂ©e. Cette icĂŽne est appelĂ©e _"icĂŽne spĂ©cifique Ă la fenĂȘtre"_, et apparaĂźtra dans tous les onglets de cette fenĂȘtre qui n'ont pas de jeu d'icĂŽnes spĂ©cifiques aux onglets. -<p>Si vous dĂ©finissez une nouvelle icĂŽne en utilisant <code>setIcon()</code>, et omettez l'option <code>tabId</code> and <code>windowId</code>, cela dĂ©finit <em>"icĂŽne globale"</em>. L'icĂŽne globale apparaĂźtra alors dans tous les onglets qui n'ont pas de jeu d'icĂŽnes spĂ©cifiques aux onglets et dont la fenĂȘtre n'a pas d'icĂŽne spĂ©cifique Ă la fenĂȘtre.</p> +Si vous dĂ©finissez une nouvelle icĂŽne en utilisant `setIcon()`, et omettez l'option `tabId` and `windowId`, cela dĂ©finit _"icĂŽne globale"_. L'icĂŽne globale apparaĂźtra alors dans tous les onglets qui n'ont pas de jeu d'icĂŽnes spĂ©cifiques aux onglets et dont la fenĂȘtre n'a pas d'icĂŽne spĂ©cifique Ă la fenĂȘtre. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var settingIcon = browser.sidebarAction.setIcon( +```js +var settingIcon = browser.sidebarAction.setIcon( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Un Objet contenant des propriĂ©tĂ©s <code>imageData</code> ou <code>path</code>, et Ă©ventuellement une propriĂ©tĂ© <code>tabId</code>.</p> - <dl> - <dt><code>imageData</code>{{optional_inline}}</dt> - <dd> - <p><code>{{WebExtAPIRef('sidebarAction.ImageDataType')}}</code> ou <code>object</code>. C'est un objet <code>ImageData</code> unique ou un objet dictionnaire.</p> +- `details` - <p>Utilisez un objet dictionnaire pour spĂ©cifier plusieurs objets <code>ImageData</code> dans diffĂ©rentes tailles, de sorte que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixels diffĂ©rente. Si <code>imageData</code> est un dictionnaire, la valeur de chaque propriĂ©tĂ© est un objet <code>ImageData</code>, et son nom est sa taille, comme ceci :</p> + - : `object`. Un Objet contenant des propriĂ©tĂ©s `imageData` ou `path`, et Ă©ventuellement une propriĂ©tĂ© `tabId`. - <pre class="brush: json">{ - 16: image16, - 32: image32 -}</pre> + - `imageData`{{optional_inline}} - <p>Le navigateur choisira l'image Ă utiliser en fonction de la densitĂ© de pixels de l'Ă©cran. Voir <a href="/fr/Add-ons/WebExtensions/manifest.json/browser_action#Choosing_icon_sizes">Choisir les tailles d'icĂŽnes</a> pour plus d'informations Ă ce sujet.</p> - </dd> - <dt><code>path</code>{{optional_inline}}</dt> - <dd> - <p><code>string</code> ou <code>object</code>. C'est soit un chemin relatif vers un fichier d'icĂŽne, soit un objet dictionnaire. </p> + - : `{{WebExtAPIRef('sidebarAction.ImageDataType')}}` ou `object`. C'est un objet `ImageData` unique ou un objet dictionnaire. - <p>Utilisez un objet de dictionnaire pour spĂ©cifier plusieurs fichiers d'icĂŽnes de diffĂ©rentes tailles, de sorte que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixels diffĂ©rente. Si <code>path</code> est un dictionnaire, la valeur de chaque propriĂ©tĂ© est un chemin relatif, et son nom est sa taille, comme ceci :</p> + Utilisez un objet dictionnaire pour spĂ©cifier plusieurs objets `ImageData` dans diffĂ©rentes tailles, de sorte que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixels diffĂ©rente. Si `imageData` est un dictionnaire, la valeur de chaque propriĂ©tĂ© est un objet `ImageData`, et son nom est sa taille, comme ceci : - <pre class="brush: json">{ - 16: "path/to/image16.jpg", - 32: "path/to/image32.jpg" -}</pre> + ```json + { + 16: image16, + 32: image32 + } + ``` - <p>Le navigateur choisira l'image Ă utiliser en fonction de la densitĂ© de pixels de l'Ă©cran. Voir <a href="/fr/Add-ons/WebExtensions/manifest.json/browser_action#Choosing_icon_sizes">Choosir les tailles d'icĂŽnes</a> pour plus d'informations Ă ce sujet.</p> + Le navigateur choisira l'image Ă utiliser en fonction de la densitĂ© de pixels de l'Ă©cran. Voir [Choisir les tailles d'icĂŽnes](/fr/Add-ons/WebExtensions/manifest.json/browser_action#Choosing_icon_sizes) pour plus d'informations Ă ce sujet. - <p>si <code>path</code> est une chaĂźne vide, le navigateur utilisera l'icĂŽne par dĂ©faut.</p> + - `path`{{optional_inline}} - <p>si <code>path</code> n'est pas vide mais ne pointe pas vers un fichier d'icĂŽne, l'icĂŽne est masquĂ©e.</p> + - : `string` ou `object`. C'est soit un chemin relatif vers un fichier d'icĂŽne, soit un objet dictionnaire. - <p>si <code>path</code> est <code>null</code>, et <code>tabId</code>a Ă©tĂ© spĂ©cifiĂ©, et que l'onglet spĂ©cifiĂ© possĂšde un jeu d'icĂŽnes spĂ©cifique Ă l'onglet: l'icĂŽne spĂ©cifique Ă l'onglet est rĂ©initialisĂ©e Ă l'icĂŽne globale (si une icĂŽne globale est dĂ©finie) ou Ă l'icĂŽne manifeste.</p> + Utilisez un objet de dictionnaire pour spĂ©cifier plusieurs fichiers d'icĂŽnes de diffĂ©rentes tailles, de sorte que l'icĂŽne ne doit pas ĂȘtre mise Ă l'Ă©chelle pour un pĂ©riphĂ©rique avec une densitĂ© de pixels diffĂ©rente. Si `path` est un dictionnaire, la valeur de chaque propriĂ©tĂ© est un chemin relatif, et son nom est sa taille, comme ceci : - <p>si <code>path</code> est <code>null</code>, et <code>tabId</code> a Ă©tĂ© omis, et qu'il y avait un jeu d'icĂŽnes global, il sera rĂ©initialisĂ© Ă l'icĂŽne de manifest.</p> - </dd> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit l'icĂŽne uniquement pour l'onglet donnĂ©.</dd> - <dt><code>windowId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit l'icĂŽne uniquement pour la fenĂȘtre donnĂ©e.</dd> - </dl> - </dd> -</dl> + ```json + { + 16: "path/to/image16.jpg", + 32: "path/to/image32.jpg" + } + ``` -<ul> - <li>Si <code>windowId</code>et <code>tabId</code> sont tous deux spĂ©cifiĂ©s, la fonction Ă©choue et l'icĂŽne n'est pas dĂ©finie.</li> - <li>SI <code>windowId</code> et <code>tabId</code> sont tous deux omis, l'icĂŽne est dĂ©finie globalement.</li> -</ul> + Le navigateur choisira l'image Ă utiliser en fonction de la densitĂ© de pixels de l'Ă©cran. Voir [Choosir les tailles d'icĂŽnes](/fr/Add-ons/WebExtensions/manifest.json/browser_action#Choosing_icon_sizes) pour plus d'informations Ă ce sujet. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + si `path` est une chaĂźne vide, le navigateur utilisera l'icĂŽne par dĂ©faut. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans argument une fois l'icĂŽne dĂ©finie.</p> + si `path` n'est pas vide mais ne pointe pas vers un fichier d'icĂŽne, l'icĂŽne est masquĂ©e. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + si `path` est `null`, et `tabId`a Ă©tĂ© spĂ©cifiĂ©, et que l'onglet spĂ©cifiĂ© possĂšde un jeu d'icĂŽnes spĂ©cifique Ă l'onglet: l'icĂŽne spĂ©cifique Ă l'onglet est rĂ©initialisĂ©e Ă l'icĂŽne globale (si une icĂŽne globale est dĂ©finie) ou Ă l'icĂŽne manifeste. -<p>{{Compat("webextensions.api.sidebarAction.setIcon",2)}}</p> + si `path` est `null`, et `tabId` a Ă©tĂ© omis, et qu'il y avait un jeu d'icĂŽnes global, il sera rĂ©initialisĂ© Ă l'icĂŽne de manifest. -<h2 id="Exemples">Exemples</h2> + - `tabId`{{optional_inline}} + - : `integer`. DĂ©finit l'icĂŽne uniquement pour l'onglet donnĂ©. + - `windowId` {{optional_inline}} + - : `integer`. DĂ©finit l'icĂŽne uniquement pour la fenĂȘtre donnĂ©e. -<p>Le code ci-dessous bascule l'icĂŽne de la barre latĂ©rale de l'onglet actif lorsque l'utilisateur clique sur une action du navigateur :</p> +<!----> -<pre class="brush: js">var on = false; +- Si `windowId`et `tabId` sont tous deux spĂ©cifiĂ©s, la fonction Ă©choue et l'icĂŽne n'est pas dĂ©finie. +- SI `windowId` et `tabId` sont tous deux omis, l'icĂŽne est dĂ©finie globalement. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument une fois l'icĂŽne dĂ©finie. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.sidebarAction.setIcon",2)}} + +## Exemples + +Le code ci-dessous bascule l'icĂŽne de la barre latĂ©rale de l'onglet actif lorsque l'utilisateur clique sur une action du navigateur : + +```js +var on = false; function toggle(tab) { if (on) { @@ -124,11 +127,11 @@ function toggle(tab) { } } -browser.browserAction.onClicked.addListener(toggle);</pre> - -<p>{{WebExtExamples}}</p> +browser.browserAction.onClicked.addListener(toggle); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Opera <a href="https://dev.opera.com/extensions/sidebar-action-api/"><code>chrome.sidebarAction</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Opera [`chrome.sidebarAction`](https://dev.opera.com/extensions/sidebar-action-api/). diff --git a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/setpanel/index.md b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/setpanel/index.md index c2dbef6ee2..d7681c8ab3 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/setpanel/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/setpanel/index.md @@ -12,61 +12,62 @@ tags: - sidebarAction translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/setPanel --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit le panneau de la barre latĂ©rale: c'est-Ă -dire le document HTML qui dĂ©finit le contenu de cette barre latĂ©rale.</p> +DĂ©finit le panneau de la barre latĂ©rale: c'est-Ă -dire le document HTML qui dĂ©finit le contenu de cette barre latĂ©rale. -<h2 id="Types_de_panneau">Types de panneau</h2> +## Types de panneau -<p>Les barres latĂ©rales ont toujours un <em>"panneau manifest"</em>, qui est le panneau dĂ©fini dans la clĂ© de manifest <code><a href="/fr/Add-ons/WebExtensions/manifest.json/sidebar_action">sidebar_action</a></code>.</p> +Les barres latĂ©rales ont toujours un _"panneau manifest"_, qui est le panneau dĂ©fini dans la clĂ© de manifest [`sidebar_action`](/fr/Add-ons/WebExtensions/manifest.json/sidebar_action). -<p>Si vous dĂ©finissez un nouveau panneau Ă l'aide de <code>setPanel()</code>, et incluez l'option <code>tabId</code> le panneau est dĂ©fini uniquement pour l'onglet donnĂ©. Ce panneau est appelĂ©Â <em>"tab-specific panel"</em>.</p> +Si vous dĂ©finissez un nouveau panneau Ă l'aide de `setPanel()`, et incluez l'option `tabId` le panneau est dĂ©fini uniquement pour l'onglet donnĂ©. Ce panneau est appelĂ©Â _"tab-specific panel"_. -<p>Si vous dĂ©finissez un nouveau panneau en utilisant <code>setPanel()</code>, et incluez l'option <code>windowId</code>, alors le panneau n'est dĂ©fini que pour la fenĂȘtre donnĂ©e.  Ce panneau est appelĂ© <em>"panneau spĂ©cifique Ă la fenĂȘtre"</em>, et apparaĂźtra dans tous les onglets de cette fenĂȘtre qui n'ont pas d'ensemble de panneaux spĂ©cifiques aux onglets.</p> +Si vous dĂ©finissez un nouveau panneau en utilisant `setPanel()`, et incluez l'option `windowId`, alors le panneau n'est dĂ©fini que pour la fenĂȘtre donnĂ©e.  Ce panneau est appelĂ© _"panneau spĂ©cifique Ă la fenĂȘtre"_, et apparaĂźtra dans tous les onglets de cette fenĂȘtre qui n'ont pas d'ensemble de panneaux spĂ©cifiques aux onglets. -<p>Si vous dĂ©finissez un nouveau panneau en utilisant <code>setPanel()</code>, et omettez les options <code>tabId</code> et <code>windowId</code>, alors ceci dĂ©finit le <em>"panneau global"</em>. Le panneau global apparaĂźtra alors dans tous les onglets qui n'ont pas d'ensemble de panneaux spĂ©cifiques aux onglets et dont la fenĂȘtre n'a pas de panneau spĂ©cifique Ă une fenĂȘtre.</p> +Si vous dĂ©finissez un nouveau panneau en utilisant `setPanel()`, et omettez les options `tabId` et `windowId`, alors ceci dĂ©finit le _"panneau global"_. Le panneau global apparaĂźtra alors dans tous les onglets qui n'ont pas d'ensemble de panneaux spĂ©cifiques aux onglets et dont la fenĂȘtre n'a pas de panneau spĂ©cifique Ă une fenĂȘtre. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.sidebarAction.setPanel( +```js +browser.sidebarAction.setPanel( details // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Un objet avec les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>panel</code></dt> - <dd><p><code>string</code> ou <code>null</code>. Le panneau Ă charger dans la barre latĂ©rale, spĂ©cifiĂ© comme une URL pointant vers un document HTML, ou <code>null</code>, ou une chaĂźne vide.</p> - <p>Ceci peut pointer vers un fichier empaquetĂ© dans l'extension (for exemple, crĂ©Ă© Ă l'aide de {{WebExtAPIRef("runtime.getURL")}}), ou un document distant (par exemple <code>https://example.org/</code>). Il doit s'agir d'une URL valide.</p> - <p>Si <code>panel</code> est <code>null</code> ou <code>""</code>,alors un panneau prĂ©cĂ©demment dĂ©fini sera supprimĂ©, de sorte que :</p> - <ul> - <li>Si <code>tabId</code> est spĂ©cifiĂ©, et que l'onglet a un jeu de panneaux spĂ©cifiques aux onglets, alors l'onglet hĂ©ritera du panneau Ă partir de la fenĂȘtre Ă laquelle il appartient.</li> - <li>Si <code>windowId</code> est spĂ©cifiĂ©, et que la fenĂȘtre a un jeu de panneaux spĂ©cifiques Ă la fenĂȘtre, alors la fenĂȘtre hĂ©ritera du panneau global.</li> - <li>Sinon, le panneau global sera rĂ©initialisĂ© au panneau manifest.</li> - </ul> - </dd> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit le panneau uniquement pour l'onglet donnĂ©.</dd> - <dt><code>windowId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit le panneau uniquement pour la fenĂȘtre donnĂ©e.</dd> - </dl> - </dd> -</dl> - -<ul> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous les deux spĂ©cifiĂ©s, la fonction Ă©choue et le panneau n'est pas dĂ©fini.</li> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous les deux omis, le panneau global est dĂ©fini.</li> -</ul> - -<h2 id="Exemples">Exemples</h2> - -<p>Ce code bascule le document de la barre latĂ©rale lorsque l'utilisateur clique sur une action du navigateur :</p> - -<pre class="brush: js">var thisPanel = browser.runtime.getURL("/this.html"); +``` + +### ParamĂštres + +- `details` + + - : `object`. Un objet avec les propriĂ©tĂ©s suivantes : + + - `panel` + + - : `string` ou `null`. Le panneau Ă charger dans la barre latĂ©rale, spĂ©cifiĂ© comme une URL pointant vers un document HTML, ou `null`, ou une chaĂźne vide. + + Ceci peut pointer vers un fichier empaquetĂ© dans l'extension (for exemple, crĂ©Ă© Ă l'aide de {{WebExtAPIRef("runtime.getURL")}}), ou un document distant (par exemple `https://example.org/`). Il doit s'agir d'une URL valide. + + Si `panel` est `null` ou `""`,alors un panneau prĂ©cĂ©demment dĂ©fini sera supprimĂ©, de sorte que : + + - Si `tabId` est spĂ©cifiĂ©, et que l'onglet a un jeu de panneaux spĂ©cifiques aux onglets, alors l'onglet hĂ©ritera du panneau Ă partir de la fenĂȘtre Ă laquelle il appartient. + - Si `windowId` est spĂ©cifiĂ©, et que la fenĂȘtre a un jeu de panneaux spĂ©cifiques Ă la fenĂȘtre, alors la fenĂȘtre hĂ©ritera du panneau global. + - Sinon, le panneau global sera rĂ©initialisĂ© au panneau manifest. + + - `tabId`{{optional_inline}} + - : `integer`. DĂ©finit le panneau uniquement pour l'onglet donnĂ©. + - `windowId` {{optional_inline}} + - : `integer`. DĂ©finit le panneau uniquement pour la fenĂȘtre donnĂ©e. + +<!----> + +- Si `windowId` et `tabId` sont tous les deux spĂ©cifiĂ©s, la fonction Ă©choue et le panneau n'est pas dĂ©fini. +- Si `windowId` et `tabId` sont tous les deux omis, le panneau global est dĂ©fini. + +## Exemples + +Ce code bascule le document de la barre latĂ©rale lorsque l'utilisateur clique sur une action du navigateur : + +```js +var thisPanel = browser.runtime.getURL("/this.html"); var thatPanel = browser.runtime.getURL("/that.html"); function toggle(panel) { @@ -77,26 +78,24 @@ function toggle(panel) { } } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { browser.sidebarAction.getPanel({}).then(toggle); }); -</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +``` -<p>{{Compat("webextensions.api.sidebarAction.setPanel",2)}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Opera <a href="https://dev.opera.com/extensions/sidebar-action-api/"><code>chrome.sidebarAction</code></a>.</p> +{{Compat("webextensions.api.sidebarAction.setPanel",2)}} -<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 Opera [`chrome.sidebarAction`](https://dev.opera.com/extensions/sidebar-action-api/). +> +> 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 @@ -123,5 +122,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/sidebaraction/settitle/index.md b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md index 7124845924..8753ee57ca 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/settitle/index.md @@ -12,85 +12,81 @@ tags: - sidebarAction translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/setTitle --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit le titre de la barre latĂ©rale. Le titre est affichĂ© n'importe oĂč dans les barres latĂ©rales du navigateur. Par exemple, Firefox l'affichera dans le menu "Affichage > Barre latĂ©rale". Il est Ă©galement affichĂ© en haut de la barre latĂ©rale lorsque la barre latĂ©rale est ouverte.</p> +DĂ©finit le titre de la barre latĂ©rale. Le titre est affichĂ© n'importe oĂč dans les barres latĂ©rales du navigateur. Par exemple, Firefox l'affichera dans le menu "Affichage > Barre latĂ©rale". Il est Ă©galement affichĂ© en haut de la barre latĂ©rale lorsque la barre latĂ©rale est ouverte. -<h2 id="Types_de_titres">Types de titres</h2> +## Types de titres -<p>Votre extension doit spĂ©cifier un titre pour la barre latĂ©rale dans la clĂ© de manifest <a href="/fr/Add-ons/WebExtensions/manifest.json/sidebar_action">sidebar_action</a>. C'est ce qu'on appelle le <em>"titre du manifest"</em>. Si vous ne spĂ©cifiez pas le titre du manifest, il sera par dĂ©faut le nom de l'extension</p> +Votre extension doit spĂ©cifier un titre pour la barre latĂ©rale dans la clĂ© de manifest [sidebar_action](/fr/Add-ons/WebExtensions/manifest.json/sidebar_action). C'est ce qu'on appelle le _"titre du manifest"_. Si vous ne spĂ©cifiez pas le titre du manifest, il sera par dĂ©faut le nom de l'extension -<p>Si vous dĂ©finissez un nouveau titre Ă l'aide de <code>setTitle()</code>, et incluez l'option <code>tabId</code> le titre est dĂ©fini uniquement pour l'onglet donnĂ©. Ce titre est appelĂ© <em>"titre spĂ©cifique Ă l'onglet"</em>.</p> +Si vous dĂ©finissez un nouveau titre Ă l'aide de `setTitle()`, et incluez l'option `tabId` le titre est dĂ©fini uniquement pour l'onglet donnĂ©. Ce titre est appelĂ© _"titre spĂ©cifique Ă l'onglet"_. +Si vous dĂ©finissez un nouveau titre Ă l'aide de `setTitle()`,  et incluez l'option `windowId`, alors le titre est dĂ©fini uniquement pour la fenĂȘtre donnĂ©e. Ce titre est appelĂ© _"titre spĂ©cifique Ă la fenĂȘtre"_, et apparaĂźtra dans tous les onglets de cette fenĂȘtre qui n'ont pas de titre spĂ©cifique Ă un onglet. +Si vous dĂ©finissez un nouveau titre Ă l'aide de `setTitle()`, et omettre les options `tabId` et `windowId`, alors ceci dĂ©finit le _"titre global"_. Le titre global apparaĂźtra alors dans tous les onglets qui n'ont pas de titre spĂ©cifique Ă un onglet et dont la fenĂȘtre n'a pas de titre spĂ©cifique Ă une fenĂȘtre. -<p>Si vous dĂ©finissez un nouveau titre Ă l'aide de <code>setTitle()</code>,  et incluez l'option <code>windowId</code>, alors le titre est dĂ©fini uniquement pour la fenĂȘtre donnĂ©e. Ce titre est appelĂ© <em>"titre spĂ©cifique Ă la fenĂȘtre"</em>, et apparaĂźtra dans tous les onglets de cette fenĂȘtre qui n'ont pas de titre spĂ©cifique Ă un onglet.</p> +## Syntaxe -<p>Si vous dĂ©finissez un nouveau titre Ă l'aide de <code>setTitle()</code>, et omettre les options <code>tabId</code> et <code>windowId</code>, alors ceci dĂ©finit le <em>"titre global"</em>. Le titre global apparaĂźtra alors dans tous les onglets qui n'ont pas de titre spĂ©cifique Ă un onglet et dont la fenĂȘtre n'a pas de titre spĂ©cifique Ă une fenĂȘtre.</p> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">browser.sidebarAction.setTitle( +```js +browser.sidebarAction.setTitle( details // object ) -</pre> +``` + +### ParamĂštres + +- `details` + + - : `object`. Un objet avec les propriĂ©tĂ©s suivantes . -<h3 id="ParamĂštres">ParamĂštres</h3> + - `title` -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Un objet avec les propriĂ©tĂ©s suivantes .</p> - <dl> - <dt><code>title</code></dt> - <dd><p><code>string</code> ou <code>null</code>. Le nouveau titre de la barre latĂ©rale.</p> - <p>si le <code>titre</code>  est une chaĂźne vide, le titre utilisĂ© sera le nom de l'extension, mais {{WebExtAPIRef("sidebarAction.getTitle")}} fournira toujours la chaĂźne vide.</p> + - : `string` ou `null`. Le nouveau titre de la barre latĂ©rale. - <p>Si le <code>titre</code> est <code>null</code>, alors un titre prĂ©cĂ©demment dĂ©fini sera supprimĂ©, de sorte que :</p> + si le `titre`  est une chaĂźne vide, le titre utilisĂ© sera le nom de l'extension, mais {{WebExtAPIRef("sidebarAction.getTitle")}} fournira toujours la chaĂźne vide. - <ul> - <li>Si <code>tabId</code> est spĂ©cifiĂ©, et que l'onglet a un jeu de titres spĂ©cifiques aux onglets, alors l'onglet hĂ©ritera du titre de la fenĂȘtre Ă laquelle il appartient.</li> - <li>Si <code>windowId</code> est spĂ©cifiĂ© et que la fenĂȘtre a un titre spĂ©cifique Ă la fenĂȘtre, alors la fenĂȘtre hĂ©ritera du titre global.</li> - <li>Sinon, le titre global sera rĂ©initialisĂ© au titre du manifest.</li> - </ul> - </dd> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit le titre uniquement pour l'onglet donnĂ©.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. DĂ©finit le titre uniquement pour la fenĂȘtre donnĂ©e.</dd> - </dl> - </dd> -</dl> + Si le `titre` est `null`, alors un titre prĂ©cĂ©demment dĂ©fini sera supprimĂ©, de sorte que : -<ul> - <li>Si <code>windowId</code> et <code>tabId</code> sont tous deux fournis, la fonction Ă©choue et le titre n'est pas dĂ©fini.</li> - <li>SI <code>windowId</code> et <code>tabId</code> sont tous les deux omis, le titre global est dĂ©finit.</li> -</ul> + - Si `tabId` est spĂ©cifiĂ©, et que l'onglet a un jeu de titres spĂ©cifiques aux onglets, alors l'onglet hĂ©ritera du titre de la fenĂȘtre Ă laquelle il appartient. + - Si `windowId` est spĂ©cifiĂ© et que la fenĂȘtre a un titre spĂ©cifique Ă la fenĂȘtre, alors la fenĂȘtre hĂ©ritera du titre global. + - Sinon, le titre global sera rĂ©initialisĂ© au titre du manifest. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `tabId`{{optional_inline}} + - : `integer`. DĂ©finit le titre uniquement pour l'onglet donnĂ©. + - `windowId`{{optional_inline}} + - : `integer`. DĂ©finit le titre uniquement pour la fenĂȘtre donnĂ©e. -<p>{{Compat("webextensions.api.sidebarAction.setTitle",2)}}</p> +<!----> -<h2 id="Exemples">Exemples</h2> +- Si `windowId` et `tabId` sont tous deux fournis, la fonction Ă©choue et le titre n'est pas dĂ©fini. +- SI `windowId` et `tabId` sont tous les deux omis, le titre global est dĂ©finit. -<p>Ce code modifie le titre de la barre latĂ©rale lorsque l'utilisateur clique sur une action du navigateur, mais uniquement pour l'onglet en cours :</p> +## CompatibilitĂ© du navigateur -<pre class="brush: js">var title = "A different title"; +{{Compat("webextensions.api.sidebarAction.setTitle",2)}} + +## Exemples + +Ce code modifie le titre de la barre latĂ©rale lorsque l'utilisateur clique sur une action du navigateur, mais uniquement pour l'onglet en cours : + +```js +var title = "A different title"; function setTitleForTab(tab) { browser.sidebarAction.setTitle({title, tabId: tab.id}); } -browser.browserAction.onClicked.addListener(setTitleForTab);</pre> - -<p>{{WebExtExamples}}</p> +browser.browserAction.onClicked.addListener(setTitleForTab); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Opera <a href="https://dev.opera.com/extensions/sidebar-action-api/"><code>chrome.sidebarAction</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Opera [`chrome.sidebarAction`](https://dev.opera.com/extensions/sidebar-action-api/). -<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 @@ -117,5 +113,4 @@ browser.browserAction.onClicked.addListener(setTitleForTab);</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/sidebaraction/toggle/index.md b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/toggle/index.md index d113f4c2ba..c2a3ab27e2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/toggle/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/sidebaraction/toggle/index.md @@ -12,43 +12,46 @@ tags: - toogle translation_of: Mozilla/Add-ons/WebExtensions/API/sidebarAction/toggle --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Permet de basculer la visibilitĂ© de la barre latĂ©rale dans la fenĂȘtre active, si la barre latĂ©rale appartient Ă l'extension.</p> +Permet de basculer la visibilitĂ© de la barre latĂ©rale dans la fenĂȘtre active, si la barre latĂ©rale appartient Ă l'extension. -<p>Vous ne pouvez appeler cette fonction que depuis l'intĂ©rieur du gestionnaire pour une <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/User_actions">action utilisateur</a>.</p> +Vous ne pouvez appeler cette fonction que depuis l'intĂ©rieur du gestionnaire pour une [action utilisateur](/fr/docs/Mozilla/Add-ons/WebExtensions/User_actions). -<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">browser.sidebarAction.toggle() -</pre> +```js +browser.sidebarAction.toggle() +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<p>Aucune.</p> +Aucune. -<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 est rĂ©solue sans discussion.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est rĂ©solue sans discussion. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.sidebarAction.toggle", 10)}}</p> +{{Compat("webextensions.api.sidebarAction.toggle", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Bascule la barre latĂ©rale lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment dans le menu contextuel :</p> +Bascule la barre latĂ©rale lorsque l'utilisateur sĂ©lectionne un Ă©lĂ©ment dans le menu contextuel : -<pre class="brush: js">browser.menus.create({ +```js +browser.menus.create({ id: "toggle-sidebar", title: "Toggle sidebar", contexts: ["all"] }); -browser.menus.onClicked.addListener(() => { +browser.menus.onClicked.addListener(() => { browser.sidebarAction.toggle(); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/storage/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/index.md index 3d4b1ba6b4..e1c917cc5a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/index.md @@ -12,73 +12,61 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/storage --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Permet aux extensions de stocker et de rĂ©cupĂ©rer des donnĂ©es et d'Ă©couter les modifications apportĂ©es aux Ă©lĂ©ments stockĂ©s.</p> +Permet aux extensions de stocker et de rĂ©cupĂ©rer des donnĂ©es et d'Ă©couter les modifications apportĂ©es aux Ă©lĂ©ments stockĂ©s. -<p>Le mĂ©canisme de stockage est basĂ© sur l'<a href="/fr/docs/Web/API/Web_Storage_API">API Web Storage</a>, Ă quelques diffĂ©rences prĂšs. Elles incluent entre autresâŻ:</p> +Le mĂ©canisme de stockage est basĂ© sur l'[API Web Storage](/fr/docs/Web/API/Web_Storage_API), Ă quelques diffĂ©rences prĂšs. Elles incluent entre autresâŻ: -<ul> - <li>Le mĂ©canisme est asynchrone.</li> - <li>La portĂ©e des valeurs s'Ă©tend Ă l'extension, pas Ă un domaine en particulier (c-Ă -d que les mĂȘmes paires clef/valeur sont disponibles pour tous les scripts d'arriĂšre-plan et de contenu).</li> - <li>Les valeurs stockĂ©es peuvent ĂȘtre de tout type compatible avec JSON et pas uniquement <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/String">String</a></code>. Ce qui inclut entre autres <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Array">Array</a></code> et <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code>, mais seulement si leur contenu peut ĂȘtre reprĂ©sentĂ© en JSON, ce qui exclut les nĆuds DOM. Il n'est pas nĂ©cessaire de convertir vos valeurs en JSON Strings avant de les stocker, mais elles sont reprĂ©sentĂ©es en JSON en interne, d'oĂč l'impĂ©ratif de compatibilitĂ©.</li> - <li>Plusieurs paires clef/valeur peuvent ĂȘtre rĂ©cupĂ©rĂ©es par un mĂȘme appel Ă l'API.</li> -</ul> +- Le mĂ©canisme est asynchrone. +- La portĂ©e des valeurs s'Ă©tend Ă l'extension, pas Ă un domaine en particulier (c-Ă -d que les mĂȘmes paires clef/valeur sont disponibles pour tous les scripts d'arriĂšre-plan et de contenu). +- Les valeurs stockĂ©es peuvent ĂȘtre de tout type compatible avec JSON et pas uniquement [`String`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String). Ce qui inclut entre autres [`Array`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Array) et [`Object`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Object), mais seulement si leur contenu peut ĂȘtre reprĂ©sentĂ© en JSON, ce qui exclut les nĆuds DOM. Il n'est pas nĂ©cessaire de convertir vos valeurs en JSON Strings avant de les stocker, mais elles sont reprĂ©sentĂ©es en JSON en interne, d'oĂč l'impĂ©ratif de compatibilitĂ©. +- Plusieurs paires clef/valeur peuvent ĂȘtre rĂ©cupĂ©rĂ©es par un mĂȘme appel Ă l'API. -<p>Pour utiliser cette API vous devez inclure la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> «âŻstorageâŻÂ» dans votre fichier <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json">manifest.json</a>.</p> +Pour utiliser cette API vous devez inclure la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) «âŻstorageâŻÂ» dans votre fichier [manifest.json](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json). -<p>Chaque extension a sa propre zone de stockage, qui peut ĂȘtre divisĂ©e entre plusieurs types de stockage.</p> +Chaque extension a sa propre zone de stockage, qui peut ĂȘtre divisĂ©e entre plusieurs types de stockage. -<p>Bien que cette API soit semblable Ă {{domxref("Window.localStorage")}} il est conseillĂ© de ne pas utiliser <code>Window.localStorage</code> dans le code de l'extension pour stocker ses donnĂ©es. Firefox effacera les donnĂ©es stockĂ©es via l'API localStorage par les extensions dans plusieurs scĂ©narios oĂč les utilisateurs effacent leur historique de navigation ou des donnĂ©es pour des raisons de confidentialitĂ©, alors que les donnĂ©es sauvĂ©es en utilisant l'API <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/local">storage.local</a></code> seront correctement conservĂ©es dans ces scĂ©narios.</p> +Bien que cette API soit semblable Ă {{domxref("Window.localStorage")}} il est conseillĂ© de ne pas utiliser `Window.localStorage` dans le code de l'extension pour stocker ses donnĂ©es. Firefox effacera les donnĂ©es stockĂ©es via l'API localStorage par les extensions dans plusieurs scĂ©narios oĂč les utilisateurs effacent leur historique de navigation ou des donnĂ©es pour des raisons de confidentialitĂ©, alors que les donnĂ©es sauvĂ©es en utilisant l'API [`storage.local`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/local) seront correctement conservĂ©es dans ces scĂ©narios. -<div class="note"> - <p><strong>Note :</strong> La zone de stockage n'est pas chiffrĂ©e et ne doit pas ĂȘtre utilisĂ©e pour stocker des informations confidentielles sur les utilisateurs.</p> -</div> +> **Note :** La zone de stockage n'est pas chiffrĂ©e et ne doit pas ĂȘtre utilisĂ©e pour stocker des informations confidentielles sur les utilisateurs. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("storage.StorageArea")}}</dt> - <dd>Un objet reprĂ©sentant la zone de stockage.</dd> - <dt>{{WebExtAPIRef("storage.StorageChange")}}</dt> - <dd>Un objet reprĂ©sentant une modification d'une zone de stockage.</dd> -</dl> +- {{WebExtAPIRef("storage.StorageArea")}} + - : Un objet reprĂ©sentant la zone de stockage. +- {{WebExtAPIRef("storage.StorageChange")}} + - : Un objet reprĂ©sentant une modification d'une zone de stockage. -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> +## PropriĂ©tĂ©s -<p><code>storage</code> a trois propriĂ©tĂ©s, qui reprĂ©sentent les diffĂ©rents types de zones de stockage disponibles.</p> +`storage` a trois propriĂ©tĂ©s, qui reprĂ©sentent les diffĂ©rents types de zones de stockage disponibles. -<dl> - <dt>{{WebExtAPIRef("storage.sync")}}</dt> - <dd>ReprĂ©sente la zone de stockage <code>sync</code>. Les items dans <code>sync</code> sont synchronisĂ©s par le navigateur, et disponibles pour toutes les instances de ce navigateur auxquelles l'utilisateur est connectĂ©, pour tous les appareils.</dd> - <dt>{{WebExtAPIRef("storage.local")}}</dt> - <dd>ReprĂ©sente la zone de stockage <code>local</code>. Les items dans <code>local</code> sont limitĂ©s Ă l'appareil sur lequel l'extension a Ă©tĂ© installĂ©e.</dd> - <dt>{{WebExtAPIRef("storage.managed")}}</dt> - <dd>ReprĂ©sente la zone de stockage <code>managed</code>. Les items dans <code>managed</code> sont en Ă©criture pour l'administrateur du domaine et en lecture seule pour l'extension. Tenter de modifier cet espace de nom renvoie une erreur.</dd> -</dl> +- {{WebExtAPIRef("storage.sync")}} + - : ReprĂ©sente la zone de stockage `sync`. Les items dans `sync` sont synchronisĂ©s par le navigateur, et disponibles pour toutes les instances de ce navigateur auxquelles l'utilisateur est connectĂ©, pour tous les appareils. +- {{WebExtAPIRef("storage.local")}} + - : ReprĂ©sente la zone de stockage `local`. Les items dans `local` sont limitĂ©s Ă l'appareil sur lequel l'extension a Ă©tĂ© installĂ©e. +- {{WebExtAPIRef("storage.managed")}} + - : ReprĂ©sente la zone de stockage `managed`. Les items dans `managed` sont en Ă©criture pour l'administrateur du domaine et en lecture seule pour l'extension. Tenter de modifier cet espace de nom renvoie une erreur. -<h2 id="ĂvĂ©nements">ĂvĂ©nements</h2> +## ĂvĂ©nements -<dl> - <dt>{{WebExtAPIRef("storage.onChanged")}}</dt> - <dd>ActivĂ© quand un ou plusieurs items d'une zone de stockage sont modifiĂ©s.</dd> -</dl> +- {{WebExtAPIRef("storage.onChanged")}} + - : ActivĂ© quand un ou plusieurs items d'une zone de stockage sont modifiĂ©s. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.storage")}}</p> +{{Compat("webextensions.api.storage")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</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 @@ -105,5 +93,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage // 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/storage/local/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/local/index.md index 05638d9208..cc4caeb2b2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/local/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/local/index.md @@ -13,55 +13,49 @@ tags: - local translation_of: Mozilla/Add-ons/WebExtensions/API/storage/local --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>ReprĂ©sente la zone de stockage <code>local</code>. Les Ă©lĂ©ments stockĂ©s <code>localement</code> sont locaux sur la machine sur laquelle l'extension a Ă©tĂ© installĂ©e.</p> +ReprĂ©sente la zone de stockage `local`. Les Ă©lĂ©ments stockĂ©s `localement` sont locaux sur la machine sur laquelle l'extension a Ă©tĂ© installĂ©e. -<p>Le navigateur peut limiter la quantitĂ© de donnĂ©es qu'une extension peut stocker dans la zone de stockage locale :</p> +Le navigateur peut limiter la quantitĂ© de donnĂ©es qu'une extension peut stocker dans la zone de stockage locale : -<ul> - <li>Chrome limite l'extension Ă 5 Mo de donnĂ©es Ă l'aide de cette API Ă moins qu'elle ne dispose de <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Unlimited_storage">permission "unlimitedStorage"</a>.</li> - <li>Firefox vous permet de demander la permission "unlimitedStorage" Ă partir de la version 56. Il ne limite pas encore la quantitĂ© de donnĂ©es que votre extension peut stocker, mais commencera Ă le faire dans une future version : c'est donc une bonne idĂ©e de demander la permission "unlimitedStorage" maintenant, si vous avez l'intention de stocker une grande quantitĂ© de donnĂ©es.</li> -</ul> +- Chrome limite l'extension Ă 5 Mo de donnĂ©es Ă l'aide de cette API Ă moins qu'elle ne dispose de [permission "unlimitedStorage"](/fr/Add-ons/WebExtensions/manifest.json/permissions#Unlimited_storage). +- Firefox vous permet de demander la permission "unlimitedStorage" Ă partir de la version 56. Il ne limite pas encore la quantitĂ© de donnĂ©es que votre extension peut stocker, mais commencera Ă le faire dans une future version : c'est donc une bonne idĂ©e de demander la permission "unlimitedStorage" maintenant, si vous avez l'intention de stocker une grande quantitĂ© de donnĂ©es. -<p>Lorsque l'extension est dĂ©sinstallĂ©e, son stockage local associĂ© est effacĂ©.</p> +Lorsque l'extension est dĂ©sinstallĂ©e, son stockage local associĂ© est effacĂ©. -<p>Toujours dans Firefox, vous pouvez empĂȘcher le navigateur d'effacer le stockage local lors de la dĂ©sinstallation en visitant "about:config" et en dĂ©finissant les deux prĂ©fĂ©rences de navigateur suivantes sur <code>true</code>: "keepUuidOnUninstall" et "keepStorageOnUninstall". Cette fonctionnalitĂ© est fournie pour aider les dĂ©veloppeurs Ă tester leurs extensions. Les extensions elles-mĂȘmes ne sont pas en mesure de modifier ces prĂ©fĂ©rences.</p> +Toujours dans Firefox, vous pouvez empĂȘcher le navigateur d'effacer le stockage local lors de la dĂ©sinstallation en visitant "about:config" et en dĂ©finissant les deux prĂ©fĂ©rences de navigateur suivantes sur `true`: "keepUuidOnUninstall" et "keepStorageOnUninstall". Cette fonctionnalitĂ© est fournie pour aider les dĂ©veloppeurs Ă tester leurs extensions. Les extensions elles-mĂȘmes ne sont pas en mesure de modifier ces prĂ©fĂ©rences. -<p>Bien que cette API soit similaire Ă {{domxref("Window.localStorage")}} il est recommandĂ© de ne pas utiliser <code>Window.localStorage</code> dans le code d'extension. Firefox effacera les donnĂ©es stockĂ©es par les extensions Ă l'aide de l'API localStorage dans divers scĂ©narios oĂč les utilisateurs effacent leur historique de navigation et leurs donnĂ©es pour des raisons de confidentialitĂ©, tandis que les donnĂ©es enregistrĂ©es avec l'API storage.local seront correctement conservĂ©es dans ces scĂ©narios.</p> +Bien que cette API soit similaire Ă {{domxref("Window.localStorage")}} il est recommandĂ© de ne pas utiliser `Window.localStorage` dans le code d'extension. Firefox effacera les donnĂ©es stockĂ©es par les extensions Ă l'aide de l'API localStorage dans divers scĂ©narios oĂč les utilisateurs effacent leur historique de navigation et leurs donnĂ©es pour des raisons de confidentialitĂ©, tandis que les donnĂ©es enregistrĂ©es avec l'API storage.local seront correctement conservĂ©es dans ces scĂ©narios. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +## MĂ©thodes -<p>L'objet <code>local</code> local implĂ©mente les mĂ©thodes dĂ©finies sur le type {{WebExtAPIRef("storage.StorageArea")}} :</p> +L'objet `local` local implĂ©mente les mĂ©thodes dĂ©finies sur le type {{WebExtAPIRef("storage.StorageArea")}} : -<dl> - <dt>{{WebExtAPIRef("storage.StorageArea.get()")}}</dt> - <dd>RĂ©cupĂšre un ou plusieurs Ă©lĂ©ments de la zone de stockage.</dd> - <dt>{{WebExtAPIRef("storage.StorageArea.getBytesInUse()")}}</dt> - <dd>Obtient la quantitĂ© d'espace de stockage (en octets) utilisĂ©e pour stocker un ou plusieurs Ă©lĂ©ments dans la zone de stockage.</dd> - <dt>{{WebExtAPIRef("storage.StorageArea.set()")}}</dt> - <dd>Stocke un ou plusieurs Ă©lĂ©ments dans la zone de stockage. Si l'Ă©lĂ©ment existe dĂ©jĂ , sa valeur sera mise Ă jour. Lorsque vous dĂ©finissez une valeur, l'Ă©vĂ©nement {{WebExtAPIRef("storage.onChanged")}} se dĂ©clenche.</dd> - <dt>{{WebExtAPIRef("storage.StorageArea.remove()")}}</dt> - <dd>Supprime un ou plusieurs Ă©lĂ©ments de la zone de stockage..</dd> - <dt>{{WebExtAPIRef("storage.StorageArea.clear()")}}</dt> - <dd>Supprime tous les Ă©lĂ©ments de la zone de stockage.</dd> -</dl> +- {{WebExtAPIRef("storage.StorageArea.get()")}} + - : RĂ©cupĂšre un ou plusieurs Ă©lĂ©ments de la zone de stockage. +- {{WebExtAPIRef("storage.StorageArea.getBytesInUse()")}} + - : Obtient la quantitĂ© d'espace de stockage (en octets) utilisĂ©e pour stocker un ou plusieurs Ă©lĂ©ments dans la zone de stockage. +- {{WebExtAPIRef("storage.StorageArea.set()")}} + - : Stocke un ou plusieurs Ă©lĂ©ments dans la zone de stockage. Si l'Ă©lĂ©ment existe dĂ©jĂ , sa valeur sera mise Ă jour. Lorsque vous dĂ©finissez une valeur, l'Ă©vĂ©nement {{WebExtAPIRef("storage.onChanged")}} se dĂ©clenche. +- {{WebExtAPIRef("storage.StorageArea.remove()")}} + - : Supprime un ou plusieurs Ă©lĂ©ments de la zone de stockage.. +- {{WebExtAPIRef("storage.StorageArea.clear()")}} + - : Supprime tous les Ă©lĂ©ments de la zone de stockage. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.storage.local")}}</p> +{{Compat("webextensions.api.storage.local")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</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 @@ -88,5 +82,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/local // 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/storage/managed/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/managed/index.md index 78cce96212..1eefd66b37 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/managed/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/managed/index.md @@ -13,21 +13,22 @@ tags: - managed translation_of: Mozilla/Add-ons/WebExtensions/API/storage/managed --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet {{WebExtAPIRef("storage.StorageArea")}} qui reprĂ©sente la zone de stockage gĂ©rĂ©e. Les Ă©lĂ©ments de stockage <code>gĂ©rĂ©</code> sont dĂ©finis par l'administrateur du domaine ou d'autres applications natives installĂ©es sur l'ordinateur de l'utilisateur et sont en lecture seule pour l'extension. Essayer de modifier cette zone de stockage entraĂźne une erreur.</p> +Un objet {{WebExtAPIRef("storage.StorageArea")}} qui reprĂ©sente la zone de stockage gĂ©rĂ©e. Les Ă©lĂ©ments de stockage `gĂ©rĂ©` sont dĂ©finis par l'administrateur du domaine ou d'autres applications natives installĂ©es sur l'ordinateur de l'utilisateur et sont en lecture seule pour l'extension. Essayer de modifier cette zone de stockage entraĂźne une erreur. -<h2 id="Provisionnement_du_stockage_gĂ©rĂ©">Provisionnement du stockage gĂ©rĂ©</h2> +## Provisionnement du stockage gĂ©rĂ© -<p>La procĂ©dure de provisionnement du stockage gĂ©rĂ© est diffĂ©rente selon les navigateurs. Firefox a sa propre mĂ©thode mais (Ă partir de Firefox 67) peut aussi utiliser la fonction Storage.managed de Chrome qui supporte un fichier <code>.json</code>. ((Voir Stockage Chrome gĂ©rĂ© ci-dessous.)</p> +La procĂ©dure de provisionnement du stockage gĂ©rĂ© est diffĂ©rente selon les navigateurs. Firefox a sa propre mĂ©thode mais (Ă partir de Firefox 67) peut aussi utiliser la fonction Storage.managed de Chrome qui supporte un fichier `.json`. ((Voir Stockage Chrome gĂ©rĂ© ci-dessous.) -<h3 id="manifestes_natives">manifestes natives</h3> +### manifestes natives -<p>Pour Firefox, vous devez crĂ©er un fichier manifest JSON dans un format spĂ©cifique, dans un emplacement spĂ©cifique. Pour plus de dĂ©tails sur la syntaxe et l'emplacement du manifeste, voir <a href="/fr/Add-ons/WebExtensions/Native_manifests">manifests natifs</a>.</p> +Pour Firefox, vous devez crĂ©er un fichier manifest JSON dans un format spĂ©cifique, dans un emplacement spĂ©cifique. Pour plus de dĂ©tails sur la syntaxe et l'emplacement du manifeste, voir [manifests natifs](/fr/Add-ons/WebExtensions/Native_manifests). -<p>Voici un exemple de manifest :</p> +Voici un exemple de manifest : -<pre class="brush: json">{ +```json +{ "name": "favourite-color-examples@mozilla.org", "description": "ignored", "type": "storage", @@ -35,38 +36,43 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/managed { "color": "management thinks it should be blue!" } -}</pre> +} +``` -<p>Compte tenu de ce manifeste, l'extension "favourite-color-examples@mozilla.org" pourrait accĂ©der aux donnĂ©es en utilisant un code comme celui-ci :</p> +Compte tenu de ce manifeste, l'extension "favourite-color-examples\@mozilla.org" pourrait accĂ©der aux donnĂ©es en utilisant un code comme celui-ci : -<pre class="brush: js">var storageItem = browser.storage.managed.get('color'); -storageItem.then((res) => { +```js +var storageItem = browser.storage.managed.get('color'); +storageItem.then((res) => { console.log(`Managed colur is: ${res.color}`); -});</pre> +}); +``` -<h3 id="Gestion_de_stockage_dans_Chrome">Gestion de stockage dans Chrome</h3> +### Gestion de stockage dans Chrome -<p>Firefox et Chrome supportent tous deux l'utilisation d'un manifeste pour les zones de stockage.</p> +Firefox et Chrome supportent tous deux l'utilisation d'un manifeste pour les zones de stockage. -<p>La zone de stockage gĂ©rĂ©e est configurĂ©e Ă l'aide d'un schĂ©ma JSON, qui est strictement validĂ© par Chrome et Firefox 67 ou supĂ©rieur. Stockez le schĂ©ma dans un fichier.json et pointez-le depuis la propriĂ©tĂ© "managed_schema" de la clĂ© de manifeste "storage" de l'extension web. Le fichier json dĂ©clare les stratĂ©gies d'entreprise supportĂ©es par l'extension.</p> +La zone de stockage gĂ©rĂ©e est configurĂ©e Ă l'aide d'un schĂ©ma JSON, qui est strictement validĂ© par Chrome et Firefox 67 ou supĂ©rieur. Stockez le schĂ©ma dans un fichier.json et pointez-le depuis la propriĂ©tĂ© "managed_schema" de la clĂ© de manifeste "storage" de l'extension web. Le fichier json dĂ©clare les stratĂ©gies d'entreprise supportĂ©es par l'extension. -<p>Les stratĂ©gies dĂ©finissent les options qui ont Ă©tĂ© configurĂ©es par un administrateur systĂšme au lieu de l'utilisateur. La gestion du stockage permet de prĂ©configurer une extension pour tous les utilisateurs d'une organisation.</p> +Les stratĂ©gies dĂ©finissent les options qui ont Ă©tĂ© configurĂ©es par un administrateur systĂšme au lieu de l'utilisateur. La gestion du stockage permet de prĂ©configurer une extension pour tous les utilisateurs d'une organisation. -<p>C'est Ă l'extension d'appliquer les stratĂ©gies configurĂ©es par l'administrateur. L'extension peut lire les stratĂ©gies Ă l'aide de l'API storage.managed.</p> +C'est Ă l'extension d'appliquer les stratĂ©gies configurĂ©es par l'administrateur. L'extension peut lire les stratĂ©gies Ă l'aide de l'API storage.managed. -<h4 id="manifest.json">manifest.json</h4> +#### manifest.json -<pre class="brush: js">{ +```js +{ "name": "chrome-storage-managed-examples@mozilla.org", "storage": { "managed_schema": "schema.json" }, } -</pre> +``` -<p>Le fichier json ressemblerait Ă ceci :</p> +Le fichier json ressemblerait Ă ceci : -<pre class="brush: json">{ +```json +{ "type": "object", // "properties" maps an optional key of this object to its schema. At the // top-level object, these keys are the policy names supported. @@ -87,23 +93,22 @@ storageItem.then((res) => { } } } -}</pre> - -<p>Pour plus d'informations, voir l'article de Chrome pour les zones de stockage <a href="https://developer.chrome.com/extensions/manifest/storage">Manifeste pour les zones de stockage</a>.</p> +} +``` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +Pour plus d'informations, voir l'article de Chrome pour les zones de stockage [Manifeste pour les zones de stockage](https://developer.chrome.com/extensions/manifest/storage). -<p>{{Compat("webextensions.api.storage.managed")}}</p> +## CompatibilitĂ© du navigateur -<p>{{WebExtExamples}}</p> +{{Compat("webextensions.api.storage.managed")}} -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. -<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 @@ -130,5 +135,4 @@ storageItem.then((res) => { // 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/storage/onchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/onchanged/index.md index 0f3d0acc00..83949fce09 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/onchanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/onchanged/index.md @@ -13,56 +13,51 @@ tags: - onChanged translation_of: Mozilla/Add-ons/WebExtensions/API/storage/onChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'un ou plusieurs Ă©lĂ©ments changent.</p> +LancĂ© lorsqu'un ou plusieurs Ă©lĂ©ments changent. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.storage.onChanged.addListener(callback) +```js +browser.storage.onChanged.addListener(callback) browser.storage.onChanged.removeListener(listener) browser.storage.onChanged.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code>s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true`s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>changes</code></dt> - <dd><code>object</code>. Objet dĂ©crivant le changement. Cela contient une propriĂ©tĂ© pour chaque clĂ© qui a changĂ©. Le nom de la propriĂ©tĂ© est le nom de la clĂ© qui a changĂ©, et sa valeur est un objet {{WebExtAPIRef('storage.StorageChange')}} dĂ©crivant la modification apportĂ©e Ă cet Ă©lĂ©ment.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>areaName</code></dt> - <dd><code>string</code>. Le nom de la zone de stockage (<code>"sync"</code>, <code>"local"</code> or <code>"managed"</code>) auquel les modifications ont Ă©tĂ© apportĂ©es.</dd> - </dl> - </dd> -</dl> + - `changes` + - : `object`. Objet dĂ©crivant le changement. Cela contient une propriĂ©tĂ© pour chaque clĂ© qui a changĂ©. Le nom de la propriĂ©tĂ© est le nom de la clĂ© qui a changĂ©, et sa valeur est un objet {{WebExtAPIRef('storage.StorageChange')}} dĂ©crivant la modification apportĂ©e Ă cet Ă©lĂ©ment. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + <!----> -<p>{{Compat("webextensions.api.storage.onChanged")}}</p> + - `areaName` + - : `string`. Le nom de la zone de stockage (`"sync"`, `"local"` or `"managed"`) auquel les modifications ont Ă©tĂ© apportĂ©es. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<pre class="brush: js">/* +{{Compat("webextensions.api.storage.onChanged")}} + +## Exemples + +```js +/* Log the storage area that changed, then for each item changed, log its old value and its new value. @@ -82,19 +77,17 @@ function logStorageChange(changes, area) { } browser.storage.onChanged.addListener(logStorageChange); -</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/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</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.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -121,5 +114,4 @@ browser.storage.onChanged.addListener(logStorageChange); // 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/storage/storagearea/clear/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/clear/index.md index e421d7113f..fee6c19907 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/clear/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/clear/index.md @@ -14,34 +14,36 @@ tags: - remove translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/clear --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime tous les Ă©lĂ©ments de la zone de stockage.</p> +Supprime tous les Ă©lĂ©ments de la zone de stockage. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 clearing = browser.storage.<storageType>.clear() -</pre> +```js +var clearing = browser.storage.<storageType>.clear() +``` -<p><code><storageType> </code>sera l'un des types de stockage accessibles en Ă©criture â {{WebExtAPIRef("storage.sync")}} or {{WebExtAPIRef("storage.local")}}.</p> +`<storageType> `sera l'un des types de stockage accessibles en Ă©criture â {{WebExtAPIRef("storage.sync")}} or {{WebExtAPIRef("storage.local")}}. -<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 remplie sans arguments si l'opĂ©ration a rĂ©ussi. Si l'opĂ©ration a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur..</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments si l'opĂ©ration a rĂ©ussi. Si l'opĂ©ration a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur.. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.storage.StorageArea.clear")}}</p> +{{Compat("webextensions.api.storage.StorageArea.clear")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function onCleared() { +```js +function onCleared() { console.log("OK"); } @@ -50,13 +52,13 @@ function onError(e) { } var clearStorage = browser.storage.local.clear(); -clearStorage.then(onCleared, onError);</pre> +clearStorage.then(onCleared, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.md index 29a65c3e62..f527cd543b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.md @@ -14,94 +14,102 @@ tags: - get translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/get --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>RĂ©cupĂšre un ou plusieurs Ă©lĂ©ments de la zone de stockage.</p> +RĂ©cupĂšre un ou plusieurs Ă©lĂ©ments de la zone de stockage. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">let gettingItem = browser.storage.<storageType>.get( - keys // null, string, object or array of strings -) -</pre> + let gettingItem = browser.storage.<storageType>.get( + keys // null, string, object or array of strings + ) -<p><code><storageType></code> sera l'un des types de stockage accessibles en Ă©criture â {{WebExtAPIRef("storage.sync", "sync")}}, {{WebExtAPIRef("storage.local", "local")}}, ou {{WebExtAPIRef("storage.managed", "managed")}}.</p> +`<storageType>` sera l'un des types de stockage accessibles en Ă©criture â {{WebExtAPIRef("storage.sync", "sync")}}, {{WebExtAPIRef("storage.local", "local")}}, ou {{WebExtAPIRef("storage.managed", "managed")}}. -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>keys</code></dt> - <dd>Une clĂ© (chaĂźne) ou des clĂ©s (un tableau de chaĂźnes ou un objet spĂ©cifiant des valeurs par dĂ©faut) pour identifier le ou les articles Ă extraire du stockage. Si vous passez une chaĂźne vide, un objet ou un tableau ici, un objet vide sera rĂ©cupĂ©rĂ©. Si vous passez <code>null</code>,  ou une valeur indĂ©finie, le contenu entier du stockage sera rĂ©cupĂ©rĂ©.</dd> -</dl> +- `keys` + - : Une clĂ© (chaĂźne) ou des clĂ©s (un tableau de chaĂźnes ou un objet spĂ©cifiant des valeurs par dĂ©faut) pour identifier le ou les articles Ă extraire du stockage. Si vous passez une chaĂźne vide, un objet ou un tableau ici, un objet vide sera rĂ©cupĂ©rĂ©. Si vous passez `null`,  ou une valeur indĂ©finie, le contenu entier du stockage sera rĂ©cupĂ©rĂ©. -<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 de <code>resultat</code> contenant tous les objets dans les <code>clefs</code> trouvĂ©es dans la zone de stockage. Si l'opĂ©ration a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur. Si le stockage gĂ©rĂ© n'est pas dĂ©fini, les donnĂ©es <code>non dĂ©finies</code> seront retournĂ©es.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet de `resultat` contenant tous les objets dans les `clefs` trouvĂ©es dans la zone de stockage. Si l'opĂ©ration a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur. Si le stockage gĂ©rĂ© n'est pas dĂ©fini, les donnĂ©es `non dĂ©finies` seront retournĂ©es. -<div class="warning"> -<p><strong>Attention :</strong> Lorsqu'elle est utilisĂ©e dans un script de contenu dans les versions de Firefox antĂ©rieures Ă 52, la promesse retournĂ©e par <code>browser.storage.local.get()</code> est remplie avec un tableau contenant un objet. L'objet dans le tableau contient les <code>clefs</code> trouvĂ©es dans la zone de stockage, comme dĂ©crit ci-dessus. La promesse est correctement remplie avec un objet lorsqu'il est utilisĂ© dans le contexte d'arriĂšre-plan<br> - (scripts d'arriĂšre-plan, popups, pages d'options, etc.). Lorsque cette API est utilisĂ©e en tant que <code>chrome.storage.local.get()</code>, elle transmet correctement un objet Ă la fonction de rappel.</p> -</div> +> **Attention :** Lorsqu'elle est utilisĂ©e dans un script de contenu dans les versions de Firefox antĂ©rieures Ă 52, la promesse retournĂ©e par `browser.storage.local.get()` est remplie avec un tableau contenant un objet. L'objet dans le tableau contient les `clefs` trouvĂ©es dans la zone de stockage, comme dĂ©crit ci-dessus. La promesse est correctement remplie avec un objet lorsqu'il est utilisĂ© dans le contexte d'arriĂšre-plan +> (scripts d'arriĂšre-plan, popups, pages d'options, etc.). Lorsque cette API est utilisĂ©e en tant que `chrome.storage.local.get()`, elle transmet correctement un objet Ă la fonction de rappel. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.storage.StorageArea.get")}}</p> +{{Compat("webextensions.api.storage.StorageArea.get")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supposons que le stockage contienne deux Ă©lĂ©ments :</p> +Supposons que le stockage contienne deux Ă©lĂ©ments : -<pre class="brush: js">// storage contains two items, +```js +// storage contains two items, // "kitten" and "monster" browser.storage.local.set({ kitten: {name:"Mog", eats:"mice"}, monster: {name:"Kraken", eats:"people"} -});</pre> +}); +``` -<p>DĂ©finissez les gestionnaires de rĂ©ussite et d'Ă©chec pour la promesse:</p> +DĂ©finissez les gestionnaires de rĂ©ussite et d'Ă©chec pour la promesse: -<pre class="brush: js">function onGot(item) { +```js +function onGot(item) { console.log(item); } function onError(error) { console.log(`Error: ${error}`); -}</pre> +} +``` -<p>Sans arguments <code>clefs</code>, tout rĂ©cupĂ©rez :</p> +Sans arguments `clefs`, tout rĂ©cupĂ©rez : -<pre class="brush: js">let gettingItem = browser.storage.local.get(); +```js +let gettingItem = browser.storage.local.get(); gettingItem.then(onGot, onError); -// -> Object { kitten: Object, monster: Object }</pre> +// -> Object { kitten: Object, monster: Object } +``` -<p>Avec un argument de clefs vide, ne retourne rien:</p> +Avec un argument de clefs vide, ne retourne rien: -<pre class="brush: js">// with an empty array, retrieve nothing +```js +// with an empty array, retrieve nothing let gettingItem = browser.storage.local.get([]); gettingItem.then(onGot, onError); -// -> Object { }</pre> +// -> Object { } +``` -<p>Avec le nom d'un objet, rĂ©cupĂ©rez la correspondance :</p> +Avec le nom d'un objet, rĂ©cupĂ©rez la correspondance : -<pre class="brush: js">let gettingItem = browser.storage.local.get("kitten"); +```js +let gettingItem = browser.storage.local.get("kitten"); gettingItem.then(onGot, onError); -// -> Object { kitten: Object }</pre> +// -> Object { kitten: Object } +``` -<p>Avec un tableau de noms d'objets, rĂ©cupĂ©rez toutes les correspondances :</p> +Avec un tableau de noms d'objets, rĂ©cupĂ©rez toutes les correspondances : -<pre class="brush: js">let gettingItem = browser.storage.local.get(["kitten", "monster", "grapefruit"]); +```js +let gettingItem = browser.storage.local.get(["kitten", "monster", "grapefruit"]); gettingItem.then(onGot, onError); -// -> Object { kitten: Object, monster: Object } </pre> +// -> Object { kitten: Object, monster: Object } +``` -<p>Avec un objet avec des noms d'objets en tant que clefs et la valeur par dĂ©faut en tant que valeur :</p> +Avec un objet avec des noms d'objets en tant que clefs et la valeur par dĂ©faut en tant que valeur : -<pre class="brush: js">let gettingItem = browser.storage.local.get({ +```js +let gettingItem = browser.storage.local.get({ kitten: "no kitten", monster: "no monster", grapefruit: { @@ -110,26 +118,29 @@ gettingItem.then(onGot, onError); } }); -// -> Object { kitten: Object, monster: Object, grapefruit: Object } -</pre> - -<p>{{WebExtExamples}}</p> +// -> Object { kitten: Object, monster: Object, grapefruit: Object } +``` -<h3 id="Chrome_exemples">Chrome exemples</h3> +{{WebExtExamples}} -<pre class="brush: js">chrome.storage.local.get("kitten", function(items){ - console.log(items.kitten); // -> {name:"Mog", eats:"mice"} -});</pre> +### Chrome exemples -<p class="brush: js">Ou avec une fonction de flĂšche</p> - -<pre class="brush: js">chrome.storage.local.get("kitten", items=>{ - console.log(items.kitten); // -> {name:"Mog", eats:"mice"} -});</pre> +```js +chrome.storage.local.get("kitten", function(items){ + console.log(items.kitten); // -> {name:"Mog", eats:"mice"} +}); +``` -<div class="note"><p><strong>Note :</strong></p> +Ou avec une fonction de flĂšche -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</p> +```js +chrome.storage.local.get("kitten", items=>{ + console.log(items.kitten); // -> {name:"Mog", eats:"mice"} +}); +``` -<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.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.md index f16cdd0e08..885e1f6338 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.md @@ -14,41 +14,39 @@ tags: - getBytesInUse translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/getBytesInUse --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient la quantitĂ© d'espace de stockage, en octets, utilisĂ© un ou plusieurs Ă©lĂ©ments stockĂ©s dans la zone de stockage.</p> +Obtient la quantitĂ© d'espace de stockage, en octets, utilisĂ© un ou plusieurs Ă©lĂ©ments stockĂ©s dans la zone de stockage. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingSpace = browser.storage.<storageType>.getBytesInUse( +```js +var gettingSpace = browser.storage.<storageType>.getBytesInUse( keys // null, string, or array of strings ) -</pre> +``` -<p><code><storageType></code> sera l'un des types de stockage accessibles en Ă©criture â {{WebExtAPIRef("storage.sync")}} ou {{WebExtAPIRef("storage.local")}}.</p> +`<storageType>` sera l'un des types de stockage accessibles en Ă©criture â {{WebExtAPIRef("storage.sync")}} ou {{WebExtAPIRef("storage.local")}}. -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>keys</code></dt> - <dd>Une clef (chaĂźne) ou des clĂ©fs (un tableau de chaĂźnes) pour identifier le ou les Ă©lĂ©ments dont vous voulez rĂ©cupĂ©rer l'espace de stockage. Si un tableau vide est passĂ©, 0 sera renvoyĂ©. Si vous passez Ă <code>null</code> ou <code>indĂ©fini</code> ici, la fonction retournera l'espace utilisĂ© par l'ensemble de la zone de stockage.</dd> -</dl> +- `keys` + - : Une clef (chaĂźne) ou des clĂ©fs (un tableau de chaĂźnes) pour identifier le ou les Ă©lĂ©ments dont vous voulez rĂ©cupĂ©rer l'espace de stockage. Si un tableau vide est passĂ©, 0 sera renvoyĂ©. Si vous passez Ă `null` ou `indĂ©fini` ici, la fonction retournera l'espace utilisĂ© par l'ensemble de la zone de stockage. -<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 entier, <code>bytesUsed</code>, reprĂ©sentant l'espace de stockage utilisĂ© par les objets spĂ©cifiĂ©s dans les <code>clefs</code>. Si l'opĂ©ration a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un entier, `bytesUsed`, reprĂ©sentant l'espace de stockage utilisĂ© par les objets spĂ©cifiĂ©s dans les `clefs`. Si l'opĂ©ration a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.storage.StorageArea.getBytesInUse")}}</p> +{{Compat("webextensions.api.storage.StorageArea.getBytesInUse")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/index.md index 963e31875b..9d8241c500 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/index.md @@ -13,44 +13,40 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>StorageArea est un objet reprĂ©sentant une zone de stockage.</p> +StorageArea est un objet reprĂ©sentant une zone de stockage. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets.</p> +Les valeurs de ce type sont des objets. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +## MĂ©thodes -<dl> - <dt>{{WebExtAPIRef("storage.StorageArea.get()")}}</dt> - <dd>RĂ©cupĂšre un ou plusieurs Ă©lĂ©ments de la zone de stockage..</dd> - <dt>{{WebExtAPIRef("storage.StorageArea.getBytesInUse()")}}</dt> - <dd>Obtient la quantitĂ© d'espace de stockage (en octets) utilisĂ©e pour stocker un ou plusieurs Ă©lĂ©ments dans la zone de stockage.</dd> - <dt>{{WebExtAPIRef("storage.StorageArea.set()")}}</dt> - <dd>Stocke un ou plusieurs Ă©lĂ©ments dans la zone de stockage. Si un Ă©lĂ©ment existe dĂ©jĂ , sa valeur sera mise Ă jour.</dd> - <dt>{{WebExtAPIRef("storage.StorageArea.remove()")}}</dt> - <dd>Supprime un ou plusieurs Ă©lĂ©ments de la zone de stockage.</dd> - <dt>{{WebExtAPIRef("storage.StorageArea.clear()")}}</dt> - <dd>Supprime tous les Ă©lĂ©ments de la zone de stockage.</dd> -</dl> +- {{WebExtAPIRef("storage.StorageArea.get()")}} + - : RĂ©cupĂšre un ou plusieurs Ă©lĂ©ments de la zone de stockage.. +- {{WebExtAPIRef("storage.StorageArea.getBytesInUse()")}} + - : Obtient la quantitĂ© d'espace de stockage (en octets) utilisĂ©e pour stocker un ou plusieurs Ă©lĂ©ments dans la zone de stockage. +- {{WebExtAPIRef("storage.StorageArea.set()")}} + - : Stocke un ou plusieurs Ă©lĂ©ments dans la zone de stockage. Si un Ă©lĂ©ment existe dĂ©jĂ , sa valeur sera mise Ă jour. +- {{WebExtAPIRef("storage.StorageArea.remove()")}} + - : Supprime un ou plusieurs Ă©lĂ©ments de la zone de stockage. +- {{WebExtAPIRef("storage.StorageArea.clear()")}} + - : Supprime tous les Ă©lĂ©ments de la zone de stockage. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.storage.StorageArea")}}</p> +{{Compat("webextensions.api.storage.StorageArea")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</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 @@ -77,5 +73,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea // 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/storage/storagearea/remove/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/remove/index.md index 1b23445b39..402bc1a072 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/remove/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/remove/index.md @@ -14,41 +14,41 @@ tags: - remove translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/remove --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime un ou plusieurs Ă©lĂ©ments de la zone de stockage.</p> +Supprime un ou plusieurs Ă©lĂ©ments de la zone de stockage. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">let removingItem = browser.storage.<storageType>.remove( +```js +let removingItem = browser.storage.<storageType>.remove( keys // string, or array of strings ) -</pre> +``` -<p><code><storageType></code> sera l'un des types de stockage accessibles en Ă©criture â {{WebExtAPIRef("storage.sync")}} ou {{WebExtAPIRef("storage.local")}}.</p> +`<storageType>` sera l'un des types de stockage accessibles en Ă©criture â {{WebExtAPIRef("storage.sync")}} ou {{WebExtAPIRef("storage.local")}}. -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>keys</code></dt> - <dd>Une chaĂźne ou un tableau de chaĂźnes reprĂ©sentant la ou les clĂ©s de l'Ă©lĂ©ment Ă supprimer.</dd> -</dl> +- `keys` + - : Une chaĂźne ou un tableau de chaĂźnes reprĂ©sentant la ou les clĂ©s de l'Ă©lĂ©ment Ă supprimer. -<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 sans arguments si l'opĂ©ration a rĂ©ussi. Si l'opĂ©ration a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments si l'opĂ©ration a rĂ©ussi. Si l'opĂ©ration a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.storage.StorageArea.remove")}}</p> +{{Compat("webextensions.api.storage.StorageArea.remove")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprimer un seul Ă©lĂ©ment:</p> +Supprimer un seul Ă©lĂ©ment: -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log("OK"); } @@ -58,13 +58,12 @@ function onError(e) { let removeKitten = browser.storage.sync.remove("kitten"); removeKitten.then(onRemoved, onError); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</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> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. diff --git a/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.md index fcd8d257a6..180fdbefea 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.md @@ -14,47 +14,46 @@ tags: - set translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/set --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Stocke un ou plusieurs Ă©lĂ©ments dans la zone de stockage ou met Ă jour les Ă©lĂ©ments existants..</p> +Stocke un ou plusieurs Ă©lĂ©ments dans la zone de stockage ou met Ă jour les Ă©lĂ©ments existants.. -<p>Lorsque vous stockez ou mettez Ă jour une valeur Ă l'aide de cette API, l'Ă©vĂ©nement {{WebExtAPIRef("storage.onChanged")}} se dĂ©clenche.</p> +Lorsque vous stockez ou mettez Ă jour une valeur Ă l'aide de cette API, l'Ă©vĂ©nement {{WebExtAPIRef("storage.onChanged")}} se dĂ©clenche. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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">let settingItem = browser.storage.<storageType>.set( +```js +let settingItem = browser.storage.<storageType>.set( keys // object ) -</pre> +``` -<p><code><storageType></code> sera l'un des types de stockage accessibles en Ă©criture â {{WebExtAPIRef("storage.sync")}} ou {{WebExtAPIRef("storage.local")}}.</p> +`<storageType>` sera l'un des types de stockage accessibles en Ă©criture â {{WebExtAPIRef("storage.sync")}} ou {{WebExtAPIRef("storage.local")}}. -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>keys</code></dt> - <dd> - <p>Un objet contenant une ou plusieurs paires clĂ© / valeur Ă stocker dans le stockage. Si un Ă©lĂ©ment existe dĂ©jĂ , sa valeur sera mise Ă jour.</p> +- `keys` - <p>Les valeurs peuvent ĂȘtre des <a href="/fr/docs/Glossary/Primitive">types primitifs</a> tels que des nombres, des boolĂ©ens et des chaĂźnes) ou des types de <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Array">tableau</a></code>.</p> + - : Un objet contenant une ou plusieurs paires clĂ© / valeur Ă stocker dans le stockage. Si un Ă©lĂ©ment existe dĂ©jĂ , sa valeur sera mise Ă jour. - <p>Il n'est gĂ©nĂ©ralement pas possible de stocker d'autres types, tels que <code>Function</code>, <code>Date</code>, <code>RegExp</code>, <code>Set</code>, <code>Map</code>, <code>ArrayBuffer</code> et etc. Certains de ces types non pris en charge seront restaurĂ©s en tant qu'objet vide, et d'autres entraĂźneront <code>set()</code> Ă lancer une erreur. Le comportement exact ici est spĂ©cifique au navigateur.</p> - </dd> -</dl> + Les valeurs peuvent ĂȘtre des [types primitifs](/fr/docs/Glossary/Primitive) tels que des nombres, des boolĂ©ens et des chaĂźnes) ou des types de [`tableau`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Array). -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + Il n'est gĂ©nĂ©ralement pas possible de stocker d'autres types, tels que `Function`, `Date`, `RegExp`, `Set`, `Map`, `ArrayBuffer` et etc. Certains de ces types non pris en charge seront restaurĂ©s en tant qu'objet vide, et d'autres entraĂźneront `set()` Ă lancer une erreur. Le comportement exact ici est spĂ©cifique au navigateur. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans arguments si l'opĂ©ration a rĂ©ussi. Si l'opĂ©ration a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur.</p> +### Valeur retournĂ©e -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments si l'opĂ©ration a rĂ©ussi. Si l'opĂ©ration a Ă©chouĂ©, la promesse sera rejetĂ©e avec un message d'erreur. -<p>{{Compat("webextensions.api.storage.StorageArea.set")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.storage.StorageArea.set")}} -<pre class="brush: js">function setItem() { +## Exemples + +```js +function setItem() { console.log("OK"); } @@ -91,11 +90,10 @@ browser.storage.local.get("kitten") .then(gotKitten, onError); browser.storage.local.get("monster") .then(gotMonster, onError); -</pre> - -<p>{{WebExtExamples}}</p> +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. diff --git a/files/fr/mozilla/add-ons/webextensions/api/storage/storagechange/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/storagechange/index.md index c57f065c74..a4fb8352f5 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/storagechange/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/storagechange/index.md @@ -13,36 +13,30 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageChange --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}`StorageChange` est un objet reprĂ©sentant une modification d'une zone de stockage. -<div><code>StorageChange</code> est un objet reprĂ©sentant une modification d'une zone de stockage.</div> +## Type -<h2 id="Type">Type</h2> +Les objets `StorageChange` contiennent les propriĂ©tĂ©s suivantes : -<p>Les objets <code>StorageChange</code> contiennent les propriĂ©tĂ©s suivantes :</p> +- `oldValue`{{optional_inline}} + - : L'ancienne valeur de l'article, s'il y avait une ancienne valeur. Cela peut ĂȘtre n'importe quel type de donnĂ©es. +- `newValue`{{optional_inline}} + - : La nouvelle valeur de l'article, s'il y a une nouvelle valeur. Cela peut ĂȘtre n'importe quel type de donnĂ©es. -<dl> - <dt><code>oldValue</code>{{optional_inline}}</dt> - <dd>L'ancienne valeur de l'article, s'il y avait une ancienne valeur. Cela peut ĂȘtre n'importe quel type de donnĂ©es.</dd> - <dt><code>newValue</code>{{optional_inline}}</dt> - <dd>La nouvelle valeur de l'article, s'il y a une nouvelle valeur. Cela peut ĂȘtre n'importe quel type de donnĂ©es.</dd> -</dl> +## CompatibilitĂ© du navigateur -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{Compat("webextensions.api.storage.StorageChange")}} -<p>{{Compat("webextensions.api.storage.StorageChange")}}</p> +{{WebExtExamples}} -<p>{{WebExtExamples}}</p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</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 @@ -69,5 +63,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageChange // 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/storage/sync/index.md b/files/fr/mozilla/add-ons/webextensions/api/storage/sync/index.md index 52b1c4724f..6d0d69f27e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/storage/sync/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/storage/sync/index.md @@ -4,81 +4,86 @@ slug: Mozilla/Add-ons/WebExtensions/API/storage/sync translation_of: Mozilla/Add-ons/WebExtensions/API/storage/sync browser-compat: webextensions.api.storage.sync --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>ReprĂ©sente la zone de stockage <code>sync</code> (pour la synchronisation). Les Ă©lĂ©ments stockĂ©s dans le stockage <code>sync</code> sont synchronisĂ©s par le navigateur et disponibles sur toutes les instances de ce navigateur auxquelles l'utilisatrice ou l'utilisateur est connectĂ© (par exemple via la synchronisation Firefox ou un compte Google), sur diffĂ©rents appareils.</p> +ReprĂ©sente la zone de stockage `sync` (pour la synchronisation). Les Ă©lĂ©ments stockĂ©s dans le stockage `sync` sont synchronisĂ©s par le navigateur et disponibles sur toutes les instances de ce navigateur auxquelles l'utilisatrice ou l'utilisateur est connectĂ© (par exemple via la synchronisation Firefox ou un compte Google), sur diffĂ©rents appareils. -<p>Pour Firefox, il faut au prĂ©alable avoir cochĂ© « Modules complĂ©mentaires » dans les options « RĂ©glages de Sync » dans « <code>about:preferences</code>.</p> +Pour Firefox, il faut au prĂ©alable avoir cochĂ© « Modules complĂ©mentaires » dans les options « RĂ©glages de Sync » dans « `about:preferences`. -<p>Notez que l'implĂ©mentation de <code>storage.sync</code> dans Firefox repose sur l'ID de l'extension. Si vous utilisez <code>storage.sync</code>, vous devez dĂ©finir un ID pour votre extension Ă l'aide de la clĂ© de manifeste <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings">browser_specific_settings</a></code>.</p> +Notez que l'implĂ©mentation de `storage.sync` dans Firefox repose sur l'ID de l'extension. Si vous utilisez `storage.sync`, vous devez dĂ©finir un ID pour votre extension Ă l'aide de la clĂ© de manifeste [`browser_specific_settings`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings). -<p>Le principal cas d'utilisation de cette API est de stocker les prĂ©fĂ©rences concernant votre extension et de permettre Ă l'utilisateur de les synchroniser dans diffĂ©rents profils.</p> +Le principal cas d'utilisation de cette API est de stocker les prĂ©fĂ©rences concernant votre extension et de permettre Ă l'utilisateur de les synchroniser dans diffĂ©rents profils. -<h2 id="quotas_de_stockage_pour_les_donnĂ©es_synchronisĂ©es">Quotas de stockage pour les donnĂ©es synchronisĂ©es</h2> +## Quotas de stockage pour les donnĂ©es synchronisĂ©es -<p>Le navigateur impose des limites sur la quantitĂ© de donnĂ©es que chaque extension peut stocker dans le stockage sync :</p> +Le navigateur impose des limites sur la quantitĂ© de donnĂ©es que chaque extension peut stocker dans le stockage sync : <table class="standard-table"> - <thead> - <tr> - <th scope="col">Nom</th> - <th scope="col">Description</th> - <th scope="col">Valeur en octets</th> - </tr> - </thead> - <tbody> - <tr> - <td>Taille de stockage maximale</td> - <td>La quantitĂ© totale maximale que chaque extension peut stocker dans la zone de stockage sync, telle que mesurĂ©e par la conversion en chaĂźne de caractĂšres JSON de chaque valeur avec la longueur de sa clĂ©.</td> - <td>102400</td> - </tr> - <tr> - <td>Taille maximale d'un Ă©lĂ©ment</td> - <td>La taille maximale pour un Ă©lĂ©ment que l'extension peut stocker dans la zone sync, telle que mesurĂ©e par la conversion en chaĂźne de caractĂšres JSON de la valeur de l'Ă©lĂ©ment avec la longueur de sa clĂ©.</td> - <td>8192</td> - </tr> - <tr> - <td>Nombre maximal d'Ă©lĂ©ments</td> - <td>Le nombre maximal d'Ă©lĂ©ments que chaque extension peut stocker dans l'espace de stockage sync.</td> - <td> - <p>512</p> - </td> - </tr> - </tbody> + <thead> + <tr> + <th scope="col">Nom</th> + <th scope="col">Description</th> + <th scope="col">Valeur en octets</th> + </tr> + </thead> + <tbody> + <tr> + <td>Taille de stockage maximale</td> + <td> + La quantitĂ© totale maximale que chaque extension peut stocker dans la + zone de stockage sync, telle que mesurĂ©e par la conversion en chaĂźne de + caractĂšres JSON de chaque valeur avec la longueur de sa clĂ©. + </td> + <td>102400</td> + </tr> + <tr> + <td>Taille maximale d'un Ă©lĂ©ment</td> + <td> + La taille maximale pour un Ă©lĂ©ment que l'extension peut stocker dans la + zone sync, telle que mesurĂ©e par la conversion en chaĂźne de caractĂšres + JSON de la valeur de l'Ă©lĂ©ment avec la longueur de sa clĂ©. + </td> + <td>8192</td> + </tr> + <tr> + <td>Nombre maximal d'Ă©lĂ©ments</td> + <td> + Le nombre maximal d'Ă©lĂ©ments que chaque extension peut stocker dans + l'espace de stockage sync. + </td> + <td><p>512</p></td> + </tr> + </tbody> </table> -<p>Si une extension tente de stocker des Ă©lĂ©ments qui dĂ©passent ces limites, l'appel Ă <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/set">storage.sync.set()</a></code> sera rejetĂ© avec une erreur. Une extension peut utiliser <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/getBytesInUse">storage.sync.getBytesInUse()</a></code> afin de connaĂźtre le quota d'espace dĂ©jĂ utilisĂ©.</p> +Si une extension tente de stocker des Ă©lĂ©ments qui dĂ©passent ces limites, l'appel Ă [`storage.sync.set()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/set) sera rejetĂ© avec une erreur. Une extension peut utiliser [`storage.sync.getBytesInUse()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/getBytesInUse) afin de connaĂźtre le quota d'espace dĂ©jĂ utilisĂ©. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +## MĂ©thodes -<p>L'objet <code>sync</code> implĂ©mente les mĂ©thodes dĂ©finies sur le type {{WebExtAPIRef("storage.StorageArea")}} :</p> +L'objet `sync` implĂ©mente les mĂ©thodes dĂ©finies sur le type {{WebExtAPIRef("storage.StorageArea")}} : -<dl> - <dt><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/get"><code>storage.StorageArea.get()</code></a></dt> - <dd>RĂ©cupĂšre un ou plusieurs Ă©lĂ©ments de la zone de stockage.</dd> - <dt><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/getBytesInUse"><code>storage.StorageArea.getBytesInUse()</code></a></dt> - <dd>RĂ©cupĂšre la quantitĂ© d'espace de stockage utilisĂ©e (exprimĂ©e en octets) utilisĂ©e pou un ou plusieurs Ă©lĂ©ments entreposĂ©s dans la zone de stockage.</dd> - <dt><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/set"><code>storage.StorageArea.set()</code></a></dt> - <dd>Stocke un ou plusieurs Ă©lĂ©ments dans la zone de stockage. Si l'Ă©lĂ©ment existe dĂ©jĂ , sa valeur est mise Ă jour.</dd> - <dt><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/remove"><code>storage.StorageArea.remove()</code></a></dt> - <dd>Supprime un ou plusieurs Ă©lĂ©ments de la zone de stockage.</dd> - <dt><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/clear"><code>storage.StorageArea.clear()</code></a></dt> - <dd>Supprime tous les Ă©lĂ©ments de la zone de stockage.</dd> - </dl> +- [`storage.StorageArea.get()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/get) + - : RĂ©cupĂšre un ou plusieurs Ă©lĂ©ments de la zone de stockage. +- [`storage.StorageArea.getBytesInUse()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/getBytesInUse) + - : RĂ©cupĂšre la quantitĂ© d'espace de stockage utilisĂ©e (exprimĂ©e en octets) utilisĂ©e pou un ou plusieurs Ă©lĂ©ments entreposĂ©s dans la zone de stockage. +- [`storage.StorageArea.set()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/set) + - : Stocke un ou plusieurs Ă©lĂ©ments dans la zone de stockage. Si l'Ă©lĂ©ment existe dĂ©jĂ , sa valeur est mise Ă jour. +- [`storage.StorageArea.remove()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/remove) + - : Supprime un ou plusieurs Ă©lĂ©ments de la zone de stockage. +- [`storage.StorageArea.clear()`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/clear) + - : Supprime tous les Ă©lĂ©ments de la zone de stockage. -<h2 id="compatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> +## CompatibilitĂ© des navigateurs -<p>{{Compat}}</p> +{{Compat}} -<p><strong>Remerciements :</strong></p> +**Remerciements :** -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/storage"><code>chrome.storage</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json"><code>storage.json</code></a> dans le code de Chromium.</p> +Cette API est basĂ©e sur l'API Chromium [`chrome.storage`](https://developer.chrome.com/extensions/storage). Cette documentation est dĂ©rivĂ©e de [`storage.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/storage.json) dans le code de Chromium. -<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> +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 @@ -105,5 +110,4 @@ browser-compat: webextensions.api.storage.sync // 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/tabs/capturetab/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/capturetab/index.md index 4813a4bfd8..0260c5c44f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/capturetab/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/capturetab/index.md @@ -12,38 +12,38 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/captureTab --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>CrĂ©e un URI de donnĂ©es codant une image de la zone visible de l'onglet donnĂ©. Vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code><all_urls></code> pour utiliser cette mĂ©thode.</p> +CrĂ©e un URI de donnĂ©es codant une image de la zone visible de l'onglet donnĂ©. Vous devez avoir la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `<all_urls>` pour utiliser cette mĂ©thode. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 capturing = browser.tabs.captureTab( +```js +var capturing = browser.tabs.captureTab( tabId, // optional integer options // optional extensionTypes.ImageDetails ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. ID de l'onglet Ă capturer. Par dĂ©faut Ă l'onglet actif dans la fenĂȘtre en cours.</dd> - <dt><code>options</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('extensionTypes.ImageDetails')}}.</dd> -</dl> +- `tabId`{{optional_inline}} + - : `integer`. ID de l'onglet Ă capturer. Par dĂ©faut Ă l'onglet actif dans la fenĂȘtre en cours. +- `options`{{optional_inline}} + - : {{WebExtAPIRef('extensionTypes.ImageDetails')}}. -<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 une URL de donnĂ©es qui code une image de la zone visible de l'onglet capturĂ©. Peut ĂȘtre affectĂ© Ă la propriĂ©tĂ© 'src' d'un Ă©lĂ©ment HTML Image pour l'affichage. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec une URL de donnĂ©es qui code une image de la zone visible de l'onglet capturĂ©. Peut ĂȘtre affectĂ© Ă la propriĂ©tĂ© 'src' d'un Ă©lĂ©ment HTML Image pour l'affichage. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Capturez une image de l'onglet actif dans la fenĂȘtre actuelle, avec les paramĂštres par dĂ©faut :</p> +Capturez une image de l'onglet actif dans la fenĂȘtre actuelle, avec les paramĂštres par dĂ©faut : -<pre class="brush: js">function onCaptured(imageUri) { +```js +function onCaptured(imageUri) { console.log(imageUri); } @@ -55,21 +55,19 @@ browser.browserAction.onClicked.addListener(function() { var capturing = browser.tabs.captureTab(); capturing.then(onCaptured, onError); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.captureTab")}}</p> +{{Compat("webextensions.api.tabs.captureTab")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) dans le code de Chromium code. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</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 @@ -96,5 +94,4 @@ browser.browserAction.onClicked.addListener(function() { // 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/tabs/capturevisibletab/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.md index a606cd1e70..e5befafab3 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.md @@ -13,38 +13,38 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/captureVisibleTab --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>CrĂ©e une URI de donnĂ©es codant une image de la zone visible de l'onglet actuellement actif dans la fenĂȘtre spĂ©cifiĂ©e. Vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code><all_urls></code> pour utiliser cette mĂ©thode. (Alternativement, Chrome permet l'utilisation de cette mĂ©thode avec la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>activeTab</code> et un geste utilisateur qualifiant).</p> +CrĂ©e une URI de donnĂ©es codant une image de la zone visible de l'onglet actuellement actif dans la fenĂȘtre spĂ©cifiĂ©e. Vous devez avoir la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `<all_urls>` pour utiliser cette mĂ©thode. (Alternativement, Chrome permet l'utilisation de cette mĂ©thode avec la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `activeTab` et un geste utilisateur qualifiant). -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 capturing = browser.tabs.captureVisibleTab( +```js +var capturing = browser.tabs.captureVisibleTab( windowId, // optional integer options // optional extensionTypes.ImageDetails ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. La fenĂȘtre cible Par dĂ©faut Ă la fenĂȘtre actuelle.</dd> - <dt><code>options</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('extensionTypes.ImageDetails')}}.</dd> -</dl> +- `windowId`{{optional_inline}} + - : `integer`. La fenĂȘtre cible Par dĂ©faut Ă la fenĂȘtre actuelle. +- `options`{{optional_inline}} + - : {{WebExtAPIRef('extensionTypes.ImageDetails')}}. -<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 une URL de donnĂ©es qui code une image de la zone visible de l'onglet capturĂ©. Peut ĂȘtre affectĂ© Ă la propriĂ©tĂ© 'src' d'un Ă©lĂ©ment HTML Image pour l'affichage. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec une URL de donnĂ©es qui code une image de la zone visible de l'onglet capturĂ©. Peut ĂȘtre affectĂ© Ă la propriĂ©tĂ© 'src' d'un Ă©lĂ©ment HTML Image pour l'affichage. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Capturez une image de l'onglet actif dans la fenĂȘtre actuelle, avec les paramĂštres par dĂ©faut :</p> +Capturez une image de l'onglet actif dans la fenĂȘtre actuelle, avec les paramĂštres par dĂ©faut : -<pre class="brush: js">function onCaptured(imageUri) { +```js +function onCaptured(imageUri) { console.log(imageUri); } @@ -56,23 +56,21 @@ browser.browserAction.onClicked.addListener(function() { var capturing = browser.tabs.captureVisibleTab(); capturing.then(onCaptured, onError); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.captureVisibleTab")}}</p> +{{Compat("webextensions.api.tabs.captureVisibleTab")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ browser.browserAction.onClicked.addListener(function() { // 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/tabs/connect/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/connect/index.md index 146df70ced..f232fae5b7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/connect/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/connect/index.md @@ -13,48 +13,47 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/connect --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Appelez cette fonction pour configurer une connexion entre les scripts d'arriĂšre-plan de l'extension (ou d'autres scripts privilĂ©giĂ©s, tels que les scripts d'arriĂšre-plan de l'extrension (ou d'autres scripts privilĂ©giĂ©s, tels que les scripts de pages d'options) et les <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts">scripts de contenu</a> appartenant Ă cette extension et s'exĂ©cutant dans l'onglet spĂ©cifiĂ©. Cette fonction renvoie un objet {{WebExtAPIRef("runtime.Port")}}.</p> +Appelez cette fonction pour configurer une connexion entre les scripts d'arriĂšre-plan de l'extension (ou d'autres scripts privilĂ©giĂ©s, tels que les scripts d'arriĂšre-plan de l'extrension (ou d'autres scripts privilĂ©giĂ©s, tels que les scripts de pages d'options) et les [scripts de contenu](/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts) appartenant Ă cette extension et s'exĂ©cutant dans l'onglet spĂ©cifiĂ©. Cette fonction renvoie un objet {{WebExtAPIRef("runtime.Port")}}. -<p>Lorsque cela est appelĂ©e, l'Ă©vĂ©nement {{WebExtAPIRef('runtime.onConnect')}} est dĂ©clenchĂ© dans tout script de contenu appartenant Ă cette extension qui s'exĂ©cute dans l'onglet spĂ©cifiĂ©. L'Ă©couteur d'Ă©vĂ©nement recevra un autre objet {{WebExtAPIRef("runtime.Port")}}. Les deux parties peuvent ensuite utiliser les objets <code>Port</code> pour Ă©changer des messages.</p> +Lorsque cela est appelĂ©e, l'Ă©vĂ©nement {{WebExtAPIRef('runtime.onConnect')}} est dĂ©clenchĂ© dans tout script de contenu appartenant Ă cette extension qui s'exĂ©cute dans l'onglet spĂ©cifiĂ©. L'Ă©couteur d'Ă©vĂ©nement recevra un autre objet {{WebExtAPIRef("runtime.Port")}}. Les deux parties peuvent ensuite utiliser les objets `Port` pour Ă©changer des messages. -<p>Pour plus de dĂ©tails, voir <a href="/fr/Add-ons/WebExtensions/Content_scripts#Connection-based_messaging">connection-based messaging</a>.</p> +Pour plus de dĂ©tails, voir [connection-based messaging](/fr/Add-ons/WebExtensions/Content_scripts#Connection-based_messaging). -<h2 id="Syntax">Syntax</h2> +## Syntax -<pre class="brush: js">browser.tabs.connect( +```js +browser.tabs.connect( tabId, // integer connectInfo // optional object ) -</pre> +``` -<h3 id="Parameters">Parameters</h3> +### Parameters -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID of the tab whose content scripts we want to connect to.</dd> - <dt><code>connectInfo</code>{{optional_inline}}</dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>name</code>{{optional_inline}}</dt> - <dd><code>string</code>. Will be passed into {{WebExtAPIRef("runtime.onConnect")}} event listeners in content scripts belonging to this extension and running in the specified tab.</dd> - <dt><code>frameId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Open a port to a specific frame identified by <code>frameId</code> instead of all frames in the tab.</dd> - </dl> - </dd> -</dl> +- `tabId` + - : `integer`. ID of the tab whose content scripts we want to connect to. +- `connectInfo`{{optional_inline}} -<h3 id="Return_value">Return value</h3> + - : `object`. -<p>{{WebExtAPIRef('runtime.Port')}}. A port that can be used to communicate with the content scripts running in the specified tab.</p> + - `name`{{optional_inline}} + - : `string`. Will be passed into {{WebExtAPIRef("runtime.onConnect")}} event listeners in content scripts belonging to this extension and running in the specified tab. + - `frameId`{{optional_inline}} + - : `integer`. Open a port to a specific frame identified by `frameId` instead of all frames in the tab. -<h2 id="Examples">Examples</h2> +### Return value -<p>In this example a background script listens for a click on a <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2">browser action</a>, then connects to the currently active tab, then sends a message using the <code>Port</code> that's returned from <code>connect()</code>:</p> +{{WebExtAPIRef('runtime.Port')}}. A port that can be used to communicate with the content scripts running in the specified tab. -<pre class="brush: js">function connectToTab(tabs) { - if (tabs.length > 0) { +## Examples + +In this example a background script listens for a click on a [browser action](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2), then connects to the currently active tab, then sends a message using the `Port` that's returned from `connect()`: + +```js +function connectToTab(tabs) { + if (tabs.length > 0) { var examplePort = browser.tabs.connect( tabs[0].id, {name: "tabs-connect-example"} @@ -73,23 +72,21 @@ browser.browserAction.onClicked.addListener(function() { }); gettingActive.then(connectToTab, onError); }); -</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +``` -<p>{{Compat("webextensions.api.tabs.connect")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.connect")}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -116,5 +113,4 @@ browser.browserAction.onClicked.addListener(function() { // 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/tabs/create/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/create/index.md index 95244d6e3e..cfecca4588 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/create/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/create/index.md @@ -13,71 +13,74 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/create --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>CrĂ©e un nouvel onglet</p> +CrĂ©e un nouvel onglet -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 creating = browser.tabs.create( +```js +var creating = browser.tabs.create( createProperties // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>createProperties</code></dt> - <dd><p><code>object</code>.PropriĂ©tĂ©s pour donner le nouvel onglet. Pour en savoir plus sur ces propriĂ©tĂ©s, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}.</p> - <dl> - <dt><code>active</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet doit devenir l'onglet actif dans la fenĂȘtre. Si elle est <code>false</code>, elle n'a aucun effet. N'affecte pas si la fenĂȘtre est mise au point (voir {{WebExtAPIRef('windows.update')}}). Par dĂ©faut Ă Â <code>true</code>.</dd> - <dt><code>cookieStoreId</code> {{optional_inline}}</dt> - <dd><code>string</code>. Utilisez-le pour crĂ©er un onglet dont l'ID de cookie estCette option n'est disponible que si l'extension a la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>"cookies".</code></dd> - <dt><code>index</code>{{optional_inline}}</dt> - <dd><code>integer</code>. La position que l'onglet devrait prendre dans la fenĂȘtre. La valeur fournie sera comprise entre zĂ©ro et le nombre d'onglets dans la fenĂȘtre.</dd> - <dt><code>openerTabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet qui a ouvert cet onglet. Si spĂ©cifiĂ©, l'onglet d'ouverture doit ĂȘtre dans la mĂȘme fenĂȘtre que l'onglet nouvellement crĂ©Ă©.</dd> - <dt><code>openInReaderMode</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. si <code>true</code>, ouvrez cet onglet en <a href="/fr/Add-ons/WebExtensions/API/tabs/toggleReaderMode">mode lecture</a>. Par dĂ©faut Ă Â <code>false</code>.</dd> - <dt><code>pinned</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet doit ĂȘtre Ă©pinglĂ©. Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>selected</code>{{optional_inline}}</dt> - <dd><p><code>boolean</code>. Si l'onglet doit devenir l'onglet sĂ©lectionnĂ© dans la fenĂȘtre. Par dĂ©faut Ă <code>true</code>.</p> - <div class="warning"><p><strong>Attention :</strong> Cette propriĂ©tĂ© est obsolĂšte et n'est pas prise en charge dans Firefox. Utilisez <code>actif</code> Ă la place.</p></div> - </dd> - <dt><code>url</code>{{optional_inline}}</dt> - <dd><p><code>string</code>. 'URL permettant de naviguer dans l'onglet initialement. Par dĂ©faut Ă la page Nouvel onglet.</p> - <p>Les URL complĂštes doivent inclure un schĂ©ma (i.e. 'http://www.google.com', par 'www.google.com').</p> - <p>Pour des raisons de sĂ©curitĂ©, dans Firefox, il se peut que ce ne soit pas une URL privilĂ©giĂ©e. Le passage de l'une des URL suivantes Ă©chouera :</p> - <ul> - <li>chrome: URLs</li> - <li>javascript: URLs</li> - <li>data: URLs</li> - <li>file: URLs (c'est-Ă -dire, fichiers sur le systĂšme de fichiers, cependant, pour utiliser un fichier empaquetĂ© Ă l'intĂ©rieur de l'extension, voir ci-dessous)</li> - <li>privileged about: URLs (par exemple, <code>about:config</code>, <code>about:addons</code>, <code>about:debugging</code>). Les URL non privilĂ©giĂ©es (e.g., <code>about:blank</code>) sont autorisĂ©s.</li> - <li>La page Nouvel onglet (<code>about:newtab</code>) peut ĂȘtre ouverte si aucune valeur n'est fournie pour l'URL.</li> - </ul> - - <p>Pour charger une page fournie avec votre extension, spĂ©cifiez une URL absolue Ă partir du fichier manifest.json de l'extension. Par exemple : '/path/to/my-page.html'. Si vous omettez le premier caractĂšre '/', l'URL est traitĂ©e comme une URL relative et diffĂ©rents navigateurs peuvent construire diffĂ©rentes URL absolues.</p> - </dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. La fenĂȘtre pour crĂ©er le nouvel onglet. Par dĂ©faut Ă la fenĂȘtre actuelle.</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>A <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> that will be fulfilled with a {{WebExtAPIRef('tabs.Tab')}} object containing details about the created tab. If the tab could not be created (for example, because <code>url</code> used a privileged scheme) the promise will be rejected with an error message.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Ouvre "https://example.org" dans un nouvel onglet :</p> - -<pre class="brush: js">function onCreated(tab) { +``` + +### ParamĂštres + +- `createProperties` + + - : `object`.PropriĂ©tĂ©s pour donner le nouvel onglet. Pour en savoir plus sur ces propriĂ©tĂ©s, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}. + + - `active`{{optional_inline}} + - : `boolean`. Si l'onglet doit devenir l'onglet actif dans la fenĂȘtre. Si elle est `false`, elle n'a aucun effet. N'affecte pas si la fenĂȘtre est mise au point (voir {{WebExtAPIRef('windows.update')}}). Par dĂ©faut Ă Â `true`. + - `cookieStoreId` {{optional_inline}} + - : `string`. Utilisez-le pour crĂ©er un onglet dont l'ID de cookie estCette option n'est disponible que si l'extension a la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `"cookies".` + - `index`{{optional_inline}} + - : `integer`. La position que l'onglet devrait prendre dans la fenĂȘtre. La valeur fournie sera comprise entre zĂ©ro et le nombre d'onglets dans la fenĂȘtre. + - `openerTabId`{{optional_inline}} + - : `integer`. L'ID de l'onglet qui a ouvert cet onglet. Si spĂ©cifiĂ©, l'onglet d'ouverture doit ĂȘtre dans la mĂȘme fenĂȘtre que l'onglet nouvellement crĂ©Ă©. + - `openInReaderMode`{{optional_inline}} + - : `boolean`. si `true`, ouvrez cet onglet en [mode lecture](/fr/Add-ons/WebExtensions/API/tabs/toggleReaderMode). Par dĂ©faut Ă Â `false`. + - `pinned`{{optional_inline}} + - : `boolean`. Si l'onglet doit ĂȘtre Ă©pinglĂ©. Par dĂ©faut Ă `false`. + - `selected`{{optional_inline}} + + - : `boolean`. Si l'onglet doit devenir l'onglet sĂ©lectionnĂ© dans la fenĂȘtre. Par dĂ©faut Ă `true`. + + > **Attention :** Cette propriĂ©tĂ© est obsolĂšte et n'est pas prise en charge dans Firefox. Utilisez `actif` Ă la place. + + - `url`{{optional_inline}} + + - : `string`. 'URL permettant de naviguer dans l'onglet initialement. Par dĂ©faut Ă la page Nouvel onglet. + + Les URL complĂštes doivent inclure un schĂ©ma (i.e. 'http\://www\.google.com', par 'www\.google.com'). + + Pour des raisons de sĂ©curitĂ©, dans Firefox, il se peut que ce ne soit pas une URL privilĂ©giĂ©e. Le passage de l'une des URL suivantes Ă©chouera : + + - chrome: URLs + - javascript: URLs + - data: URLs + - file: URLs (c'est-Ă -dire, fichiers sur le systĂšme de fichiers, cependant, pour utiliser un fichier empaquetĂ© Ă l'intĂ©rieur de l'extension, voir ci-dessous) + - privileged about: URLs (par exemple, `about:config`, `about:addons`, `about:debugging`). Les URL non privilĂ©giĂ©es (e.g., `about:blank`) sont autorisĂ©s. + - La page Nouvel onglet (`about:newtab`) peut ĂȘtre ouverte si aucune valeur n'est fournie pour l'URL. + + Pour charger une page fournie avec votre extension, spĂ©cifiez une URL absolue Ă partir du fichier manifest.json de l'extension. Par exemple : '/path/to/my-page.html'. Si vous omettez le premier caractĂšre '/', l'URL est traitĂ©e comme une URL relative et diffĂ©rents navigateurs peuvent construire diffĂ©rentes URL absolues. + + - `windowId`{{optional_inline}} + - : `integer`. La fenĂȘtre pour crĂ©er le nouvel onglet. Par dĂ©faut Ă la fenĂȘtre actuelle. + +### Valeur retournĂ©e + +A [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) that will be fulfilled with a {{WebExtAPIRef('tabs.Tab')}} object containing details about the created tab. If the tab could not be created (for example, because `url` used a privileged scheme) the promise will be rejected with an error message. + +## Exemples + +Ouvre "https\://example.org" dans un nouvel onglet : + +```js +function onCreated(tab) { console.log(`Created new tab: ${tab.id}`) } @@ -90,23 +93,22 @@ browser.browserAction.onClicked.addListener(function() { url:"https://example.org" }); creating.then(onCreated, onError); -});</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +}); +``` -<p>{{Compat("webextensions.api.tabs.create", 10)}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.create", 10)}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -133,5 +135,4 @@ browser.browserAction.onClicked.addListener(function() { // 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/tabs/detectlanguage/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.md index 8a9a96a508..c6b6c409c3 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.md @@ -13,38 +13,38 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/detectLanguage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©tecte la langue principale du contenu dans un onglet, en utilisant le <a href="https://github.com/CLD2Owners/cld2">dĂ©tecteur de langue compact</a> (CLD).</p> +DĂ©tecte la langue principale du contenu dans un onglet, en utilisant le [dĂ©tecteur de langue compact](https://github.com/CLD2Owners/cld2) (CLD). -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 detecting = browser.tabs.detectLanguage( +```js +var detecting = browser.tabs.detectLanguage( tabId, // optional integer callback // optional function ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId </code>{{optional_inline}}</dt> - <dd><code>integer</code>. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours.</dd> - <dt><code>callback </code>{{optional_inline}}</dt> - <dd><code>function</code>. Actuellement, si un <code>tabId</code> est spĂ©cifiĂ©, cette mĂ©thode utilise ce rappel pour renvoyer les rĂ©sultats au lieu de renvoyer une promesse. Le rappel reçoit comme seul paramĂštre d'entrĂ©e une chaĂźne de caractĂšres contenant le code de langue dĂ©tectĂ© <code>en</code> ou <code>fr</code>.</dd> -</dl> +- `tabId `{{optional_inline}} + - : `integer`. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours. +- `callback `{{optional_inline}} + - : `function`. Actuellement, si un `tabId` est spĂ©cifiĂ©, cette mĂ©thode utilise ce rappel pour renvoyer les rĂ©sultats au lieu de renvoyer une promesse. Le rappel reçoit comme seul paramĂštre d'entrĂ©e une chaĂźne de caractĂšres contenant le code de langue dĂ©tectĂ© `en` ou `fr`. -<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 une chaĂźne reprĂ©sentant un code de langue ISO tel que <code>en</code> ou <code>fr</code>. Pour une liste complĂšte des langues prises en charge par cette mĂ©thode, see <a href="https://src.chromium.org/viewvc/chrome/trunk/src/third_party/cld/languages/internal/languages.cc#l23">kLanguageInfoTable</a>. Pour une langue inconnue, <code>"und"</code> sera retournĂ© (mais voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1288263">bug 1288263</a>). Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise)qui sera remplie avec une chaĂźne reprĂ©sentant un code de langue ISO tel que `en` ou `fr`. Pour une liste complĂšte des langues prises en charge par cette mĂ©thode, see [kLanguageInfoTable](https://src.chromium.org/viewvc/chrome/trunk/src/third_party/cld/languages/internal/languages.cc#l23). Pour une langue inconnue, `"und"` sera retournĂ© (mais voir [bug 1288263](https://bugzilla.mozilla.org/show_bug.cgi?id=1288263)). Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©tecter et enregistrer la langue de l'onglet actif lorsque l'utilisateur clique sur une action du navigateur :</p> +DĂ©tecter et enregistrer la langue de l'onglet actif lorsque l'utilisateur clique sur une action du navigateur : -<pre class="brush: js">function onLanguageDetected(lang) { +```js +function onLanguageDetected(lang) { console.log(`Language is: ${lang}`); } @@ -55,11 +55,13 @@ function onError(error) { browser.browserAction.onClicked.addListener(function() { var detecting = browser.tabs.detectLanguage(); detecting.then(onLanguageDetected, onError); -});</pre> +}); +``` -<p>DĂ©tecter et enregistrer la langue de chaque onglet ouvert lorsque l'utilisateur clique sur une action du navigateur (notez que cet exemple nĂ©cessite la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "tabs") :</p> +DĂ©tecter et enregistrer la langue de chaque onglet ouvert lorsque l'utilisateur clique sur une action du navigateur (notez que cet exemple nĂ©cessite la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "tabs") : -<pre class="brush: js">function onLanguageDetected(url, lang) { +```js +function onLanguageDetected(url, lang) { console.log(`Language in ${url} is: ${lang}`); } @@ -78,25 +80,22 @@ function detectLanguages(tabs) { browser.browserAction.onClicked.addListener(function() { var querying = browser.tabs.query({}); querying.then(detectLanguages, onError); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.tabs.detectLanguage")}} +> **Note :** +> +> Cette API est basĂ©e sur lâAPI [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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>{{Compat("webextensions.api.tabs.detectLanguage")}}</p> - -<div class="note"><p><strong>Note :</strong></p> - -<p>Cette API est basĂ©e sur lâAPI <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -123,5 +122,4 @@ browser.browserAction.onClicked.addListener(function() { // 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/tabs/discard/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/discard/index.md index c1dd5c9470..c20e84caca 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/discard/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/discard/index.md @@ -12,41 +12,41 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/discard --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Rejette un ou plusieurs onglets.</p> +Rejette un ou plusieurs onglets. -<p>Certains navigateurs "suppriment" automatiquement les onglets dont ils ne pensent pas qu'ils seront bientĂŽt utiles Ă l'utilisateur. L'onglet reste visible dans la bande d'onglets et le navigateur se souvient de son Ă©tat, donc si l'utilisateur sĂ©lectionne un onglet qui a Ă©tĂ© supprimĂ©, il est immĂ©diatement restaurĂ©.</p> +Certains navigateurs "suppriment" automatiquement les onglets dont ils ne pensent pas qu'ils seront bientĂŽt utiles Ă l'utilisateur. L'onglet reste visible dans la bande d'onglets et le navigateur se souvient de son Ă©tat, donc si l'utilisateur sĂ©lectionne un onglet qui a Ă©tĂ© supprimĂ©, il est immĂ©diatement restaurĂ©. -<p>Les dĂ©tails de ce qui est supprimĂ© sont spĂ©cifiques au navigateur, mais en gĂ©nĂ©ral, l'abandon d'un onglet permet au navigateur de libĂ©rer une partie de la mĂ©moire occupĂ©e par cet onglet.</p> +Les dĂ©tails de ce qui est supprimĂ© sont spĂ©cifiques au navigateur, mais en gĂ©nĂ©ral, l'abandon d'un onglet permet au navigateur de libĂ©rer une partie de la mĂ©moire occupĂ©e par cet onglet. -<p>L'API {{WebExtAPIRef("tabs.discard()")}} permet Ă une extension d'ignorer un ou plusieurs onglets. Il n'est pas possible de supprimer l'onglet actuellement actif ou un onglet dont le document contient un programme d'Ă©coute <code><a href="/fr/docs/Web/Events/beforeunload">beforeunload</a></code> qui afficherait une invite.</p> +L'API {{WebExtAPIRef("tabs.discard()")}} permet Ă une extension d'ignorer un ou plusieurs onglets. Il n'est pas possible de supprimer l'onglet actuellement actif ou un onglet dont le document contient un programme d'Ă©coute [`beforeunload`](/fr/docs/Web/Events/beforeunload) qui afficherait une invite. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 discarding = browser.tabs.discard( +```js +var discarding = browser.tabs.discard( tabIds // integer or integer array ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabIds</code></dt> - <dd><code><code>integer</code></code> or <code><code>array</code></code> of <code><code><code>integer</code></code></code>. Les ID de l'onglet ou des onglets Ă ignorer.</dd> -</dl> +- `tabIds` + - : `integer` or `array` of `integer`. Les ID de l'onglet ou des onglets Ă ignorer. -<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 sans argument lorsque tous les onglets spĂ©cifiĂ©s ont Ă©tĂ© supprimĂ©s. Si une erreur se produit (par exemple, ID d'onglet non valide), la promesse sera rejetĂ©e avec un message d'erreur.Si l'ID de l'onglet actif est transmis, il ne sera pas supprimĂ©, mais la promesse sera satisfaite et tous les autres onglets transfĂ©rĂ©s seront supprimĂ©s.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque tous les onglets spĂ©cifiĂ©s ont Ă©tĂ© supprimĂ©s. Si une erreur se produit (par exemple, ID d'onglet non valide), la promesse sera rejetĂ©e avec un message d'erreur.Si l'ID de l'onglet actif est transmis, il ne sera pas supprimĂ©, mais la promesse sera satisfaite et tous les autres onglets transfĂ©rĂ©s seront supprimĂ©s. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprimer un seul onglet :</p> +Supprimer un seul onglet : -<pre class="brush: js">function onDiscarded() { +```js +function onDiscarded() { console.log(`Discarded`); } @@ -55,11 +55,13 @@ function onError(error) { } var discarding = browser.tabs.discard(2); -discarding.then(onDiscarded, onError);</pre> +discarding.then(onDiscarded, onError); +``` -<p>Ignorer plusieurs onglets :</p> +Ignorer plusieurs onglets : -<pre class="brush: js">function onDiscarded() { +```js +function onDiscarded() { console.log(`Discarded`); } @@ -68,21 +70,20 @@ function onError(error) { } var discarding = browser.tabs.discard([15, 14, 1]); -discarding.then(onDiscarded, onError);</pre> +discarding.then(onDiscarded, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.discard", 10)}}</p> +{{Compat("webextensions.api.tabs.discard", 10)}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>.</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 @@ -109,5 +110,4 @@ discarding.then(onDiscarded, onError);</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/tabs/duplicate/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.md index 177cec75a3..9899a0c7aa 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.md @@ -4,52 +4,45 @@ slug: Mozilla/Add-ons/WebExtensions/API/tabs/duplicate translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/duplicate browser-compat: webextensions.api.tabs.duplicate --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Duplique un onglet dont l'identifiant est donnĂ©.</p> +Duplique un onglet dont l'identifiant est donnĂ©. -<p>Il s'agit d'une fonction asynchrone qui renvoie une <a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">promesse (<code>Promise</code>)</a>.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [promesse (`Promise`)](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise). -<h2 id="syntax">Syntaxe</h2> +## Syntaxe -<pre class="brush:js"> +```js let duplicating = browser.tabs.duplicate( tabId, // entier duplicateProperties // objet optionnel ); -</pre> +``` -<h3 id="parameters">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'identifiant de l'onglet Ă dupliquer.</dd> - <dt><code>duplicateProperties</code> Optionnel</dt> - <dd><p><code>object</code>. Un objet dĂ©crivant la façon dont l'onglet est dupliquĂ©. Il contient les propriĂ©tĂ©s suivantesâŻ:</p> - <dl> - <dt><code><var>index</var></code> Optionnel</dt> - <dd><code>integer</code>. La position du nouvel onglet dans la fenĂȘtre. La valeur est restreinte Ă l'intervalle entre zĂ©ro et le nombre d'onglets dans la fenĂȘtre.</dd> - <dt><code><var>active</var></code> Optionnel</dt> - <dd> - <p><code>boolean</code>. Si l'onglet devient l'onglet actif dans la fenĂȘtre. Cela ne change pas l'Ă©tat du focus pour la fenĂȘtre. <code>true</code> par dĂ©faut.</p> - </dd> - </dl> - </dd> -</dl> +- `tabId` + - : `integer`. L'identifiant de l'onglet Ă dupliquer. +- `duplicateProperties` Optionnel -<h3 id="return_value">Valeur de retour</h3> + - : `object`. Un objet dĂ©crivant la façon dont l'onglet est dupliquĂ©. Il contient les propriĂ©tĂ©s suivantesâŻ: -<p>Une <a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">promesse (<code>Promise</code>)</a> dont la valeur de rĂ©solution sera un objet <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/tabs/Tab"><code>tabs.Tab</code></a> contenant des dĂ©tails sur l'onglet dupliquĂ©. L'objet <code>Tab</code> contiendra les propriĂ©tĂ©s <code>url</code>, <code>title</code> et <code>favIconUrl</code> uniquement si l'extension dispose de la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions"> permission <code>"tabs"</code></a> ou lorsque <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#host_permissions">l'hĂŽte correspond Ă un hĂŽte ciblĂ© dans les permissions</a>. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> + - `index` Optionnel + - : `integer`. La position du nouvel onglet dans la fenĂȘtre. La valeur est restreinte Ă l'intervalle entre zĂ©ro et le nombre d'onglets dans la fenĂȘtre. + - `active` Optionnel + - : `boolean`. Si l'onglet devient l'onglet actif dans la fenĂȘtre. Cela ne change pas l'Ă©tat du focus pour la fenĂȘtre. `true` par dĂ©faut. -<div class="note"> -<p><strong>Note :</strong> Ă partir de Firefox 68, la promesse renvoyĂ©e par <code>browser.tabs.duplicate()</code> se rĂ©sout dĂšs que l'onglet a Ă©tĂ© dupliquĂ©. Auparavant, la promesse n'Ă©tait rĂ©solue qu'une fois l'onglet entiĂšrement chargĂ©.</p> -</div> +### Valeur de retour -<h2 id="Exemples">Exemples</h2> +Une [promesse (`Promise`)](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise) dont la valeur de rĂ©solution sera un objet [`tabs.Tab`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/tabs/Tab) contenant des dĂ©tails sur l'onglet dupliquĂ©. L'objet `Tab` contiendra les propriĂ©tĂ©s `url`, `title` et `favIconUrl` uniquement si l'extension dispose de la [permission `"tabs"`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) ou lorsque [l'hĂŽte correspond Ă un hĂŽte ciblĂ© dans les permissions](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#host_permissions). Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<p>Duplique le premier onglet, puis affiche l'identifiant de l'onglet nouvellement crĂ©Ă© :</p> +> **Note :** Ă partir de Firefox 68, la promesse renvoyĂ©e par `browser.tabs.duplicate()` se rĂ©sout dĂšs que l'onglet a Ă©tĂ© dupliquĂ©. Auparavant, la promesse n'Ă©tait rĂ©solue qu'une fois l'onglet entiĂšrement chargĂ©. -<pre class="brush: js"> +## Exemples + +Duplique le premier onglet, puis affiche l'identifiant de l'onglet nouvellement crĂ©Ă© : + +```js function onDuplicated(tabInfo) { console.log(tabInfo.id); } @@ -61,7 +54,7 @@ function onError(error) { // Duplique le premier onglet du tableau function duplicateFirstTab(tabs) { console.log(tabs); - if (tabs.length > 0) { + if (tabs.length > 0) { let duplicating = browser.tabs.duplicate(tabs[0].id); duplicating.then(onDuplicated, onError); } @@ -69,27 +62,24 @@ function duplicateFirstTab(tabs) { // On rĂ©cupĂšre tous les onglets ouverts let querying = browser.tabs.query({}); -querying.then(duplicateFirstTab, onError);</pre> - -<h3 id="example_extensions">Exemple d'extensions</h3> - -<ul> - <li><a href="https://github.com/mdn/webextensions-examples/tree/master/tabs-tabs-tabs">tabs-tabs-tabs</a></li> -</ul> +querying.then(duplicateFirstTab, onError); +``` -<h2 id="browser_compatibility">CompatibilitĂ© des navigateurs</h2> +### Exemple d'extensions -<p>{{Compat}}</p> +- [tabs-tabs-tabs](https://github.com/mdn/webextensions-examples/tree/master/tabs-tabs-tabs) -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© des navigateurs -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -116,5 +106,4 @@ querying.then(duplicateFirstTab, onError);</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/tabs/executescript/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/executescript/index.md index 0b790a369a..cf707654b2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/executescript/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/executescript/index.md @@ -14,76 +14,79 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/executeScript --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Injecte du code JavaScript dans une page.</p> +Injecte du code JavaScript dans une page. -<p>Vous pouvez injecter du code dans des pages dont l'URL peut ĂȘtre exprimĂ©e Ă l'aide d'un <a href="/fr/Add-ons/WebExtensions/Match_patterns">modĂšle de correspondance </a>: son schĂ©ma doit ĂȘtre "http", "https", "file", "ftp". Pour ce faire, vous devez disposer de la permission pour l'URL de la page, soit explicitement en tant que <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permission d'hĂŽte</a>, ou via la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#activeTab_permission">permission activeTab</a>.</p> +Vous pouvez injecter du code dans des pages dont l'URL peut ĂȘtre exprimĂ©e Ă l'aide d'un [modĂšle de correspondance ](/fr/Add-ons/WebExtensions/Match_patterns): son schĂ©ma doit ĂȘtre "http", "https", "file", "ftp". Pour ce faire, vous devez disposer de la permission pour l'URL de la page, soit explicitement en tant que [permission d'hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions), ou via la [permission activeTab](/fr/Add-ons/WebExtensions/manifest.json/permissions#activeTab_permission). -<p>Vous pouvez Ă©galement injecter du code dans des pages empaquetĂ©es avec votre propre extension :</p> +Vous pouvez Ă©galement injecter du code dans des pages empaquetĂ©es avec votre propre extension : -<pre class="brush: js">browser.tabs.create({url: "/my-page.html"}).then(() => { +```js +browser.tabs.create({url: "/my-page.html"}).then(() => { browser.tabs.executeScript({ code: `console.log('location:', window.location.href);` }); -});</pre> +}); +``` -<p>Vous n'avez pas besoin de permissions spĂ©ciales pour le faire.</p> +Vous n'avez pas besoin de permissions spĂ©ciales pour le faire. -<p>Vous <em>ne pouvez pas</em> injecter de code dans les pages intĂ©grĂ©es du navigateur, par exemple : about:debugging, about:addons, ou sur la page qui s'ouvre lorsque vous ouvrez un nouvel onglet vide.</p> +Vous _ne pouvez pas_ injecter de code dans les pages intĂ©grĂ©es du navigateur, par exemple : about:debugging, about:addons, ou sur la page qui s'ouvre lorsque vous ouvrez un nouvel onglet vide. -<p>Les scripts que vous injectez sâappellent des scripts de contenu. <a href="/fr/Add-ons/WebExtensions/Content_scripts">En savoir plus sur les scripts de contenu</a>.</p> +Les scripts que vous injectez sâappellent des scripts de contenu. [En savoir plus sur les scripts de contenu](/fr/Add-ons/WebExtensions/Content_scripts). -<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 executing = browser.tabs.executeScript( +```js +var executing = browser.tabs.executeScript( tabId, // optional integer details // object ) -</pre> +``` + +### ParamĂštres -<h3 id="ParamĂštres">ParamĂštres</h3> +- `tabId` {{optional_inline}} + - : `integer`. LâID de lâonglet dans lequel exĂ©cuter le script. Par dĂ©faut, lâonglet actif de la fenĂȘtre en cours. +- `details` -<dl> - <dt><code>tabId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. LâID de lâonglet dans lequel exĂ©cuter le script. Par dĂ©faut, lâonglet actif de la fenĂȘtre en cours.</dd> - <dt><code>details</code></dt> - <dd><p>Un objet dĂ©crivant le script Ă exĂ©cuter. Il contient les propriĂ©tĂ©s suivantesâŻ:</p> - <dl> - <dt><code>allFrames</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si <code>true</code>, le code sera injectĂ© dans toutes les cadres de la page courante. Si <code>true</code> et <code>frameId</code> est dĂ©fini, alors il y aura une erreur, frameId et allFrames sont mutuellement exclusifs. Si c'est <code>false</code>, le code n'est injectĂ© que dans le cadre supĂ©rieur. La valeur par dĂ©faut est <code>false</code>.</dd> - <dt><code>code </code>{{optional_inline}}</dt> - <dd><code>string</code>. Code Ă injecter, sous la forme dâune chaine de texte. <strong>AttentionâŻ:</strong> nâutilisez pas cette propriĂ©tĂ© pour interpoler des donnĂ©es non sĂ»res dans JavaScript, car cela pourrait introduire une faille de sĂ©curitĂ©.</dd> - <dt><code>file</code> {{optional_inline}}</dt> - <dd><code>string</code>. Chemin dâaccĂšs Ă un fichier contenant le code Ă injecter. Dans Firefox, les URL relatives ne commençant pas Ă la racine de l'extension sont rĂ©solues par rapport Ă l'URL de la page en cours. Dans Chrome, ces URL sont rĂ©solues par rapport Ă lâURL de base de lâextension. Pour travailler avec plusieurs navigateurs, vous pouvez spĂ©cifier le chemin comme une URL relative, en commençant Ă la racine de lâextension, comme ceci : <code>"/path/to/script.js"</code>.</dd> - <dt><code>frameId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. Le cadre oĂč le code doit ĂȘtre injectĂ©. La valeur par dĂ©faut est <code>0</code> (le cadre de niveau supĂ©rieur).</dd> - <dt><code>matchAboutBlank</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si <code>true</code>, le code sera injectĂ© dans des cadres <code>about:blank</code> et <code>about:srcdoc</code> inclus depuis une page si votre extension a accĂšs Ă leur document parent. Le code ne peut pas ĂȘtre insĂ©rĂ© dans les cadres <code>about:</code> de niveau supĂ©rieur. Par dĂ©faut, <code>false</code>.</dd> - <dt><code>runAt</code> {{optional_inline}}</dt> - <dd>{{WebExtAPIRef('extensionTypes.RunAt')}}. Le moment le plus tĂŽt auquel le code sera injectĂ© dans lâonglet. Par dĂ©faut, <code>document_idle</code>.</dd> - </dl> - </dd> -</dl> + - : Un objet dĂ©crivant le script Ă exĂ©cuter. Il contient les propriĂ©tĂ©s suivantesâŻ: -<h3 id="Valeur_de_retour">Valeur de retour</h3> + - `allFrames` {{optional_inline}} + - : `boolean`. Si `true`, le code sera injectĂ© dans toutes les cadres de la page courante. Si `true` et `frameId` est dĂ©fini, alors il y aura une erreur, frameId et allFrames sont mutuellement exclusifs. Si c'est `false`, le code n'est injectĂ© que dans le cadre supĂ©rieur. La valeur par dĂ©faut est `false`. + - `code `{{optional_inline}} + - : `string`. Code Ă injecter, sous la forme dâune chaine de texte. **AttentionâŻ:** nâutilisez pas cette propriĂ©tĂ© pour interpoler des donnĂ©es non sĂ»res dans JavaScript, car cela pourrait introduire une faille de sĂ©curitĂ©. + - `file` {{optional_inline}} + - : `string`. Chemin dâaccĂšs Ă un fichier contenant le code Ă injecter. Dans Firefox, les URL relatives ne commençant pas Ă la racine de l'extension sont rĂ©solues par rapport Ă l'URL de la page en cours. Dans Chrome, ces URL sont rĂ©solues par rapport Ă lâURL de base de lâextension. Pour travailler avec plusieurs navigateurs, vous pouvez spĂ©cifier le chemin comme une URL relative, en commençant Ă la racine de lâextension, comme ceci : `"/path/to/script.js"`. + - `frameId` {{optional_inline}} + - : `integer`. Le cadre oĂč le code doit ĂȘtre injectĂ©. La valeur par dĂ©faut est `0` (le cadre de niveau supĂ©rieur). + - `matchAboutBlank` {{optional_inline}} + - : `boolean`. Si `true`, le code sera injectĂ© dans des cadres `about:blank` et `about:srcdoc` inclus depuis une page si votre extension a accĂšs Ă leur document parent. Le code ne peut pas ĂȘtre insĂ©rĂ© dans les cadres `about:` de niveau supĂ©rieur. Par dĂ©faut, `false`. + - `runAt` {{optional_inline}} + - : {{WebExtAPIRef('extensionTypes.RunAt')}}. Le moment le plus tĂŽt auquel le code sera injectĂ© dans lâonglet. Par dĂ©faut, `document_idle`. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> rĂ©solue avec un tableau dâobjets reprĂ©sentant le rĂ©sultat du script dans chaque cadre oĂč le script a Ă©tĂ© injectĂ©.</p> +### Valeur de retour -<p>Le rĂ©sultat du script est la derniĂšre instruction Ă©valuĂ©e, ce qui est similaire Ă ce qui serait produit (les rĂ©sultats, pas les affichages de <code>console.log()</code>) si vous exĂ©cutiez le script dans la <a href="/fr/docs/Outils/Console_Web">Console Web</a>. Par exemple, considĂ©rez un script comme celui-ciâŻ:</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) rĂ©solue avec un tableau dâobjets reprĂ©sentant le rĂ©sultat du script dans chaque cadre oĂč le script a Ă©tĂ© injectĂ©. -<pre class="brush: js">var foo='my result';foo;</pre> +Le rĂ©sultat du script est la derniĂšre instruction Ă©valuĂ©e, ce qui est similaire Ă ce qui serait produit (les rĂ©sultats, pas les affichages de `console.log()`) si vous exĂ©cutiez le script dans la [Console Web](/fr/docs/Outils/Console_Web). Par exemple, considĂ©rez un script comme celui-ciâŻ: -<p>Ici, le tableau des rĂ©sultats contiendra la chaĂźne <code>"my result"</code> en tant quâĂ©lĂ©ment. Les valeurs de rĂ©sultat doivent ĂȘtre <a href="/fr/docs/Web/API/Web_Workers_API/algorithme_clonage_structure">clonables tructurĂ©es</a>. La derniĂšre dĂ©claration peut Ă©galement ĂȘtre une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise</a></code>, mais cette fonctionnalitĂ© n'est pas supportĂ©e par la bibliothĂšque <a href="https://github.com/mozilla/webextension-polyfill#tabsexecutescript">webextension-polyfill</a>.<br> - Si une erreur se produit, la promesse sera rejetĂ©e avec un message dâerreur.</p> +```js +var foo='my result';foo; +``` -<h2 id="Exemples">Exemples</h2> +Ici, le tableau des rĂ©sultats contiendra la chaĂźne `"my result"` en tant quâĂ©lĂ©ment. Les valeurs de rĂ©sultat doivent ĂȘtre [clonables tructurĂ©es](/fr/docs/Web/API/Web_Workers_API/algorithme_clonage_structure). La derniĂšre dĂ©claration peut Ă©galement ĂȘtre une [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise), mais cette fonctionnalitĂ© n'est pas supportĂ©e par la bibliothĂšque [webextension-polyfill](https://github.com/mozilla/webextension-polyfill#tabsexecutescript). +Si une erreur se produit, la promesse sera rejetĂ©e avec un message dâerreur. -<p>Cet exemple exĂ©cute un extrait de code dâune ligne dans lâonglet actuellement actifâŻ:</p> +## Exemples -<pre class="brush: js">function onExecuted(result) { +Cet exemple exĂ©cute un extrait de code dâune ligne dans lâonglet actuellement actifâŻ: + +```js +function onExecuted(result) { console.log(`We made it green`); } @@ -96,11 +99,13 @@ var makeItGreen = 'document.body.style.border = "5px solid green"'; var executing = browser.tabs.executeScript({ code: makeItGreen }); -executing.then(onExecuted, onError);</pre> +executing.then(onExecuted, onError); +``` -<p>Lâexemple suivant exĂ©cute un script Ă partir dâun fichier empaquetĂ© avec lâextension appelĂ© <code>content-script.js</code>. Le script est exĂ©cutĂ© dans lâonglet actuellement actif. Le script est exĂ©cutĂ© dans les sous-cadres ainsi que dans le document principalâŻ:</p> +Lâexemple suivant exĂ©cute un script Ă partir dâun fichier empaquetĂ© avec lâextension appelĂ© `content-script.js`. Le script est exĂ©cutĂ© dans lâonglet actuellement actif. Le script est exĂ©cutĂ© dans les sous-cadres ainsi que dans le document principalâŻ: -<pre class="brush: js">function onExecuted(result) { +```js +function onExecuted(result) { console.log(`We executed in all subframes`); } @@ -112,11 +117,13 @@ var executing = browser.tabs.executeScript({ file: "/content-script.js", allFrames: true }); -executing.then(onExecuted, onError);</pre> +executing.then(onExecuted, onError); +``` -<p>Lâexemple suivant exĂ©cute un script Ă partir dâun fichier empaquetĂ© avec lâextension appelĂ© <code>content-script.js</code>. Le script est exĂ©cutĂ© dans lâonglet ayant lâID 2âŻ:</p> +Lâexemple suivant exĂ©cute un script Ă partir dâun fichier empaquetĂ© avec lâextension appelĂ© `content-script.js`. Le script est exĂ©cutĂ© dans lâonglet ayant lâID 2âŻ: -<pre class="brush: js">function onExecuted(result) { +```js +function onExecuted(result) { console.log(`We executed in tab 2`); } @@ -128,21 +135,20 @@ var executing = browser.tabs.executeScript( 2, { file: "/content-script.js" }); -executing.then(onExecuted, onError);</pre> - -<p>{{WebExtExamples}}</p> +executing.then(onExecuted, onError); +``` -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> +{{WebExtExamples}} -<p>{{Compat("webextensions.api.tabs.executeScript")}}</p> +## CompatibilitĂ© des navigateurs -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.tabs.executeScript")}} -<p>Cette API est basĂ©e sur lâAPI <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur lâAPI [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) dans le code de Chromium code. -<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 @@ -169,5 +175,4 @@ executing.then(onExecuted, onError);</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/tabs/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/get/index.md index c889a95e70..b2cc539d70 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/get/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/get/index.md @@ -13,35 +13,35 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/get --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ătant donnĂ© un ID d'onglet, obtenez les dĂ©tails de l'onglet en tant qu'objet {{WebExtAPIRef("tabs.Tab")}}.</p> +Ătant donnĂ© un ID d'onglet, obtenez les dĂ©tails de l'onglet en tant qu'objet {{WebExtAPIRef("tabs.Tab")}}. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 getting = browser.tabs.get( +```js +var getting = browser.tabs.get( tabId // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet Ă obtenir.</dd> -</dl> +- `tabId` + - : `integer`. ID de l'onglet Ă obtenir. -<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('tabs.Tab')}} contenant des informations sur l'onglet. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des informations sur l'onglet. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Obtenir des informations sur un onglet lorsqu'il est activĂ© :</p> +Obtenir des informations sur un onglet lorsqu'il est activĂ© : -<pre class="brush: js">async function logListener(info) { +```js +async function logListener(info) { try { let tabInfo = await browser.tabs.get(info.tabId); console.log(tabInfo); @@ -50,21 +50,20 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/get } } -browser.tabs.onActivated.addListener(logListener);</pre> +browser.tabs.onActivated.addListener(logListener); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.get")}}</p> +{{Compat("webextensions.api.tabs.get")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur lâAPI [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) dans le code de Chromium code. -<p>Cette API est basĂ©e sur lâAPI <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</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 @@ -91,5 +90,4 @@ browser.tabs.onActivated.addListener(logListener);</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/tabs/getallinwindow/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.md index da8b786701..4dd5f57b54 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.md @@ -14,50 +14,45 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getAllInWindow --- -<div>{{AddonSidebar}} -<div> -<p><strong>Deprecated</strong><br> - Cette mĂ©thode est dĂ©prĂ©ciĂ©e. Utilisez {{WebExtAPIRef("tabs.query", "tabs.query({currentWindow: true})")}} Ă la place.</p> -</div> -</div> +{{AddonSidebar}} -<p>Obtient des dĂ©tails sur tous les onglets de la fenĂȘtre spĂ©cifiĂ©e.</p> +**Deprecated** +Cette mĂ©thode est dĂ©prĂ©ciĂ©e. Utilisez {{WebExtAPIRef("tabs.query", "tabs.query({currentWindow: true})")}} Ă la place. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise</a></code>.</p> +Obtient des dĂ©tails sur tous les onglets de la fenĂȘtre spĂ©cifiĂ©e. -<h2 id="Syntaxe">Syntaxe</h2> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise). -<pre class="brush: js">var getting = browser.tabs.getAllInWindow( +## Syntaxe + +```js +var getting = browser.tabs.getAllInWindow( windowId // optional integer ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>windowId</code>{{Optional_Inline}}</dt> - <dd><code>integer</code>. Par dĂ©faut Ă la fenĂȘtre actuelle.</dd> -</dl> +``` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### ParamĂštres -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise</a></code> qui sera remplie avec un <code>tableau</code> d'ojets <code>{{WebExtAPIRef('tabs.Tab')}}</code> contenant des informations sur tous les onglets de la fenĂȘtre. Si la fenĂȘtre n'a pas pu ĂȘtre trouvĂ©e ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +- `windowId`{{Optional_Inline}} + - : `integer`. Par dĂ©faut Ă la fenĂȘtre actuelle. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.tabs.getAllInWindow")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise) qui sera remplie avec un `tableau` d'ojets `{{WebExtAPIRef('tabs.Tab')}}` contenant des informations sur tous les onglets de la fenĂȘtre. Si la fenĂȘtre n'a pas pu ĂȘtre trouvĂ©e ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<p>{{WebExtExamples}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.tabs.getAllInWindow")}} -<p>Cette API est basĂ©e sur lâAPI <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -84,5 +79,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getAllInWindow // 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/tabs/getcurrent/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.md index ee26a84063..fc0ca25903 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.md @@ -13,32 +13,34 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getCurrent --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtenez un {{WebExtAPIRef("tabs.Tab")}} contenant des informations sur l'onglet dans lequel ce script s'exĂ©cute.</p> +Obtenez un {{WebExtAPIRef("tabs.Tab")}} contenant des informations sur l'onglet dans lequel ce script s'exĂ©cute. -<p>Vous pouvez appeler cette fonction dans des contextes comportant un onglet de navigateur, par exemple une <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Options_pages">pages d'options</a>. Si vous l'appelez Ă partir d'un script d'arriĂšre-plan ou d'une fenĂȘtre contextuelle, elle renverra undefined.</p> +Vous pouvez appeler cette fonction dans des contextes comportant un onglet de navigateur, par exemple une [pages d'options](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Options_pages). Si vous l'appelez Ă partir d'un script d'arriĂšre-plan ou d'une fenĂȘtre contextuelle, elle renverra undefined. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingCurrent = browser.tabs.getCurrent() -</pre> +```js +var gettingCurrent = browser.tabs.getCurrent() +``` -<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 remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des informations sur l'onglet en cours. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des informations sur l'onglet en cours. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Obtenir les informations sur l'onglet en cours :</p> +Obtenir les informations sur l'onglet en cours : -<pre class="brush: js">function onGot(tabInfo) { +```js +function onGot(tabInfo) { console.log(tabInfo); } @@ -47,23 +49,22 @@ function onError(error) { } var gettingCurrent = browser.tabs.getCurrent(); -gettingCurrent.then(onGot, onError);</pre> +gettingCurrent.then(onGot, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.getCurrent")}}</p> +{{Compat("webextensions.api.tabs.getCurrent")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur lâAPI [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ gettingCurrent.then(onGot, onError);</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/tabs/getselected/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/getselected/index.md index 20fe260b83..dcd5477edd 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/getselected/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/getselected/index.md @@ -14,49 +14,44 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getSelected --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div class="warning"> -<p><strong>Attention :</strong> Cette mĂ©thode est dĂ©prĂ©ciĂ©e. utilisez {{WebExtAPIRef("tabs.query", "tabs.query({active: true})")}} Ă la place.</p> -</div> +> **Attention :** Cette mĂ©thode est dĂ©prĂ©ciĂ©e. utilisez {{WebExtAPIRef("tabs.query", "tabs.query({active: true})")}} Ă la place. -<p>Obtient l'onglet sĂ©lectionnĂ© dans la fenĂȘtre spĂ©cifiĂ©e</p> +Obtient l'onglet sĂ©lectionnĂ© dans la fenĂȘtre spĂ©cifiĂ©e -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingSelected = browser.tabs.getSelected( +```js +var gettingSelected = browser.tabs.getSelected( windowId // optional integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Par dĂ©faut Ă la fenĂȘtre actuelle.</dd> -</dl> +- `windowId`{{optional_inline}} + - : `integer`. Par dĂ©faut Ă la fenĂȘtre actuelle. -<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 <a href="/fr/Add-ons/WebExtensions/API/tabs/Tab"><code>tabs.Tab</code></a> contenant des informations sur l'onglet sĂ©lectionnĂ©. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet [`tabs.Tab`](/fr/Add-ons/WebExtensions/API/tabs/Tab) contenant des informations sur l'onglet sĂ©lectionnĂ©. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.getSelected")}}</p> +{{Compat("webextensions.api.tabs.getSelected")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur lâAPI [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -83,5 +78,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getSelected // 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/tabs/getzoom/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoom/index.md index 7b97eca351..689aa3b568 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoom/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoom/index.md @@ -13,35 +13,35 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getZoom --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient le facteur de zoom actuel pour l'onglet spĂ©cifiĂ©.</p> +Obtient le facteur de zoom actuel pour l'onglet spĂ©cifiĂ©. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingZoom = browser.tabs.getZoom( +```js +var gettingZoom = browser.tabs.getZoom( tabId // optional integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet pour obtenir le facteur de zoom actuel. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours.</dd> -</dl> +- `tabId`{{optional_inline}} + - : `integer`. L'ID de l'onglet pour obtenir le facteur de zoom actuel. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours. -<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 satisfaite avec le facteur de zoom actuel de l'onglet, sous la forme d'un nombre compris entre 0,3 et 3. Si l'onglet n'a pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera satisfaite avec le facteur de zoom actuel de l'onglet, sous la forme d'un nombre compris entre 0,3 et 3. Si l'onglet n'a pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Obtenez le facteur de zoom pour l'onglet actuel :</p> +Obtenez le facteur de zoom pour l'onglet actuel : -<pre class="brush: js">function onGot(zoom) { +```js +function onGot(zoom) { console.log(zoom); } @@ -50,11 +50,13 @@ function onError(error) { } var gettingZoom = browser.tabs.getZoom(); -gettingZoom.then(onGot, onError);</pre> +gettingZoom.then(onGot, onError); +``` -<p>Obtenez le facteur zoom pour l'onglet dont l'ID est 2:</p> +Obtenez le facteur zoom pour l'onglet dont l'ID est 2: -<pre class="brush: js">function onGot(zoom) { +```js +function onGot(zoom) { console.log(zoom); } @@ -63,23 +65,22 @@ function onError(error) { } var gettingZoom = browser.tabs.getZoom(2); -gettingZoom.then(onGot, onError);</pre> +gettingZoom.then(onGot, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.getZoom")}}</p> +{{Compat("webextensions.api.tabs.getZoom")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur lâAPI [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -106,5 +107,4 @@ gettingZoom.then(onGot, onError);</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/tabs/getzoomsettings/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.md index 89934d27f2..05de478c05 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.md @@ -13,35 +13,35 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getZoomSettings --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient les paramĂštres de zoom actuels pour un onglet spĂ©cifiĂ©.</p> +Obtient les paramĂštres de zoom actuels pour un onglet spĂ©cifiĂ©. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingZoomSettings = browser.tabs.getZoomSettings( +```js +var gettingZoomSettings = browser.tabs.getZoomSettings( tabId // optional integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet pour obtenir les paramĂštres de zoom actuels. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours.</dd> -</dl> +- `tabId`{{optional_inline}} + - : `integer`. L'ID de l'onglet pour obtenir les paramĂštres de zoom actuels. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours. -<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('tabs.ZoomSettings')}} reprĂ©sentant les paramĂštres de zoom actuels de l'onglet. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef('tabs.ZoomSettings')}} reprĂ©sentant les paramĂštres de zoom actuels de l'onglet. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Obtenez les paramĂštres de zoom pour l'onglet en cours :</p> +Obtenez les paramĂštres de zoom pour l'onglet en cours : -<pre class="brush: js">function onGot(settings) { +```js +function onGot(settings) { console.log(settings); } @@ -50,23 +50,22 @@ function onError(error) { } var gettingZoomSettings = browser.tabs.getZoomSettings(); -gettingZoomSettings.then(onGot, onError);</pre> +gettingZoomSettings.then(onGot, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.getZoomSettings")}}</p> +{{Compat("webextensions.api.tabs.getZoomSettings")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur lâAPI [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -93,5 +92,4 @@ gettingZoomSettings.then(onGot, onError);</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/tabs/goback/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/goback/index.md index f0c2dc8c64..bcacffa657 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/goback/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/goback/index.md @@ -12,44 +12,42 @@ tags: - hoBack translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/goBack --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Naviguer Ă la page prĂ©cĂ©dente dans l'historique de l'onglet, si disponible.</p> +Naviguer Ă la page prĂ©cĂ©dente dans l'historique de l'onglet, si disponible. -<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 withgoingBack = browser.tabs.goBack( +```js +var withgoingBack = browser.tabs.goBack( tabId, // optional integer callback // optional function ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet Ă naviguer. Par dĂ©faut, l'onglet actif de la fenĂȘtre en cours.</dd> - <dt><code>callback</code>{{optional_inline}}</dt> - <dd><code>function</code>. Lorsque la navigation sur la page se termine, cette fonction est appelĂ©e sans paramĂštres.</dd> -</dl> +- `tabId`{{optional_inline}} + - : `integer`. L'ID de l'onglet Ă naviguer. Par dĂ©faut, l'onglet actif de la fenĂȘtre en cours. +- `callback`{{optional_inline}} + - : `function`. Lorsque la navigation sur la page se termine, cette fonction est appelĂ©e sans paramĂštres. -<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 est tenue lorsque la navigation sur la page se termine.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est tenue lorsque la navigation sur la page se termine. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.tabs.goBack")}} +## Exemples -<p>{{Compat("webextensions.api.tabs.goBack")}}</p> +Retournez Ă la page prĂ©cĂ©dente dans l'onglet en cours : -<h2 id="Exemples">Exemples</h2> - -<p>Retournez Ă la page prĂ©cĂ©dente dans l'onglet en cours :</p> - -<pre class="brush: js">function onGoBack() { +```js +function onGoBack() { console.log("Gone back"); } @@ -58,19 +56,18 @@ function onError(error) { } var goingBack = browser.tabs.goBack(); -goingBack.then(onGoBack, onError);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +goingBack.then(onGoBack, onError); +``` -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/tabs#method-getZoomSettings"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code Chromium.</p> +{{WebExtExamples}} -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence amĂ©ricaine Creative Commons Attribution 3.0.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-getZoomSettings) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence amĂ©ricaine Creative Commons Attribution 3.0. -<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 @@ -97,5 +94,4 @@ goingBack.then(onGoBack, onError);</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/tabs/goforward/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/goforward/index.md index fce5647bc7..10aa1b0c54 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/goforward/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/goforward/index.md @@ -12,44 +12,42 @@ tags: - goForward translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/goForward --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Passez Ă la page suivante dans l'historique de l'onglet, si disponible.</p> +Passez Ă la page suivante dans l'historique de l'onglet, si disponible. -<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 goingForward = browser.tabs.goForward( +```js +var goingForward = browser.tabs.goForward( tabId, // optional integer callback // optional function ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet Ă naviguer. Par dĂ©faut, l'onglet actif de la fenĂȘtre en cours.</dd> - <dt><code>callback</code>{{optional_inline}}</dt> - <dd><code>function</code>. Lorsque la navigation sur la page se termine, cette fonction est appelĂ©e sans paramĂštres.</dd> -</dl> +- `tabId`{{optional_inline}} + - : `integer`. L'ID de l'onglet Ă naviguer. Par dĂ©faut, l'onglet actif de la fenĂȘtre en cours. +- `callback`{{optional_inline}} + - : `function`. Lorsque la navigation sur la page se termine, cette fonction est appelĂ©e sans paramĂštres. -<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 est tenue lorsque la navigation sur la page se termine.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est tenue lorsque la navigation sur la page se termine. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.tabs.goForward")}} +## Exemples -<p>{{Compat("webextensions.api.tabs.goForward")}}</p> +Passez Ă la page suivante dans l'onglet en cours : -<h2 id="Exemples">Exemples</h2> - -<p>Passez Ă la page suivante dans l'onglet en cours :</p> - -<pre class="brush: js">function onGoForward() { +```js +function onGoForward() { console.log("Gone forward"); } @@ -58,19 +56,18 @@ function onError(error) { } var goingForward = browser.tabs.goForward(); -goingForward.then(onGoForward, onError);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +goingForward.then(onGoForward, onError); +``` -<p>Cette API est basĂ©e sur l'API <a href="https://developer.chrome.com/extensions/tabs#method-getZoomSettings"><code>chrome.tabs</code></a> de Chromium.Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence amĂ©ricaine Creative Commons Attribution 3.0.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-getZoomSettings) de Chromium.Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence amĂ©ricaine Creative Commons Attribution 3.0. -<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 @@ -97,5 +94,4 @@ goingForward.then(onGoForward, onError);</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/tabs/hide/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.md index 5686440252..b934121907 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.md @@ -12,53 +12,53 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/hide --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Masque un ou plusieurs onglets.</p> +Masque un ou plusieurs onglets. -<p>Les onglets cachĂ©s ne sont plus visibles dans l'onglet du navigateur. Les onglets cachĂ©s ne sont pas automatiquement <a href="/fr/Add-ons/WebExtensions/API/tabs/discard">supprimĂ©s</a> :  le code qui s'y trouve continue Ă s'exĂ©cuter. Vous pouvez explicitement supprimer les onglets Ă chaque fois que vous les masquez : bien que cela ne soit pas appropriĂ© dans toutes les situations, cela aidera Ă rĂ©duire les ressources utilisĂ©es par le navigateur.</p> +Les onglets cachĂ©s ne sont plus visibles dans l'onglet du navigateur. Les onglets cachĂ©s ne sont pas automatiquement [supprimĂ©s](/fr/Add-ons/WebExtensions/API/tabs/discard) :  le code qui s'y trouve continue Ă s'exĂ©cuter. Vous pouvez explicitement supprimer les onglets Ă chaque fois que vous les masquez : bien que cela ne soit pas appropriĂ© dans toutes les situations, cela aidera Ă rĂ©duire les ressources utilisĂ©es par le navigateur. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<p>Tous les onglets ne peuvent pas ĂȘtre masquĂ©s :</p> +Tous les onglets ne peuvent pas ĂȘtre masquĂ©s : -<ul> - <li>Les onglets Ă©pinglĂ©s ne peuvent pas ĂȘtre masquĂ©s.</li> - <li>Les onglets qui partagent l'Ă©cran, le microphone ou l'appareil photo ne peuvent pas ĂȘtre masquĂ©s.</li> - <li>L'onglet actif actuel ne peut pas ĂȘtre masquĂ©.</li> - <li>Les onglets en cours de fermeture ne peuvent pas ĂȘtre masquĂ©s.</li> -</ul> +- Les onglets Ă©pinglĂ©s ne peuvent pas ĂȘtre masquĂ©s. +- Les onglets qui partagent l'Ă©cran, le microphone ou l'appareil photo ne peuvent pas ĂȘtre masquĂ©s. +- L'onglet actif actuel ne peut pas ĂȘtre masquĂ©. +- Les onglets en cours de fermeture ne peuvent pas ĂȘtre masquĂ©s. -<p>La premiĂšre fois qu'une extension cache un onglet, le navigateur indiquera Ă l'utilisateur que l'onglet est cachĂ©, leur montrera comment ils peuvent accĂ©der Ă l'onglet cachĂ© et leur donnera l'option de dĂ©sactiver l'extension Ă la place.</p> +La premiĂšre fois qu'une extension cache un onglet, le navigateur indiquera Ă l'utilisateur que l'onglet est cachĂ©, leur montrera comment ils peuvent accĂ©der Ă l'onglet cachĂ© et leur donnera l'option de dĂ©sactiver l'extension Ă la place. -<p>Pour utiliser cette API, vous devez disposer de la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "tabHide".</p> +Pour utiliser cette API, vous devez disposer de la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "tabHide". -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var hiding = browser.tabs.hide( +```js +var hiding = browser.tabs.hide( tabIds // integer or integer array ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabIds</code></dt> - <dd><p><code>integer</code> or <code>array</code> of <code>integer</code>. Les ID de l'onglet ou des onglets Ă masquer.</p> - <p>Si l'un de ces onglets ne peut pas ĂȘtre masquĂ©, il ne sera pas masquĂ©, mais l'appel sera toujours valide et les onglets Ă©ligibles seront toujours masquĂ©s. Par exemple, si vous passez <code>[1, 3]</code>, et <code>1</code> identifie l'onglet actif, alors seulement <code>3</code> seront cachĂ©s.</p> - <p>Cependant, si l'un des ID d'onglet n'est pas valide, l'appel Ă©chouera et aucun onglet ne sera masquĂ©.</p> - </dd> -</dl> +- `tabIds` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `integer` or `array` of `integer`. Les ID de l'onglet ou des onglets Ă masquer. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un tableau contenant les ID des onglets qui ont Ă©tĂ© cachĂ©s. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> + Si l'un de ces onglets ne peut pas ĂȘtre masquĂ©, il ne sera pas masquĂ©, mais l'appel sera toujours valide et les onglets Ă©ligibles seront toujours masquĂ©s. Par exemple, si vous passez `[1, 3]`, et `1` identifie l'onglet actif, alors seulement `3` seront cachĂ©s. -<h2 id="Exemples">Exemples</h2> + Cependant, si l'un des ID d'onglet n'est pas valide, l'appel Ă©chouera et aucun onglet ne sera masquĂ©. -<p>Masquer un seul onglet :</p> +### Valeur retournĂ©e -<pre class="brush: js">function onHidden() { +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un tableau contenant les ID des onglets qui ont Ă©tĂ© cachĂ©s. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. + +## Exemples + +Masquer un seul onglet : + +```js +function onHidden() { console.log(`Hidden`); } @@ -66,11 +66,13 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.tabs.hide(2).then(onHidden, onError);</pre> +browser.tabs.hide(2).then(onHidden, onError); +``` -<p>Masquer plusieurs onglets :</p> +Masquer plusieurs onglets : -<pre class="brush: js">function onHidden() { +```js +function onHidden() { console.log(`Hidden`); } @@ -78,10 +80,11 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.tabs.hide([15, 14, 1]).then(onHidden, onError);</pre> +browser.tabs.hide([15, 14, 1]).then(onHidden, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.hide")}}</p> +{{Compat("webextensions.api.tabs.hide")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.md index f96c75b883..3dff709140 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.md @@ -13,62 +13,52 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/highlight --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Met en Ă©vidence (sĂ©lectionnĂ©) un ou plusieurs onglets. Les onglets sont spĂ©cifiĂ©s Ă l'aide d'un identifiant de fenĂȘtre et d'une plage d'indices de tabulation. -<div>Met en Ă©vidence (sĂ©lectionnĂ©) un ou plusieurs onglets. Les onglets sont spĂ©cifiĂ©s Ă l'aide d'un identifiant de fenĂȘtre et d'une plage d'indices de tabulation.</div> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise). -<div></div> +## Syntaxe -<div> -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise</a></code>.</p> -</div> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">var highlighting = browser.tabs.highlight( +```js +var highlighting = browser.tabs.highlight( highlightInfo // object ) -</pre> +``` + +### ParamĂštres + +- `highlightInfo` + + - : `object`. -<h3 id="ParamĂštres">ParamĂštres</h3> + - `windowId`{{optional_inline}} + - : `integer`. ID de la fenĂȘtre contenant les onglets. + - `populate`{{optional_inline}} -<dl> - <dt><code>highlightInfo</code></dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. ID de la fenĂȘtre contenant les onglets.</dd> - <dt><code>populate</code>{{optional_inline}}</dt> - <dd><p><code>boolean</code>. Par dĂ©faut la valeur est <code>true</code>. S'il est dĂ©fini sur <code>false</code>, l'objet {{WebExtAPIRef('windows.Window')}} n'aura pas de propriĂ©tĂ© <code>tabs</code> contenant une liste d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les onglets ouverts dans la fenĂȘtre.</p> - <div class="note"> - <p><strong>Note :</strong> Remplir la fenĂȘtre (le comportement par dĂ©faut) peut ĂȘtre une opĂ©ration coĂ»teuse s'il y a beaucoup d'onglets. Pour de meilleures performances, il est recommandĂ© de dĂ©finir manuellement configurĂ© <code>populate</code> Ă <code>false</code> si vous n'avez pas besoin des dĂ©tails de l'onglet.</p> - </div> - </dd> - <dt><code>tabs</code></dt> - <dd><code>array</code> de valeurs entiĂšres spĂ©cifiant un ou plusieurs onglets Ă mettre en Ă©vidence. Les onglets surlignĂ©s prĂ©cĂ©demment qui ne sont pas inclus dans les <code>onglets</code> cesseront d'ĂȘtre surlignĂ©s. Le premier onglet des <code>onglets</code> devient actif.</dd> - </dl> - </dd> -</dl> + - : `boolean`. Par dĂ©faut la valeur est `true`. S'il est dĂ©fini sur `false`, l'objet {{WebExtAPIRef('windows.Window')}} n'aura pas de propriĂ©tĂ© `tabs` contenant une liste d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les onglets ouverts dans la fenĂȘtre. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + > **Note :** Remplir la fenĂȘtre (le comportement par dĂ©faut) peut ĂȘtre une opĂ©ration coĂ»teuse s'il y a beaucoup d'onglets. Pour de meilleures performances, il est recommandĂ© de dĂ©finir manuellement configurĂ© `populate` Ă `false` si vous n'avez pas besoin des dĂ©tails de l'onglet. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise</a></code>  qui sera remplie avec un objet {{WebExtAPIRef('windows.Window')}} contenant des dĂ©tails sur la fenĂȘtre dont les onglets ont Ă©tĂ© mis en surbrillance. Si la fenĂȘtre n'a pas pu ĂȘtre trouvĂ©e ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> + - `tabs` + - : `array` de valeurs entiĂšres spĂ©cifiant un ou plusieurs onglets Ă mettre en Ă©vidence. Les onglets surlignĂ©s prĂ©cĂ©demment qui ne sont pas inclus dans les `onglets` cesseront d'ĂȘtre surlignĂ©s. Le premier onglet des `onglets` devient actif. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.tabs.highlight",2)}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise)  qui sera remplie avec un objet {{WebExtAPIRef('windows.Window')}} contenant des dĂ©tails sur la fenĂȘtre dont les onglets ont Ă©tĂ© mis en surbrillance. Si la fenĂȘtre n'a pas pu ĂȘtre trouvĂ©e ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<p>{{WebExtExamples}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.tabs.highlight",2)}} -<p>Cette API est basĂ©e sur lâAPI <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -95,5 +85,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/highlight // 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/tabs/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/index.md index cfea5b78c9..cd253e4d16 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/index.md @@ -14,185 +14,171 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs --- -<div>{{AddonSidebar}}</div> - -<p>Permet d'interagir avec le systĂšme d'onglets du navigateur.</p> - -<p>Vous pouvez utiliser cette API pour obtenir une liste des onglets ouverts, filtrĂ©s par diffĂ©rents critĂšres, ainsi que pour ouvrir, mettre Ă jour, dĂ©placer, recharger et supprimer des onglets. Vous ne pouvez pas accĂ©der directement au contenu hĂ©bergĂ© par les onglets Ă l'aide de cette API, mais vous pouvez insĂ©rer du JavaScript et du CSS dans les onglets en utilisant les API {{WebExtAPIRef("tabs.executeScript()")}} ou {{WebExtAPIRef("tabs.insertCSS()")}}.</p> - -<p>Vous pouvez utiliser la majeure partie de cette API sans autorisation spĂ©ciale. ToutefoisâŻ:</p> - -<ul> - <li>Pour accĂ©der Ă <code>Tab.url</code>, <code>Tab.title</code> et <code>Tab.favIconUrl</code>, vous devez avoir la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>"tabs"</code>. - - <ul> - <li>Dans Firefox, cela signifie Ă©galement que vous avez besoin de <code>"tabs"</code> pour {{WebExtAPIRef("tabs.query", "requĂȘte d'onglet")}} par URL.</li> - </ul> - </li> - <li> - <p>Pour utiliser {{WebExtAPIRef("tabs.executeScript()")}} ou {{WebExtAPIRef("tabs.insertCSS()")}}, vous devez avoir les <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#host_permissions">permission d'hĂŽte</a> pour l'onglet.</p> - </li> -</ul> - -<p>Alternativement, vous pouvez obtenir ces autorisations temporairement, uniquement pour l'onglet actuellement actif et uniquement en rĂ©ponse Ă une action explicite de l'utilisateur ou de l'utilisatrice, en demandant la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#activetab_permission">permission <code>"activeTab"</code></a>.</p> - -<p>De nombreuses opĂ©rations d'onglet utilisent un identifiant (<code>id</code>) d'onglet. Les <code>id</code> d'onglets sont seulement garantis uniques Ă un onglet durant une session de navigation. Si le navigateur est redĂ©marrĂ©, il pourra recycler, et recyclera, les id d'onglets. Pour associer des informations Ă un onglet Ă travers les redĂ©marrages du navigateur, utilisez {{WebExtAPIRef("sessions.setTabValue()")}}.</p> - -<h2 id="Types">Types</h2> - -<dl> - <dt>{{WebExtAPIRef("tabs.MutedInfoReason")}}</dt> - <dd>SpĂ©cifie la raison pour laquelle un onglet a Ă©tĂ© rendu silencieux ou Ă nouveau sonore.</dd> - <dt>{{WebExtAPIRef("tabs.MutedInfo")}}</dt> - <dd>Cet objet contient un boolĂ©en indiquant si l'onglet est silencieux et la raison de la derniĂšre modification de l'Ă©tat.</dd> - <dt>{{WebExtAPIRef("tabs.PageSettings")}}</dt> - <dd> - <p>Permet de contrĂŽler le rendu d'un onglet au format PDF par la mĂ©thode {{WebExtAPIRef("tabs.saveAsPDF()")}}.</p> - </dd> - <dt>{{WebExtAPIRef("tabs.Tab")}}</dt> - <dd>Ce type contient des informations sur un onglet.</dd> - <dt>{{WebExtAPIRef("tabs.TabStatus")}}</dt> - <dd>Indique si l'onglet a fini de charger.</dd> - <dt>{{WebExtAPIRef("tabs.WindowType")}}</dt> - <dd>Le type de fenĂȘtre qui hĂ©berge cet onglet.</dd> - <dt>{{WebExtAPIRef("tabs.ZoomSettingsMode")}}</dt> - <dd>DĂ©finit si les modifications de zoom sont traitĂ©es par le navigateur, par l'extension ou sont dĂ©sactivĂ©es.</dd> - <dt>{{WebExtAPIRef("tabs.ZoomSettingsScope")}}</dt> - <dd>DĂ©finit si les modifications de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet.</dd> - <dt>{{WebExtAPIRef("tabs.ZoomSettings")}}</dt> - <dd>DĂ©finit les paramĂštres de zoom {{WebExtAPIRef("tabs.ZoomSettingsMode", "mode")}}, {{WebExtAPIRef("tabs.ZoomSettingsScope", "scope")}}, et le facteur de zoom par dĂ©faut.</dd> -</dl> - -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> - -<dl> - <dt>{{WebExtAPIRef("tabs.TAB_ID_NONE")}}</dt> - <dd>Une valeur d'id spĂ©ciale donnĂ©e aux onglets qui ne sont pas des onglets de navigation (par exemple, les onglets dans les fenĂȘtres <em>devtools</em>).</dd> -</dl> - -<h2 id="Fonctions">Fonctions</h2> - -<dl> - <dt>{{WebExtAPIRef("tabs.captureTab()")}}</dt> - <dd>CrĂ©e un URI de donnĂ©es codant une image de la zone visible de l'onglet donnĂ©.</dd> - <dt>{{WebExtAPIRef("tabs.captureVisibleTab()")}}</dt> - <dd>CrĂ©e un URI de donnĂ©es codant une image de la zone visible de l'onglet actuellement actif dans la fenĂȘtre donnĂ©e.</dd> - <dt>{{WebExtAPIRef("tabs.connect()")}}</dt> - <dd>DĂ©finit une connexion pour Ă©changer des messages entre les scripts d'arriĂšre-plan de l'extension (ou d'autres scripts privilĂ©giĂ©s, tels que les scripts de <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/user_interface/Popups">popups</a> ou les scripts de page d'options) et les <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts">scripts de contenu</a> s'exĂ©cutant dans l'onglet spĂ©cifiĂ©.</dd> - <dt>{{WebExtAPIRef("tabs.create()")}}</dt> - <dd>CrĂ©e un nouvel onglet.</dd> - <dt>{{WebExtAPIRef("tabs.detectLanguage()")}}</dt> - <dd>DĂ©tecte la langue principale du contenu dans un onglet.</dd> - <dt>{{WebExtAPIRef("tabs.discard()")}}</dt> - <dd>Ăvince un ou plusieurs onglets.</dd> - <dt>{{WebExtAPIRef("tabs.duplicate()")}}</dt> - <dd>Duplique un onglet.</dd> - <dt>{{WebExtAPIRef("tabs.executeScript()")}}</dt> - <dd>Injecte du code JavaScript dans une page.</dd> - <dt>{{WebExtAPIRef("tabs.get()")}}</dt> - <dd>Obtient des dĂ©tails sur l'onglet spĂ©cifiĂ©.</dd> - <dt>{{WebExtAPIRef("tabs.getAllInWindow()")}} {{deprecated_inline}}</dt> - <dd>Obtient des dĂ©tails sur tous les onglets de la fenĂȘtre spĂ©cifiĂ©e.</dd> - <dt>{{WebExtAPIRef("tabs.getCurrent()")}}</dt> - <dd>Obtient des informations sur l'onglet dans lequel ce script s'exĂ©cute, en tant qu'objet {{WebExtAPIRef("tabs.Tab")}}.</dd> - <dt>{{WebExtAPIRef("tabs.getSelected()")}} {{deprecated_inline}}</dt> - <dd>Obtient l'onglet sĂ©lectionnĂ© dans la fenĂȘtre spĂ©cifiĂ©e. <strong>Deprecated: utilisez plutĂŽt <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/tabs/query"><code>tabs.query({active: true})</code></a>.</strong></dd> - <dt>{{WebExtAPIRef("tabs.getZoom()")}}</dt> - <dd>Obtient le facteur de zoom actuel de l'onglet spĂ©cifiĂ©.</dd> - <dt>{{WebExtAPIRef("tabs.getZoomSettings()")}}</dt> - <dd>Obtient les paramĂštres de zoom actuels pour l'onglet spĂ©cifiĂ©.</dd> - <dt>{{WebExtAPIRef("tabs.goForward()")}}</dt> - <dd>Passez Ă la page suivante, si vous en avez une.</dd> - <dt>{{WebExtAPIRef("tabs.goBack()")}}</dt> - <dd>Retour Ă la page prĂ©cĂ©dente, si elle est disponible.</dd> - <dt>{{WebExtAPIRef("tabs.hide()")}} {{experimental_inline}}</dt> - <dd>Masque un ou plusieurs onglets.</dd> - <dt>{{WebExtAPIRef("tabs.highlight()")}}</dt> - <dd>Met en Ă©vidence un ou plusieurs onglets.</dd> - <dt>{{WebExtAPIRef("tabs.insertCSS()")}}</dt> - <dd>Injecte CSS dans une page.</dd> - <dt>{{WebExtAPIRef("tabs.move()")}}</dt> - <dd>DĂ©place un ou plusieurs onglets vers une nouvelle position dans la mĂȘme fenĂȘtre ou vers une autre fenĂȘtre.</dd> - <dt>{{WebExtApiRef("tabs.moveInSuccession()")}}</dt> - <dd>Modifie la relation de succession pour un groupe d'onglets.</dd> - <dt>{{WebExtAPIRef("tabs.print()")}}</dt> - <dd>Imprime le contenu de l'onglet actif.</dd> - <dt>{{WebExtAPIRef("tabs.printPreview()")}}</dt> - <dd> - <div>Ouvre l'aperçu avant impression pour l'onglet actif.</div> - </dd> - <dt>{{WebExtAPIRef("tabs.query()")}}</dt> - <dd>Obtient tous les onglets ayant les propriĂ©tĂ©s spĂ©cifiĂ©es, ou tous les onglets si aucune propriĂ©tĂ© n'est spĂ©cifiĂ©e.</dd> - <dt>{{WebExtAPIRef("tabs.reload()")}}</dt> - <dd>Recharge un onglet, en contournant Ă©ventuellement le cache web local.</dd> - <dt>{{WebExtAPIRef("tabs.remove()")}}</dt> - <dd>Ferme un ou plusieurs onglets.</dd> - <dt>{{WebExtAPIRef("tabs.removeCSS()")}}</dt> - <dd>Supprime d'une page CSS qui a Ă©tĂ© prĂ©cĂ©demment injectĂ©e en appelant {{WebExtAPIRef("tabs.insertCSS()")}}.</dd> - <dt>{{WebExtAPIRef("tabs.saveAsPDF()")}}</dt> - <dd>Enregistre la page en cours au format PDF.</dd> - <dt>{{WebExtAPIRef("tabs.sendMessage()")}}</dt> - <dd>Envoie un message unique au(x) script(s) de contenu dans l'onglet spĂ©cifiĂ©.</dd> - <dt>{{WebExtAPIRef("tabs.sendRequest()")}} {{deprecated_inline}}</dt> - <dd>Envoie une requĂȘte unique au(x) script(s) de contenu dans l'onglet spĂ©cifiĂ©. <strong>DĂ©prĂ©ciĂ©âŻ:</strong> utilisez {{WebExtAPIRef("tabs.sendMessage()")}} Ă la place.</dd> - <dt>{{WebExtAPIRef("tabs.setZoom()")}}</dt> - <dd>Effectue un zoom sur l'onglet spĂ©cifiĂ©.</dd> - <dt>{{WebExtAPIRef("tabs.setZoomSettings()")}}</dt> - <dd>DĂ©finit les paramĂštres de zoom pour l'onglet spĂ©cifiĂ©.</dd> - <dt>{{WebExtAPIRef("tabs.show()")}} {{experimental_inline}}</dt> - <dd>Affiche un ou plusieurs onglets qui ont Ă©tĂ© {{WebExtAPIRef("tabs.hide()", "masquĂ©s")}}.</dd> - <dt>{{WebExtAPIRef("tabs.toggleReaderMode()")}}</dt> - <dd>Bascule en mode lecture pour l'onglet spĂ©cifiĂ©.</dd> - <dt>{{WebExtAPIRef("tabs.update()")}}</dt> - <dd>Charge une nouvelle URL dans l'onglet, ou modifie d'autres propriĂ©tĂ©s de l'onglet.</dd> -</dl> - -<h2 id="ĂvĂšnements">ĂvĂšnements</h2> - -<dl> - <dt>{{WebExtAPIRef("tabs.onActivated")}}</dt> - <dd>Est Ă©mis lorsque l'onglet actif dans une fenĂȘtre change. Notez que l'URL de l'onglet peut ne pas ĂȘtre dĂ©finie au moment oĂč cet Ă©vĂšnement a Ă©tĂ© Ă©mis.</dd> - <dt>{{WebExtAPIRef("tabs.onActiveChanged")}} {{deprecated_inline}}</dt> - <dd>Est Ă©mis lorsque l'onglet sĂ©lectionnĂ© dans une fenĂȘtre change. <strong>DĂ©prĂ©ciĂ©âŻ:</strong> utilisez {{WebExtAPIRef("tabs.onActivated")}} Ă la place.</dd> - <dt>{{WebExtAPIRef("tabs.onAttached")}}</dt> - <dd>Est Ă©mis lorsqu'un onglet est attachĂ© Ă une fenĂȘtre, par exemple parce qu'il a Ă©tĂ© dĂ©placĂ© entre diffĂ©rentes fenĂȘtres.</dd> - <dt>{{WebExtAPIRef("tabs.onCreated")}}</dt> - <dd>Est Ă©mis lorsqu'un onglet est crĂ©Ă©. Notez que l'URL de l'onglet peut ne pas ĂȘtre dĂ©finie au moment oĂč cet Ă©vĂšnement a Ă©tĂ© Ă©mis.</dd> - <dt>{{WebExtAPIRef("tabs.onDetached")}}</dt> - <dd>Est Ă©mis lorsqu'un onglet est dĂ©tachĂ© d'une fenĂȘtre, par exemple parce qu'il a Ă©tĂ© dĂ©placĂ© entre diffĂ©rentes fenĂȘtres.</dd> - <dt>{{WebExtAPIRef("tabs.onHighlightChanged")}} {{deprecated_inline}}</dt> - <dd>Est Ă©mis lorsque les onglets en surbrillance ou sĂ©lectionnĂ©s dans une fenĂȘtre changent. <strong>DĂ©prĂ©ciĂ©âŻ:</strong> utilisez {{WebExtAPIRef("tabs.onHighlighted")}} Ă la place.</dd> - <dt>{{WebExtAPIRef("tabs.onHighlighted")}}</dt> - <dd>Est Ă©mis lorsque les onglets en surbrillance ou sĂ©lectionnĂ©s dans une fenĂȘtre changent.</dd> - <dt>{{WebExtAPIRef("tabs.onMoved")}}</dt> - <dd>Est Ă©mis lorsqu'un onglet est dĂ©placĂ© dans une fenĂȘtre.</dd> - <dt>{{WebExtAPIRef("tabs.onRemoved")}}</dt> - <dd>Est Ă©mis lorsqu'un onglet est fermĂ©.</dd> - <dt>{{WebExtAPIRef("tabs.onReplaced")}}</dt> - <dd>Est Ă©mis lorsqu'un onglet est remplacĂ© par un autre onglet en raison d'un <i lang="en">prerendering</i>.</dd> - <dt>{{WebExtAPIRef("tabs.onSelectionChanged")}} {{deprecated_inline}}</dt> - <dd>Est Ă©mis lorsque l'onglet sĂ©lectionnĂ© dans une fenĂȘtre change. <strong>DĂ©prĂ©ciĂ©âŻ:</strong> utilisez {{WebExtAPIRef("tabs.onActivated")}} Ă la place.</dd> - <dt>{{WebExtAPIRef("tabs.onUpdated")}}</dt> - <dd>Est Ă©mis lorsqu'un onglet est mis Ă jour.</dd> - <dt>{{WebExtAPIRef("tabs.onZoomChange")}}</dt> - <dd>Est Ă©mis lorsque le zoom dans un onglet est changĂ©.</dd> -</dl> - -<h2 id="CompatibilitĂ©_des_navigateurs">CompatibilitĂ© des navigateurs</h2> - -<p>{{Compat("webextensions.api.tabs")}}</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/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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}} + +Permet d'interagir avec le systĂšme d'onglets du navigateur. + +Vous pouvez utiliser cette API pour obtenir une liste des onglets ouverts, filtrĂ©s par diffĂ©rents critĂšres, ainsi que pour ouvrir, mettre Ă jour, dĂ©placer, recharger et supprimer des onglets. Vous ne pouvez pas accĂ©der directement au contenu hĂ©bergĂ© par les onglets Ă l'aide de cette API, mais vous pouvez insĂ©rer du JavaScript et du CSS dans les onglets en utilisant les API {{WebExtAPIRef("tabs.executeScript()")}} ou {{WebExtAPIRef("tabs.insertCSS()")}}. + +Vous pouvez utiliser la majeure partie de cette API sans autorisation spĂ©ciale. ToutefoisâŻ: + +- Pour accĂ©der Ă `Tab.url`, `Tab.title` et `Tab.favIconUrl`, vous devez avoir la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) `"tabs"`. + + - Dans Firefox, cela signifie Ă©galement que vous avez besoin de `"tabs"` pour {{WebExtAPIRef("tabs.query", "requĂȘte d'onglet")}} par URL. + +- Pour utiliser {{WebExtAPIRef("tabs.executeScript()")}} ou {{WebExtAPIRef("tabs.insertCSS()")}}, vous devez avoir les [permission d'hĂŽte](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#host_permissions) pour l'onglet. + +Alternativement, vous pouvez obtenir ces autorisations temporairement, uniquement pour l'onglet actuellement actif et uniquement en rĂ©ponse Ă une action explicite de l'utilisateur ou de l'utilisatrice, en demandant la [permission `"activeTab"`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#activetab_permission). + +De nombreuses opĂ©rations d'onglet utilisent un identifiant (`id`) d'onglet. Les `id` d'onglets sont seulement garantis uniques Ă un onglet durant une session de navigation. Si le navigateur est redĂ©marrĂ©, il pourra recycler, et recyclera, les id d'onglets. Pour associer des informations Ă un onglet Ă travers les redĂ©marrages du navigateur, utilisez {{WebExtAPIRef("sessions.setTabValue()")}}. + +## Types + +- {{WebExtAPIRef("tabs.MutedInfoReason")}} + - : SpĂ©cifie la raison pour laquelle un onglet a Ă©tĂ© rendu silencieux ou Ă nouveau sonore. +- {{WebExtAPIRef("tabs.MutedInfo")}} + - : Cet objet contient un boolĂ©en indiquant si l'onglet est silencieux et la raison de la derniĂšre modification de l'Ă©tat. +- {{WebExtAPIRef("tabs.PageSettings")}} + - : Permet de contrĂŽler le rendu d'un onglet au format PDF par la mĂ©thode {{WebExtAPIRef("tabs.saveAsPDF()")}}. +- {{WebExtAPIRef("tabs.Tab")}} + - : Ce type contient des informations sur un onglet. +- {{WebExtAPIRef("tabs.TabStatus")}} + - : Indique si l'onglet a fini de charger. +- {{WebExtAPIRef("tabs.WindowType")}} + - : Le type de fenĂȘtre qui hĂ©berge cet onglet. +- {{WebExtAPIRef("tabs.ZoomSettingsMode")}} + - : DĂ©finit si les modifications de zoom sont traitĂ©es par le navigateur, par l'extension ou sont dĂ©sactivĂ©es. +- {{WebExtAPIRef("tabs.ZoomSettingsScope")}} + - : DĂ©finit si les modifications de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet. +- {{WebExtAPIRef("tabs.ZoomSettings")}} + - : DĂ©finit les paramĂštres de zoom {{WebExtAPIRef("tabs.ZoomSettingsMode", "mode")}}, {{WebExtAPIRef("tabs.ZoomSettingsScope", "scope")}}, et le facteur de zoom par dĂ©faut. + +## PropriĂ©tĂ©s + +- {{WebExtAPIRef("tabs.TAB_ID_NONE")}} + - : Une valeur d'id spĂ©ciale donnĂ©e aux onglets qui ne sont pas des onglets de navigation (par exemple, les onglets dans les fenĂȘtres _devtools_). + +## Fonctions + +- {{WebExtAPIRef("tabs.captureTab()")}} + - : CrĂ©e un URI de donnĂ©es codant une image de la zone visible de l'onglet donnĂ©. +- {{WebExtAPIRef("tabs.captureVisibleTab()")}} + - : CrĂ©e un URI de donnĂ©es codant une image de la zone visible de l'onglet actuellement actif dans la fenĂȘtre donnĂ©e. +- {{WebExtAPIRef("tabs.connect()")}} + - : DĂ©finit une connexion pour Ă©changer des messages entre les scripts d'arriĂšre-plan de l'extension (ou d'autres scripts privilĂ©giĂ©s, tels que les scripts de [popups](/fr/docs/Mozilla/Add-ons/WebExtensions/user_interface/Popups) ou les scripts de page d'options) et les [scripts de contenu](/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts) s'exĂ©cutant dans l'onglet spĂ©cifiĂ©. +- {{WebExtAPIRef("tabs.create()")}} + - : CrĂ©e un nouvel onglet. +- {{WebExtAPIRef("tabs.detectLanguage()")}} + - : DĂ©tecte la langue principale du contenu dans un onglet. +- {{WebExtAPIRef("tabs.discard()")}} + - : Ăvince un ou plusieurs onglets. +- {{WebExtAPIRef("tabs.duplicate()")}} + - : Duplique un onglet. +- {{WebExtAPIRef("tabs.executeScript()")}} + - : Injecte du code JavaScript dans une page. +- {{WebExtAPIRef("tabs.get()")}} + - : Obtient des dĂ©tails sur l'onglet spĂ©cifiĂ©. +- {{WebExtAPIRef("tabs.getAllInWindow()")}} {{deprecated_inline}} + - : Obtient des dĂ©tails sur tous les onglets de la fenĂȘtre spĂ©cifiĂ©e. +- {{WebExtAPIRef("tabs.getCurrent()")}} + - : Obtient des informations sur l'onglet dans lequel ce script s'exĂ©cute, en tant qu'objet {{WebExtAPIRef("tabs.Tab")}}. +- {{WebExtAPIRef("tabs.getSelected()")}} {{deprecated_inline}} + - : Obtient l'onglet sĂ©lectionnĂ© dans la fenĂȘtre spĂ©cifiĂ©e. **Deprecated: utilisez plutĂŽt [`tabs.query({active: true})`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/tabs/query).** +- {{WebExtAPIRef("tabs.getZoom()")}} + - : Obtient le facteur de zoom actuel de l'onglet spĂ©cifiĂ©. +- {{WebExtAPIRef("tabs.getZoomSettings()")}} + - : Obtient les paramĂštres de zoom actuels pour l'onglet spĂ©cifiĂ©. +- {{WebExtAPIRef("tabs.goForward()")}} + - : Passez Ă la page suivante, si vous en avez une. +- {{WebExtAPIRef("tabs.goBack()")}} + - : Retour Ă la page prĂ©cĂ©dente, si elle est disponible. +- {{WebExtAPIRef("tabs.hide()")}} {{experimental_inline}} + - : Masque un ou plusieurs onglets. +- {{WebExtAPIRef("tabs.highlight()")}} + - : Met en Ă©vidence un ou plusieurs onglets. +- {{WebExtAPIRef("tabs.insertCSS()")}} + - : Injecte CSS dans une page. +- {{WebExtAPIRef("tabs.move()")}} + - : DĂ©place un ou plusieurs onglets vers une nouvelle position dans la mĂȘme fenĂȘtre ou vers une autre fenĂȘtre. +- {{WebExtApiRef("tabs.moveInSuccession()")}} + - : Modifie la relation de succession pour un groupe d'onglets. +- {{WebExtAPIRef("tabs.print()")}} + - : Imprime le contenu de l'onglet actif. +- {{WebExtAPIRef("tabs.printPreview()")}} + - : Ouvre l'aperçu avant impression pour l'onglet actif. +- {{WebExtAPIRef("tabs.query()")}} + - : Obtient tous les onglets ayant les propriĂ©tĂ©s spĂ©cifiĂ©es, ou tous les onglets si aucune propriĂ©tĂ© n'est spĂ©cifiĂ©e. +- {{WebExtAPIRef("tabs.reload()")}} + - : Recharge un onglet, en contournant Ă©ventuellement le cache web local. +- {{WebExtAPIRef("tabs.remove()")}} + - : Ferme un ou plusieurs onglets. +- {{WebExtAPIRef("tabs.removeCSS()")}} + - : Supprime d'une page CSS qui a Ă©tĂ© prĂ©cĂ©demment injectĂ©e en appelant {{WebExtAPIRef("tabs.insertCSS()")}}. +- {{WebExtAPIRef("tabs.saveAsPDF()")}} + - : Enregistre la page en cours au format PDF. +- {{WebExtAPIRef("tabs.sendMessage()")}} + - : Envoie un message unique au(x) script(s) de contenu dans l'onglet spĂ©cifiĂ©. +- {{WebExtAPIRef("tabs.sendRequest()")}} {{deprecated_inline}} + - : Envoie une requĂȘte unique au(x) script(s) de contenu dans l'onglet spĂ©cifiĂ©. **DĂ©prĂ©ciĂ©âŻ:** utilisez {{WebExtAPIRef("tabs.sendMessage()")}} Ă la place. +- {{WebExtAPIRef("tabs.setZoom()")}} + - : Effectue un zoom sur l'onglet spĂ©cifiĂ©. +- {{WebExtAPIRef("tabs.setZoomSettings()")}} + - : DĂ©finit les paramĂštres de zoom pour l'onglet spĂ©cifiĂ©. +- {{WebExtAPIRef("tabs.show()")}} {{experimental_inline}} + - : Affiche un ou plusieurs onglets qui ont Ă©tĂ© {{WebExtAPIRef("tabs.hide()", "masquĂ©s")}}. +- {{WebExtAPIRef("tabs.toggleReaderMode()")}} + - : Bascule en mode lecture pour l'onglet spĂ©cifiĂ©. +- {{WebExtAPIRef("tabs.update()")}} + - : Charge une nouvelle URL dans l'onglet, ou modifie d'autres propriĂ©tĂ©s de l'onglet. + +## ĂvĂšnements + +- {{WebExtAPIRef("tabs.onActivated")}} + - : Est Ă©mis lorsque l'onglet actif dans une fenĂȘtre change. Notez que l'URL de l'onglet peut ne pas ĂȘtre dĂ©finie au moment oĂč cet Ă©vĂšnement a Ă©tĂ© Ă©mis. +- {{WebExtAPIRef("tabs.onActiveChanged")}} {{deprecated_inline}} + - : Est Ă©mis lorsque l'onglet sĂ©lectionnĂ© dans une fenĂȘtre change. **DĂ©prĂ©ciĂ©âŻ:** utilisez {{WebExtAPIRef("tabs.onActivated")}} Ă la place. +- {{WebExtAPIRef("tabs.onAttached")}} + - : Est Ă©mis lorsqu'un onglet est attachĂ© Ă une fenĂȘtre, par exemple parce qu'il a Ă©tĂ© dĂ©placĂ© entre diffĂ©rentes fenĂȘtres. +- {{WebExtAPIRef("tabs.onCreated")}} + - : Est Ă©mis lorsqu'un onglet est crĂ©Ă©. Notez que l'URL de l'onglet peut ne pas ĂȘtre dĂ©finie au moment oĂč cet Ă©vĂšnement a Ă©tĂ© Ă©mis. +- {{WebExtAPIRef("tabs.onDetached")}} + - : Est Ă©mis lorsqu'un onglet est dĂ©tachĂ© d'une fenĂȘtre, par exemple parce qu'il a Ă©tĂ© dĂ©placĂ© entre diffĂ©rentes fenĂȘtres. +- {{WebExtAPIRef("tabs.onHighlightChanged")}} {{deprecated_inline}} + - : Est Ă©mis lorsque les onglets en surbrillance ou sĂ©lectionnĂ©s dans une fenĂȘtre changent. **DĂ©prĂ©ciĂ©âŻ:** utilisez {{WebExtAPIRef("tabs.onHighlighted")}} Ă la place. +- {{WebExtAPIRef("tabs.onHighlighted")}} + - : Est Ă©mis lorsque les onglets en surbrillance ou sĂ©lectionnĂ©s dans une fenĂȘtre changent. +- {{WebExtAPIRef("tabs.onMoved")}} + - : Est Ă©mis lorsqu'un onglet est dĂ©placĂ© dans une fenĂȘtre. +- {{WebExtAPIRef("tabs.onRemoved")}} + - : Est Ă©mis lorsqu'un onglet est fermĂ©. +- {{WebExtAPIRef("tabs.onReplaced")}} + + - : Est Ă©mis lorsqu'un onglet est remplacĂ© par un autre onglet en raison d'un + + <i lang="en">prerendering</i> + + . + +- {{WebExtAPIRef("tabs.onSelectionChanged")}} {{deprecated_inline}} + - : Est Ă©mis lorsque l'onglet sĂ©lectionnĂ© dans une fenĂȘtre change. **DĂ©prĂ©ciĂ©âŻ:** utilisez {{WebExtAPIRef("tabs.onActivated")}} Ă la place. +- {{WebExtAPIRef("tabs.onUpdated")}} + - : Est Ă©mis lorsqu'un onglet est mis Ă jour. +- {{WebExtAPIRef("tabs.onZoomChange")}} + - : Est Ă©mis lorsque le zoom dans un onglet est changĂ©. + +## CompatibilitĂ© des navigateurs + +{{Compat("webextensions.api.tabs")}} + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -219,5 +205,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs // 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/tabs/insertcss/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/insertcss/index.md index d51ca99171..9608711022 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/insertcss/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/insertcss/index.md @@ -14,67 +14,64 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/insertCSS --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Injecter du code CSS dans une page web.</p> +Injecter du code CSS dans une page web. -<p>Pour utiliser cette API vous devez avoir la permission "<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">host permission</a>" ou utiliser la permission "<a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#activeTab_permission">activeTab permission</a>".</p> +Pour utiliser cette API vous devez avoir la permission "[host permission](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions)" ou utiliser la permission "[activeTab permission](/fr/Add-ons/WebExtensions/manifest.json/permissions#activeTab_permission)". -<p>Vous ne pouvez injecter du CSS que dans des pages dont l'URL peut ĂȘtre exprimĂ©e en utilisant un <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">motif de correspondance</a>, ce qui signifie que son schĂ©ma doit ĂȘtre "http", "https", "file", "ftp". Cela signifie que vous ne pouvez pas injecter de CSS dans les pages intĂ©grĂ©es du navigateur, telles que about:debugging, about:addons, ou la page qui s'ouvre lorsque vous ouvrez un nouvel onglet vide.</p> +Vous ne pouvez injecter du CSS que dans des pages dont l'URL peut ĂȘtre exprimĂ©e en utilisant un [motif de correspondance](/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns), ce qui signifie que son schĂ©ma doit ĂȘtre "http", "https", "file", "ftp". Cela signifie que vous ne pouvez pas injecter de CSS dans les pages intĂ©grĂ©es du navigateur, telles que about:debugging, about:addons, ou la page qui s'ouvre lorsque vous ouvrez un nouvel onglet vide. -<div class="note"> -<p><strong>Note :</strong> Firefox rĂ©sout les URL dans les fichiers CSS injectĂ©s par rapport au fichier CSS lui-mĂȘme, plutĂŽt qu'Ă la page dans laquelle il est injectĂ©.</p> -</div> +> **Note :** Firefox rĂ©sout les URL dans les fichiers CSS injectĂ©s par rapport au fichier CSS lui-mĂȘme, plutĂŽt qu'Ă la page dans laquelle il est injectĂ©. -<p>Le CSS insĂ©rĂ© peut ĂȘtre retirĂ© Ă nouveau en appelant {{WebExtAPIRef("tabs.removeCSS()")}}.</p> +Le CSS insĂ©rĂ© peut ĂȘtre retirĂ© Ă nouveau en appelant {{WebExtAPIRef("tabs.removeCSS()")}}. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise</a></code> (sur Firefox seulement).</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise) (sur Firefox seulement). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var inserting = browser.tabs.insertCSS( +```js +var inserting = browser.tabs.insertCSS( tabId, // optional integer details // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>tabId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet dans lequel insĂ©rer le CSS. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours.</dd> - <dt><code>details</code></dt> - <dd><p>Un objet dĂ©crivant le CSS Ă insĂ©rer. Il contient les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>allFrames</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si <code>true</code>, le CSS sera injectĂ© dans toutes les images de la page en cours. Si c'est <code>false</code>, CSS est seulement injectĂ© dans le cadre supĂ©rieur. Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>code</code>{{optional_inline}}</dt> - <dd><code>string</code>. Code Ă injecter, sous la forme d'une chaĂźne de texte.</dd> - <dt><code>cssOrigin</code>{{optional_inline}}</dt> - <dd><code>string</code>. Cela peut prendre l'une des deux valeurs suivantes: "utilisateur", pour ajouter le CSS en tant que feuille de style utilisateur, ou "auteur" pour l'ajouter en tant que feuille de style auteur. SpĂ©cifier "utilisateur" vous permet d'empĂȘcher les sites Web de surcharger le CSS que vous insĂ©rez: voir <a href="/fr/docs/Web/CSS/Cascade#Cascading_order">la commande en cascade</a>. Si cette option est omise, le CSS est ajoutĂ© en tant que feuille de style auteur.</dd> - <dt><code>file</code>{{optional_inline}}</dt> - <dd><code>string</code>. Chemin d'accĂšs Ă un fichier contenant le code Ă injecter. Dans Firefox, les URL relatives sont rĂ©solues par rapport Ă l'URL de la page en cours. Dans Chrome, ces URL sont rĂ©solues par rapport Ă l'URL de base de l'extension. Pour travailler avec plusieurs navigateurs, vous pouvez spĂ©cifier le chemin comme une URL absolue, en commençant Ă la racine de l'extension, comme ceci : <code>"/path/to/stylesheet.css"</code>.</dd> - <dt><code>frameId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Le cadre oĂč le CSS doit ĂȘtre injectĂ©. La valeur par dĂ©faut est <code>0</code> (l'image de niveau supĂ©rieur).</dd> - <dt><code>matchAboutBlank</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si<code>true</code>, le code sera injectĂ© dans les cadres "about:blank" et "about:srcdoc" intĂ©grĂ©s si votre extension a accĂšs Ă leur document parent. Le code ne peut pas ĂȘtre insĂ©rĂ© au niveau supĂ©rieur about: frames. Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>runAt</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('extensionTypes.RunAt')}}. Le plus tĂŽt que le code sera injectĂ© dans l'onglet. Par dĂ©faut Ă "document_idle".</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise</a></code> qui sera remplie sans arguments lorsque tous les CSS ont Ă©tĂ© insĂ©rĂ©s. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Cet exemple s'insĂšre dans l'onglet CSS actif qui provient d'une chaĂźne.</p> - -<pre class="brush: js">var css = "body { border: 20px dotted pink; }"; - -browser.browserAction.onClicked.addListener(() => { +``` + +### ParamĂštres + +- `tabId` {{optional_inline}} + - : `integer`. L'ID de l'onglet dans lequel insĂ©rer le CSS. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours. +- `details` + + - : Un objet dĂ©crivant le CSS Ă insĂ©rer. Il contient les propriĂ©tĂ©s suivantes : + + - `allFrames`{{optional_inline}} + - : `boolean`. Si `true`, le CSS sera injectĂ© dans toutes les images de la page en cours. Si c'est `false`, CSS est seulement injectĂ© dans le cadre supĂ©rieur. Par dĂ©faut Ă `false`. + - `code`{{optional_inline}} + - : `string`. Code Ă injecter, sous la forme d'une chaĂźne de texte. + - `cssOrigin`{{optional_inline}} + - : `string`. Cela peut prendre l'une des deux valeurs suivantes: "utilisateur", pour ajouter le CSS en tant que feuille de style utilisateur, ou "auteur" pour l'ajouter en tant que feuille de style auteur. SpĂ©cifier "utilisateur" vous permet d'empĂȘcher les sites Web de surcharger le CSS que vous insĂ©rez: voir [la commande en cascade](/fr/docs/Web/CSS/Cascade#Cascading_order). Si cette option est omise, le CSS est ajoutĂ© en tant que feuille de style auteur. + - `file`{{optional_inline}} + - : `string`. Chemin d'accĂšs Ă un fichier contenant le code Ă injecter. Dans Firefox, les URL relatives sont rĂ©solues par rapport Ă l'URL de la page en cours. Dans Chrome, ces URL sont rĂ©solues par rapport Ă l'URL de base de l'extension. Pour travailler avec plusieurs navigateurs, vous pouvez spĂ©cifier le chemin comme une URL absolue, en commençant Ă la racine de l'extension, comme ceci : `"/path/to/stylesheet.css"`. + - `frameId`{{optional_inline}} + - : `integer`. Le cadre oĂč le CSS doit ĂȘtre injectĂ©. La valeur par dĂ©faut est `0` (l'image de niveau supĂ©rieur). + - `matchAboutBlank`{{optional_inline}} + - : `boolean`. Si`true`, le code sera injectĂ© dans les cadres "about:blank" et "about:srcdoc" intĂ©grĂ©s si votre extension a accĂšs Ă leur document parent. Le code ne peut pas ĂȘtre insĂ©rĂ© au niveau supĂ©rieur about: frames. Par dĂ©faut Ă `false`. + - `runAt`{{optional_inline}} + - : {{WebExtAPIRef('extensionTypes.RunAt')}}. Le plus tĂŽt que le code sera injectĂ© dans l'onglet. Par dĂ©faut Ă "document_idle". + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise) qui sera remplie sans arguments lorsque tous les CSS ont Ă©tĂ© insĂ©rĂ©s. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. + +## Exemples + +Cet exemple s'insĂšre dans l'onglet CSS actif qui provient d'une chaĂźne. + +```js +var css = "body { border: 20px dotted pink; }"; + +browser.browserAction.onClicked.addListener(() => { function onError(error) { console.log(`Error: ${error}`); @@ -82,11 +79,13 @@ browser.browserAction.onClicked.addListener(() => { var insertingCSS = browser.tabs.insertCSS({code: css}); insertingCSS.then(null, onError); -});</pre> +}); +``` -<p>Cet exemple insĂšre CSS qui est chargĂ© Ă partir d'un fichier empaquetĂ© avec l'extension. Le CSS est insĂ©rĂ© dans l'onglet dont l'identifiant est 2 :</p> +Cet exemple insĂšre CSS qui est chargĂ© Ă partir d'un fichier empaquetĂ© avec l'extension. Le CSS est insĂ©rĂ© dans l'onglet dont l'identifiant est 2 : -<pre class="brush: js">browser.browserAction.onClicked.addListener(() => { +```js +browser.browserAction.onClicked.addListener(() => { function onError(error) { console.log(`Error: ${error}`); @@ -94,23 +93,22 @@ browser.browserAction.onClicked.addListener(() => { var insertingCSS = browser.tabs.insertCSS(2, {file: "content-style.css"}); insertingCSS.then(null, onError); -});</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +}); +``` -<p>{{Compat("webextensions.api.tabs.insertCSS")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.insertCSS")}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -137,5 +135,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/tabs/move/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/move/index.md index 4e2d2605a9..5fc7d40283 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/move/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/move/index.md @@ -14,50 +14,51 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/move --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©place un ou plusieurs onglets vers une nouvelle position dans la mĂȘme fenĂȘtre ou vers une autre fenĂȘtre.</p> +DĂ©place un ou plusieurs onglets vers une nouvelle position dans la mĂȘme fenĂȘtre ou vers une autre fenĂȘtre. -<p>Vous pouvez uniquement dĂ©placer des onglets vers et Ă partir de fenĂȘtres dont {{WebExtAPIRef('windows.WindowType', 'WindowType')}} est <code>"normal"</code>.</p> +Vous pouvez uniquement dĂ©placer des onglets vers et Ă partir de fenĂȘtres dont {{WebExtAPIRef('windows.WindowType', 'WindowType')}} est `"normal"`. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 moving = browser.tabs.move( +```js +var moving = browser.tabs.move( tabIds, // integer or integer array moveProperties // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabIds</code></dt> - <dd><code><code>integer</code></code> ou <code><code>array</code></code> d'<code><code>integer</code></code>. ID du {{WebExtAPIRef('tabs.Tab', 'tab')}}Ă dĂ©placer, ou un tableau d'ID d'onglet.</dd> - <dt><code>moveProperties</code></dt> - <dd><p><code>object</code>. Un objet qui spĂ©cifie oĂč dĂ©placer le(s) onglet(s).</p> - <dl> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. 'ID de la fenĂȘtre dans laquelle vous souhaitez dĂ©placer les onglet(s). Si vous omettez cela, chaque onglet de <code>tabIds</code> sera dĂ©placĂ© vers l' <code>index</code> dans sa fenĂȘtre actuelle. Si vous incluez ceci, et <code>tabIds</code> contient plus d'un onglet, alors le premier onglet de <code>tabIds</code> sera dĂ©placĂ© vers l'<code>index</code>, et les autres onglets le suivront dans l'ordre donnĂ© dans <code>tabIds</code>.</dd> - <dt><code>index</code></dt> - <dd><p><code>integer</code>. La position de l'index pour dĂ©placer la tabulation Ă , en commençant Ă 0. Une valeur de -1 placera la tabulation Ă la fin de la fenĂȘtre.</p> - <p>Si vous passez une valeur infĂ©rieure Ă -1, la fonction renvoie une erreur.</p> - <p>Notez que vous ne pouvez pas dĂ©placer les onglets Ă©pinglĂ©s sur une position aprĂšs les onglets non Ă©pinglĂ©s d'une fenĂȘtre, ou dĂ©placer les onglets non Ă©pinglĂ©s Ă une position avant les onglets Ă©pinglĂ©s. Par exemple, si vous avez un ou plusieurs onglets Ă©pinglĂ©s dans la fenĂȘtre cible et si tabIds fait rĂ©fĂ©rence Ă un onglet non Ă©pinglĂ©, vous ne pouvez pas passer 0 ici. Si vous essayez de le faire, la fonction Ă©chouera silencieusement (elle ne produira pas d'erreur).</p> - </dd> - </dl> - </dd> -</dl> +- `tabIds` + - : `integer` ou `array` d'`integer`. ID du {{WebExtAPIRef('tabs.Tab', 'tab')}}Ă dĂ©placer, ou un tableau d'ID d'onglet. +- `moveProperties` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. Un objet qui spĂ©cifie oĂč dĂ©placer le(s) onglet(s). -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera satisfaite avec un objet <code>{{WebExtAPIRef('tabs.Tab')}}</code> ou un <code><code>tableau</code></code> d'objets <code><code>{{WebExtAPIRef('tabs.Tab')}}</code></code>, contenant des dĂ©tails sur les onglets dĂ©placĂ©s. Si aucun onglet n'a Ă©tĂ© dĂ©placĂ© (par exemple, parce que vous avez essayĂ© de dĂ©placer un onglet non Ă©pinglĂ© avant un onglet Ă©pinglĂ©), il s'agira d'un tableau vide. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> + - `windowId`{{optional_inline}} + - : `integer`. 'ID de la fenĂȘtre dans laquelle vous souhaitez dĂ©placer les onglet(s). Si vous omettez cela, chaque onglet de `tabIds` sera dĂ©placĂ© vers l' `index` dans sa fenĂȘtre actuelle. Si vous incluez ceci, et `tabIds` contient plus d'un onglet, alors le premier onglet de `tabIds` sera dĂ©placĂ© vers l'`index`, et les autres onglets le suivront dans l'ordre donnĂ© dans `tabIds`. + - `index` -<h2 id="Exemples">Exemples</h2> + - : `integer`. La position de l'index pour dĂ©placer la tabulation Ă , en commençant Ă 0. Une valeur de -1 placera la tabulation Ă la fin de la fenĂȘtre. -<p>DĂ©placer le premier onglet de la fenĂȘtre en cours vers la derniĂšre position de la fenĂȘtre en cours :</p> + Si vous passez une valeur infĂ©rieure Ă -1, la fonction renvoie une erreur. -<pre class="brush: js">function onMoved(tab) { + Notez que vous ne pouvez pas dĂ©placer les onglets Ă©pinglĂ©s sur une position aprĂšs les onglets non Ă©pinglĂ©s d'une fenĂȘtre, ou dĂ©placer les onglets non Ă©pinglĂ©s Ă une position avant les onglets Ă©pinglĂ©s. Par exemple, si vous avez un ou plusieurs onglets Ă©pinglĂ©s dans la fenĂȘtre cible et si tabIds fait rĂ©fĂ©rence Ă un onglet non Ă©pinglĂ©, vous ne pouvez pas passer 0 ici. Si vous essayez de le faire, la fonction Ă©chouera silencieusement (elle ne produira pas d'erreur). + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera satisfaite avec un objet `{{WebExtAPIRef('tabs.Tab')}}` ou un `tableau` d'objets `{{WebExtAPIRef('tabs.Tab')}}`, contenant des dĂ©tails sur les onglets dĂ©placĂ©s. Si aucun onglet n'a Ă©tĂ© dĂ©placĂ© (par exemple, parce que vous avez essayĂ© de dĂ©placer un onglet non Ă©pinglĂ© avant un onglet Ă©pinglĂ©), il s'agira d'un tableau vide. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. + +## Exemples + +DĂ©placer le premier onglet de la fenĂȘtre en cours vers la derniĂšre position de la fenĂȘtre en cours : + +```js +function onMoved(tab) { console.log(`Moved: ${tab}`); } @@ -76,11 +77,13 @@ function firstToLast(windowInfo) { browser.browserAction.onClicked.addListener(function() { var gettingCurrent = browser.windows.getCurrent({populate: true}); gettingCurrent.then(firstToLast, onError); -});</pre> +}); +``` -<p>DĂ©placer tous les onglets servis via HTTP ou HTTPS depuis * .mozilla.org jusqu'Ă la fin de leur fenĂȘtre :</p> +DĂ©placer tous les onglets servis via HTTP ou HTTPS depuis \* .mozilla.org jusqu'Ă la fin de leur fenĂȘtre : -<pre class="brush: js">function onMoved(tab) { +```js +function onMoved(tab) { console.log(`Moved: ${tab}`); } @@ -89,7 +92,7 @@ function onError(error) { } function moveMoz(tabs) { - var mozTabIds = tabs.map(tabInfo => tabInfo.id); + var mozTabIds = tabs.map(tabInfo => tabInfo.id); var moving = browser.tabs.move(mozTabIds, {index: -1}); moving.then(onMoved, onError); } @@ -97,11 +100,13 @@ function moveMoz(tabs) { browser.browserAction.onClicked.addListener(function() { var gettingMozTabs = browser.tabs.query({url:"*://*.mozilla.org/*"}); gettingMozTabs.then(moveMoz, onError); -});</pre> +}); +``` -<p>DĂ©placer tous les onglets servis via HTTP ou HTTPS de * .mozilla.org vers la fenĂȘtre qui hĂ©berge le premier onglet de ce type, en commençant Ă la position 0 :</p> +DĂ©placer tous les onglets servis via HTTP ou HTTPS de \* .mozilla.org vers la fenĂȘtre qui hĂ©berge le premier onglet de ce type, en commençant Ă la position 0 : -<pre class="brush: js">function onMoved(tab) { +```js +function onMoved(tab) { console.log(`Moved: ${tab}`); } @@ -110,7 +115,7 @@ function onError(error) { } function moveMoz(tabs) { - var mozTabIds = tabs.map(tabInfo => tabInfo.id); + var mozTabIds = tabs.map(tabInfo => tabInfo.id); var targetWindow = tabs[0].windowId; var moving = browser.tabs.move(mozTabIds, {windowId: targetWindow, index: 0}); moving.then(onMoved, onError); @@ -119,23 +124,22 @@ function moveMoz(tabs) { browser.browserAction.onClicked.addListener(function() { var gettingMozTabs = browser.tabs.query({url:"*://*.mozilla.org/*"}); gettingMozTabs.then(moveMoz, onError); -});</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +}); +``` -<p>{{Compat("webextensions.api.tabs.move")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur lâAPI <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.move")}} -<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 [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -162,5 +166,4 @@ browser.browserAction.onClicked.addListener(function() { // 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/tabs/moveinsuccession/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/moveinsuccession/index.md index 261cb96adf..f394f3ab94 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/moveinsuccession/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/moveinsuccession/index.md @@ -12,40 +12,39 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/moveInSuccession --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>Modifie la relation de succession pour un groupe d'onglets.</p> +Modifie la relation de succession pour un groupe d'onglets. -<p>Using the {{WebExtAPIRef('tabs')}} API, a tab can be assigned a <em>successor</em> tab in the same window. If tab B is the successor of tab A, and tab A is closed while it is the active tab, tab B will be activated next. If tab A doesn't have a successor, then the browser is free to determine which tab to activate next. If tab B is the successor of tab A, then tab A is called a <em>predecessor</em> of tab B. A tab can have at most one successor, but it can have any number of predecessors. A tab cannot take itself or a tab in a different window as a successor.</p> +Using the {{WebExtAPIRef('tabs')}} API, a tab can be assigned a _successor_ tab in the same window. If tab B is the successor of tab A, and tab A is closed while it is the active tab, tab B will be activated next. If tab A doesn't have a successor, then the browser is free to determine which tab to activate next. If tab B is the successor of tab A, then tab A is called a _predecessor_ of tab B. A tab can have at most one successor, but it can have any number of predecessors. A tab cannot take itself or a tab in a different window as a successor. -<p>All tabs start out with no successor; tabs only get a successor if assigned one by a WebExtension. However, the browser must not orphan a tab in a succession relationship with other tabs, if possible: if tab B is the successor of tab A, and tab C is the successor of tab B, and B is closed (or moved to another window), then tab A will take tab C as its successor. Preventing C from being orphaned in this way is called <em>moving a tab</em> (B) <em>from its line of succession</em>.</p> +All tabs start out with no successor; tabs only get a successor if assigned one by a WebExtension. However, the browser must not orphan a tab in a succession relationship with other tabs, if possible: if tab B is the successor of tab A, and tab C is the successor of tab B, and B is closed (or moved to another window), then tab A will take tab C as its successor. Preventing C from being orphaned in this way is called _moving a tab_ (B) _from its line of succession_. -<p><code>tabs.moveInSuccession()</code> takes an array of tab IDs, and moves all of those tabs from their lines of succession. It then makes each tab the successor of the previous tab in the array, forming a chain. It can optionally set the successor of the last tab in the chain to an anchor tab, which is <em>not</em> moved from its line of succession. Additional options can control whether the tab chain is "prepended" or "appended" to the anchor tab, and whether the operation acts like a linked-list insert.</p> +`tabs.moveInSuccession()` takes an array of tab IDs, and moves all of those tabs from their lines of succession. It then makes each tab the successor of the previous tab in the array, forming a chain. It can optionally set the successor of the last tab in the chain to an anchor tab, which is _not_ moved from its line of succession. Additional options can control whether the tab chain is "prepended" or "appended" to the anchor tab, and whether the operation acts like a linked-list insert. -<p>While the successor tab can be assigned with {{WebExtAPIRef('tabs.update()')}}, it is often desirable to use <code>tabs.moveInSuccession()</code> to change successors, even if only a single tab is having its successor assigned. The difference is that <code>browser.tabs.moveInSuccession([a], b)</code> moves tab <code>a</code> from its line of succession, so any predecessors of <code>a</code> will adopt <code>a</code>'s previous successor; whereas if <code>browser.tabs.update(a, {successorTabId: b})</code> is used instead, tab <code>a</code> may continue to be the successor of other tabs, which could be unexpected. Another advantage of <code>tabs.moveInSuccession()</code> is that all of the succession changes happen atomically, without having to worry about races between calls to {{WebExtAPIRef('tabs.update()')}} and {{WebExtAPIRef('tabs.get()')}} and other operations like the user closing a tab.</p> +While the successor tab can be assigned with {{WebExtAPIRef('tabs.update()')}}, it is often desirable to use `tabs.moveInSuccession()` to change successors, even if only a single tab is having its successor assigned. The difference is that `browser.tabs.moveInSuccession([a], b)` moves tab `a` from its line of succession, so any predecessors of `a` will adopt `a`'s previous successor; whereas if `browser.tabs.update(a, {successorTabId: b})` is used instead, tab `a` may continue to be the successor of other tabs, which could be unexpected. Another advantage of `tabs.moveInSuccession()` is that all of the succession changes happen atomically, without having to worry about races between calls to {{WebExtAPIRef('tabs.update()')}} and {{WebExtAPIRef('tabs.get()')}} and other operations like the user closing a tab. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.moveInSuccession([1, 3, 5, 7, 2, 9], 4, {insert:true})</pre> +```js +browser.tabs.moveInSuccession([1, 3, 5, 7, 2, 9], 4, {insert:true}) +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabIds</code></dt> - <dd><code>array</code> of <code>integer</code>. Un tableau d'<code>ID</code>s. L'ordre des Ă©lĂ©ments dans le tableau dĂ©finit la relation des onglets. Tout <code>ID</code> d'onglet invalide, ou l'<code>ID</code> d'onglet correspondant Ă des onglets qui ne sont pas dans la mĂȘme fenĂȘtre que <code>tabId</code> (ou le premier onglet du tableau, si <code>tabId</code> est omis), sera ignorĂ© - ils conserveront leurs successeurs et prĂ©dĂ©cesseurs actuels.</dd> - <dt><code>tabId</code> {{optional_inline}}</dt> - <dd><code>integer.</code> L'<code>ID</code> de l'onglet qui succĂ©dera au dernier onglet du tableau <code>tabIds</code>. Si cet <code>ID</code> est invalide ou {{WebExtAPIRef('tabs.TAB_ID_NONE')}}, le dernier onglet n'aura pas de successeur. Par dĂ©faut {{WebExtAPIRef('tabs.TAB_ID_NONE')}}.</dd> - <dt><code>options</code> {{optional_inline}}</dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>append</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. DĂ©termine s'il faut dĂ©placer les onglets dans les <code>tabIds</code> avant ou aprĂšs <code>tabId </code>dans la succession. Si <code>false</code>, les onglets sont dĂ©placĂ©s avant <code>tabId</code>, si <code>true</code>, les onglets sont dĂ©placĂ©s aprĂšs <code>tabId</code>. Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>insert</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. DĂ©termine s'il faut lier les prĂ©dĂ©cesseurs ou successeurs actuels (selon <code>options.append</code>) de <code>tabId</code>Ă l'autre cĂŽtĂ© de la chaĂźne aprĂšs son ajout ou son ajout. Si true, l'un des Ă©vĂ©nements suivants se produit : si <code>options.append</code> est <code>false</code>, le premier onglet du tableau est dĂ©fini comme successeur de tout prĂ©dĂ©cesseur actuel de <code>tabId</code>; Si <code>options.append</code> est <code>true</code>, le successeur actuel de tabId est dĂ©fini comme le successeur du dernier onglet du tableau. La valeur par dĂ©faut est <code>false</code>.</dd> - </dl> - </dd> -</dl> +- `tabIds` + - : `array` of `integer`. Un tableau d'`ID`s. L'ordre des Ă©lĂ©ments dans le tableau dĂ©finit la relation des onglets. Tout `ID` d'onglet invalide, ou l'`ID` d'onglet correspondant Ă des onglets qui ne sont pas dans la mĂȘme fenĂȘtre que `tabId` (ou le premier onglet du tableau, si `tabId` est omis), sera ignorĂ© - ils conserveront leurs successeurs et prĂ©dĂ©cesseurs actuels. +- `tabId` {{optional_inline}} + - : `integer.` L'`ID` de l'onglet qui succĂ©dera au dernier onglet du tableau `tabIds`. Si cet `ID` est invalide ou {{WebExtAPIRef('tabs.TAB_ID_NONE')}}, le dernier onglet n'aura pas de successeur. Par dĂ©faut {{WebExtAPIRef('tabs.TAB_ID_NONE')}}. +- `options` {{optional_inline}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : `object`. -<p>{{Compat("webextensions.api.tabs.moveInSuccession", 10)}}</p> + - `append` {{optional_inline}} + - : `boolean`. DĂ©termine s'il faut dĂ©placer les onglets dans les `tabIds` avant ou aprĂšs `tabId `dans la succession. Si `false`, les onglets sont dĂ©placĂ©s avant `tabId`, si `true`, les onglets sont dĂ©placĂ©s aprĂšs `tabId`. Par dĂ©faut Ă `false`. + - `insert` {{optional_inline}} + - : `boolean`. DĂ©termine s'il faut lier les prĂ©dĂ©cesseurs ou successeurs actuels (selon `options.append`) de `tabId`Ă l'autre cĂŽtĂ© de la chaĂźne aprĂšs son ajout ou son ajout. Si true, l'un des Ă©vĂ©nements suivants se produit : si `options.append` est `false`, le premier onglet du tableau est dĂ©fini comme successeur de tout prĂ©dĂ©cesseur actuel de `tabId`; Si `options.append` est `true`, le successeur actuel de tabId est dĂ©fini comme le successeur du dernier onglet du tableau. La valeur par dĂ©faut est `false`. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.tabs.moveInSuccession", 10)}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md index 2c900b4551..7b71bd1a43 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md @@ -13,38 +13,34 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfo --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Cet objet contient un boolĂ©en indiquant si l'onglet est muet et la raison du dernier changement d'Ă©tat.</p> +Cet objet contient un boolĂ©en indiquant si l'onglet est muet et la raison du dernier changement d'Ă©tat. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>extensionId</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'ID de l'extension qui a modifiĂ© en dernier l'Ă©tat muet. Non dĂ©fini si une extension n'a pas Ă©tĂ© la raison pour laquelle l'Ă©tat muet a Ă©tĂ© modifiĂ© pour la derniĂšre fois.</dd> - <dt><code>muted</code></dt> - <dd><code>boolean</code>. Si l'onglet est actuellement coupĂ©. Ăquivalent Ă l'affichage de l'indicateur audio coupĂ©.</dd> - <dt><code>reason</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('tabs.MutedInfoReason')}}. La raison pour laquelle l'onglet a Ă©tĂ© dĂ©sactivĂ© ou dĂ©sactivĂ©. Non dĂ©fini si l'Ă©tat muet de l'onglet n'a jamais Ă©tĂ© modifiĂ©.</dd> -</dl> +- `extensionId`{{optional_inline}} + - : `string`. L'ID de l'extension qui a modifiĂ© en dernier l'Ă©tat muet. Non dĂ©fini si une extension n'a pas Ă©tĂ© la raison pour laquelle l'Ă©tat muet a Ă©tĂ© modifiĂ© pour la derniĂšre fois. +- `muted` + - : `boolean`. Si l'onglet est actuellement coupĂ©. Ăquivalent Ă l'affichage de l'indicateur audio coupĂ©. +- `reason`{{optional_inline}} + - : {{WebExtAPIRef('tabs.MutedInfoReason')}}. La raison pour laquelle l'onglet a Ă©tĂ© dĂ©sactivĂ© ou dĂ©sactivĂ©. Non dĂ©fini si l'Ă©tat muet de l'onglet n'a jamais Ă©tĂ© modifiĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.MutedInfo")}}</p> +{{Compat("webextensions.api.tabs.MutedInfo")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -71,5 +67,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfo // 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/tabs/mutedinforeason/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.md index 1d1e71bcdb..c840ba3263 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.md @@ -13,38 +13,34 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfoReason --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>SpĂ©cifie la raison pour laquelle un onglet a Ă©tĂ© dĂ©sactivĂ© ou dĂ©sactivĂ©.</p> +SpĂ©cifie la raison pour laquelle un onglet a Ă©tĂ© dĂ©sactivĂ© ou dĂ©sactivĂ©. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<dl> - <dt>"capture"</dt> - <dd>La capture d'onglets a commencĂ©, forçant un changement d'Ă©tat muet.</dd> - <dt>"extension"</dt> - <dd>Une extension dĂ©finit l'Ă©tat muet. Si c'est la raison, <code>extensionId</code> dans {{WebExtAPIRef("tabs.mutedInfo")}} contiendra l'ID de l'extension responsable.</dd> - <dt>"user"</dt> - <dd>L'utilisateur dĂ©finit l'Ă©tat muet.</dd> -</dl> +- "capture" + - : La capture d'onglets a commencĂ©, forçant un changement d'Ă©tat muet. +- "extension" + - : Une extension dĂ©finit l'Ă©tat muet. Si c'est la raison, `extensionId` dans {{WebExtAPIRef("tabs.mutedInfo")}} contiendra l'ID de l'extension responsable. +- "user" + - : L'utilisateur dĂ©finit l'Ă©tat muet. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.MutedInfoReason")}}</p> +{{Compat("webextensions.api.tabs.MutedInfoReason")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -71,5 +67,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfoReason // 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/tabs/onactivated/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivated/index.md index 8032a515ae..48974a44ef 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivated/index.md @@ -13,81 +13,73 @@ tags: - tavs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onActivated --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Se dĂ©clenche lorsque l'onglet actif dans une fenĂȘtre change. Notez que l'URL de l'onglet peut ne pas ĂȘtre dĂ©finie au moment oĂč cet Ă©vĂ©nement s'est dĂ©clenchĂ©, mais vous pouvez Ă©couter les Ă©vĂ©nements {{WebExtAPIRef("tabs.onUpdated")}} pour ĂȘtre averti lorsqu'une URL est dĂ©finie.</p> +Se dĂ©clenche lorsque l'onglet actif dans une fenĂȘtre change. Notez que l'URL de l'onglet peut ne pas ĂȘtre dĂ©finie au moment oĂč cet Ă©vĂ©nement s'est dĂ©clenchĂ©, mais vous pouvez Ă©couter les Ă©vĂ©nements {{WebExtAPIRef("tabs.onUpdated")}} pour ĂȘtre averti lorsqu'une URL est dĂ©finie. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onActivated.addListener(listener) +```js +browser.tabs.onActivated.addListener(listener) browser.tabs.onActivated.removeListener(listener) browser.tabs.onActivated.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement</dd> - <dt><code>removeListener(listener)</code></dt> - <dd> ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement +- `removeListener(listener)` + - :  ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>activeInfo</code></dt> - <dd><a href="#activeInfo"><code>object</code></a>. ID de l'onglet qui a Ă©tĂ© activĂ©, et ID de sa fenĂȘtre.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + - `activeInfo` + - : [`object`](#activeInfo). ID de l'onglet qui a Ă©tĂ© activĂ©, et ID de sa fenĂȘtre. -<h3 id="activeInfo">activeInfo</h3> +## Objets supplĂ©mentaires -<dl> - <dt><code>previousTabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet activĂ© prĂ©cĂ©dent, si cet onglet est encore ouvert.</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet qui est devenu actif.</dd> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. L'ID de la fenĂȘtre de l'onglet.</dd> -</dl> +### activeInfo -<h2 id="Exemples">Exemples</h2> +- `previousTabId` + - : `integer`. L'ID de l'onglet activĂ© prĂ©cĂ©dent, si cet onglet est encore ouvert. +- `tabId` + - : `integer`. L'ID de l'onglet qui est devenu actif. +- `windowId` + - : `integer`. L'ID de la fenĂȘtre de l'onglet. -<p>Ăcouter et enregistrer les Ă©vĂ©nements d'activation des onglets :</p> +## Exemples -<pre class="brush: js">function handleActivated(activeInfo) { +Ăcouter et enregistrer les Ă©vĂ©nements d'activation des onglets : + +```js +function handleActivated(activeInfo) { console.log("Tab " + activeInfo.tabId + " was activated"); } -browser.tabs.onActivated.addListener(handleActivated);</pre> - -<p>{{WebExtExamples}}</p> +browser.tabs.onActivated.addListener(handleActivated); +``` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{WebExtExamples}} -<p>{{Compat("webextensions.api.tabs.onActivated")}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.tabs.onActivated")}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) dans le code de Chromium code. -<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 @@ -114,5 +106,4 @@ browser.tabs.onActivated.addListener(handleActivated);</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/tabs/onactivechanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.md index 1e64ef3cfa..219be18946 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.md @@ -14,80 +14,65 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onActiveChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div class="warning"> -<p><strong>Attention :</strong> Cet Ă©vĂ©nement est obsolĂšte. Utilisez {{WebExtAPIRef("tabs.onActivated")}} Ă la place.</p> -</div> +> **Attention :** Cet Ă©vĂ©nement est obsolĂšte. Utilisez {{WebExtAPIRef("tabs.onActivated")}} Ă la place. -<p>Se dĂ©clenche lorsque l'onglet sĂ©lectionnĂ© dans une fenĂȘtre change. Notez que l'URL de l'onglet peut ne pas ĂȘtre dĂ©finie au moment oĂč cet Ă©vĂ©nement a Ă©tĂ© dĂ©clenchĂ©, mais vous pouvez Ă©couter les Ă©vĂ©nements {{WebExtAPIRef('tabs.onUpdated')}} pour ĂȘtre averti lorsqu'une URL est dĂ©finie.</p> +Se dĂ©clenche lorsque l'onglet sĂ©lectionnĂ© dans une fenĂȘtre change. Notez que l'URL de l'onglet peut ne pas ĂȘtre dĂ©finie au moment oĂč cet Ă©vĂ©nement a Ă©tĂ© dĂ©clenchĂ©, mais vous pouvez Ă©couter les Ă©vĂ©nements {{WebExtAPIRef('tabs.onUpdated')}} pour ĂȘtre averti lorsqu'une URL est dĂ©finie. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onActiveChanged.addListener(listener) +```js +browser.tabs.onActiveChanged.addListener(listener) browser.tabs.onActiveChanged.removeListener(listener) browser.tabs.onActiveChanged.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement..</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie<code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie`true` s'il Ă©coute, sinon `false`. -<dl> -</dl> +<!----> -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet qui est devenu actif.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>selectInfo</code></dt> - <dd><a href="#selectInfo"><code>object</code></a>.</dd> - </dl> - </dd> -</dl> + - `tabId` + - : `integer`. L'ID de l'onglet qui est devenu actif. -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + <!----> -<h3 id="selectInfo">selectInfo</h3> + - `selectInfo` + - : [`object`](#selectInfo). -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. L'ID de la fenĂȘtre contenant l'onglet sĂ©lectionnĂ©.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### selectInfo -<p>{{Compat("webextensions.api.tabs.onActiveChanged")}}</p> +- `windowId` + - : `integer`. L'ID de la fenĂȘtre contenant l'onglet sĂ©lectionnĂ©. -<p> - </p><div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur - <p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.onActiveChanged")}} - <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> -<p></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -114,5 +99,4 @@ browser.tabs.onActiveChanged.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/tabs/onattached/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onattached/index.md index 6e28fc017e..2d1c2570cf 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onattached/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onattached/index.md @@ -13,87 +13,79 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onAttached --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'un onglet est attachĂ© Ă une fenĂȘtre, par exemple parce qu'il a Ă©tĂ© dĂ©placĂ© entre les fenĂȘtres.</p> +LancĂ© lorsqu'un onglet est attachĂ© Ă une fenĂȘtre, par exemple parce qu'il a Ă©tĂ© dĂ©placĂ© entre les fenĂȘtres. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onAttached.addListener(listener) +```js +browser.tabs.onAttached.addListener(listener) browser.tabs.onAttached.removeListener(listener) browser.tabs.onAttached.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>CVĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : CVĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet qui a Ă©tĂ© attachĂ© Ă une nouvelle fenĂȘtre..</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>attachInfo</code></dt> - <dd><a href="#attachInfo"><code>object</code></a>. ID de la nouvelle fenĂȘtre, et index de l'onglet Ă l'intĂ©rieur.</dd> - </dl> - </dd> -</dl> + - `tabId` + - : `integer`. ID de l'onglet qui a Ă©tĂ© attachĂ© Ă une nouvelle fenĂȘtre.. -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + <!----> -<h3 id="attachInfo">attachInfo</h3> + - `attachInfo` + - : [`object`](#attachInfo). ID de la nouvelle fenĂȘtre, et index de l'onglet Ă l'intĂ©rieur. -<dl> - <dt><code>newWindowId</code></dt> - <dd><code>integer</code>. ID de la nouvelle fenĂȘtre.</dd> - <dt><code>newPosition</code></dt> - <dd><code>integer</code>. Position de l'index que l'onglet a dans la nouvelle fenĂȘtre.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="Exemples">Exemples</h2> +### attachInfo -<p>Ăcoutez les Ă©vĂ©nements attachĂ©s et consignez les informations :</p> +- `newWindowId` + - : `integer`. ID de la nouvelle fenĂȘtre. +- `newPosition` + - : `integer`. Position de l'index que l'onglet a dans la nouvelle fenĂȘtre. -<pre class="brush: js">function handleAttached(tabId, attachInfo) { +## Exemples + +Ăcoutez les Ă©vĂ©nements attachĂ©s et consignez les informations : + +```js +function handleAttached(tabId, attachInfo) { console.log("Tab: " + tabId + " attached"); console.log("New window: " + attachInfo.newWindowId); console.log("New index: " + attachInfo.newPosition); } -browser.tabs.onAttached.addListener(handleAttached);</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +browser.tabs.onAttached.addListener(handleAttached); +``` -<p>{{Compat("webextensions.api.tabs.onAttached")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.onAttached")}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -120,5 +112,4 @@ browser.tabs.onAttached.addListener(handleAttached);</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/tabs/oncreated/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/oncreated/index.md index 41488ce2c1..c88a17ec75 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/oncreated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/oncreated/index.md @@ -13,71 +13,65 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onCreated --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'un onglet est crĂ©Ă©.</p> +LancĂ© lorsqu'un onglet est crĂ©Ă©. -<p>Notez que l'URL de l'onglet peut ne pas avoir sa valeur finale au moment oĂč cet Ă©vĂ©nement a Ă©tĂ© dĂ©clenchĂ©. En particulier, Firefox ouvre un nouvel onglet avec l'URL "about:blank" avant de charger la nouvelle page. Vous pouvez Ă©couter les Ă©vĂ©nements {{WebExtAPIRef("tabs.onUpdated")}} pour ĂȘtre averti lorsqu'une URL est dĂ©finie.</p> +Notez que l'URL de l'onglet peut ne pas avoir sa valeur finale au moment oĂč cet Ă©vĂ©nement a Ă©tĂ© dĂ©clenchĂ©. En particulier, Firefox ouvre un nouvel onglet avec l'URL "about:blank" avant de charger la nouvelle page. Vous pouvez Ă©couter les Ă©vĂ©nements {{WebExtAPIRef("tabs.onUpdated")}} pour ĂȘtre averti lorsqu'une URL est dĂ©finie. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onCreated.addListener(callback) +```js +browser.tabs.onCreated.addListener(callback) browser.tabs.onCreated.removeListener(listener) browser.tabs.onCreated.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si le <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si le `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>tab</code></dt> - <dd>{{WebExtAPIRef('tabs.Tab')}}. DĂ©tails de l'onglet qui a Ă©tĂ© crĂ©Ă©.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="Examples">Examples</h2> + - `tab` + - : {{WebExtAPIRef('tabs.Tab')}}. DĂ©tails de l'onglet qui a Ă©tĂ© crĂ©Ă©. -<p>Consignez les ID des nouveaux onglets crĂ©Ă©s :</p> +## Examples -<pre class="brush: js">function handleCreated(tab) { +Consignez les ID des nouveaux onglets crĂ©Ă©s : + +```js +function handleCreated(tab) { console.log(tab.id); } -browser.tabs.onCreated.addListener(handleCreated);</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +browser.tabs.onCreated.addListener(handleCreated); +``` -<p>{{Compat("webextensions.api.tabs.onCreated")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.onCreated")}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -104,5 +98,4 @@ browser.tabs.onCreated.addListener(handleCreated);</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/tabs/ondetached/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/ondetached/index.md index c6b5e83254..618ddcd79a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/ondetached/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/ondetached/index.md @@ -13,87 +13,79 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onDetached --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'un onglet est dĂ©tachĂ© d'une fenĂȘtre, par exemple parce qu'il est dĂ©placĂ© entre des fenĂȘtres.</p> +LancĂ© lorsqu'un onglet est dĂ©tachĂ© d'une fenĂȘtre, par exemple parce qu'il est dĂ©placĂ© entre des fenĂȘtres. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onDetached.addListener(listener) +```js +browser.tabs.onDetached.addListener(listener) browser.tabs.onDetached.removeListener(listener) browser.tabs.onDetached.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>l'Ă©couteur</code> est enregistrĂ© pour cet Ă©vĂ©nemen. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `l'Ă©couteur` est enregistrĂ© pour cet Ă©vĂ©nemen. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet qui a Ă©tĂ© dĂ©tachĂ©.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>detachInfo</code></dt> - <dd><a href="#detachInfo"><code>object</code></a>. ID de la fenĂȘtre prĂ©cĂ©dente et index de l'onglet Ă l'intĂ©rieur.</dd> - </dl> - </dd> -</dl> + - `tabId` + - : `integer`. ID de l'onglet qui a Ă©tĂ© dĂ©tachĂ©. -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + <!----> -<h3 id="detachInfo">detachInfo</h3> + - `detachInfo` + - : [`object`](#detachInfo). ID de la fenĂȘtre prĂ©cĂ©dente et index de l'onglet Ă l'intĂ©rieur. -<dl> - <dt><code>oldWindowId</code></dt> - <dd><code>integer</code>. ID de la fenĂȘtre prĂ©cĂ©dente</dd> - <dt><code>oldPosition</code></dt> - <dd><code>integer</code>. Position de l'index que l'onglet avait dans l'ancienne fenĂȘtre.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="Exemples">Exemples</h2> +### detachInfo -<p>Ecoutez les Ă©vĂ©nements de dĂ©tachement et consignez les informations :</p> +- `oldWindowId` + - : `integer`. ID de la fenĂȘtre prĂ©cĂ©dente +- `oldPosition` + - : `integer`. Position de l'index que l'onglet avait dans l'ancienne fenĂȘtre. -<pre class="brush: js">function handleDetached(tabId, detachInfo) { +## Exemples + +Ecoutez les Ă©vĂ©nements de dĂ©tachement et consignez les informations : + +```js +function handleDetached(tabId, detachInfo) { console.log("Tab: " + tabId + " moved"); console.log("Old window: " + detachInfo.oldWindowId); console.log("Old index: " + detachInfo.oldPosition); } -browser.tabs.onDetached.addListener(handleDetached);</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +browser.tabs.onDetached.addListener(handleDetached); +``` -<p>{{Compat("webextensions.api.tabs.onDetached")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.onDetached")}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -120,5 +112,4 @@ browser.tabs.onDetached.addListener(handleDetached);</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/tabs/onhighlightchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md index 5ada516c51..eb662c3e50 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md @@ -14,73 +14,60 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onHighlightChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div class="warning"> - <p><strong>Attention :</strong> Cet Ă©vĂ©nement est obsolĂšte. Utilisez {{WebExtAPIRef("tabs.onHighlighted")}} Ă la place.</p></div> +> **Attention :** Cet Ă©vĂ©nement est obsolĂšte. Utilisez {{WebExtAPIRef("tabs.onHighlighted")}} Ă la place. -<p>LancĂ© lorsque les onglets en surbrillance ou sĂ©lectionnĂ©s dans une fenĂȘtre changent.</p> +LancĂ© lorsque les onglets en surbrillance ou sĂ©lectionnĂ©s dans une fenĂȘtre changent. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onHighlightChanged.addListener(listener) +```js +browser.tabs.onHighlightChanged.addListener(listener) browser.tabs.onHighlightChanged.removeListener(listener) browser.tabs.onHighlightChanged.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code>s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true`s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>selectInfo</code></dt> - <dd><a href="#selectInfo"><code>object</code></a>.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + - `selectInfo` + - : [`object`](#selectInfo). -<h3 id="selectInfo">selectInfo</h3> +## Objets supplĂ©mentaires -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. La fenĂȘtre dont les onglets ont changĂ©.</dd> - <dt><code>tabIds</code></dt> - <dd><code>array</code> d'<code><code>integer</code></code>. Tous les onglets en surbrillance dans la fenĂȘtre.</dd> -</dl> +### selectInfo -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- `windowId` + - : `integer`. La fenĂȘtre dont les onglets ont changĂ©. +- `tabIds` + - : `array` d'`integer`. Tous les onglets en surbrillance dans la fenĂȘtre. -<p>{{Compat("webextensions.api.tabs.onHighlightChanged")}}</p> +## CompatibilitĂ© du navigateur -<p> - </p><div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.tabs.onHighlightChanged")}} - <p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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>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> -<p></p> - -<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 @@ -107,5 +94,4 @@ browser.tabs.onHighlightChanged.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/tabs/onhighlighted/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.md index 58a21f1e5d..09dc183817 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.md @@ -13,80 +13,72 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onHighlighted --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque l'ensemble des onglets en surbrillance dans une fenĂȘtre change</p> +LancĂ© lorsque l'ensemble des onglets en surbrillance dans une fenĂȘtre change -<p>Notez qu'avant la version 63, Firefox n'avait pas le concept de mettre en Ă©vidence plusieurs onglets, donc cet Ă©vĂ©nement n'Ă©tait qu'un alias pour {{WebExtAPIRef("tabs.onActivated")}}.</p> +Notez qu'avant la version 63, Firefox n'avait pas le concept de mettre en Ă©vidence plusieurs onglets, donc cet Ă©vĂ©nement n'Ă©tait qu'un alias pour {{WebExtAPIRef("tabs.onActivated")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onHighlighted.addListener(listener) +```js +browser.tabs.onHighlighted.addListener(listener) browser.tabs.onHighlighted.removeListener(listener) browser.tabs.onHighlighted.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> de l'Ă©couteur est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` de l'Ă©couteur est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>highlightInfo</code></dt> - <dd><a href="#highlightInfo"><code>object</code></a>. ID(s) des onglets en surbrillance, et ID de leur fenĂȘtre.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + - `highlightInfo` + - : [`object`](#highlightInfo). ID(s) des onglets en surbrillance, et ID de leur fenĂȘtre. -<h3 id="highlightInfo">highlightInfo</h3> +## Objets supplĂ©mentaires -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. ID de la fenĂȘtre dont les onglets ont changĂ©.</dd> - <dt><code>tabIds</code></dt> - <dd><code>array</code> d'<code><code>integer</code></code>. Identifiants des onglets en surbrillance dans la fenĂȘtre</dd> -</dl> +### highlightInfo -<h2 id="Exemples">Exemples</h2> +- `windowId` + - : `integer`. ID de la fenĂȘtre dont les onglets ont changĂ©. +- `tabIds` + - : `array` d'`integer`. Identifiants des onglets en surbrillance dans la fenĂȘtre -<p>Ecoutez les Ă©vĂ©nements en surbrillance et consignez les ID des onglets mis en surbrillance</p> +## Exemples -<pre class="brush: js">function handleHighlighted(highlightInfo) { +Ecoutez les Ă©vĂ©nements en surbrillance et consignez les ID des onglets mis en surbrillance + +```js +function handleHighlighted(highlightInfo) { console.log("Highlighted tabs: " + highlightInfo.tabIds); } -browser.tabs.onHighlighted.addListener(handleHighlighted);</pre> - -<p>{{WebExtExamples}}</p> +browser.tabs.onHighlighted.addListener(handleHighlighted); +``` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{WebExtExamples}} -<p>{{Compat("webextensions.api.tabs.onHighlighted")}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.tabs.onHighlighted")}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) dans le code de Chromium code. -<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 +105,4 @@ browser.tabs.onHighlighted.addListener(handleHighlighted);</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/tabs/onmoved/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onmoved/index.md index a9ab08a87f..7ab02282c6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onmoved/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onmoved/index.md @@ -13,94 +13,83 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onMoved --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'un onglet est dĂ©placĂ© dans une fenĂȘtre</p> +LancĂ© lorsqu'un onglet est dĂ©placĂ© dans une fenĂȘtre -<p>Un seul Ă©vĂ©nement de dĂ©placement est dĂ©clenchĂ©, reprĂ©sentant l'onglet que l'utilisateur a dĂ©placĂ© directement. Les Ă©vĂ©nements de dĂ©placement ne sont pas dĂ©clenchĂ©s pour les autres onglets qui doivent se dĂ©placer en rĂ©ponse. Cet Ă©vĂ©nement n'est pas dĂ©clenchĂ© lorsqu'un onglet est dĂ©placĂ© entre des fenĂȘtres. Pour cela, voir {{WebExtAPIRef('tabs.onDetached')}}.</p> +Un seul Ă©vĂ©nement de dĂ©placement est dĂ©clenchĂ©, reprĂ©sentant l'onglet que l'utilisateur a dĂ©placĂ© directement. Les Ă©vĂ©nements de dĂ©placement ne sont pas dĂ©clenchĂ©s pour les autres onglets qui doivent se dĂ©placer en rĂ©ponse. Cet Ă©vĂ©nement n'est pas dĂ©clenchĂ© lorsqu'un onglet est dĂ©placĂ© entre des fenĂȘtres. Pour cela, voir {{WebExtAPIRef('tabs.onDetached')}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onMoved.addListener(listener) +```js +browser.tabs.onMoved.addListener(listener) browser.tabs.onMoved.removeListener(listener) browser.tabs.onMoved.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> st l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si le <code>listener</code>est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` st l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si le `listener`est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dĂ©placĂ© par l'utilisateur.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>moveInfo</code></dt> - <dd><a href="#moveInfo"><code>object</code></a>. Informations sur le dĂ©mĂ©nagement.</dd> - </dl> - </dd> -</dl> + - `tabId` + - : `integer`. ID de l'onglet dĂ©placĂ© par l'utilisateur. -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + <!----> -<h3 id="moveInfo">moveInfo</h3> + - `moveInfo` + - : [`object`](#moveInfo). Informations sur le dĂ©mĂ©nagement. -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. ID de la fenĂȘtre de cet onglet.</dd> - <dt><code>fromIndex</code></dt> - <dd><code>integer</code>. Index initial de cet onglet dans la fenĂȘtre.</dd> - <dt><code>toIndex</code></dt> - <dd><code>integer</code>. Index final de cet onglet dans la fenĂȘtre</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="Exemples">Exemples</h2> +### moveInfo -<p>Ăcouter et enregistrer les Ă©vĂ©nements de dĂ©placement :</p> +- `windowId` + - : `integer`. ID de la fenĂȘtre de cet onglet. +- `fromIndex` + - : `integer`. Index initial de cet onglet dans la fenĂȘtre. +- `toIndex` + - : `integer`. Index final de cet onglet dans la fenĂȘtre -<pre class="brush: js">function handleMoved(tabId, moveInfo) { +## Exemples + +Ăcouter et enregistrer les Ă©vĂ©nements de dĂ©placement : + +```js +function handleMoved(tabId, moveInfo) { console.log("Tab " + tabId + " moved from " + moveInfo.fromIndex + " to " + moveInfo.toIndex); } -browser.tabs.onMoved.addListener(handleMoved);</pre> - -<p>{{WebExtExamples}}</p> - -<dl> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +browser.tabs.onMoved.addListener(handleMoved); +``` -<p>{{Compat("webextensions.api.tabs.onMoved")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.onMoved")}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -127,5 +116,4 @@ browser.tabs.onMoved.addListener(handleMoved);</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/tabs/onremoved/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onremoved/index.md index 360e8ac589..26bbdd1bef 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onremoved/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onremoved/index.md @@ -13,90 +13,79 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onRemoved --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© quand un onglet est fermĂ©.</p> +LancĂ© quand un onglet est fermĂ©. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onRemoved.addListener(callback) +```js +browser.tabs.onRemoved.addListener(callback) browser.tabs.onRemoved.removeListener(listener) browser.tabs.onRemoved.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet qui s'est fermĂ©.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>removeInfo</code></dt> - <dd><a href="#removeInfo"><code>object</code></a>. L'ID de la fenĂȘtre de l'onglet et un boolĂ©en indiquant si la fenĂȘtre est Ă©galement fermĂ©e.</dd> - </dl> - </dd> -</dl> + - `tabId` + - : `integer`. ID de l'onglet qui s'est fermĂ©. -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + <!----> -<h3 id="removeInfo">removeInfo</h3> + - `removeInfo` + - : [`object`](#removeInfo). L'ID de la fenĂȘtre de l'onglet et un boolĂ©en indiquant si la fenĂȘtre est Ă©galement fermĂ©e. -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. La fenĂȘtre dont l'onglet est fermĂ©.</dd> - <dt><code>isWindowClosing</code></dt> - <dd><code>boolean</code>. <code>true</code> si l'onglet est fermĂ© car sa fenĂȘtre est en cours de fermeture.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="Exemples">Exemples</h2> +### removeInfo -<p>Ăcoutez les Ă©vĂ©nements proches et consignez les informations :</p> +- `windowId` + - : `integer`. La fenĂȘtre dont l'onglet est fermĂ©. +- `isWindowClosing` + - : `boolean`. `true` si l'onglet est fermĂ© car sa fenĂȘtre est en cours de fermeture. -<pre class="brush: js">function handleRemoved(tabId, removeInfo) { +## Exemples + +Ăcoutez les Ă©vĂ©nements proches et consignez les informations : + +```js +function handleRemoved(tabId, removeInfo) { console.log("Tab: " + tabId + " is closing"); console.log("Window ID: " + removeInfo.windowId); console.log("Window is closing: " + removeInfo.isWindowClosing); } -browser.tabs.onRemoved.addListener(handleRemoved);</pre> - -<p>{{WebExtExamples}}</p> - -<dl> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +browser.tabs.onRemoved.addListener(handleRemoved); +``` -<p>{{Compat("webextensions.api.tabs.onRemoved")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.onRemoved")}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -123,5 +112,4 @@ browser.tabs.onRemoved.addListener(handleRemoved);</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/tabs/onreplaced/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.md index 346770d48e..265ba03904 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.md @@ -13,80 +13,71 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onReplaced --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'un onglet est remplacĂ© par un autre en raison d'un prĂ©rendering ou d'un instantanĂ©.</p> +LancĂ© lorsqu'un onglet est remplacĂ© par un autre en raison d'un prĂ©rendering ou d'un instantanĂ©. -<p>Cet Ă©vĂ©nement peut ne pas ĂȘtre pertinent ou pris en charge par des navigateurs autres que Chrome.</p> +Cet Ă©vĂ©nement peut ne pas ĂȘtre pertinent ou pris en charge par des navigateurs autres que Chrome. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onReplaced.addListener(listener) +```js +browser.tabs.onReplaced.addListener(listener) browser.tabs.onReplaced.removeListener(listener) browser.tabs.onReplaced.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>addedTabId</code></dt> - <dd><code>integer</code>. ID de l'onglet de remplacement.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>removedTabId</code></dt> - <dd><code>integer</code>. ID de l'onglet qui a Ă©tĂ© remplacĂ©.</dd> - </dl> - </dd> -</dl> + - `addedTabId` + - : `integer`. ID de l'onglet de remplacement. -<h2 id="Exemples">Exemples</h2> + <!----> -<p>Ăcoutez les Ă©vĂ©nements de remplacement et consignez les informations associĂ©es :</p> + - `removedTabId` + - : `integer`. ID de l'onglet qui a Ă©tĂ© remplacĂ©. -<pre class="brush: js">function handleReplaced(addedTabId, removedTabId) { +## Exemples + +Ăcoutez les Ă©vĂ©nements de remplacement et consignez les informations associĂ©es : + +```js +function handleReplaced(addedTabId, removedTabId) { console.log("New tab: " + addedTabId); console.log("Old tab: " + removedTabId); } browser.tabs.onReplaced.addListener(handleReplaced); -</pre> - -<p>{{WebExtExamples}}</p> - - - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +``` -<p>{{Compat("webextensions.api.tabs.onReplaced")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.onReplaced")}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 +104,4 @@ browser.tabs.onReplaced.addListener(handleReplaced); // 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/tabs/onselectionchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.md index 32841dc868..e59ac78675 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.md @@ -14,77 +14,65 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onSelectionChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div class="warning"> - <p><strong>Attention :</strong> Cet Ă©vĂ©nement est obsolĂšte. Utilisez {{WebExtAPIRef("tabs.onActivated")}} Ă la place.</p> -</div> +> **Attention :** Cet Ă©vĂ©nement est obsolĂšte. Utilisez {{WebExtAPIRef("tabs.onActivated")}} Ă la place. -<p>Se dĂ©clenche lorsque l'onglet sĂ©lectionnĂ© dans une fenĂȘtre change.</p> +Se dĂ©clenche lorsque l'onglet sĂ©lectionnĂ© dans une fenĂȘtre change. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onSelectionChanged.addListener(listener) +```js +browser.tabs.onSelectionChanged.addListener(listener) browser.tabs.onSelectionChanged.removeListener(listener) browser.tabs.onSelectionChanged.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd> VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - :  VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet qui est devenu actif.</dd> - </dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : - <dl> - <dt><code>selectInfo</code></dt> - <dd><a href="#selectInfo"><code>object</code></a>.</dd> - </dl> - </dd> -</dl> + - `tabId` + - : `integer`. L'ID de l'onglet qui est devenu actif. -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + <!----> -<h3 id="selectInfo">selectInfo</h3> + - `selectInfo` + - : [`object`](#selectInfo). -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. L'ID de la fenĂȘtre dans laquelle l'onglet sĂ©lectionnĂ© a changĂ©.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### selectInfo -<p>{{Compat("webextensions.api.tabs.onSelectionChanged")}}</p> +- `windowId` + - : `integer`. L'ID de la fenĂȘtre dans laquelle l'onglet sĂ©lectionnĂ© a changĂ©. -<p>{{WebExtExamples}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.tabs.onSelectionChanged")}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -111,5 +99,4 @@ browser.tabs.onSelectionChanged.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/tabs/onupdated/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onupdated/index.md index a434d27b61..7c6bd95443 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onupdated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onupdated/index.md @@ -13,115 +13,104 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onUpdated --- -<p>C'est dĂ©clenchĂ© lorsqu'un onglet est mis Ă jour.</p> +C'est dĂ©clenchĂ© lorsqu'un onglet est mis Ă jour. -<p>Lorsque l'utilisateur navigue vers une nouvelle URL dans un onglet, cela gĂ©nĂšre gĂ©nĂ©ralement plusieurs Ă©vĂ©nements <code>onUpdated</code> au fur et Ă mesure que diverses propriĂ©tĂ©s de l'objet {{WebExtAPIRef("tabs.Tab")}} sont mises Ă jour. Ceci inclut l' <code>url</code>, mais aussi potentiellement le <code>title</code> et les propriĂ©tĂ©s <code>favIconUrl</code>. La propriĂ©tĂ© du <code>status</code> passe par le <code>"loading"</code> et <code>"complete"</code>.</p> +Lorsque l'utilisateur navigue vers une nouvelle URL dans un onglet, cela gĂ©nĂšre gĂ©nĂ©ralement plusieurs Ă©vĂ©nements `onUpdated` au fur et Ă mesure que diverses propriĂ©tĂ©s de l'objet {{WebExtAPIRef("tabs.Tab")}} sont mises Ă jour. Ceci inclut l' `url`, mais aussi potentiellement le `title` et les propriĂ©tĂ©s `favIconUrl`. La propriĂ©tĂ© du `status` passe par le `"loading"` et `"complete"`. -<p>Cet Ă©vĂ©nement sera Ă©galement dĂ©clenchĂ© pour les modifications des propriĂ©tĂ©s d'un onglet qui n'impliquent pas de navigation, comme le pinning et le dĂ©brochage (qui met Ă jour la propriĂ©tĂ© <code>pinned</code>) et le muting ou le unmuting (qui met Ă jour les propriĂ©tĂ©s <code>audible</code> et <code>mutedInfo</code>).</p> +Cet Ă©vĂ©nement sera Ă©galement dĂ©clenchĂ© pour les modifications des propriĂ©tĂ©s d'un onglet qui n'impliquent pas de navigation, comme le pinning et le dĂ©brochage (qui met Ă jour la propriĂ©tĂ© `pinned`) et le muting ou le unmuting (qui met Ă jour les propriĂ©tĂ©s `audible` et `mutedInfo`). -<p>Vous pouvez filtrer cet Ă©vĂ©nement, en le rendant uniquement valable pour les onglets dont les urls correspondent Ă des <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">patterns</a> spĂ©cifiques, ou pour les modifications de propriĂ©tĂ©s spĂ©cifiques, ou pour les modifications d'un onglet ou d'une fenĂȘtre spĂ©cifique, ou toute combinaison de ces restrictions.</p> +Vous pouvez filtrer cet Ă©vĂ©nement, en le rendant uniquement valable pour les onglets dont les urls correspondent Ă des [patterns](/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns) spĂ©cifiques, ou pour les modifications de propriĂ©tĂ©s spĂ©cifiques, ou pour les modifications d'un onglet ou d'une fenĂȘtre spĂ©cifique, ou toute combinaison de ces restrictions. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onUpdated.addListener(listener[, extraParameters]) +```js +browser.tabs.onUpdated.addListener(listener[, extraParameters]) browser.tabs.onUpdated.removeListener(listener) browser.tabs.onUpdated.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback[, extraParameters])</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants :</p> - - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet qui a Ă©tĂ© mis Ă jour.</dd> - <dt><code>changeInfo</code></dt> - <dd><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/tabs/onUpdated$edit#changeInfo"><code>object</code></a>. ontient les propriĂ©tĂ©s des propriĂ©tĂ©s de l'onglet qui ont Ă©tĂ© modifiĂ©es. Voir <code><a href="/fr/Add-ons/WebExtensions/API/tabs/onUpdated#changeInfo">changeInfo</a></code> ci-dessous.</dd> - <dt><code>tab</code></dt> - <dd>{{WebExtAPIRef('tabs.Tab')}}. Le nouvel Ă©tat de l'onglet.</dd> - </dl> - </dd> - <dt><code>extraParameters</code>{{optional_inline}}</dt> - <dd> - <p><code>object</code>. Un ensemble de filtres qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur. C'est un objet qui peut avoir une ou plusieurs des propriĂ©tĂ©s suivantes. Les Ă©vĂ©nements ne seront envoyĂ©s que s'ils satisfont Ă tous les filtres donnĂ©s.</p> - - <dl> - <dt><code>urls</code></dt> - <dd><code>Array</code>. Un tableau <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">match patterns</a>. Ne dĂ©clenchez l'Ă©vĂ©nement que pour les onglets dont la propriĂ©tĂ© de l'<code>url</code> courante correspond Ă l'un des motifs.</dd> - <dt><code>properties</code></dt> - <dd> - <p><code>Array</code>. un tableau de chaĂźne de caractĂšres, qui sont les noms des propriĂ©tĂ©s de l'objet {{WebExtAPIRef("tabs.Tab")}}. Ne dĂ©clenchez cet Ă©vĂ©nement seulement pour les changement apportĂ©es Ă l'une des propriĂ©tĂ©s nommĂ©es dans ce tableau. Les propriĂ©tĂ©s suivantes peuvent ĂȘtre listĂ©es ici :</p> - - <ul> - <li>"attention"</li> - <li>"audible"</li> - <li>"discarded"</li> - <li>"favIconUrl"</li> - <li>"hidden"</li> - <li>"isArticle"</li> - <li>"mutedInfo"</li> - <li>"pinned"</li> - <li>"sharingState"</li> - <li>"status"</li> - <li>"title"</li> - </ul> - </dd> - <dt><code>tabId</code></dt> - <dd><code>Integer</code>. Ne dĂ©clenchez cet Ă©vĂ©nement que pour l'onglet identifiĂ© par cet ID.</dd> - <dt><code>windowId</code></dt> - <dd><code>Integer</code>. N'activez cet Ă©vĂ©nement que pour les onglets qui se trouvent actuellement dans la fenĂȘtre identifiĂ©e par cet ID.</dd> - </dl> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="changeInfo">changeInfo</h3> - -<p>RĂ©pertorie les modifications apportĂ©es Ă l'Ă©tat de l'onglet mis Ă jour. Pour en savoir plus sur ces propriĂ©tĂ©s, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}.</p> - -<dl> - <dt><code>attention</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Indique si l'onglet attire l'attention. Par exemple, lorsque l'onglet affiche un dialogue modal, <code>attention</code> sera <code>true</code>.</dd> - <dt><code>audible</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Nouvel Ă©tat audible de l'onglet.</dd> - <dt><code>discarded</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet est ignorĂ©. Un onglet supprimĂ© est celui dont le contenu a Ă©tĂ© dĂ©chargĂ© de la mĂ©moire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargĂ© la prochaine fois qu'il est activĂ©.</dd> - <dt><code>favIconUrl</code>{{optional_inline}}</dt> - <dd><code>string</code>. Nouvelle URL de favicon de l'onglet.</dd> - <dt><code>mutedInfo</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('tabs.MutedInfo')}}. Le nouvel Ă©tat muet de l'onglet et la raison du changement.</dd> - <dt><code>pinned</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Nouvel Ă©tat Ă©pinglĂ© de l'onglet.</dd> - <dt><code>status</code>{{optional_inline}}</dt> - <dd><code>string</code>. Le statut de l'onglet. Peut ĂȘtre soit <em>chargĂ©</em> ou <em>complet</em>.</dd> - <dt><code>title</code>{{optional_inline}}</dt> - <dd><code>string</code>. Le nouveau titre de l'onglet.</dd> - <dt><code>url</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'URL de l'onglet s'il a changĂ©.</dd> -</dl> - -<h2 id="Exemples">Exemples</h2> - -<p>Ăcoutez et connectez toutes les informations de changement et nouvel Ă©tat:</p> - -<pre class="brush: js">function handleUpdated(tabId, changeInfo, tabInfo) { +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback[, extraParameters])` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants : + + - `tabId` + - : `integer`. ID de l'onglet qui a Ă©tĂ© mis Ă jour. + - `changeInfo` + - : [`object`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/tabs/onUpdated$edit#changeInfo). ontient les propriĂ©tĂ©s des propriĂ©tĂ©s de l'onglet qui ont Ă©tĂ© modifiĂ©es. Voir [`changeInfo`](/fr/Add-ons/WebExtensions/API/tabs/onUpdated#changeInfo) ci-dessous. + - `tab` + - : {{WebExtAPIRef('tabs.Tab')}}. Le nouvel Ă©tat de l'onglet. + +- `extraParameters`{{optional_inline}} + + - : `object`. Un ensemble de filtres qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur. C'est un objet qui peut avoir une ou plusieurs des propriĂ©tĂ©s suivantes. Les Ă©vĂ©nements ne seront envoyĂ©s que s'ils satisfont Ă tous les filtres donnĂ©s. + + - `urls` + - : `Array`. Un tableau [match patterns](/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns). Ne dĂ©clenchez l'Ă©vĂ©nement que pour les onglets dont la propriĂ©tĂ© de l'`url` courante correspond Ă l'un des motifs. + - `properties` + + - : `Array`. un tableau de chaĂźne de caractĂšres, qui sont les noms des propriĂ©tĂ©s de l'objet {{WebExtAPIRef("tabs.Tab")}}. Ne dĂ©clenchez cet Ă©vĂ©nement seulement pour les changement apportĂ©es Ă l'une des propriĂ©tĂ©s nommĂ©es dans ce tableau. Les propriĂ©tĂ©s suivantes peuvent ĂȘtre listĂ©es ici : + + - "attention" + - "audible" + - "discarded" + - "favIconUrl" + - "hidden" + - "isArticle" + - "mutedInfo" + - "pinned" + - "sharingState" + - "status" + - "title" + + - `tabId` + - : `Integer`. Ne dĂ©clenchez cet Ă©vĂ©nement que pour l'onglet identifiĂ© par cet ID. + - `windowId` + - : `Integer`. N'activez cet Ă©vĂ©nement que pour les onglets qui se trouvent actuellement dans la fenĂȘtre identifiĂ©e par cet ID. + +## Objets supplĂ©mentaires + +### changeInfo + +RĂ©pertorie les modifications apportĂ©es Ă l'Ă©tat de l'onglet mis Ă jour. Pour en savoir plus sur ces propriĂ©tĂ©s, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}. + +- `attention` {{optional_inline}} + - : `boolean`. Indique si l'onglet attire l'attention. Par exemple, lorsque l'onglet affiche un dialogue modal, `attention` sera `true`. +- `audible`{{optional_inline}} + - : `boolean`. Nouvel Ă©tat audible de l'onglet. +- `discarded` {{optional_inline}} + - : `boolean`. Si l'onglet est ignorĂ©. Un onglet supprimĂ© est celui dont le contenu a Ă©tĂ© dĂ©chargĂ© de la mĂ©moire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargĂ© la prochaine fois qu'il est activĂ©. +- `favIconUrl`{{optional_inline}} + - : `string`. Nouvelle URL de favicon de l'onglet. +- `mutedInfo`{{optional_inline}} + - : {{WebExtAPIRef('tabs.MutedInfo')}}. Le nouvel Ă©tat muet de l'onglet et la raison du changement. +- `pinned`{{optional_inline}} + - : `boolean`. Nouvel Ă©tat Ă©pinglĂ© de l'onglet. +- `status`{{optional_inline}} + - : `string`. Le statut de l'onglet. Peut ĂȘtre soit _chargĂ©_ ou _complet_. +- `title`{{optional_inline}} + - : `string`. Le nouveau titre de l'onglet. +- `url`{{optional_inline}} + - : `string`. L'URL de l'onglet s'il a changĂ©. + +## Exemples + +Ăcoutez et connectez toutes les informations de changement et nouvel Ă©tat: + +```js +function handleUpdated(tabId, changeInfo, tabInfo) { console.log("Updated tab: " + tabId); console.log("Changed attributes: "); console.log(changeInfo); @@ -129,24 +118,28 @@ browser.tabs.onUpdated.hasListener(listener) console.log(tabInfo); } -browser.tabs.onUpdated.addListener(handleUpdated);</pre> +browser.tabs.onUpdated.addListener(handleUpdated); +``` -<p>Consigner les modifications dans les URL :</p> +Consigner les modifications dans les URL : -<pre class="brush: js">function handleUpdated(tabId, changeInfo, tabInfo) { +```js +function handleUpdated(tabId, changeInfo, tabInfo) { if (changeInfo.url) { console.log("Tab: " + tabId + " URL changed to " + changeInfo.url); } } -browser.tabs.onUpdated.addListener(handleUpdated);</pre> +browser.tabs.onUpdated.addListener(handleUpdated); +``` -<h3 id="Filtering_examples">Filtering examples</h3> +### Filtering examples -<p>Le journal ne change que pour les onglets dont la propriĂ©tĂ© <code>url</code> est <a href="/fr/Add-ons/WebExtensions/Match_patterns">matched</a> par "https://developer.mozilla.org/*" ou "https://twitter.com/mozdevnet":</p> +Le journal ne change que pour les onglets dont la propriĂ©tĂ© `url` est [matched](/fr/Add-ons/WebExtensions/Match_patterns) par "https\://developer.mozilla.org/\*" ou "https\://twitter.com/mozdevnet": -<pre class="brush: js">const pattern1 = "https://developer.mozilla.org/*"; +```js +const pattern1 = "https://developer.mozilla.org/*"; const pattern2 = "https://twitter.com/mozdevnet"; const filter = { @@ -159,11 +152,13 @@ function handleUpdated(tabId, changeInfo, tabInfo) { console.log("New tab Info: ", tabInfo); } -browser.tabs.onUpdated.addListener(handleUpdated, filter);</pre> +browser.tabs.onUpdated.addListener(handleUpdated, filter); +``` -<p>Le journal ne change que la propriĂ©tĂ© <code>Ă©pinglĂ©e</code> des onglets (c'est-Ă -dire les actions d'Ă©pinglage et de dĂ©blocage) :</p> +Le journal ne change que la propriĂ©tĂ© `Ă©pinglĂ©e` des onglets (c'est-Ă -dire les actions d'Ă©pinglage et de dĂ©blocage) : -<pre class="brush: js">const filter = { +```js +const filter = { properties: ["pinned"] } @@ -173,16 +168,16 @@ function handleUpdated(tabId, changeInfo, tabInfo) { console.log("New tab Info: ", tabInfo); } -browser.tabs.onUpdated.addListener(handleUpdated, filter);</pre> +browser.tabs.onUpdated.addListener(handleUpdated, filter); +``` -<p>Combiner les deux filtres prĂ©cĂ©dents : changements de journal seulement :</p> +Combiner les deux filtres prĂ©cĂ©dents : changements de journal seulement : -<ul> - <li>A la propriĂ©tĂ© <code>Ă©pinglĂ©e</code> des onglets</li> - <li>Dont la propriĂ©tĂ© <code>url</code> est <a href="/fr/Add-ons/WebExtensions/Match_patterns">matched</a> par "https://developer.mozilla.org/*" ou "https://twitter.com/mozdevnet":</li> -</ul> +- A la propriĂ©tĂ© `Ă©pinglĂ©e` des onglets +- Dont la propriĂ©tĂ© `url` est [matched](/fr/Add-ons/WebExtensions/Match_patterns) par "https\://developer.mozilla.org/\*" ou "https\://twitter.com/mozdevnet": -<pre class="brush: js">const pattern1 = "https://developer.mozilla.org/*"; +```js +const pattern1 = "https://developer.mozilla.org/*"; const pattern2 = "https://twitter.com/mozdevnet"; const filter = { @@ -198,17 +193,17 @@ function handleUpdated(tabId, changeInfo, tabInfo) { browser.tabs.onUpdated.addListener( handleUpdated, - filter);</pre> + filter); +``` -<p>Changements dans le journal seulement :</p> +Changements dans le journal seulement : -<ul> - <li>A la propriĂ©tĂ© <code>Ă©pinglĂ©e</code> des onglets</li> - <li>Dont la propriĂ©tĂ© <code>url</code> est <a href="/fr/Add-ons/WebExtensions/Match_patterns">matched</a> par "https://developer.mozilla.org/*" ou "https://twitter.com/mozdevnet"</li> - <li>et qui font partie de la fenĂȘtre actuelle du navigateur au moment oĂč l'Ă©vĂ©nement de mise Ă jour est dĂ©clenchĂ© :</li> -</ul> +- A la propriĂ©tĂ© `Ă©pinglĂ©e` des onglets +- Dont la propriĂ©tĂ© `url` est [matched](/fr/Add-ons/WebExtensions/Match_patterns) par "https\://developer.mozilla.org/\*" ou "https\://twitter.com/mozdevnet" +- et qui font partie de la fenĂȘtre actuelle du navigateur au moment oĂč l'Ă©vĂ©nement de mise Ă jour est dĂ©clenchĂ© : -<pre class="brush: js">const pattern1 = "https://developer.mozilla.org/*"; +```js +const pattern1 = "https://developer.mozilla.org/*"; const pattern2 = "https://twitter.com/mozdevnet"; const filter = { @@ -225,21 +220,20 @@ function handleUpdated(tabId, changeInfo, tabInfo) { browser.tabs.onUpdated.addListener( handleUpdated, - filter);</pre> - -<p>{{WebExtExamples}}</p> + filter); +``` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{WebExtExamples}} -<p>{{Compat("webextensions.api.tabs.onUpdated", 10)}}</p> +## CompatibilitĂ© du navigateur -<div class="note"><p><strong>Note :</strong></p> +{{Compat("webextensions.api.tabs.onUpdated", 10)}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json) dans le code de Chromium code. -<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 @@ -266,7 +260,6 @@ browser.tabs.onUpdated.addListener( // 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> -<p>{{AddonSidebar}}</p> +{{AddonSidebar}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md index 67b0c63bd5..0da209ffa4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md @@ -13,89 +13,78 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onZoomChange --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>EnvoyĂ© lorsqu'un onglet est agrandi.</p> +EnvoyĂ© lorsqu'un onglet est agrandi. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.onZoomChange.addListener(listener) +```js +browser.tabs.onZoomChange.addListener(listener) browser.tabs.onZoomChange.removeListener(listener) browser.tabs.onZoomChange.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> de l'Ă©couteur est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` de l'Ă©couteur est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>ZoomChangeInfo</code></dt> - <dd><a href="#ZoomChangeInfo"><code>object</code></a>. Informations sur l'Ă©vĂ©nement de zoom.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + - `ZoomChangeInfo` + - : [`object`](#ZoomChangeInfo). Informations sur l'Ă©vĂ©nement de zoom. -<h3 id="ZoomChangeInfo">ZoomChangeInfo</h3> +## Objets supplĂ©mentaires -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet qui a Ă©tĂ© zoomĂ©.</dd> - <dt><code>oldZoomFactor</code></dt> - <dd><code>number</code>. Le facteur de zoom prĂ©cĂ©dent.</dd> - <dt><code>newZoomFactor</code></dt> - <dd><code>number</code>. Le nouveau facteur de zoom.</dd> - <dt><code>zoomSettings</code></dt> - <dd>{{WebExtAPIRef('tabs.ZoomSettings')}}. ParamĂštres de zoom pour l'onglet.</dd> -</dl> +### ZoomChangeInfo -<h2 id="Exemples">Exemples</h2> +- `tabId` + - : `integer`. ID de l'onglet qui a Ă©tĂ© zoomĂ©. +- `oldZoomFactor` + - : `number`. Le facteur de zoom prĂ©cĂ©dent. +- `newZoomFactor` + - : `number`. Le nouveau facteur de zoom. +- `zoomSettings` + - : {{WebExtAPIRef('tabs.ZoomSettings')}}. ParamĂštres de zoom pour l'onglet. -<p>Ecoutez les Ă©vĂ©nements de zoom et consignez les informations :</p> +## Exemples -<pre class="brush: js">function handleZoomed(zoomChangeInfo) { +Ecoutez les Ă©vĂ©nements de zoom et consignez les informations : + +```js +function handleZoomed(zoomChangeInfo) { console.log("Tab: " + zoomChangeInfo.tabId + " zoomed"); console.log("Old zoom: " + zoomChangeInfo.oldZoomFactor); console.log("New zoom: " + zoomChangeInfo.newZoomFactor); } -browser.tabs.onZoomChange.addListener(handleZoomed);</pre> - -<p>{{WebExtExamples}}</p> - -<dl> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +browser.tabs.onZoomChange.addListener(handleZoomed); +``` -<p>{{Compat("webextensions.api.tabs.onZoomChange")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.onZoomChange")}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -122,5 +111,4 @@ browser.tabs.onZoomChange.addListener(handleZoomed);</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/tabs/pagesettings/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.md index aae4f3a3e7..71f55b5e84 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.md @@ -12,75 +12,71 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/PageSettings --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Le type <strong><code>tabs.PageSettings</code></strong> est utilisĂ© pour contrĂŽler le rendu d'un onglet au format PDF par la mĂ©thode {{WebExtAPIRef("tabs.saveAsPDF()")}}.</p> +Le type **`tabs.PageSettings`** est utilisĂ© pour contrĂŽler le rendu d'un onglet au format PDF par la mĂ©thode {{WebExtAPIRef("tabs.saveAsPDF()")}}. -<p>Toutes ses propriĂ©tĂ©s sont facultatives.</p> +Toutes ses propriĂ©tĂ©s sont facultatives. -<p>Pour dĂ©finir les en-tĂȘtes et les pieds de page, vous pouvez inclure certains caractĂšres spĂ©ciaux dans les chaĂźnes que vous fournissez. Ceux-ci seront remplacĂ©s dans la sortie rendue comme suit :</p> +Pour dĂ©finir les en-tĂȘtes et les pieds de page, vous pouvez inclure certains caractĂšres spĂ©ciaux dans les chaĂźnes que vous fournissez. Ceux-ci seront remplacĂ©s dans la sortie rendue comme suit : -<ul> - <li>"&P": le numĂ©ro de page, comme "2"</li> - <li>"&PT": le numĂ©ro de page et le nombre total de pages, comme "2 su 3"</li> - <li>"&D": la date / heure actuelle</li> - <li>"&T": le titre de la page</li> - <li>"&U": l'URL de la page</li> -</ul> +- "\&P": le numĂ©ro de page, comme "2" +- "\&PT": le numĂ©ro de page et le nombre total de pages, comme "2 su 3" +- "\&D": la date / heure actuelle +- "\&T": le titre de la page +- "\&U": l'URL de la page -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>edgeBottom </code>{{optional_inline}}</dt> - <dd><code>number</code>. L'espacement entre le bas des pieds et le bord infĂ©rieur du papier (pouces). Par dĂ©faut : 0.</dd> - <dt><code>edgeLeft </code>{{optional_inline}}</dt> - <dd><code>number</code>. L'espacement entre l'en-tĂȘte / pied de page gauche et le bord gauche du papier (pouces). Par dĂ©faut : 0</dd> - <dt><code>edgeRight </code>{{optional_inline}}</dt> - <dd><code>number</code>. L'espacement entre l'en-tĂȘte / pied droit et le bord gauche du papier (pouces). Par dĂ©faut : 0.</dd> - <dt><code>edgeTop </code>{{optional_inline}}</dt> - <dd><code>number</code>. L'espacement entre le haut des en-tĂȘtes et le bord supĂ©rieur du papier (pouces). Par dĂ©faut : 0</dd> - <dt><code>footerCenter</code> {{optional_inline}}</dt> - <dd><code>string</code>. Le texte du pied de page central de la page. DĂ©faut : ''.</dd> - <dt><code>footerLeft</code> {{optional_inline}}</dt> - <dd><code>string</code>. Le texte pour le pied gauche de la page. Par dĂ©faut : '&PT'.</dd> - <dt><code>footerRight</code> {{optional_inline}}</dt> - <dd><code>string</code>. Le texte pour le pied droit de la page. Par dĂ©faut : '&D'.</dd> - <dt><code>headerCenter</code> {{optional_inline}}</dt> - <dd><code>string</code>. Le texte de l'en-tĂȘte du centre de la page. DĂ©faut : ''.</dd> - <dt><code>headerLeft</code> {{optional_inline}}</dt> - <dd><code>string</code>. Le texte de l'en-tĂȘte gauche de la page. Par dĂ©faut : '&T'.</dd> - <dt><code>headerRight</code> {{optional_inline}}</dt> - <dd><code>string</code>. Le texte de l'en-tĂȘte de la page. Par dĂ©faut : '&U'.</dd> - <dt><code>marginBottom </code>{{optional_inline}}</dt> - <dd><code>number</code>. La marge entre le contenu de la page et le bord infĂ©rieur du papier (pouces). Par dĂ©faut : 0.5.</dd> - <dt><code>marginLeft </code>{{optional_inline}}</dt> - <dd><code>number</code>. La marge entre le contenu de la page et le bord gauche du papier (pouces). Par dĂ©faut : 0.5.</dd> - <dt><code>marginRight </code>{{optional_inline}}</dt> - <dd><code>number</code>. La marge entre le contenu de la page et le bord droit du papier (en pouces). Par dĂ©faut : 0.5.</dd> - <dt><code>marginTop </code>{{optional_inline}}</dt> - <dd><code>number</code>. La marge entre le contenu de la page et le bord supĂ©rieur du papier (pouces). Par dĂ©faut : 0.5.</dd> - <dt><code>orientation </code> {{optional_inline}}</dt> - <dd><code>integer</code>. Orientation de la page: 0 signifie "portrait", 1 signifie "paysage". Par dĂ©faut : 0.</dd> - <dt><code>paperHeight </code>{{optional_inline}}</dt> - <dd><code>number</code>. La hauteur du papier dans les unitĂ©s de format papier. Par dĂ©faut : 11.0.</dd> - <dt><code>paperSizeUnit</code> {{optional_inline}}</dt> - <dd><code>integer</code>. L'unitĂ© de format de papier: 0 = pouces, 1 = millimĂštres. Par dĂ©faut : 0.</dd> - <dt><code>paperWidth</code> {{optional_inline}}</dt> - <dd><code>number</code>. La largeur du papier dans les unitĂ©s de format papier. Par dĂ©faut : 8.5.</dd> - <dt><code>scaling</code> {{optional_inline}}</dt> - <dd><code>number</code>. Facteur d'Ă©chelle du contenu de la page. 1 signifie 100% ou taille normale. Par dĂ©faut : 1.</dd> - <dt><code>showBackgroundColors</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si les couleurs d'arriĂšre-plan de la page doivent ĂȘtre affichĂ©es. Par dĂ©faut : false.</dd> - <dt><code>showBackgroundImages</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si les images d'arriĂšre-plan de la page doivent ĂȘtre affichĂ©es. Par dĂ©faut : false.</dd> - <dt><code>shrinkToFit</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si le contenu de la page doit rĂ©trĂ©cir pour s'adapter Ă la largeur de la page (remplace la mise Ă l'Ă©chelle). Par dĂ©faut : true.</dd> -</dl> +- `edgeBottom `{{optional_inline}} + - : `number`. L'espacement entre le bas des pieds et le bord infĂ©rieur du papier (pouces). Par dĂ©faut : 0. +- `edgeLeft `{{optional_inline}} + - : `number`. L'espacement entre l'en-tĂȘte / pied de page gauche et le bord gauche du papier (pouces). Par dĂ©faut : 0 +- `edgeRight `{{optional_inline}} + - : `number`. L'espacement entre l'en-tĂȘte / pied droit et le bord gauche du papier (pouces). Par dĂ©faut : 0. +- `edgeTop `{{optional_inline}} + - : `number`. L'espacement entre le haut des en-tĂȘtes et le bord supĂ©rieur du papier (pouces). Par dĂ©faut : 0 +- `footerCenter` {{optional_inline}} + - : `string`. Le texte du pied de page central de la page. DĂ©faut : ''. +- `footerLeft` {{optional_inline}} + - : `string`. Le texte pour le pied gauche de la page. Par dĂ©faut : '\&PT'. +- `footerRight` {{optional_inline}} + - : `string`. Le texte pour le pied droit de la page. Par dĂ©faut : '\&D'. +- `headerCenter` {{optional_inline}} + - : `string`. Le texte de l'en-tĂȘte du centre de la page. DĂ©faut : ''. +- `headerLeft` {{optional_inline}} + - : `string`. Le texte de l'en-tĂȘte gauche de la page. Par dĂ©faut : '\&T'. +- `headerRight` {{optional_inline}} + - : `string`. Le texte de l'en-tĂȘte de la page. Par dĂ©faut : '\&U'. +- `marginBottom `{{optional_inline}} + - : `number`. La marge entre le contenu de la page et le bord infĂ©rieur du papier (pouces). Par dĂ©faut : 0.5. +- `marginLeft `{{optional_inline}} + - : `number`. La marge entre le contenu de la page et le bord gauche du papier (pouces). Par dĂ©faut : 0.5. +- `marginRight `{{optional_inline}} + - : `number`. La marge entre le contenu de la page et le bord droit du papier (en pouces). Par dĂ©faut : 0.5. +- `marginTop `{{optional_inline}} + - : `number`. La marge entre le contenu de la page et le bord supĂ©rieur du papier (pouces). Par dĂ©faut : 0.5. +- `orientation `{{optional_inline}} + - : `integer`. Orientation de la page: 0 signifie "portrait", 1 signifie "paysage". Par dĂ©faut : 0. +- `paperHeight `{{optional_inline}} + - : `number`. La hauteur du papier dans les unitĂ©s de format papier. Par dĂ©faut : 11.0. +- `paperSizeUnit` {{optional_inline}} + - : `integer`. L'unitĂ© de format de papier: 0 = pouces, 1 = millimĂštres. Par dĂ©faut : 0. +- `paperWidth` {{optional_inline}} + - : `number`. La largeur du papier dans les unitĂ©s de format papier. Par dĂ©faut : 8.5. +- `scaling` {{optional_inline}} + - : `number`. Facteur d'Ă©chelle du contenu de la page. 1 signifie 100% ou taille normale. Par dĂ©faut : 1. +- `showBackgroundColors` {{optional_inline}} + - : `boolean`. Si les couleurs d'arriĂšre-plan de la page doivent ĂȘtre affichĂ©es. Par dĂ©faut : false. +- `showBackgroundImages` {{optional_inline}} + - : `boolean`. Si les images d'arriĂšre-plan de la page doivent ĂȘtre affichĂ©es. Par dĂ©faut : false. +- `shrinkToFit` {{optional_inline}} + - : `boolean`. Si le contenu de la page doit rĂ©trĂ©cir pour s'adapter Ă la largeur de la page (remplace la mise Ă l'Ă©chelle). Par dĂ©faut : true. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.PageSettings")}}</p> +{{Compat("webextensions.api.tabs.PageSettings")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.md index c2ab587834..3c60495edb 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.md @@ -13,34 +13,36 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/print --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Appelez cette fonction pour imprimer le contenu de l'onglet actif. Si cette fonction est appelĂ©e, l'utilisateur recevra la boĂźte de dialogue d'impression de la plate-forme sous-jacente et aura la possibilitĂ© de modifier les paramĂštres d'impression, puis d'imprimer l'onglet actuellement actif.</p> +Appelez cette fonction pour imprimer le contenu de l'onglet actif. Si cette fonction est appelĂ©e, l'utilisateur recevra la boĂźte de dialogue d'impression de la plate-forme sous-jacente et aura la possibilitĂ© de modifier les paramĂštres d'impression, puis d'imprimer l'onglet actuellement actif. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.tabs.print() -</pre> +```js +browser.tabs.print() +``` -<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>None.</p> +None. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Dans cet exemple, un script d'arriĂšre-plan Ă©coute un clic sur une <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2">action navigateur</a>, puis tente d'imprimer l'onglet actuellement actif :</p> +Dans cet exemple, un script d'arriĂšre-plan Ă©coute un clic sur une [action navigateur](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2), puis tente d'imprimer l'onglet actuellement actif : -<pre class="brush: js">browser.browserAction.onClicked.addListener(() => { +```js +browser.browserAction.onClicked.addListener(() => { browser.tabs.print(); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.print")}}</p> +{{Compat("webextensions.api.tabs.print")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.md index 277bc5af28..3d9fc5ab2d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.md @@ -12,51 +12,41 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/printPreview --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Ouvre l'aperçu avant impression pour l'onglet actif.C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise).Une extension peut dĂ©tecter lorsque l'aperçu d'impression a Ă©tĂ© fermĂ© en Ă©coutant l'Ă©vĂ©nement [afterprint](/fr/docs/Web/Events/afterprint) : -<div>Ouvre l'aperçu avant impression pour l'onglet actif.</div> +```js +window.addEventListener("afterprint", resumeFunction, false); +``` -<div></div> +## Syntaxe -<div>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</div> +```js +var openingPreview = browser.tabs.printPreview() +``` -<div></div> +### ParamĂštres -<div>Une extension peut dĂ©tecter lorsque l'aperçu d'impression a Ă©tĂ© fermĂ© en Ă©coutant l'Ă©vĂ©nement <a href="/fr/docs/Web/Events/afterprint">afterprint</a> :</div> +None. -<div></div> +### Valeur retournĂ©e -<div> -<pre class="brush: js">window.addEventListener("afterprint", resumeFunction, false);</pre> -</div> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque la page d'aperçu est ouverte. -<h2 id="Syntaxe">Syntaxe</h2> +## Exemples -<pre class="brush: js">var openingPreview = browser.tabs.printPreview() -</pre> +Dans cet exemple, un script d'arriĂšre-plan Ă©coute un clic sur une [action de navigateur](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2), puis ouvre l'aperçu avant impression pour l'onglet actuellement actif : -<h3 id="ParamĂštres">ParamĂštres</h3> - -<p>None.</p> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans argument lorsque la page d'aperçu est ouverte.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Dans cet exemple, un script d'arriĂšre-plan Ă©coute un clic sur une <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Browser_actions_2">action de navigateur</a>, puis ouvre l'aperçu avant impression pour l'onglet actuellement actif :</p> - -<pre class="brush: js">browser.browserAction.onClicked.addListener(() => { +```js +browser.browserAction.onClicked.addListener(() => { browser.tabs.printPreview() - .then(() => { + .then(() => { console.log("Entered print preview"); }); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.printPreview")}}</p> +{{Compat("webextensions.api.tabs.printPreview")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.md index 7e7a756610..9f753a7c03 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.md @@ -13,74 +13,73 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/query --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient tous les onglets qui ont les propriĂ©tĂ©s spĂ©cifiĂ©es, ou tous les onglets si aucune propriĂ©tĂ© n'est spĂ©cifiĂ©e.</p> +Obtient tous les onglets qui ont les propriĂ©tĂ©s spĂ©cifiĂ©es, ou tous les onglets si aucune propriĂ©tĂ© n'est spĂ©cifiĂ©e. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 querying = browser.tabs.query( +```js +var querying = browser.tabs.query( queryInfo // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>queryInfo</code></dt> - <dd><p><code>object</code>. La fonction <code>query()</code> obtiendra uniquement les onglets dont les propriĂ©tĂ©s correspondent aux propriĂ©tĂ©s incluses ici. Pour en savoir plus sur ces propriĂ©tĂ©s, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}.</p> - <dl> - <dt><code>active</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si les onglets sont actifs dans leurs fenĂȘtres.</dd> - <dt><code>audible</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si les onglets sont audibles.</dd> - <dt><code>autoDiscardable</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si les onglets peuvent ĂȘtre supprimĂ©s automatiquement par le navigateur lorsque les ressources sont faibles.</dd> - <dt><code>cookieStoreId</code> {{optional_inline}}</dt> - <dd><code>string</code>. Utilisez cette option pour renvoyer uniquement les onglets dont l'ID est <code>cookieStoreId</code>. Cette option n'est disponible que si l'extension Ă la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>"cookies"</code></dd> - <dt><code>currentWindow</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si les onglets sont dans la fenĂȘtre actuelle.</dd> - <dt><code>discarded</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si les onglets sont supprimĂ©s. Un onglet supprimĂ© est celui dont le contenu a Ă©tĂ© dĂ©chargĂ© de la mĂ©moire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargĂ© la prochaine fois qu'il est activĂ©.***</dd> - <dt><code>hidden</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si les onglets sont cachĂ©s.</dd> - <dt><code>highlighted</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si les onglets sont en surbrillance.</dd> - <dt><code>index</code>{{optional_inline}}</dt> - <dd><code>integer</code>. La position des onglets dans leurs fenĂȘtres.</dd> - <dt><code>muted</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si les onglets sont en sourdine.</dd> - <dt><code>lastFocusedWindow</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si les onglets sont dans la derniĂšre fenĂȘtre focalisĂ©e.</dd> - <dt><code>openerTabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet qui a ouvert cet onglet.</dd> - <dt><code>pinned</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si les onglets sont Ă©pinglĂ©s.</dd> - <dt><code>status</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('tabs.TabStatus')}}. Si les onglets ont terminĂ© le chargement.</dd> - <dt><code>title</code>{{optional_inline}}</dt> - <dd><code>string</code>. Faites correspondre les titres de page Ă un motif.</dd> - <dt><code>url</code>{{optional_inline}}</dt> - <dd><code><code>string</code></code> ou <code><code>array</code> de <code><code>string</code></code></code>. Faites correspondre les onglets avec un ou plusieurs <a href="/fr/Add-ons/WebExtensions/Match_patterns">modĂšle de correspondance</a>. Notez que les identificateurs de fragment ne sont pas appariĂ©s.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de la fenĂȘtre parente, ou {{WebExtAPIRef('windows.WINDOW_ID_CURRENT')}} pour la fenĂȘtre en cours.</dd> - <dt><code>windowType</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('tabs.WindowType')}}. Le type de fenĂȘtre dans lequel les onglets y sont.</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un <code>tableau</code> d'objets <code>{{WebExtAPIRef('tabs.Tab')}}</code>, contenant des informations sur chaque onglet correspondant. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Obtenez tous les onglets : </p> - -<pre class="brush: js">function logTabs(tabs) { +``` + +### ParamĂštres + +- `queryInfo` + + - : `object`. La fonction `query()` obtiendra uniquement les onglets dont les propriĂ©tĂ©s correspondent aux propriĂ©tĂ©s incluses ici. Pour en savoir plus sur ces propriĂ©tĂ©s, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}. + + - `active`{{optional_inline}} + - : `boolean`. Si les onglets sont actifs dans leurs fenĂȘtres. + - `audible`{{optional_inline}} + - : `boolean`. Si les onglets sont audibles. + - `autoDiscardable`{{optional_inline}} + - : `boolean`. Si les onglets peuvent ĂȘtre supprimĂ©s automatiquement par le navigateur lorsque les ressources sont faibles. + - `cookieStoreId` {{optional_inline}} + - : `string`. Utilisez cette option pour renvoyer uniquement les onglets dont l'ID est `cookieStoreId`. Cette option n'est disponible que si l'extension Ă la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `"cookies"` + - `currentWindow`{{optional_inline}} + - : `boolean`. Si les onglets sont dans la fenĂȘtre actuelle. + - `discarded`{{optional_inline}} + - : `boolean`. Si les onglets sont supprimĂ©s. Un onglet supprimĂ© est celui dont le contenu a Ă©tĂ© dĂ©chargĂ© de la mĂ©moire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargĂ© la prochaine fois qu'il est activĂ©.\*\*\* + - `hidden`{{optional_inline}} + - : `boolean`. Si les onglets sont cachĂ©s. + - `highlighted`{{optional_inline}} + - : `boolean`. Si les onglets sont en surbrillance. + - `index`{{optional_inline}} + - : `integer`. La position des onglets dans leurs fenĂȘtres. + - `muted`{{optional_inline}} + - : `boolean`. Si les onglets sont en sourdine. + - `lastFocusedWindow`{{optional_inline}} + - : `boolean`. Si les onglets sont dans la derniĂšre fenĂȘtre focalisĂ©e. + - `openerTabId`{{optional_inline}} + - : `integer`. L'ID de l'onglet qui a ouvert cet onglet. + - `pinned`{{optional_inline}} + - : `boolean`. Si les onglets sont Ă©pinglĂ©s. + - `status`{{optional_inline}} + - : {{WebExtAPIRef('tabs.TabStatus')}}. Si les onglets ont terminĂ© le chargement. + - `title`{{optional_inline}} + - : `string`. Faites correspondre les titres de page Ă un motif. + - `url`{{optional_inline}} + - : `string` ou `array de string`. Faites correspondre les onglets avec un ou plusieurs [modĂšle de correspondance](/fr/Add-ons/WebExtensions/Match_patterns). Notez que les identificateurs de fragment ne sont pas appariĂ©s. + - `windowId`{{optional_inline}} + - : `integer`. L'ID de la fenĂȘtre parente, ou {{WebExtAPIRef('windows.WINDOW_ID_CURRENT')}} pour la fenĂȘtre en cours. + - `windowType`{{optional_inline}} + - : {{WebExtAPIRef('tabs.WindowType')}}. Le type de fenĂȘtre dans lequel les onglets y sont. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un `tableau` d'objets `{{WebExtAPIRef('tabs.Tab')}}`, contenant des informations sur chaque onglet correspondant. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. + +## Exemples + +Obtenez tous les onglets : + +```js +function logTabs(tabs) { for (let tab of tabs) { // tab.url requires the `tabs` permission console.log(tab.url); @@ -92,11 +91,13 @@ function onError(error) { } var querying = browser.tabs.query({}); -querying.then(logTabs, onError);</pre> +querying.then(logTabs, onError); +``` -<p>Obtenez tous les onglets dans la fenĂȘtre actuelle :</p> +Obtenez tous les onglets dans la fenĂȘtre actuelle : -<pre class="brush: js">function logTabs(tabs) { +```js +function logTabs(tabs) { for (let tab of tabs) { // tab.url requires the `tabs` permission console.log(tab.url); @@ -108,11 +109,13 @@ function onError(error) { } var querying = browser.tabs.query({currentWindow: true}); -querying.then(logTabs, onError);</pre> +querying.then(logTabs, onError); +``` -<p>Obtenez l'onglet actif dans la fenĂȘtre actuelle :</p> +Obtenez l'onglet actif dans la fenĂȘtre actuelle : -<pre class="brush: js">function logTabs(tabs) { +```js +function logTabs(tabs) { for (let tab of tabs) { // tab.url requires the `tabs` permission console.log(tab.url); @@ -124,11 +127,13 @@ function onError(error) { } var querying = browser.tabs.query({currentWindow: true, active: true}); -querying.then(logTabs, onError);</pre> +querying.then(logTabs, onError); +``` -<p>Obtenez des onglets pour toutes les URL HTTP et HTTPS sous "mozilla.org" ou l'un de ses sous-domaines :</p> +Obtenez des onglets pour toutes les URL HTTP et HTTPS sous "mozilla.org" ou l'un de ses sous-domaines : -<pre class="brush: js">function logTabs(tabs) { +```js +function logTabs(tabs) { for (let tab of tabs) { // tab.url requires the `tabs` permission console.log(tab.url); @@ -140,23 +145,22 @@ function onError(error) { } var querying = browser.tabs.query({url: "*://*.mozilla.org/*"}); -querying.then(logTabs, onError);</pre> +querying.then(logTabs, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.query")}}</p> +{{Compat("webextensions.api.tabs.query")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -183,5 +187,4 @@ querying.then(logTabs, onError);</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/tabs/reload/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/reload/index.md index af9306d5fa..a1b390154c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/reload/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/reload/index.md @@ -13,51 +13,54 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/reload --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Rechargez un onglet, en contournant Ă©ventuellement le cache Web local.</p> +Rechargez un onglet, en contournant Ă©ventuellement le cache Web local. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 reloading = browser.tabs.reload( +```js +var reloading = browser.tabs.reload( tabId, // optional integer reloadProperties // optional object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet Ă recharger. Par dĂ©faut Ă l'onglet sĂ©lectionnĂ© de la fenĂȘtre en cours.</dd> - <dt><code>reloadProperties</code>{{optional_inline}}</dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>bypassCache</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Contourner le cache web local. La valeur par dĂ©faut est <code>false</code>.</dd> - </dl> - </dd> -</dl> +- `tabId`{{optional_inline}} + - : `integer`. L'ID de l'onglet Ă recharger. Par dĂ©faut Ă l'onglet sĂ©lectionnĂ© de la fenĂȘtre en cours. +- `reloadProperties`{{optional_inline}} -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans arguments lorsque l'onglet a Ă©tĂ© rechargĂ©. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> + - `bypassCache`{{optional_inline}} + - : `boolean`. Contourner le cache web local. La valeur par dĂ©faut est `false`. -<h2 id="Exemples">Exemples</h2> +### Valeur retournĂ©e -<p>Recharger l'onglet actif de la fenĂȘtre en cours :</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments lorsque l'onglet a Ă©tĂ© rechargĂ©. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<pre class="brush: js">browser.tabs.reload();</pre> +## Exemples -<p>Rechargez l'onglet actif de la fenĂȘtre en cours, en ignorant le cache :</p> +Recharger l'onglet actif de la fenĂȘtre en cours : -<pre class="brush: js">browser.tabs.reload({bypassCache: true});</pre> +```js +browser.tabs.reload(); +``` -<p>Rechargez l'onglet dont l'ID est 2, en ignorant le cache et en appelant un rappel lorsque vous avez terminĂ© :</p> +Rechargez l'onglet actif de la fenĂȘtre en cours, en ignorant le cache : -<pre class="brush: js">function onReloaded() { +```js +browser.tabs.reload({bypassCache: true}); +``` + +Rechargez l'onglet dont l'ID est 2, en ignorant le cache et en appelant un rappel lorsque vous avez terminĂ© : + +```js +function onReloaded() { console.log(`Reloaded`); } @@ -66,23 +69,22 @@ function onError(error) { } var reloading = browser.tabs.reload(2, {bypassCache: true}); -reloading.then(onReloaded, onError);</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +reloading.then(onReloaded, onError); +``` -<p>{{Compat("webextensions.api.tabs.reload")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur lâAPI <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.reload")}} -<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 [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -109,5 +111,4 @@ reloading.then(onReloaded, onError);</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/tabs/remove/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/remove/index.md index 90deff9f09..9b2b5d8368 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/remove/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/remove/index.md @@ -13,35 +13,35 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/remove --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ferme un ou plusieurs onglets.</p> +Ferme un ou plusieurs onglets. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 removing = browser.tabs.remove( +```js +var removing = browser.tabs.remove( tabIds // integer or integer array ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabIds</code></dt> - <dd><code><code>integer</code></code> or <code><code>array</code> of <code><code>integer</code></code></code>. Les identifiants de l'onglet ou des onglets Ă fermer.</dd> -</dl> +- `tabIds` + - : `integer` or `array of integer`. Les identifiants de l'onglet ou des onglets Ă fermer. -<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 sans arguments lorsque tous les onglets spĂ©cifiĂ©s ont Ă©tĂ© supprimĂ©s ou que leurs invites <code>beforeunload</code> ont Ă©tĂ© traitĂ©es. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments lorsque tous les onglets spĂ©cifiĂ©s ont Ă©tĂ© supprimĂ©s ou que leurs invites `beforeunload` ont Ă©tĂ© traitĂ©es. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Fermer un seul onglet :</p> +Fermer un seul onglet : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log(`Removed`); } @@ -50,11 +50,13 @@ function onError(error) { } var removing = browser.tabs.remove(2); -removing.then(onRemoved, onError);</pre> +removing.then(onRemoved, onError); +``` -<p>Fermer plusieurs onglets :</p> +Fermer plusieurs onglets : -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log(`Removed`); } @@ -63,23 +65,22 @@ function onError(error) { } var removing = browser.tabs.remove([15, 14, 1]); -removing.then(onRemoved, onError);</pre> +removing.then(onRemoved, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.remove")}}</p> +{{Compat("webextensions.api.tabs.remove")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur lâAPI [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -106,5 +107,4 @@ removing.then(onRemoved, onError);</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/tabs/removecss/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/removecss/index.md index 42cc08592e..00af43200b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/removecss/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/removecss/index.md @@ -13,54 +13,52 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/removeCSS --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime d'une page CSS prĂ©cĂ©demment injectĂ©e par un appel Ă {{WebExtAPIRef("tabs.insertCSS()")}}.</p> +Supprime d'une page CSS prĂ©cĂ©demment injectĂ©e par un appel Ă {{WebExtAPIRef("tabs.insertCSS()")}}. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var removing = browser.tabs.removeCSS( - tabId, // optional integer - details // object -) -</pre> + var removing = browser.tabs.removeCSS( + tabId, // optional integer + details // object + ) -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet Ă partir duquel supprimer le CSS. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours.</dd> - <dt><code>details</code></dt> - <dd>Un objet dĂ©crivant le CSS Ă retirer de la page. Il contient les propriĂ©tĂ©s suivantes : - <dl> - <dt></dt> - <dt><code>allFrames</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. si <code>true</code>, le code sera supprimĂ© de toutes les images de la page en cours. si c'est <code>false</code>, le code est seulement retirĂ© du cadre supĂ©rieur. Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>code</code>{{optional_inline}}</dt> - <dd><code>string</code>. CSS Ă supprimer, en tant que chaĂźne de texte. Cela doit correspondre exactement Ă une chaĂźne CSS prĂ©cĂ©demment insĂ©rĂ©e dans la page en utilisant {{WebExtAPIRef("tabs.insertCSS()")}}.</dd> - <dt><code>cssOrigin</code>{{optional_inline}}</dt> - <dd><code>string</code>. Cela peut prendre l'une des deux valeurs suivantes : "user", pour CSS ajoutĂ© en tant que feuille de style utilisateur, ou "author" pour CSS ajoutĂ© en tant que feuille de style auteur. Si cette option a Ă©tĂ© dĂ©finie prĂ©cĂ©demment par {{WebExtAPIRef("tabs.insertCSS()")}}, elle doit correspondre exactement.</dd> - <dt><code>file</code>{{optional_inline}}</dt> - <dd><code>string</code>. Chemin d'accĂšs Ă un fichier contenant le CSS Ă supprimer. Cela doit correspondre exactement Ă un fichier CSS prĂ©alablement insĂ©rĂ© dans la page en utilisant {{WebExtAPIRef("tabs.insertCSS()")}}.</dd> - <dt><code>frameId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Le cadre Ă partir duquel supprimer le CSS. La valeur par dĂ©faut est <code>0</code> (l'image de niveau supĂ©rieur).</dd> - <dt><code>matchAboutBlank</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. si <code>true</code>, le CSS sera supprimĂ© des cadres "about:blank" et "about:srcdoc" intĂ©grĂ©s si votre extension a accĂšs Ă leur document parent. Par dĂ©faut Ă <code>false</code>.</dd> - </dl> - </dd> -</dl> +- `tabId` {{optional_inline}} + - : `integer`. L'ID de l'onglet Ă partir duquel supprimer le CSS. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours. +- `details` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : Un objet dĂ©crivant le CSS Ă retirer de la page. Il contient les propriĂ©tĂ©s suivantes : -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans arguments lorsque tous les CSS ont Ă©tĂ© supprimĂ©s. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> + - `allFrames`{{optional_inline}} -<h2 id="Exemples">Exemples</h2> + - : `boolean`. si `true`, le code sera supprimĂ© de toutes les images de la page en cours. si c'est `false`, le code est seulement retirĂ© du cadre supĂ©rieur. Par dĂ©faut Ă `false`. -<p>Cet exemple ajoute du code CSS en utilisant {{WebExtAPIRef("tabs.insertCSS")}}, puis le supprime Ă nouveau lorsque l'utilisateur clique sur une action du navigateur :</p> + - `code`{{optional_inline}} + - : `string`. CSS Ă supprimer, en tant que chaĂźne de texte. Cela doit correspondre exactement Ă une chaĂźne CSS prĂ©cĂ©demment insĂ©rĂ©e dans la page en utilisant {{WebExtAPIRef("tabs.insertCSS()")}}. + - `cssOrigin`{{optional_inline}} + - : `string`. Cela peut prendre l'une des deux valeurs suivantes : "user", pour CSS ajoutĂ© en tant que feuille de style utilisateur, ou "author" pour CSS ajoutĂ© en tant que feuille de style auteur. Si cette option a Ă©tĂ© dĂ©finie prĂ©cĂ©demment par {{WebExtAPIRef("tabs.insertCSS()")}}, elle doit correspondre exactement. + - `file`{{optional_inline}} + - : `string`. Chemin d'accĂšs Ă un fichier contenant le CSS Ă supprimer. Cela doit correspondre exactement Ă un fichier CSS prĂ©alablement insĂ©rĂ© dans la page en utilisant {{WebExtAPIRef("tabs.insertCSS()")}}. + - `frameId`{{optional_inline}} + - : `integer`. Le cadre Ă partir duquel supprimer le CSS. La valeur par dĂ©faut est `0` (l'image de niveau supĂ©rieur). + - `matchAboutBlank`{{optional_inline}} + - : `boolean`. si `true`, le CSS sera supprimĂ© des cadres "about:blank" et "about:srcdoc" intĂ©grĂ©s si votre extension a accĂšs Ă leur document parent. Par dĂ©faut Ă `false`. -<pre class="brush: js">var css = "body { border: 20px dotted pink; }"; +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments lorsque tous les CSS ont Ă©tĂ© supprimĂ©s. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. + +## Exemples + +Cet exemple ajoute du code CSS en utilisant {{WebExtAPIRef("tabs.insertCSS")}}, puis le supprime Ă nouveau lorsque l'utilisateur clique sur une action du navigateur : + +```js +var css = "body { border: 20px dotted pink; }"; function onError(error) { console.log(`Error: ${error}`); @@ -69,26 +67,25 @@ function onError(error) { var insertingCSS = browser.tabs.insertCSS(2, {code: css}); insertingCSS.then(null, onError); -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { var removing = browser.tabs.removeCSS(2, {code: css}); removing.then(null, onError); -});</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +}); +``` -<p>{{Compat("webextensions.api.tabs.removeCSS")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur lâAPI <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.removeCSS")}} -<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 [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -115,5 +112,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/tabs/saveaspdf/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/saveaspdf/index.md index c13d1cfeae..aededbb921 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/saveaspdf/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/saveaspdf/index.md @@ -12,49 +12,48 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/saveAsPDF --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Enregistre la page en cours en tant que fichier PDF. Cela ouvrira une boĂźte de dialogue, fournie par le systĂšme d'exploitation sous-jacent, demandant Ă l'utilisateur oĂč il veut enregistrer le fichier PDF.</p> +Enregistre la page en cours en tant que fichier PDF. Cela ouvrira une boĂźte de dialogue, fournie par le systĂšme d'exploitation sous-jacent, demandant Ă l'utilisateur oĂč il veut enregistrer le fichier PDF. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 saving = browser.tabs.saveAsPDF( +```js +var saving = browser.tabs.saveAsPDF( pageSettings // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>pageSettings</code></dt> - <dd><code>object</code>. ParamĂštres de la page enregistrĂ©e, en tant qu'objet {{WebExtAPIRef("tabs.PageSettings")}}. Cet objet doit ĂȘtre donnĂ©, mais toutes ses propriĂ©tĂ©s sont facultatives. Toutes les propriĂ©tĂ©s non spĂ©cifiĂ©es ici recevront les valeurs par dĂ©faut rĂ©pertoriĂ©es dans la documentation {{WebExtAPIRef("tabs.PageSettings", "PageSettings")}}.</dd> -</dl> +- `pageSettings` + - : `object`. ParamĂštres de la page enregistrĂ©e, en tant qu'objet {{WebExtAPIRef("tabs.PageSettings")}}. Cet objet doit ĂȘtre donnĂ©, mais toutes ses propriĂ©tĂ©s sont facultatives. Toutes les propriĂ©tĂ©s non spĂ©cifiĂ©es ici recevront les valeurs par dĂ©faut rĂ©pertoriĂ©es dans la documentation {{WebExtAPIRef("tabs.PageSettings", "PageSettings")}}. -<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 une chaĂźne d'Ă©tat lorsque la boĂźte de dialogue sera fermĂ©e. La chaĂźne peut ĂȘtre l'une des :</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec une chaĂźne d'Ă©tat lorsque la boĂźte de dialogue sera fermĂ©e. La chaĂźne peut ĂȘtre l'une des : -<ul> - <li>"saved"</li> - <li>"replaced"</li> - <li>"canceled"</li> - <li>"not_saved"</li> - <li>"not_replaced"</li> -</ul> +- "saved" +- "replaced" +- "canceled" +- "not_saved" +- "not_replaced" -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Dans cet exemple, un script d'arriĂšre-plan Ă©coute un clic sur une <a href="/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension">action du navigateur</a>, puis tente d'enregistrer l'onglet actif en tant que fichier PDF, puis enregistre le rĂ©sultat:</p> +Dans cet exemple, un script d'arriĂšre-plan Ă©coute un clic sur une [action du navigateur](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension), puis tente d'enregistrer l'onglet actif en tant que fichier PDF, puis enregistre le rĂ©sultat: -<pre class="brush: js">browser.browserAction.onClicked.addListener(() => { +```js +browser.browserAction.onClicked.addListener(() => { browser.tabs.saveAsPDF({}) - .then((status) => { + .then((status) => { console.log(status); }); -});</pre> +}); +``` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.saveAsPDF")}}</p> +{{Compat("webextensions.api.tabs.saveAsPDF")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md index 02c287215f..e380822b15 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md @@ -14,56 +14,47 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/sendMessage --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Envoi un message unique depuis le script d'arriĂšre plan d'extension (ou autre scripts accrĂ©ditĂ©, comme les scripts popup ou les scripts de page d'options) vers n'importe quel [script de contenu ](/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts)concernĂ© par l'extension et qui s'execute dans l'onglet spĂ©cifiĂ©.Ce message sera reçu dans script de contenu par n'importe quel gestionnaire d'Ă©vĂšnements Ă l'Ă©coute de l'Ă©vĂšnement -<div>Envoi un message unique depuis le script d'arriĂšre plan d'extension (ou autre scripts accrĂ©ditĂ©, comme les scripts popup ou les scripts de page d'options) vers n'importe quel <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts">script de contenu </a>concernĂ© par l'extension et qui s'execute dans l'onglet spĂ©cifiĂ©.</div> +{{WebExtAPIRef("runtime.onMessage")}}. Les gestionnaires d'Ă©vĂšnements peuvent optionellement envoyĂ© une rĂ©ponse en retour au script d'arriĂšre plan en utilisant l'argument `sendResponse`. -<div>Ce message sera reçu dans script de contenu par n'importe quel gestionnaire d'Ă©vĂšnements Ă l'Ă©coute de l'Ă©vĂšnement</div> +Il s'agit d'une fonction asynchrone qui renvoit un objet [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<p>{{WebExtAPIRef("runtime.onMessage")}}. Les gestionnaires d'Ă©vĂšnements peuvent optionellement envoyĂ© une rĂ©ponse en retour au script d'arriĂšre plan en utilisant l'argument <code>sendResponse</code>.</p> +> **Note :** Vous pouvez Ă©galement utiliser une [approche basĂ©e sur la connexion pour Ă©changer des messages](/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#Communication_avec_les_scripts_darriĂšre-plan). -<p>Il s'agit d'une fonction asynchrone qui renvoit un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +## Syntaxe -<div class="note"> -<p><strong>Note :</strong> Vous pouvez Ă©galement utiliser une <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Content_scripts#Communication_avec_les_scripts_darriĂšre-plan">approche basĂ©e sur la connexion pour Ă©changer des messages</a>.</p> -</div> - - - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">var sending = browser.tabs.sendMessage( +```js +var sending = browser.tabs.sendMessage( tabId, // integer message, // any options // optional object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet qui contient le script de contenu auquel on veut envoyer un message.</dd> - <dt><code>message</code></dt> - <dd><code>any</code>. Un objet qui peut ĂȘtre sĂ©rialisĂ© en JSON.</dd> - <dt><code>options</code>{{optional_inline}}</dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>frameId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Envoie le message Ă un cadre (<em>iframe</em>) spĂ©cifique identifiĂ©e par <code>frameId</code> au lieu de tous les cadres de l'onglet. Le fait que le script de contenu soit exĂ©cutĂ© dans tous les cadres dĂ©pend du paramĂštre <code>all_frames</code> dans la section <a href="/fr/Add-ons/WebExtensions/manifest.json/content_scripts"><code>content_scripts</code></a> de manifest.json.</dd> - </dl> - </dd> -</dl> +- `tabId` + - : `integer`. ID de l'onglet qui contient le script de contenu auquel on veut envoyer un message. +- `message` + - : `any`. Un objet qui peut ĂȘtre sĂ©rialisĂ© en JSON. +- `options`{{optional_inline}} -<h3 id="Valeur_renvoyĂ©e">Valeur renvoyĂ©e</h3> + - : `object`. -<p>Un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera rempli avec une rĂ©ponse objet au format JSON envoyĂ© par le gestionnaire de message dans le script de contenu, ou sans arguments si le script de contenu n'a pas renvoyĂ© de rĂ©ponses. Si une erreur survient durant la connexion avec l'onglet spĂ©cifiĂ©, ou si n'importe quelle erreur survient, la promesse sera rejetĂ© avec un message d'erreur. Si plusieurs trames rĂ©pondent au message, la promesse est rĂ©solue en une des rĂ©ponses</p> + - `frameId`{{optional_inline}} + - : `integer`. Envoie le message Ă un cadre (_iframe_) spĂ©cifique identifiĂ©e par `frameId` au lieu de tous les cadres de l'onglet. Le fait que le script de contenu soit exĂ©cutĂ© dans tous les cadres dĂ©pend du paramĂštre `all_frames` dans la section [`content_scripts`](/fr/Add-ons/WebExtensions/manifest.json/content_scripts) de manifest.json. -<h2 id="Exemples">Exemples</h2> +### Valeur renvoyĂ©e -<p>Voici un exemple de script d'arriĂšre plan qui envoi un message au script de contenu qui s'execute dans l'onglet actif quand le client clique sur l'icone de l'extension. Le script d'arriĂšre plan s'attend Ă©galement que le script de contenu lui renvoit une rĂ©ponse:</p> +Un objet [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rempli avec une rĂ©ponse objet au format JSON envoyĂ© par le gestionnaire de message dans le script de contenu, ou sans arguments si le script de contenu n'a pas renvoyĂ© de rĂ©ponses. Si une erreur survient durant la connexion avec l'onglet spĂ©cifiĂ©, ou si n'importe quelle erreur survient, la promesse sera rejetĂ© avec un message d'erreur. Si plusieurs trames rĂ©pondent au message, la promesse est rĂ©solue en une des rĂ©ponses -<pre class="brush: js">// background-script.js +## Exemples + +Voici un exemple de script d'arriĂšre plan qui envoi un message au script de contenu qui s'execute dans l'onglet actif quand le client clique sur l'icone de l'extension. Le script d'arriĂšre plan s'attend Ă©galement que le script de contenu lui renvoit une rĂ©ponse: + +```js +// background-script.js "use strict"; function onError(error) { @@ -75,46 +66,47 @@ function sendMessageToTabs(tabs) { browser.tabs.sendMessage( tab.id, {greeting: "Hi from background script"} - ).then(response => { + ).then(response => { console.log("Message from the content script:"); console.log(response.response); }).catch(onError); } } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { browser.tabs.query({ currentWindow: true, active: true }).then(sendMessageToTabs).catch(onError); -});</pre> +}); +``` -<p>Voici le script de contenu associĂ©:</p> +Voici le script de contenu associĂ©: -<pre class="brush: js">// content-script.js +```js +// content-script.js "use strict"; -browser.runtime.onMessage.addListener(request => { +browser.runtime.onMessage.addListener(request => { console.log("Message from the background script:"); console.log(request.greeting); return Promise.resolve({response: "Hi from content script"}); -});</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatiblitĂ©_des_navigateurs">CompatiblitĂ© des navigateurs</h2> +}); +``` -<p>{{Compat("webextensions.api.tabs.sendMessage")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatiblitĂ© des navigateurs -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.sendMessage")}} -<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.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -141,5 +133,4 @@ browser.runtime.onMessage.addListener(request => { // 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/tabs/sendrequest/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.md index a1c4fea52c..569d11ac9a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.md @@ -13,50 +13,45 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/sendRequest --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div class="warning"> -<p><strong>Attention :</strong> Cette mĂ©thode a Ă©tĂ© dĂ©prĂ©ciĂ©e. Utilisez {{WebExtAPIRef("tabs.sendMessage()")}} Ă la place.</p> -</div> +> **Attention :** Cette mĂ©thode a Ă©tĂ© dĂ©prĂ©ciĂ©e. Utilisez {{WebExtAPIRef("tabs.sendMessage()")}} Ă la place. -<p>Envoie une seule requĂȘte au(x) script(s) de contenu dans l'onglet spĂ©cifiĂ©, avec un rappel facultatif Ă exĂ©cuter lorsqu'une rĂ©ponse est renvoyĂ©e. L'Ă©vĂ©nement {{WebExtAPIRef('extension.onRequest')}} est dĂ©clenchĂ© dans chaque script de contenu exĂ©cutĂ© dans l'onglet spĂ©cifiĂ© pour l'extension en cours.</p> +Envoie une seule requĂȘte au(x) script(s) de contenu dans l'onglet spĂ©cifiĂ©, avec un rappel facultatif Ă exĂ©cuter lorsqu'une rĂ©ponse est renvoyĂ©e. L'Ă©vĂ©nement {{WebExtAPIRef('extension.onRequest')}} est dĂ©clenchĂ© dans chaque script de contenu exĂ©cutĂ© dans l'onglet spĂ©cifiĂ© pour l'extension en cours. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 sending = browser.tabs.sendRequest( +```js +var sending = browser.tabs.sendRequest( tabId, // integer request // any ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>.</dd> - <dt><code>request</code></dt> - <dd><code>any</code>.</dd> -</dl> +- `tabId` + - : `integer`. +- `request` + - : `any`. -<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 l'objet de rĂ©ponse JSON envoyĂ© par le gestionnaire du message dans le script de contenu, ou sans arguments si le script de contenu n'a pas envoyĂ© de rĂ©ponse. Si une erreur survient lors de la connexion Ă l'onglet spĂ©cifiĂ© ou si une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec l'objet de rĂ©ponse JSON envoyĂ© par le gestionnaire du message dans le script de contenu, ou sans arguments si le script de contenu n'a pas envoyĂ© de rĂ©ponse. Si une erreur survient lors de la connexion Ă l'onglet spĂ©cifiĂ© ou si une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.sendRequest")}}</p> +{{Compat("webextensions.api.tabs.sendRequest")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur lâAPI [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -83,5 +78,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/sendRequest // 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/tabs/setzoom/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoom/index.md index e8d668c96f..239e6c94a3 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoom/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoom/index.md @@ -13,68 +13,69 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/setZoom --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Effectue un zoom sur l'onglet spĂ©cifiĂ©.</p> +Effectue un zoom sur l'onglet spĂ©cifiĂ©. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 zooming = browser.tabs.setZoom( +```js +var zooming = browser.tabs.setZoom( tabId, // optional integer zoomFactor // number ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet Ă zoomer. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours.</dd> - <dt><code>zoomFactor</code></dt> - <dd><code>number</code>. Le nouveau facteur de zoom. Utilisez une valeur de 0 ici pour rĂ©gler l'onglet Ă son facteur de zoom par dĂ©faut actuel. Sinon, il doit s'agir d'un nombre compris entre 0,3 et 3, en spĂ©cifiant un facteur de zoom.</dd> -</dl> +- `tabId`{{optional_inline}} + - : `integer`. L'ID de l'onglet Ă zoomer. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours. +- `zoomFactor` + - : `number`. Le nouveau facteur de zoom. Utilisez une valeur de 0 ici pour rĂ©gler l'onglet Ă son facteur de zoom par dĂ©faut actuel. Sinon, il doit s'agir d'un nombre compris entre 0,3 et 3, en spĂ©cifiant un facteur de zoom. -<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> cela sera accompli sans arguments aprĂšs que le facteur de zoom ait Ă©tĂ© changĂ©. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) cela sera accompli sans arguments aprĂšs que le facteur de zoom ait Ă©tĂ© changĂ©. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Set the zoom factor for the current tab to 2:</p> +Set the zoom factor for the current tab to 2: -<pre class="brush: js">function onError(error) { +```js +function onError(error) { console.log(`Error: ${error}`); } var setting = browser.tabs.setZoom(2); -setting.then(null, onError);</pre> +setting.then(null, onError); +``` -<p>Set the zoom factor for the tab whose ID is 16 tab to 0.5:</p> +Set the zoom factor for the tab whose ID is 16 tab to 0.5: -<pre class="brush: js">function onError(error) { +```js +function onError(error) { console.log(`Error: ${error}`); } var setting = browser.tabs.setZoom(16, 0.5); -setting.then(null, onError);</pre> +setting.then(null, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.setZoom")}}</p> +{{Compat("webextensions.api.tabs.setZoom")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur lâAPI [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -101,5 +102,4 @@ setting.then(null, onError);</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/tabs/setzoomsettings/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.md index 626942a3fb..3e83c8f206 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.md @@ -13,38 +13,38 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/setZoomSettings --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit les paramĂštres de zoom pour l'onglet spĂ©cifiĂ©. Ces paramĂštres sont rĂ©initialisĂ©s aux paramĂštres par dĂ©faut lors de la navigation dans l'onglet.</p> +DĂ©finit les paramĂštres de zoom pour l'onglet spĂ©cifiĂ©. Ces paramĂštres sont rĂ©initialisĂ©s aux paramĂštres par dĂ©faut lors de la navigation dans l'onglet. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 settingZoomSettings = browser.tabs.setZoomSettings( +```js +var settingZoomSettings = browser.tabs.setZoomSettings( tabId, // optional integer zoomSettings // ZoomSettings ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet pour modifier les paramĂštres de zoom pour. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours.</dd> - <dt><code>zoomSettings</code></dt> - <dd>{{WebExtAPIRef('tabs.ZoomSettings')}}. DĂ©finit comment les modifications de zoom sont gĂ©rĂ©es et Ă quelle portĂ©e.</dd> -</dl> +- `tabId`{{optional_inline}} + - : `integer`. L'ID de l'onglet pour modifier les paramĂštres de zoom pour. Par dĂ©faut Ă l'onglet actif de la fenĂȘtre en cours. +- `zoomSettings` + - : {{WebExtAPIRef('tabs.ZoomSettings')}}. DĂ©finit comment les modifications de zoom sont gĂ©rĂ©es et Ă quelle portĂ©e. -<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 sans arguments aprĂšs que les paramĂštres de zoom ont Ă©tĂ© modifiĂ©s. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments aprĂšs que les paramĂštres de zoom ont Ă©tĂ© modifiĂ©s. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>DĂ©sactiver le zoom pour l'onglet actuel :</p> +DĂ©sactiver le zoom pour l'onglet actuel : -<pre class="brush: js">function onSet() { +```js +function onSet() { console.log(`Set zoom factor`); } @@ -53,23 +53,22 @@ function onError(error) { } var setting = browser.tabs.setZoomSettings({mode:"disabled"}); -setting.then(onSet, onError);</pre> +setting.then(onSet, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.setZoomSettings")}}</p> +{{Compat("webextensions.api.tabs.setZoomSettings")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur lâAPI [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -96,5 +95,4 @@ setting.then(onSet, onError);</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/tabs/show/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/show/index.md index 5f78d0937c..093c0593d2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/show/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/show/index.md @@ -12,35 +12,35 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/show --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Affiche un ou plusieurs onglets prĂ©cĂ©demment masquĂ©s par un appel Ă {{WebExtAPIRef("tabs.hide")}}.</p> +Affiche un ou plusieurs onglets prĂ©cĂ©demment masquĂ©s par un appel Ă {{WebExtAPIRef("tabs.hide")}}. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 showing = browser.tabs.show( +```js +var showing = browser.tabs.show( tabIds // integer or integer array ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabIds</code></dt> - <dd><code><code>integer</code></code> or <code><code>array</code></code> of <code><code>integer</code></code>. Les ID de l'onglet ou des onglets Ă afficher.</dd> -</dl> +- `tabIds` + - : `integer` or `array` of `integer`. Les ID de l'onglet ou des onglets Ă afficher. -<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 accomplie sans arguments. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera accomplie sans arguments. Si une erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Afficher un seul onglet :</p> +Afficher un seul onglet : -<pre class="brush: js">function onShown() { +```js +function onShown() { console.log(`Shown`); } @@ -48,11 +48,13 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.tabs.show(2).then(onShown, onError);</pre> +browser.tabs.show(2).then(onShown, onError); +``` -<p>Afficher plusieurs onglets :</p> +Afficher plusieurs onglets : -<pre class="brush: js">function onShown() { +```js +function onShown() { console.log(`Shown`); } @@ -60,10 +62,11 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.tabs.show([15, 14, 1]).then(onShown, onError);</pre> +browser.tabs.show([15, 14, 1]).then(onShown, onError); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.show")}}</p> +{{Compat("webextensions.api.tabs.show")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.md index b6f12e9c87..ce4ea87b45 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.md @@ -13,88 +13,90 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/Tab --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <strong><code>tabs.Tab</code></strong> contient des informations sur un onglet. Cela donne accĂšs Ă des informations sur le contenu de l'onglet, la taille du contenu, les Ă©tats spĂ©ciaux ou les restrictions en vigueur, etc.</p> +Le type **`tabs.Tab`** contient des informations sur un onglet. Cela donne accĂšs Ă des informations sur le contenu de l'onglet, la taille du contenu, les Ă©tats spĂ©ciaux ou les restrictions en vigueur, etc. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>active</code></dt> - <dd><p><code>boolean</code>. Si l'onglet est actif dans sa fenĂȘtre. Ceci peut ĂȘtre vrai mĂȘme si la fenĂȘtre de l'onglet n'est pas actuellement focalisĂ©e.</p> - <p>L'onglet actif est gĂ©nĂ©ralement l'onglet sĂ©lectionnĂ©. Cependant, sur Firefox pour Android, les popups d'extension s'ouvrent dans un nouvel onglet. Lorsque cet onglet popup est sĂ©lectionnĂ©, l'onglet actif sera plutĂŽt celui dans lequel le popup s'est ouvert.</p></dd> - <dt><code>attention</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Indique si l'onglet attire l'attention. Par exemple, lorsque l'onglet affiche un dialogue modal, <code>attention</code> sera Ă <code>true</code>.</dd> - <dt><code>audible</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet n'est pas coupĂ©: si l'onglet produit du son. Si l'onglet est coupĂ©: si l'onglet produit un son, s'il n'est pas muet.</dd> - <dt><code>autoDiscardable</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet peut ĂȘtre supprimĂ© automatiquement par le navigateur lorsque les ressources sont faibles.</dd> - <dt><code>cookieStoreId</code> {{optional_inline}}</dt> - <dd><code>string</code>. Le magasin de cookies de l'onglet. Si diffĂ©rents onglets peuvent avoir diffĂ©rents magasins de cookies (par exemple, pour prendre en charge l'<a href="https://wiki.mozilla.org/Security/Contextual_Identity_Project/Containers">identitiĂ© contextuelle</a>), vous pouvez passer cette option <code>storeId</code> dans diffĂ©rentes mĂ©thodes de l'API {{WebExtAPIRef("cookies")}}, pour dĂ©finir et obtenir des cookies associĂ©s Ă Le magasin de cookies de cet onglet. Seulement prĂ©sent si l'extension a la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>"cookies".</code></dd> - <dt><code>discarded</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet est ignorĂ©. Un onglet supprimĂ© est celui dont le contenu a Ă©tĂ© dĂ©chargĂ© de la mĂ©moire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargĂ© la prochaine fois qu'il est activĂ©.</dd> - <dt><code>favIconUrl</code> {{optional_inline}}</dt> - <dd><code>string</code>. L'URL de la favicon de l'onglet. Seulement prĂ©sent si l'extension a la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>"tabs"</code>. Il peut Ă©galement s'agir d'une chaĂźne vide si l'onglet est en cours de chargement.</dd> - <dt><code>height</code> {{optional_inline}}</dt> - <dd><code>integer</code>. La hauteur de l'onglet en pixels.</dd> - <dt><code>hidden</code></dt> - <dd><code>boolean</code>. Si l'onglet est cachĂ©.</dd> - <dt><code>highlighted</code></dt> - <dd><p><code>boolean</code>. Si l'onglet est en surbrillance, c'est-Ă -dire une partie de la sĂ©lection de l'onglet en cours. Un onglet actif est toujours mis en surbrillance, mais certains navigateurs peuvent permettre de mettre en surbrillance des onglets supplĂ©mentaires, par exemple en cliquant dessus tout en maintenant les touches <kbd>Ctrl</kbd>, <kbd>Shift</kbd> ou <kbd>â Command</kbd> .</p> - <p>Firefox pour Android ne prend pas en charge la mise en surbrillance de plusieurs onglets, et le bureau Firefox nĂ©cessite la prĂ©fĂ©rence <code>browser.tabs.multiselect</code> (activĂ© par dĂ©faut).</p></dd> - <dt><code>id</code> {{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet. Les ID d'onglet sont uniques dans une session de navigateur. L'ID d'onglet peut Ă©galement ĂȘtre dĂ©fini sur {{WebExtAPIRef('tabs.TAB_ID_NONE')}} pour les fenĂȘtres de navigateur qui n'hĂ©bergent pas d'onglets de contenu (par exemple, les fenĂȘtres devtools).</dd> - <dt><code>incognito</code></dt> - <dd><code>boolean</code>. Si l'onglet est dans une fenĂȘtre de navigation privĂ©e.</dd> - <dt><code>index</code></dt> - <dd><code>integer</code>. L'indice de base zĂ©ro de l'onglet dans sa fenĂȘtre.</dd> - <dt><code>isArticle</code></dt> - <dd><code>boolean</code>. Vrai si l'onglet peut ĂȘtre <a href="/fr/Add-ons/WebExtensions/API/tabs/toggleReaderMode">rendu en mode lecteur</a>, sinon faux.</dd> - <dt><code>isInReaderMode</code></dt> - <dd><code>boolean</code>. Vrai si l'onglet en cours de <a href="/fr/Add-ons/WebExtensions/API/tabs/toggleReaderMode">rendu en mode lecteur</a>, sinon faux.</dd> - <dt><code>lastAccessed</code></dt> - <dd><code>double</code>. Heure Ă laquelle l'onglet a Ă©tĂ© accĂ©dĂ© pour la derniĂšre fois, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>mutedInfo</code> {{optional_inline}}</dt> - <dd>{{WebExtAPIRef('tabs.MutedInfo')}}. L'Ă©tat en sourdine actuel pour l'onglet et la raison du dernier changement d'Ă©tat.</dd> - <dt><code>openerTabId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet qui a ouvert cet onglet, le cas Ă©chĂ©ant. Cette propriĂ©tĂ© n'est prĂ©sente que si l'onglet d'ouverture existe toujours.</dd> - <dt><code>pinned</code></dt> - <dd><code>boolean</code>. Si l'onglet est Ă©pinglĂ©.</dd> - <dt><code>selected</code> {{deprecated_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet est sĂ©lectionnĂ©. Cette propriĂ©tĂ© a Ă©tĂ© remplacĂ©e par <code>active</code> et <code>highlighted</code>.</dd> - <dt><code>sessionId</code> {{optional_inline}}</dt> - <dd><code>string</code>. L'identifiant de session utilisĂ© pour identifier de façon unique un <code>onglet</code> obtenu Ă partir de l'API {{WebExtAPIRef('sessions')}}.</dd> - <dt><code>status</code> {{optional_inline}}</dt> - <dd><code>string</code>. Soit <em>charger</em> ou <em>complĂ©ter</em>.</dd> - <dt><code>successorId</code> {{optional_inline}}</dt> - <dd><code>integer</code> L'ID du successeur de l'onglet.</dd> - <dt><code>title</code> {{optional_inline}}</dt> - <dd><code>string</code>. Le titre de l'onglet. Seulement prĂ©sent si l'extension Ă la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>"tabs".</code></dd> - <dt><code>url</code> {{optional_inline}}</dt> - <dd><code>string</code>. L'URL du document que l'onglet affiche. Seulement prĂ©sent si l'extension Ă la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> <code>"tabs"</code>.</dd> - <dt><code>width</code> {{optional_inline}}</dt> - <dd><code>integer</code>. La largeur de l'onglet en pixels</dd> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. L'ID de la fenĂȘtre qui hĂ©berge cet onglet.**</dd> -</dl> +- `active` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : `boolean`. Si l'onglet est actif dans sa fenĂȘtre. Ceci peut ĂȘtre vrai mĂȘme si la fenĂȘtre de l'onglet n'est pas actuellement focalisĂ©e. -<p>{{Compat("webextensions.api.tabs.Tab", 10)}}</p> + L'onglet actif est gĂ©nĂ©ralement l'onglet sĂ©lectionnĂ©. Cependant, sur Firefox pour Android, les popups d'extension s'ouvrent dans un nouvel onglet. Lorsque cet onglet popup est sĂ©lectionnĂ©, l'onglet actif sera plutĂŽt celui dans lequel le popup s'est ouvert. -<p>{{WebExtExamples}}</p> +- `attention` {{optional_inline}} + - : `boolean`. Indique si l'onglet attire l'attention. Par exemple, lorsque l'onglet affiche un dialogue modal, `attention` sera Ă `true`. +- `audible` {{optional_inline}} + - : `boolean`. Si l'onglet n'est pas coupĂ©: si l'onglet produit du son. Si l'onglet est coupĂ©: si l'onglet produit un son, s'il n'est pas muet. +- `autoDiscardable` {{optional_inline}} + - : `boolean`. Si l'onglet peut ĂȘtre supprimĂ© automatiquement par le navigateur lorsque les ressources sont faibles. +- `cookieStoreId` {{optional_inline}} + - : `string`. Le magasin de cookies de l'onglet. Si diffĂ©rents onglets peuvent avoir diffĂ©rents magasins de cookies (par exemple, pour prendre en charge l'[identitiĂ© contextuelle](https://wiki.mozilla.org/Security/Contextual_Identity_Project/Containers)), vous pouvez passer cette option `storeId` dans diffĂ©rentes mĂ©thodes de l'API {{WebExtAPIRef("cookies")}}, pour dĂ©finir et obtenir des cookies associĂ©s Ă Le magasin de cookies de cet onglet. Seulement prĂ©sent si l'extension a la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `"cookies".` +- `discarded` {{optional_inline}} + - : `boolean`. Si l'onglet est ignorĂ©. Un onglet supprimĂ© est celui dont le contenu a Ă©tĂ© dĂ©chargĂ© de la mĂ©moire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargĂ© la prochaine fois qu'il est activĂ©. +- `favIconUrl` {{optional_inline}} + - : `string`. L'URL de la favicon de l'onglet. Seulement prĂ©sent si l'extension a la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `"tabs"`. Il peut Ă©galement s'agir d'une chaĂźne vide si l'onglet est en cours de chargement. +- `height` {{optional_inline}} + - : `integer`. La hauteur de l'onglet en pixels. +- `hidden` + - : `boolean`. Si l'onglet est cachĂ©. +- `highlighted` -<div class="note"><p><strong>Note :</strong></p> + - : `boolean`. Si l'onglet est en surbrillance, c'est-Ă -dire une partie de la sĂ©lection de l'onglet en cours. Un onglet actif est toujours mis en surbrillance, mais certains navigateurs peuvent permettre de mettre en surbrillance des onglets supplĂ©mentaires, par exemple en cliquant dessus tout en maintenant les touches <kbd>Ctrl</kbd>, <kbd>Shift</kbd> ou <kbd>â Command</kbd> . -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> + Firefox pour Android ne prend pas en charge la mise en surbrillance de plusieurs onglets, et le bureau Firefox nĂ©cessite la prĂ©fĂ©rence `browser.tabs.multiselect` (activĂ© par dĂ©faut). -<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> +- `id` {{optional_inline}} + - : `integer`. L'ID de l'onglet. Les ID d'onglet sont uniques dans une session de navigateur. L'ID d'onglet peut Ă©galement ĂȘtre dĂ©fini sur {{WebExtAPIRef('tabs.TAB_ID_NONE')}} pour les fenĂȘtres de navigateur qui n'hĂ©bergent pas d'onglets de contenu (par exemple, les fenĂȘtres devtools). +- `incognito` + - : `boolean`. Si l'onglet est dans une fenĂȘtre de navigation privĂ©e. +- `index` + - : `integer`. L'indice de base zĂ©ro de l'onglet dans sa fenĂȘtre. +- `isArticle` + - : `boolean`. Vrai si l'onglet peut ĂȘtre [rendu en mode lecteur](/fr/Add-ons/WebExtensions/API/tabs/toggleReaderMode), sinon faux. +- `isInReaderMode` + - : `boolean`. Vrai si l'onglet en cours de [rendu en mode lecteur](/fr/Add-ons/WebExtensions/API/tabs/toggleReaderMode), sinon faux. +- `lastAccessed` + - : `double`. Heure Ă laquelle l'onglet a Ă©tĂ© accĂ©dĂ© pour la derniĂšre fois, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `mutedInfo` {{optional_inline}} + - : {{WebExtAPIRef('tabs.MutedInfo')}}. L'Ă©tat en sourdine actuel pour l'onglet et la raison du dernier changement d'Ă©tat. +- `openerTabId` {{optional_inline}} + - : `integer`. L'ID de l'onglet qui a ouvert cet onglet, le cas Ă©chĂ©ant. Cette propriĂ©tĂ© n'est prĂ©sente que si l'onglet d'ouverture existe toujours. +- `pinned` + - : `boolean`. Si l'onglet est Ă©pinglĂ©. +- `selected` {{deprecated_inline}} + - : `boolean`. Si l'onglet est sĂ©lectionnĂ©. Cette propriĂ©tĂ© a Ă©tĂ© remplacĂ©e par `active` et `highlighted`. +- `sessionId` {{optional_inline}} + - : `string`. L'identifiant de session utilisĂ© pour identifier de façon unique un `onglet` obtenu Ă partir de l'API {{WebExtAPIRef('sessions')}}. +- `status` {{optional_inline}} + - : `string`. Soit _charger_ ou _complĂ©ter_. +- `successorId` {{optional_inline}} + - : `integer` L'ID du successeur de l'onglet. +- `title` {{optional_inline}} + - : `string`. Le titre de l'onglet. Seulement prĂ©sent si l'extension Ă la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) `"tabs".` +- `url` {{optional_inline}} + - : `string`. L'URL du document que l'onglet affiche. Seulement prĂ©sent si l'extension Ă la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) `"tabs"`. +- `width` {{optional_inline}} + - : `integer`. La largeur de l'onglet en pixels +- `windowId` + - : `integer`. L'ID de la fenĂȘtre qui hĂ©berge cet onglet.\*\* -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.tabs.Tab", 10)}} + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 +123,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/Tab // 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/tabs/tab_id_none/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.md index 9ba6040cd2..c36e6c3fb4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.md @@ -13,25 +13,23 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/TAB_ID_NONE --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Une valeur d'ID spĂ©ciale donnĂ©e aux onglets qui ne sont pas des onglets du navigateur (par exemple, des onglets dans les fenĂȘtres devtools).</p> +Une valeur d'ID spĂ©ciale donnĂ©e aux onglets qui ne sont pas des onglets du navigateur (par exemple, des onglets dans les fenĂȘtres devtools). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.TAB_ID_NONE")}}</p> +{{Compat("webextensions.api.tabs.TAB_ID_NONE")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#property-TAB_ID_NONE). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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/tabs#property-TAB_ID_NONE"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -58,5 +56,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/TAB_ID_NONE // 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/tabs/tabstatus/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.md index 3ed5059c4e..74e5f97032 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.md @@ -13,29 +13,27 @@ tags: - tazbs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/TabStatus --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Indique si l'onglet a terminĂ© le chargement.</p> +Indique si l'onglet a terminĂ© le chargement. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : <code>"loading"</code> et <code>"complete"</code>.</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : `"loading"` et `"complete"`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.TabStatus")}}</p> +{{Compat("webextensions.api.tabs.TabStatus")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -62,5 +60,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/TabStatus // 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/tabs/togglereadermode/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/togglereadermode/index.md index 75547d51f4..a858679aad 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/togglereadermode/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/togglereadermode/index.md @@ -12,68 +12,66 @@ tags: - toogleReaderMode translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/toggleReaderMode --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Bascule en mode Lecteur pour l'onglet donnĂ©.</p> +Bascule en mode Lecteur pour l'onglet donnĂ©. -<ul> -</ul> +Cette fonction permet de basculer en mode Lecteur pour l'onglet donnĂ©. Il prend un identifiant de tabulation en tant que paramĂštre: s'il est omis, l'onglet actuellement actif est basculĂ©. -<p>Cette fonction permet de basculer en mode Lecteur pour l'onglet donnĂ©. Il prend un identifiant de tabulation en tant que paramĂštre: s'il est omis, l'onglet actuellement actif est basculĂ©.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +Le mode Lecteur, Ă©galement connu sous le nom de Reader View, est une fonction de navigateur qui permet Ă l'utilisateur de se concentrer plus facilement sur un article en : -<p>Le mode Lecteur, Ă©galement connu sous le nom de Reader View, est une fonction de navigateur qui permet Ă l'utilisateur de se concentrer plus facilement sur un article en :</p> +- masquage d'Ă©lĂ©ments de page non essentiels, tels que des encadrĂ©s, des bas de page et des annonces +- changer la taille du texte de la page, le contraste et la disposition pour une meilleure lisibilitĂ©. -<ul> - <li>masquage d'Ă©lĂ©ments de page non essentiels, tels que des encadrĂ©s, des bas de page et des annonces</li> - <li>changer la taille du texte de la page, le contraste et la disposition pour une meilleure lisibilitĂ©.</li> -</ul> +Le mode Lecteur est utile spĂ©cifiquement pour les articles: c'est-Ă -dire, les pages qui ont un corps de texte comme caractĂ©ristique principale. Les pages qui n'ont pas d'article identifiable ne peuvent pas ĂȘtre affichĂ©es en mode Lecteur. Pour savoir si une page est un article, vĂ©rifiez la propriĂ©tĂ© `isArticle` de {{WebExtAPIRef("tabs.Tab")}}. -<p>Le mode Lecteur est utile spĂ©cifiquement pour les articles: c'est-Ă -dire, les pages qui ont un corps de texte comme caractĂ©ristique principale. Les pages qui n'ont pas d'article identifiable ne peuvent pas ĂȘtre affichĂ©es en mode Lecteur. Pour savoir si une page est un article, vĂ©rifiez la propriĂ©tĂ© <code>isArticle</code> de {{WebExtAPIRef("tabs.Tab")}}.</p> +Pour savoir si un onglet est dĂ©jĂ en mode Lecteur, vĂ©rifiez la propriĂ©tĂ©Â `isInReaderMode` de {{WebExtAPIRef("tabs.Tab")}}. Pour suivre les onglets entrant ou sortant du mode Lecteur, vous devez suivre l'Ă©tat actuel de tous les onglets et vĂ©rifier quand `isInReaderMode` change : -<p>Pour savoir si un onglet est dĂ©jĂ en mode Lecteur, vĂ©rifiez la propriĂ©tĂ©Â <code>isInReaderMode</code> de {{WebExtAPIRef("tabs.Tab")}}. Pour suivre les onglets entrant ou sortant du mode Lecteur, vous devez suivre l'Ă©tat actuel de tous les onglets et vĂ©rifier quand <code>isInReaderMode</code> change :</p> - -<pre class="brush: js">function handleUpdated(tabId, changeInfo, tabInfo) { +```js +function handleUpdated(tabId, changeInfo, tabInfo) { if (changeInfo.status === "complete") { console.log(`Tab ${tabId} reader mode: ${tabInfo.isInReaderMode}`); } } -browser.tabs.onUpdated.addListener(handleUpdated);</pre> +browser.tabs.onUpdated.addListener(handleUpdated); +``` -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var toggling = browser.tabs.toggleReaderMode( +```js +var toggling = browser.tabs.toggleReaderMode( tabId // optional integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet Ă afficher en mode Lecteur. Par dĂ©faut Ă l'onglet sĂ©lectionnĂ© de la fenĂȘtre en cours.</dd> -</dl> +- `tabId`{{optional_inline}} + - : `integer`. L'ID de l'onglet Ă afficher en mode Lecteur. Par dĂ©faut Ă l'onglet sĂ©lectionnĂ© de la fenĂȘtre en cours. -<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 sans argument lorsque l'onglet a Ă©tĂ© mis Ă jour. Si une erreur se produit (par exemple, parce que la page n'Ă©tait pas un article), la promesse sera rejetĂ©e avec un message d'erreur..</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans argument lorsque l'onglet a Ă©tĂ© mis Ă jour. Si une erreur se produit (par exemple, parce que la page n'Ă©tait pas un article), la promesse sera rejetĂ©e avec un message d'erreur.. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code bascule chaque nouvelle page en mode lecteur, si cette page est Ă©ligible pour cela :</p> +Ce code bascule chaque nouvelle page en mode lecteur, si cette page est Ă©ligible pour cela : -<pre class="brush: js">function switchToReaderMode(tabId, changeInfo, tabInfo) { +```js +function switchToReaderMode(tabId, changeInfo, tabInfo) { if (changeInfo.isArticle) { browser.tabs.toggleReaderMode(tabId); } } -browser.tabs.onUpdated.addListener(switchToReaderMode);</pre> +browser.tabs.onUpdated.addListener(switchToReaderMode); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.toggleReaderMode")}}</p> +{{Compat("webextensions.api.tabs.toggleReaderMode")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.md index 76f37e6a2f..4f5cffe7e2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.md @@ -13,79 +13,83 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/update --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Parcourez l'onglet vers une nouvelle URL ou modifiez d'autres propriĂ©tĂ©s de l'onglet.</p> +Parcourez l'onglet vers une nouvelle URL ou modifiez d'autres propriĂ©tĂ©s de l'onglet. -<p>Pour utiliser cette fonction, transmettez l'ID de l'onglet Ă mettre Ă jour et un objet <code>updateProperties</code> contenant les propriĂ©tĂ©s que vous souhaitez mettre Ă jour. Les propriĂ©tĂ©s qui ne sont pas spĂ©cifiĂ©es dans <code>updateProperties</code> ne sont pas modifiĂ©es.</p> +Pour utiliser cette fonction, transmettez l'ID de l'onglet Ă mettre Ă jour et un objet `updateProperties` contenant les propriĂ©tĂ©s que vous souhaitez mettre Ă jour. Les propriĂ©tĂ©s qui ne sont pas spĂ©cifiĂ©es dans `updateProperties` ne sont pas modifiĂ©es. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 updating = browser.tabs.update( +```js +var updating = browser.tabs.update( tabId, // optional integer updateProperties // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Par dĂ©faut Ă l'onglet sĂ©lectionnĂ© de la fenĂȘtre en cours.</dd> - <dt><code>updateProperties</code></dt> - <dd><p><code>object</code>. L'ensemble des propriĂ©tĂ©s Ă mettre Ă jour pour cet onglet. Pour en savoir plus sur ces propriĂ©tĂ©s, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}.</p> - <dl> - <dt><code>active</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet doit devenir actif. Ne modifie pas le focus de la fenĂȘtre (voir {{WebExtAPIRef('windows.update')}}). Si <code>true</code>, les onglets surlignĂ©s non actifs cesseront d'ĂȘtre surlignĂ©s. Si <code>false</code>, ne fait rien.</dd> - <dt><code>autoDiscardable</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet doit ĂȘtre supprimĂ© automatiquement par le navigateur lorsque les ressources sont faibles.</dd> - <dt><code>highlighted</code>{{optional_inline}}</dt> - <dd><p><code>boolean</code>. Ajoute ou supprime l'onglet de la sĂ©lection courante. Si <code>true</code> et que l'onglet n'est pas surlignĂ©, il deviendra actif par dĂ©faut.</p> - <p>Si vous voulez seulement mettre en surbrillance l'onglet sans l'activer, Firefox accepte le rĂ©glage <code>highlighted</code> Ă <code>true</code> et <code>active</code> Ă <code>false</code>. D'autres navigateurs peuvent activer l'onglet mĂȘme dans ce cas.</p> - </dd> - <dt><code>loadReplace</code>{{optional_inline}}</dt> - <dd> - <p><code>boolean</code>. Si la nouvelle URL doit remplacer l'ancienne URL dans l'historique de navigation de l'onglet, accessible via le bouton "Retour".</p> - - <p>Par exemple, supposons que l'utilisateur crĂ©e un nouvel onglet en utilisant Ctrl + T. Par dĂ©faut, dans Firefox, cela chargerait "about:newtab". Si votre extension met alors Ă jour cette page en utilisant {{WebExtAPIRef("tabs.update")}}, sans <code>loadReplace</code>, le bouton "retour" sera activĂ© et ramĂšnera l'utilisateur Ă "about:newtab". Si l'extension dĂ©finit <code>loadReplace</code>, le bouton "retour" sera dĂ©sactivĂ© et ce sera comme si l'URL fournie par l'extension Ă©tait la premiĂšre page visitĂ©e dans cet onglet.</p> - - <p>Notez cependant que l'URL d'origine apparaĂźtra toujours dans l'historique global du navigateur.</p> - </dd> - <dt><code>muted</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet doit ĂȘtre coupĂ©.</dd> - <dt><code>openerTabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de l'onglet qui a ouvert cet onglet. Si spĂ©cifiĂ©, l'onglet d'ouverture doit ĂȘtre dans la mĂȘme fenĂȘtre que cet onglet.</dd> - <dt><code>pinned</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet doit ĂȘtre Ă©pinglĂ©.</dd> - <dt><code>selected</code> {{deprecated_inline}} {{optional_inline}}</dt> - <dd><code>boolean</code>. Si l'onglet doit ĂȘtre sĂ©lectionnĂ©. Cette propriĂ©tĂ© a Ă©tĂ© remplacĂ©e par <code>active</code> et <code>highlighted</code>.</dd> - <dt><code>successorTabId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. L'identifiant de l'ID du successeur de l'onglet.</dd> - <dt><code>url</code>{{optional_inline}}</dt> - <dd><p><code>string</code>. Une URL pour naviguer dans l'onglet.</p><p>Pour des raisons de sĂ©curitĂ©, dans Firefox, il se peut que ce ne soit pas une URL privilĂ©giĂ©e. Le passage de l'une des URL suivantes Ă©chouera, avec {{WebExtAPIRef("runtime.lastError")}} Ă©tant dĂ©fini sur un message d'erreur :</p> - <ul> - <li>chrome: URLs</li> - <li>javascript: URLs</li> - <li>data: URLs</li> - <li>file: URLs (c'est-Ă -dire, fichiers sur le systĂšme de fichiers, cependant, pour utiliser un fichier empaquetĂ© Ă l'intĂ©rieur de l'extension, voir ci-dessous)</li> - <li>confidentiel : URLs (par exemle, <code>about:config</code>, <code>about:addons</code>, <code>about:debugging</code>, <code>about:newtab</code>). Les URL non privilĂ©giĂ©es (par exemple, <code>about:blank</code>) sont autorisĂ©es.</li> - </ul> - <p>Pour charger une page fournie avec votre extension, spĂ©cifiez une URL absolue Ă partir du fichier manifest.json de l'extension. Par exemple : '/path/to/my-page.html'. Si vous omettez le premier caractĂšre '/', l'URL est traitĂ©e comme une URL relative et diffĂ©rents navigateurs peuvent construire diffĂ©rentes URL absolues.</p></dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>A <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des dĂ©tails sur l'onglet mis Ă jour. L'objet {{WebExtAPIRef('tabs.Tab')}} ne contient pas d' <code>url</code>, <code>title</code> et <code>favIconUrl</code> sauf si la permission <code>"tabs"</code> a Ă©tĂ© demandĂ©e. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Naviguez dans l'onglet actif de la fenĂȘtre en cours pour https://developer.mozilla.org :</p> - -<pre class="brush: js">function onUpdated(tab) { +``` + +### ParamĂštres + +- `tabId`{{optional_inline}} + - : `integer`. Par dĂ©faut Ă l'onglet sĂ©lectionnĂ© de la fenĂȘtre en cours. +- `updateProperties` + + - : `object`. L'ensemble des propriĂ©tĂ©s Ă mettre Ă jour pour cet onglet. Pour en savoir plus sur ces propriĂ©tĂ©s, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}. + + - `active`{{optional_inline}} + - : `boolean`. Si l'onglet doit devenir actif. Ne modifie pas le focus de la fenĂȘtre (voir {{WebExtAPIRef('windows.update')}}). Si `true`, les onglets surlignĂ©s non actifs cesseront d'ĂȘtre surlignĂ©s. Si `false`, ne fait rien. + - `autoDiscardable`{{optional_inline}} + - : `boolean`. Si l'onglet doit ĂȘtre supprimĂ© automatiquement par le navigateur lorsque les ressources sont faibles. + - `highlighted`{{optional_inline}} + + - : `boolean`. Ajoute ou supprime l'onglet de la sĂ©lection courante. Si `true` et que l'onglet n'est pas surlignĂ©, il deviendra actif par dĂ©faut. + + Si vous voulez seulement mettre en surbrillance l'onglet sans l'activer, Firefox accepte le rĂ©glage `highlighted` Ă `true` et `active` Ă `false`. D'autres navigateurs peuvent activer l'onglet mĂȘme dans ce cas. + + - `loadReplace`{{optional_inline}} + + - : `boolean`. Si la nouvelle URL doit remplacer l'ancienne URL dans l'historique de navigation de l'onglet, accessible via le bouton "Retour". + + Par exemple, supposons que l'utilisateur crĂ©e un nouvel onglet en utilisant Ctrl + T. Par dĂ©faut, dans Firefox, cela chargerait "about:newtab". Si votre extension met alors Ă jour cette page en utilisant {{WebExtAPIRef("tabs.update")}}, sans `loadReplace`, le bouton "retour" sera activĂ© et ramĂšnera l'utilisateur Ă "about:newtab". Si l'extension dĂ©finit `loadReplace`, le bouton "retour" sera dĂ©sactivĂ© et ce sera comme si l'URL fournie par l'extension Ă©tait la premiĂšre page visitĂ©e dans cet onglet. + + Notez cependant que l'URL d'origine apparaĂźtra toujours dans l'historique global du navigateur. + + - `muted`{{optional_inline}} + - : `boolean`. Si l'onglet doit ĂȘtre coupĂ©. + - `openerTabId`{{optional_inline}} + - : `integer`. L'ID de l'onglet qui a ouvert cet onglet. Si spĂ©cifiĂ©, l'onglet d'ouverture doit ĂȘtre dans la mĂȘme fenĂȘtre que cet onglet. + - `pinned`{{optional_inline}} + - : `boolean`. Si l'onglet doit ĂȘtre Ă©pinglĂ©. + - `selected` {{deprecated_inline}} {{optional_inline}} + - : `boolean`. Si l'onglet doit ĂȘtre sĂ©lectionnĂ©. Cette propriĂ©tĂ© a Ă©tĂ© remplacĂ©e par `active` et `highlighted`. + - `successorTabId` {{optional_inline}} + - : `integer`. L'identifiant de l'ID du successeur de l'onglet. + - `url`{{optional_inline}} + + - : `string`. Une URL pour naviguer dans l'onglet. + + Pour des raisons de sĂ©curitĂ©, dans Firefox, il se peut que ce ne soit pas une URL privilĂ©giĂ©e. Le passage de l'une des URL suivantes Ă©chouera, avec {{WebExtAPIRef("runtime.lastError")}} Ă©tant dĂ©fini sur un message d'erreur : + + - chrome: URLs + - javascript: URLs + - data: URLs + - file: URLs (c'est-Ă -dire, fichiers sur le systĂšme de fichiers, cependant, pour utiliser un fichier empaquetĂ© Ă l'intĂ©rieur de l'extension, voir ci-dessous) + - confidentiel : URLs (par exemle, `about:config`, `about:addons`, `about:debugging`, `about:newtab`). Les URL non privilĂ©giĂ©es (par exemple, `about:blank`) sont autorisĂ©es. + + Pour charger une page fournie avec votre extension, spĂ©cifiez une URL absolue Ă partir du fichier manifest.json de l'extension. Par exemple : '/path/to/my-page.html'. Si vous omettez le premier caractĂšre '/', l'URL est traitĂ©e comme une URL relative et diffĂ©rents navigateurs peuvent construire diffĂ©rentes URL absolues. + +### Valeur retournĂ©e + +A [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des dĂ©tails sur l'onglet mis Ă jour. L'objet {{WebExtAPIRef('tabs.Tab')}} ne contient pas d' `url`, `title` et `favIconUrl` sauf si la permission `"tabs"` a Ă©tĂ© demandĂ©e. Si l'onglet n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. + +## Exemples + +Naviguez dans l'onglet actif de la fenĂȘtre en cours pour https\://developer.mozilla.org : + +```js +function onUpdated(tab) { console.log(`Updated tab: ${tab.id}`); } @@ -94,11 +98,13 @@ function onError(error) { } var updating = browser.tabs.update({url: "https://developer.mozilla.org"}); -updating.then(onUpdated, onError);</pre> +updating.then(onUpdated, onError); +``` -<p>Activez le premier onglet de la fenĂȘtre actuelle et naviguez jusqu'Ă https://developer.mozilla.org:</p> +Activez le premier onglet de la fenĂȘtre actuelle et naviguez jusqu'Ă https\://developer.mozilla.org: -<pre class="brush: js">function onUpdated(tab) { +```js +function onUpdated(tab) { console.log(`Updated tab: ${tab.id}`); } @@ -115,23 +121,22 @@ function updateFirstTab(tabs) { } var querying = browser.tabs.query({currentWindow:true}); -querying.then(updateFirstTab, onError);</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +querying.then(updateFirstTab, onError); +``` -<p>{{Compat("webextensions.api.tabs.update", 10)}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur lâAPI <a href="https://developer.chrome.com/extensions/tabs#method-executeScript"><code>chrome.tabs</code></a> de Chromium. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.json</code></a> dans le code de Chromium code.</p> +{{Compat("webextensions.api.tabs.update", 10)}} -<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 [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript) de Chromium. Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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 @@ -158,5 +163,4 @@ querying.then(updateFirstTab, onError);</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/tabs/windowtype/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/windowtype/index.md index cfed6e3f85..0de32516db 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/windowtype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/windowtype/index.md @@ -13,36 +13,32 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/WindowType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type de fenĂȘtre qui hĂ©berge cet onglet.</p> +Le type de fenĂȘtre qui hĂ©berge cet onglet. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont:</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont: -<ul> - <li><strong>"normal"</strong></li> - <li><strong>"popup"</strong></li> - <li><strong>"panel"</strong></li> - <li><strong>"devtools"</strong></li> -</ul> +- **"normal"** +- **"popup"** +- **"panel"** +- **"devtools"** -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.WindowType")}}</p> +{{Compat("webextensions.api.tabs.WindowType")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -69,5 +65,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/WindowType // 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/tabs/zoomsettings/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.md index 2d32640a5b..9ac9f3c5a0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.md @@ -13,38 +13,34 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettings --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit les paramĂštres de zoom pour un onglet : {{WebExtAPIRef("tabs.ZoomSettingsMode", "mode")}}, {{WebExtAPIRef("tabs.ZoomSettingsScope", "scope")}}, et le facteur de zoom par dĂ©faut.</p> +DĂ©finit les paramĂštres de zoom pour un onglet : {{WebExtAPIRef("tabs.ZoomSettingsMode", "mode")}}, {{WebExtAPIRef("tabs.ZoomSettingsScope", "scope")}}, et le facteur de zoom par dĂ©faut. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>defaultZoomFactor</code>{{optional_inline}}</dt> - <dd><code>number</code>. Le niveau de zoom par dĂ©faut pour l'onglet actuel. Notez que ceci n'est utilisĂ© que dans {{WebExtAPIRef("tabs.getZoomSettings")}}.</dd> - <dt><code>mode</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('tabs.ZoomSettingsMode')}}. DĂ©finit si les modifications de zoom sont gĂ©rĂ©es par le navigateur, par l'extension ou dĂ©sactivĂ©es.</dd> - <dt><code>scope</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('tabs.ZoomSettingsScope')}}. DĂ©finit si les changements de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet.</dd> -</dl> +- `defaultZoomFactor`{{optional_inline}} + - : `number`. Le niveau de zoom par dĂ©faut pour l'onglet actuel. Notez que ceci n'est utilisĂ© que dans {{WebExtAPIRef("tabs.getZoomSettings")}}. +- `mode`{{optional_inline}} + - : {{WebExtAPIRef('tabs.ZoomSettingsMode')}}. DĂ©finit si les modifications de zoom sont gĂ©rĂ©es par le navigateur, par l'extension ou dĂ©sactivĂ©es. +- `scope`{{optional_inline}} + - : {{WebExtAPIRef('tabs.ZoomSettingsScope')}}. DĂ©finit si les changements de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.ZoomSettings")}}</p> +{{Compat("webextensions.api.tabs.ZoomSettings")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -71,5 +67,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettings // 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/tabs/zoomsettingsmode/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.md index e9122e79e3..376b590e21 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.md @@ -13,38 +13,34 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsMode --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit comment les modifications de zoom sont gĂ©rĂ©es. Les extensions peuvent transfĂ©rer cette valeur dans {{WebExtAPIRef("tabs.setZoomSettings()")}} pour contrĂŽler la façon dont le navigateur gĂšre les tentatives de modification des paramĂštres de zoom pour un onglet. Par dĂ©faut Ă "automatique".</p> +DĂ©finit comment les modifications de zoom sont gĂ©rĂ©es. Les extensions peuvent transfĂ©rer cette valeur dans {{WebExtAPIRef("tabs.setZoomSettings()")}} pour contrĂŽler la façon dont le navigateur gĂšre les tentatives de modification des paramĂštres de zoom pour un onglet. Par dĂ©faut Ă "automatique". -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<dl> - <dt>"automatic"</dt> - <dd>Les modifications de zoom sont gĂ©rĂ©es normalement par le navigateur.</dd> - <dt>"disabled"</dt> - <dd>DĂ©sactive tout zoom dans l'onglet. L'onglet revient au niveau de zoom par dĂ©faut, et toutes les modifications de zoom tentĂ©es seront ignorĂ©es.</dd> - <dt>"manual"</dt> - <dd>L'extension gĂšre elle-mĂȘme les changements de zoom, en Ă©coutant l'Ă©vĂ©nement {{WebExtAPIRef("tabs.onZoomChange")}} et en redimensionnant la page en consĂ©quence. Ce mode ne prend pas en charge le zoom <code>per-origin</code> : il ignore la <code>portĂ©e</code> {{WebExtAPIRef("tabs.zoomSettings", "zoom setting")}} et utilise toujours la fonction <code>per-tab</code>.</dd> -</dl> +- "automatic" + - : Les modifications de zoom sont gĂ©rĂ©es normalement par le navigateur. +- "disabled" + - : DĂ©sactive tout zoom dans l'onglet. L'onglet revient au niveau de zoom par dĂ©faut, et toutes les modifications de zoom tentĂ©es seront ignorĂ©es. +- "manual" + - : L'extension gĂšre elle-mĂȘme les changements de zoom, en Ă©coutant l'Ă©vĂ©nement {{WebExtAPIRef("tabs.onZoomChange")}} et en redimensionnant la page en consĂ©quence. Ce mode ne prend pas en charge le zoom `per-origin` : il ignore la `portĂ©e` {{WebExtAPIRef("tabs.zoomSettings", "zoom setting")}} et utilise toujours la fonction `per-tab`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.ZoomSettingsMode")}}</p> +{{Compat("webextensions.api.tabs.ZoomSettingsMode")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -71,5 +67,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsMode // 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/tabs/zoomsettingsscope/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.md index 19ea5f571a..9ec0f5db0a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.md @@ -13,36 +13,32 @@ tags: - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsScope --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©finit si les changements de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet. La valeur par dĂ©faut est Ă <code>per-origin</code> lorsque  {{WebExtAPIRef("tabs.zoomSettingsMode")}} est "automatique", et est toujours <code>per-tab</code>.</p> +DĂ©finit si les changements de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet. La valeur par dĂ©faut est Ă `per-origin` lorsque  {{WebExtAPIRef("tabs.zoomSettingsMode")}} est "automatique", et est toujours `per-tab`. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<dl> - <dt>"per-origin"</dt> - <dd>Tous les autres onglets ayant la mĂȘme origine que cet onglet auront les changements de zoom qui leur sont appliquĂ©s. Cette Ă©tendue n'est disponible que si if {{WebExtAPIRef("tabs.zoomSettingsMode")}} est "automatique".</dd> - <dt>"per-tab"</dt> - <dd>Les changements de zoom ne prennent effet que dans cet onglet et les changements de zoom dans les autres onglets n'affectent pas le zoom de cet onglet. De plus, les changements de zoom <code>per-tab</code> ont rĂ©initialisĂ©s lors de la navigation ; la navigation dans un onglet charge toujours les pages avec <code>per-origin</code> de zoom d'origine.</dd> -</dl> +- "per-origin" + - : Tous les autres onglets ayant la mĂȘme origine que cet onglet auront les changements de zoom qui leur sont appliquĂ©s. Cette Ă©tendue n'est disponible que si if {{WebExtAPIRef("tabs.zoomSettingsMode")}} est "automatique". +- "per-tab" + - : Les changements de zoom ne prennent effet que dans cet onglet et les changements de zoom dans les autres onglets n'affectent pas le zoom de cet onglet. De plus, les changements de zoom `per-tab` ont rĂ©initialisĂ©s lors de la navigation ; la navigation dans un onglet charge toujours les pages avec `per-origin` de zoom d'origine. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.tabs.ZoomSettingsScope")}}</p> +{{Compat("webextensions.api.tabs.ZoomSettingsScope")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.tabs`](https://developer.chrome.com/extensions/tabs#method-executeScript). Cette documentation est dĂ©rivĂ©e de [`tabs.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.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/tabs#method-executeScript"><code>chrome.tabs</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/tabs.json"><code>tabs.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 @@ -69,5 +65,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsScope // 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/theme/getcurrent/index.md b/files/fr/mozilla/add-ons/webextensions/api/theme/getcurrent/index.md index 9c71e2d90f..3e0395a07b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/theme/getcurrent/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/theme/getcurrent/index.md @@ -12,39 +12,39 @@ tags: - getCurrent translation_of: Mozilla/Add-ons/WebExtensions/API/theme/getCurrent --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Retourne le theme utilisĂ© actuellement sous la forme d'un objet {{WebExtAPIRef("theme.Theme", "Theme")}}. Les arguments disponible dans l'objet couleur sont listĂ©s dans les <a href="/fr/Add-ons/WebExtensions/manifest.json/theme#colors">propriĂ©tĂ©s de la couleur</a>.</p> +Retourne le theme utilisĂ© actuellement sous la forme d'un objet {{WebExtAPIRef("theme.Theme", "Theme")}}. Les arguments disponible dans l'objet couleur sont listĂ©s dans les [propriĂ©tĂ©s de la couleur](/fr/Add-ons/WebExtensions/manifest.json/theme#colors). -<p>Il s'agit d'une fonction asynchrone qui renvoie un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +Il s'agit d'une fonction asynchrone qui renvoie un objet [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var getting = browser.theme.getCurrent( - <em>windowId</em> // integer +```js +var getting = browser.theme.getCurrent( + windowId // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. L'ID d'une fenĂȘtre. Si cela est indiquĂ©, le thĂšme appliquĂ© sur cette fenĂȘtre sera retournĂ©. Sinon le thĂšme appliquĂ© sur la derniĂšre fenĂȘtre active sera retournĂ©.</dd> -</dl> +- `windowId` {{optional_inline}} + - : `integer`. L'ID d'une fenĂȘtre. Si cela est indiquĂ©, le thĂšme appliquĂ© sur cette fenĂȘtre sera retournĂ©. Sinon le thĂšme appliquĂ© sur la derniĂšre fenĂȘtre active sera retournĂ©. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p>Un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>. L'objet Promise sera rĂ©solu avec un objet {{WebExtAPIRef("theme.Theme")}} reprĂ©sentant le thĂšme appliquĂ© Ă la fenĂȘtre spĂ©cifiĂ©e. Si aucun thĂšme provenant d'une extension a Ă©tĂ© appliquĂ©, l'objet Promise sera rĂ©solu avec un objet vide.</p> +Un objet [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). L'objet Promise sera rĂ©solu avec un objet {{WebExtAPIRef("theme.Theme")}} reprĂ©sentant le thĂšme appliquĂ© Ă la fenĂȘtre spĂ©cifiĂ©e. Si aucun thĂšme provenant d'une extension a Ă©tĂ© appliquĂ©, l'objet Promise sera rĂ©solu avec un objet vide. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.theme.getCurrent", 10)}}</p> +{{Compat("webextensions.api.theme.getCurrent", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Obtient les propriĂ©tĂ©s des couleurs <code>accentcolor</code> et <code>toolbar</code> dans le thĂšme actuel.</p> +Obtient les propriĂ©tĂ©s des couleurs `accentcolor` et `toolbar` dans le thĂšme actuel. -<pre class="brush: js">function getStyle(themeInfo) +```js +function getStyle(themeInfo) { if (themeInfo.colors) { @@ -59,6 +59,7 @@ async function getCurrentThemeInfo() getStyle(themeInfo); } -getCurrentThemeInfo();</pre> +getCurrentThemeInfo(); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/theme/index.md b/files/fr/mozilla/add-ons/webextensions/api/theme/index.md index 96aaffe71b..ac00a54881 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/theme/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/theme/index.md @@ -8,43 +8,35 @@ tags: - add-on translation_of: Mozilla/Add-ons/WebExtensions/API/theme --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Permet aux extensions du navigateur de mettre Ă jour le thĂšme du navigateur.</p> +Permet aux extensions du navigateur de mettre Ă jour le thĂšme du navigateur. -<p>Pour utiliser cette API, une extension doit demander la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "theme" dans son fichier <a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a>.</p> +Pour utiliser cette API, une extension doit demander la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "theme" dans son fichier [manifest.json](/fr/Add-ons/WebExtensions/manifest.json). -<div class="note"> -<p><strong>Note :</strong> quand on met un thĂšme en arriĂšre plan, on doit dĂ©clarer la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> 'theme' et on ne peut pas utiliser la fonction <a href="/fr/Add-ons/WebExtensions/manifest.json/theme">theme</a> du manifest, puisque ce n'est pas compatible.</p> -</div> +> **Note :** quand on met un thĂšme en arriĂšre plan, on doit dĂ©clarer la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) 'theme' et on ne peut pas utiliser la fonction [theme](/fr/Add-ons/WebExtensions/manifest.json/theme) du manifest, puisque ce n'est pas compatible. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("theme.Theme")}}</dt> - <dd>ReprĂ©sente le contenu d'un thĂšme.</dd> -</dl> +- {{WebExtAPIRef("theme.Theme")}} + - : ReprĂ©sente le contenu d'un thĂšme. -<h2 id="Fonctions">Fonctions</h2> +## Fonctions -<dl> - <dt>{{WebExtAPIRef("theme.getCurrent()")}}</dt> - <dd>Retourne le thĂšme actuel du navigateur.</dd> - <dt>{{WebExtAPIRef("theme.update()")}}</dt> - <dd>Met Ă jour Ă le thĂšme du navigateur.</dd> - <dt>{{WebExtAPIRef("theme.reset()")}}</dt> - <dd>Supprime les mises Ă jour de thĂšmes effectuĂ©es lors d'un appel Ă {{WebExtAPIRef("theme.update()")}}.</dd> -</dl> +- {{WebExtAPIRef("theme.getCurrent()")}} + - : Retourne le thĂšme actuel du navigateur. +- {{WebExtAPIRef("theme.update()")}} + - : Met Ă jour Ă le thĂšme du navigateur. +- {{WebExtAPIRef("theme.reset()")}} + - : Supprime les mises Ă jour de thĂšmes effectuĂ©es lors d'un appel Ă {{WebExtAPIRef("theme.update()")}}. -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt>{{WebExtAPIRef("theme.onUpdated")}}</dt> - <dd>Emis quand le thĂšme du navigateur change.</dd> -</dl> +- {{WebExtAPIRef("theme.onUpdated")}} + - : Emis quand le thĂšme du navigateur change. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.theme")}}</p> +{{Compat("webextensions.api.theme")}} -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/theme/onupdated/index.md b/files/fr/mozilla/add-ons/webextensions/api/theme/onupdated/index.md index c6a9a680d7..d1f3a1d716 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/theme/onupdated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/theme/onupdated/index.md @@ -9,68 +9,58 @@ tags: - WebExtensions; translation_of: Mozilla/Add-ons/WebExtensions/API/theme/onUpdated --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'Ă©vĂ©nement se dĂ©clenche lorsqu'un thĂšme fourni en tant qu'extension de navigateur est appliquĂ© ou supprimĂ©, plus prĂ©cisĂ©ment :</p> +L'Ă©vĂ©nement se dĂ©clenche lorsqu'un thĂšme fourni en tant qu'extension de navigateur est appliquĂ© ou supprimĂ©, plus prĂ©cisĂ©ment : -<ul> - <li>Quand un <a href="/fr/Add-ons/Themes/Theme_concepts#Static_themes">thĂšme statique</a> est installĂ©</li> - <li>Quand un <a href="/fr/Add-ons/WebExtensions/API/theme">thĂšme dynamique </a>appelle <code><a href="/fr/Add-ons/WebExtensions/API/theme/update">theme.update()</a></code> ou <code><a href="/fr/Add-ons/WebExtensions/API/theme/update">theme.reset()</a></code></li> - <li>Quand un thĂšme est dĂ©sinstallĂ©</li> -</ul> +- Quand un [thĂšme statique](/fr/Add-ons/Themes/Theme_concepts#Static_themes) est installĂ© +- Quand un [thĂšme dynamique ](/fr/Add-ons/WebExtensions/API/theme)appelle [`theme.update()`](/fr/Add-ons/WebExtensions/API/theme/update) ou [`theme.reset()`](/fr/Add-ons/WebExtensions/API/theme/update) +- Quand un thĂšme est dĂ©sinstallĂ© -<p>Notez que cet Ă©vĂ©nement n'est pas dĂ©clenchĂ© pour les thĂšmes intĂ©grĂ©s.</p> +Notez que cet Ă©vĂ©nement n'est pas dĂ©clenchĂ© pour les thĂšmes intĂ©grĂ©s. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.theme.onUpdated.addListener(listener) +```js +browser.theme.onUpdated.addListener(listener) browser.theme.onUpdated.removeListener(listener) browser.theme.onUpdated.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +Les Ă©vĂ©nements ont trois fonctions : -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘte d'Ă©couter cet Ă©vĂ©nement. L'argument de <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Retourne <code>true</code> s'il Ă©coute, sinon <code>false</code>.</dd> -</dl> +- `addListener(listener)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘte d'Ă©couter cet Ă©vĂ©nement. L'argument de `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifie si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Retourne `true` s'il Ă©coute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les paramĂštres suivants :</p> +- `callback` - <dl> - <dt><code>updateInfo</code></dt> - <dd> - <p><code>object</code>. Un objet contenant deux propriĂ©tĂ©s :</p> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les paramĂštres suivants : - <dl> - <dt><code>theme</code></dt> - <dd><code>object</code>. Si l'Ă©vĂ©nement a Ă©tĂ© dĂ©clenchĂ© parce qu'un thĂšme fourni par une extension a Ă©tĂ© supprimĂ©, il s'agira d'un objet vide. Si il a Ă©tĂ© dĂ©clenchĂ© parce qu'un thĂšme fourni par une extension a Ă©tĂ© appliquĂ©, ce sera un objet {{WebExtAPIRef("theme.Theme")}} reprĂ©sentant le thĂšme qui a Ă©tĂ© appliquĂ©.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de la fenĂȘtre pour laquelle le thĂšme a Ă©tĂ© mis Ă jour. Si cette propriĂ©tĂ© n'est pas prĂ©sente, cela signifie que le thĂšme a Ă©tĂ© mise Ă jour globalement.</dd> - </dl> - </dd> - </dl> - </dd> -</dl> + - `updateInfo` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : `object`. Un objet contenant deux propriĂ©tĂ©s : -<p>{{Compat("webextensions.api.theme.onUpdated", 10)}}</p> + - `theme` + - : `object`. Si l'Ă©vĂ©nement a Ă©tĂ© dĂ©clenchĂ© parce qu'un thĂšme fourni par une extension a Ă©tĂ© supprimĂ©, il s'agira d'un objet vide. Si il a Ă©tĂ© dĂ©clenchĂ© parce qu'un thĂšme fourni par une extension a Ă©tĂ© appliquĂ©, ce sera un objet {{WebExtAPIRef("theme.Theme")}} reprĂ©sentant le thĂšme qui a Ă©tĂ© appliquĂ©. + - `windowId`{{optional_inline}} + - : `integer`. L'ID de la fenĂȘtre pour laquelle le thĂšme a Ă©tĂ© mis Ă jour. Si cette propriĂ©tĂ© n'est pas prĂ©sente, cela signifie que le thĂšme a Ă©tĂ© mise Ă jour globalement. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function handleUpdated(updateInfo) { +{{Compat("webextensions.api.theme.onUpdated", 10)}} + +## Exemples + +```js +function handleUpdated(updateInfo) { if (updateInfo.theme.colors) { console.log(`Theme was applied: ${updateInfo.theme}`); } else { @@ -78,6 +68,7 @@ browser.theme.onUpdated.hasListener(listener) } } -browser.theme.onUpdated.addListener(handleUpdated);</pre> +browser.theme.onUpdated.addListener(handleUpdated); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/theme/reset/index.md b/files/fr/mozilla/add-ons/webextensions/api/theme/reset/index.md index 2b56b92f49..df2bedd50f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/theme/reset/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/theme/reset/index.md @@ -12,42 +12,42 @@ tags: - reset translation_of: Mozilla/Add-ons/WebExtensions/API/theme/reset --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>RĂ©initialise tout thĂšme appliquĂ© Ă l'aide de la mĂ©thode {{WebExtAPIRef("theme.update()")}}</p> +RĂ©initialise tout thĂšme appliquĂ© Ă l'aide de la mĂ©thode {{WebExtAPIRef("theme.update()")}} -<p>Notez que cela rĂ©initialisera toujours le thĂšme au thĂšme par dĂ©faut d'origine, mĂȘme si l'utilisateur a sĂ©lectionnĂ© un thĂšme diffĂ©rent avant que le thĂšme de cette extension ait Ă©tĂ© appliquĂ© (voir <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1415267">bug 1415267</a>).</p> +Notez que cela rĂ©initialisera toujours le thĂšme au thĂšme par dĂ©faut d'origine, mĂȘme si l'utilisateur a sĂ©lectionnĂ© un thĂšme diffĂ©rent avant que le thĂšme de cette extension ait Ă©tĂ© appliquĂ© (voir [bug 1415267](https://bugzilla.mozilla.org/show_bug.cgi?id=1415267)). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.theme.reset( windowsId // integer ) -</pre> +```js +browser.theme.reset( windowsId // integer ) +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. L'ID d'une fenĂȘtre. Si cela est indiquĂ©, le thĂšme appliquĂ© sur cette fenĂȘtre sera rĂ©initialisĂ©. Sinon le thĂšme sera rĂ©initialisĂ© sur toutes les fenĂȘtres.</dd> -</dl> +- `windowId` {{optional_inline}} + - : `integer`. L'ID d'une fenĂȘtre. Si cela est indiquĂ©, le thĂšme appliquĂ© sur cette fenĂȘtre sera rĂ©initialisĂ©. Sinon le thĂšme sera rĂ©initialisĂ© sur toutes les fenĂȘtres. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.theme.reset")}}</p> +{{Compat("webextensions.api.theme.reset")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code applique un thĂšme, puis le supprime lorsque l'utilisateur clique sur une action du navigateur:</p> +Ce code applique un thĂšme, puis le supprime lorsque l'utilisateur clique sur une action du navigateur: -<pre class="brush: js">browser.theme.update(themes.night); +```js +browser.theme.update(themes.night); -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { browser.theme.reset(); -});</pre> +}); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<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 @@ -74,5 +74,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/theme/theme/index.md b/files/fr/mozilla/add-ons/webextensions/api/theme/theme/index.md index ee72779ebe..686bbd4f6e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/theme/theme/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/theme/theme/index.md @@ -8,16 +8,16 @@ tags: - add-on translation_of: Mozilla/Add-ons/WebExtensions/API/theme/Theme --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet thĂšme reprĂ©sente la spĂ©cification d'un thĂšme.</p> +Un objet thĂšme reprĂ©sente la spĂ©cification d'un thĂšme. -<h2 id="Type">Type</h2> +## Type -<p>Un <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Object">object</a> JSON qui prend les mĂȘmes propriĂ©tĂ©s que la clĂ© du manifest <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/theme">"theme"</a>.</p> +Un [object](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Object) JSON qui prend les mĂȘmes propriĂ©tĂ©s que la clĂ© du manifest ["theme"](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/theme). -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.theme.Theme")}}</p> +{{Compat("webextensions.api.theme.Theme")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/theme/update/index.md b/files/fr/mozilla/add-ons/webextensions/api/theme/update/index.md index 20c0ecca5c..498e9fc094 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/theme/update/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/theme/update/index.md @@ -12,39 +12,39 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/theme/update --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Met Ă jour le thĂšme du navigateur en fonction du contenu de l'objet {{WebExtAPIRef("theme.Theme", "Theme")}} donnĂ©.</p> +Met Ă jour le thĂšme du navigateur en fonction du contenu de l'objet {{WebExtAPIRef("theme.Theme", "Theme")}} donnĂ©. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.theme.update( +```js +browser.theme.update( windowId, // integer theme // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. L'ID d'une fenĂȘtre. Si cela est prĂ©vu, le thĂšme est appliquĂ© uniquement Ă cette fenĂȘtre. S'il est omis, le thĂšme est appliquĂ© Ă toutes les fenĂȘtres.</dd> -</dl> +- `windowId` {{optional_inline}} + - : `integer`. L'ID d'une fenĂȘtre. Si cela est prĂ©vu, le thĂšme est appliquĂ© uniquement Ă cette fenĂȘtre. S'il est omis, le thĂšme est appliquĂ© Ă toutes les fenĂȘtres. -<dl> - <dt><code>theme</code></dt> - <dd><code>object</code>. Un objet {{WebExtAPIRef("theme.Theme", "Theme")}} spĂ©cifiant des valeurs pour les Ă©lĂ©ments de l'interface utilisateur que vous voulez modifier</dd> -</dl> +<!----> -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- `theme` + - : `object`. Un objet {{WebExtAPIRef("theme.Theme", "Theme")}} spĂ©cifiant des valeurs pour les Ă©lĂ©ments de l'interface utilisateur que vous voulez modifier -<p>{{Compat("webextensions.api.theme.update", 10)}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.theme.update", 10)}} -<p>DĂ©finit le thĂšme du navigateur pour utiliser un graphique solaire avec une couleur de fond complĂ©mentaire:</p> +## Exemples -<pre class="brush: js">const suntheme = { +DĂ©finit le thĂšme du navigateur pour utiliser un graphique solaire avec une couleur de fond complĂ©mentaire: + +```js +const suntheme = { images: { headerURL: 'sun.jpg', }, @@ -54,11 +54,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/theme/update } }; -browser.theme.update(suntheme);</pre> +browser.theme.update(suntheme); +``` -<p>DĂ©finissez le thĂšme uniquement pour la fenĂȘtre actuellement ciblĂ©e:</p> +DĂ©finissez le thĂšme uniquement pour la fenĂȘtre actuellement ciblĂ©e: -<pre class="brush: js">const day = { +```js +const day = { images: { headerURL: 'sun.jpg', }, @@ -79,6 +81,7 @@ async function updateThemeForCurrentWindow() { browser.theme.update(currentWindow.id, day); } -browser.menus.onClicked.addListener(updateThemeForCurrentWindow);</pre> +browser.menus.onClicked.addListener(updateThemeForCurrentWindow); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/topsites/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/topsites/get/index.md index 199b3d65de..a173e84acd 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/topsites/get/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/topsites/get/index.md @@ -13,64 +13,63 @@ tags: - topSites translation_of: Mozilla/Add-ons/WebExtensions/API/topSites/get --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient un tableau contenant des informations sur les pages que l'utilisateur a visitĂ©es souvent et rĂ©cemment.</p> +Obtient un tableau contenant des informations sur les pages que l'utilisateur a visitĂ©es souvent et rĂ©cemment. -<p>Les navigateurs gardent une liste des pages que l'utilisateur visite souvent et rĂ©cemment. Ils utilisent cette liste pour aider l'utilisateur Ă retourner Ă ces endroits facilement. Par exemple, Firefox fournit par dĂ©faut une liste des pages les plus visitĂ©es dans la page "Nouvel onglet".</p> +Les navigateurs gardent une liste des pages que l'utilisateur visite souvent et rĂ©cemment. Ils utilisent cette liste pour aider l'utilisateur Ă retourner Ă ces endroits facilement. Par exemple, Firefox fournit par dĂ©faut une liste des pages les plus visitĂ©es dans la page "Nouvel onglet". -<p>Pour dĂ©terminer quelles pages apparaissent dans la liste et dans quel ordre, le navigateur combine "frĂ©quence" - combien de fois l'utilisateur a visitĂ© la page - et "rĂ©cente" - combien de fois l'utilisateur a visitĂ© la page.</p> +Pour dĂ©terminer quelles pages apparaissent dans la liste et dans quel ordre, le navigateur combine "frĂ©quence" - combien de fois l'utilisateur a visitĂ© la page - et "rĂ©cente" - combien de fois l'utilisateur a visitĂ© la page. -<p>Le navigateur peut ensuite appliquer un filtrage supplĂ©mentaire Ă cette liste avant de la prĂ©senter Ă l'utilisateur. Par exemple, dans Firefox, la page "Nouvel onglet" ne liste qu'une page par domaine, et l'utilisateur peut bloquer l'apparition de pages dans la liste.</p> +Le navigateur peut ensuite appliquer un filtrage supplĂ©mentaire Ă cette liste avant de la prĂ©senter Ă l'utilisateur. Par exemple, dans Firefox, la page "Nouvel onglet" ne liste qu'une page par domaine, et l'utilisateur peut bloquer l'apparition de pages dans la liste. -<p>L'API <code>topSites.get()</code> permet Ă une extension d'accĂ©der Ă cette liste. AppelĂ© sans aucune option, il fournira la liste filtrĂ©e des pages, c'est-Ă -dire celle qui apparaĂźt dans la page "Nouvel onglet". Cependant, en fournissant diverses options, il est possible pour une extension d'obtenir la liste non filtrĂ©e des pages.</p> +L'API `topSites.get()` permet Ă une extension d'accĂ©der Ă cette liste. AppelĂ© sans aucune option, il fournira la liste filtrĂ©e des pages, c'est-Ă -dire celle qui apparaĂźt dans la page "Nouvel onglet". Cependant, en fournissant diverses options, il est possible pour une extension d'obtenir la liste non filtrĂ©e des pages. -<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). -<p>Pour utiliser l'API topSites, vous devez avoir la <a href="fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission de l'API</a> "topSites"</p> +Pour utiliser l'API topSites, vous devez avoir la [permission de l'API](fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "topSites" -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var gettingTopSites = browser.topSites.get() -</pre> +```js +var gettingTopSites = browser.topSites.get() +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>options</code></dt> - <dd><p><code>object</code>. Options pour modifier la liste des pages retournĂ©es. Il peut s'agir de l'une des propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>includeBlocked</code> {{optional_inline}}</dt> - <dd><code>Boolean</code>. Inclure les pages que l'utilisateur a supprimĂ©es de la page "Nouvel onglet". La valeur par dĂ©faut est <code>false</code>.</dd> - <dt><code>includeFavicon</code> {{optional_inline}}</dt> - <dd><code>Boolean</code>.  Inclure les favicons dans les rĂ©sultats, pour les pages oĂč ils sont disponibles. La valeur par dĂ©faut est <code>false</code>.</dd> - <dt><code>includePinned</code> {{optional_inline}}</dt> - <dd><code>Boolean</code>. inclure les sites que l'utilisateur a Ă©pinglĂ©s dans le nouvel onglet Firefox.<br> - Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>includeSearchShortcuts</code> {{optional_inline}}</dt> - <dd><code>Boolean</code>.  Inclut les raccourcis de recherche qui apparaissent dans le nouvel onglet Firefox.<br> - Par dĂ©faut Ă <code>false</code>.</dd> - <dt><code>limit</code> {{optional_inline}}</dt> - <dd><code>Integer</code>. Le nombre de pages Ă retourner. Ce chiffre doit ĂȘtre compris entre 1 et 100 inclusivement. La valeur par dĂ©faut est 12.</dd> - <dt><code>onePerDomain</code> {{optional_inline}}</dt> - <dd><code>Boolean</code>. N'incluez qu'une seule page par domaine. La valeur par dĂ©faut est <code>true</code>.</dd> - </dl> - </dd> -</dl> +- `options` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. Options pour modifier la liste des pages retournĂ©es. Il peut s'agir de l'une des propriĂ©tĂ©s suivantes : -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>. Ceci sera rĂ©alisĂ© avec un tableau d'objets {{WebExtAPIRef("topSites.MostVisitedURL", "MostVisitedURL")}}, un pour chaque site listĂ© dans la page "Nouvel onglet" du navigateur. Si une erreur se produit, la presse sera rejetĂ©e avec un message d'erreur.</p> + - `includeBlocked` {{optional_inline}} + - : `Boolean`. Inclure les pages que l'utilisateur a supprimĂ©es de la page "Nouvel onglet". La valeur par dĂ©faut est `false`. + - `includeFavicon` {{optional_inline}} + - : `Boolean`.  Inclure les favicons dans les rĂ©sultats, pour les pages oĂč ils sont disponibles. La valeur par dĂ©faut est `false`. + - `includePinned` {{optional_inline}} + - : `Boolean`. inclure les sites que l'utilisateur a Ă©pinglĂ©s dans le nouvel onglet Firefox. + Par dĂ©faut Ă `false`. + - `includeSearchShortcuts` {{optional_inline}} + - : `Boolean`.  Inclut les raccourcis de recherche qui apparaissent dans le nouvel onglet Firefox. + Par dĂ©faut Ă `false`. + - `limit` {{optional_inline}} + - : `Integer`. Le nombre de pages Ă retourner. Ce chiffre doit ĂȘtre compris entre 1 et 100 inclusivement. La valeur par dĂ©faut est 12. + - `onePerDomain` {{optional_inline}} + - : `Boolean`. N'incluez qu'une seule page par domaine. La valeur par dĂ©faut est `true`. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.topSites.get")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Ceci sera rĂ©alisĂ© avec un tableau d'objets {{WebExtAPIRef("topSites.MostVisitedURL", "MostVisitedURL")}}, un pour chaque site listĂ© dans la page "Nouvel onglet" du navigateur. Si une erreur se produit, la presse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Ce code enregistre le titre et l'UL de tous les sites dans la page "Nouvel onglet" :</p> +{{Compat("webextensions.api.topSites.get")}} -<pre class="brush: js">function logTopSites(topSitesArray) { +## Exemples + +Ce code enregistre le titre et l'UL de tous les sites dans la page "Nouvel onglet" : + +```js +function logTopSites(topSitesArray) { for (topSite of topSitesArray) { console.log(`Title: ${topSite.title}, URL: ${topSite.url}`); } @@ -82,11 +81,12 @@ function onError(error) { var gettingTopSites = browser.topSites.get(); gettingTopSites.then(logTopSites, onError); -</pre> +``` -<p>Ce code enregistre le titre et l'URL de toutes les pages d'accueil, y compris celles que l'utilisateur a bloquĂ©es, et peut inclure plusieurs pages dans le mĂȘme domaine :</p> +Ce code enregistre le titre et l'URL de toutes les pages d'accueil, y compris celles que l'utilisateur a bloquĂ©es, et peut inclure plusieurs pages dans le mĂȘme domaine : -<pre class="brush: js">function logTopSites(topSitesArray) { +```js +function logTopSites(topSitesArray) { for (topSite of topSitesArray) { console.log(`Title: ${topSite.title}, URL: ${topSite.url}`); } @@ -101,17 +101,16 @@ var gettingTopSites = browser.topSites.get({ onePerDomain: false }); -gettingTopSites.then(logTopSites, onError);</pre> - -<p>{{WebExtExamples}}</p> +gettingTopSites.then(logTopSites, onError); +``` -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/topSites"><code>chrome.topSites</code></a>.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.topSites`](https://developer.chrome.com/extensions/topSites). -<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 @@ -138,5 +137,4 @@ gettingTopSites.then(logTopSites, onError);</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/topsites/index.md b/files/fr/mozilla/add-ons/webextensions/api/topsites/index.md index 9aa64c78ca..21c02f626f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/topsites/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/topsites/index.md @@ -12,45 +12,37 @@ tags: - topSites translation_of: Mozilla/Add-ons/WebExtensions/API/topSites --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Utilisez l'API topSites pour obtenir un tableau contenant les pages que l'utilisateur a visitĂ©es frĂ©quemment.</p> +Utilisez l'API topSites pour obtenir un tableau contenant les pages que l'utilisateur a visitĂ©es frĂ©quemment. -<p>Les navigateurs maintiennent ceci pour aider l'utilisateur Ă retourner Ă ces endroits facilement. Par exemple, Firefox fournit par dĂ©faut une liste des pages les plus visitĂ©es dans la page "Nouvel onglet".</p> +Les navigateurs maintiennent ceci pour aider l'utilisateur Ă retourner Ă ces endroits facilement. Par exemple, Firefox fournit par dĂ©faut une liste des pages les plus visitĂ©es dans la page "Nouvel onglet". -<p>Pour utiliser l'API topSites, vous devez disposez de l' <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">API permission</a> "topSites".</p> +Pour utiliser l'API topSites, vous devez disposez de l' [API permission](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "topSites". -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("topSites.MostVisitedURL")}}</dt> - <dd>Un objet contenant le titre et l'URL d'un site web.</dd> -</dl> +- {{WebExtAPIRef("topSites.MostVisitedURL")}} + - : Un objet contenant le titre et l'URL d'un site web. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +## MĂ©thodes -<dl> - <dt>{{WebExtAPIRef("topSites.get()")}}</dt> - <dd>Obtient un tableau contenant tous les sites rĂ©pertoriĂ©s dans la page "Nouvel onglet" du navigateur. Notez que le nombre de sites renvoyĂ©s ici est spĂ©cifique au navigateur, et les sites particuliers retournĂ©s seront probablement spĂ©cifiques Ă l'utilisateur, en fonction de leur historique de navigation.</dd> -</dl> +- {{WebExtAPIRef("topSites.get()")}} + - : Obtient un tableau contenant tous les sites rĂ©pertoriĂ©s dans la page "Nouvel onglet" du navigateur. Notez que le nombre de sites renvoyĂ©s ici est spĂ©cifique au navigateur, et les sites particuliers retournĂ©s seront probablement spĂ©cifiques Ă l'utilisateur, en fonction de leur historique de navigation. -<h2 id="CompatibilitĂ©_du_Navigateur">CompatibilitĂ© du Navigateur</h2> +## CompatibilitĂ© du Navigateur +{{Compat("webextensions.api.topSites")}} +{{WebExtExamples("h2")}} -<p>{{Compat("webextensions.api.topSites")}}</p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.topSites`](https://developer.chrome.com/extensions/topSites). +> +> 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>{{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/topSites"><code>chrome.topSites</code></a>.</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 @@ -77,5 +69,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/topSites // 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/topsites/mostvisitedurl/index.md b/files/fr/mozilla/add-ons/webextensions/api/topsites/mostvisitedurl/index.md index 8d8698190e..6d39143ce1 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/topsites/mostvisitedurl/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/topsites/mostvisitedurl/index.md @@ -13,42 +13,36 @@ tags: - topSites translation_of: Mozilla/Add-ons/WebExtensions/API/topSites/MostVisitedURL --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type <code>MostVisitedURL</code> contient deux propriĂ©tĂ©s : le titre de la page et son URL.</p> +Le type `MostVisitedURL` contient deux propriĂ©tĂ©s : le titre de la page et son URL. -<h2 id="Type">Type</h2> +## Type -<p>Values of this type are objects. They contain the following properties:</p> +Values of this type are objects. They contain the following properties: -<dl> - <dt><code>favicon</code> {{optional_inline}}</dt> - <dd><code>String</code>. Une donnĂ©e : URL contenant le favicon de la page, si <code>includeFavicon</code> Ă©tait donnĂ© dans {{WebExtAPIRef("topSites.get()")}} et le favicon Ă©tait disponible.</dd> - <dt><code>title</code></dt> - <dd><code>String</code>. Le titre de la page.</dd> - <dt><code>url</code></dt> - <dd><code>String</code>. L'URL de la page.</dd> -</dl> +- `favicon` {{optional_inline}} + - : `String`. Une donnĂ©e : URL contenant le favicon de la page, si `includeFavicon` Ă©tait donnĂ© dans {{WebExtAPIRef("topSites.get()")}} et le favicon Ă©tait disponible. +- `title` + - : `String`. Le titre de la page. +- `url` + - : `String`. L'URL de la page. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur +{{Compat("webextensions.api.topSites.MostVisitedURL")}} +## Exemples -<p>{{Compat("webextensions.api.topSites.MostVisitedURL")}}</p> +{{WebExtExamples}} -<h2 id="Exemples">Exemples</h2> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.topSites`](https://developer.chrome.com/extensions/topSites). +> +> 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>{{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/topSites"><code>chrome.topSites</code></a>.</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 @@ -75,5 +69,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/topSites/MostVisitedURL // 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/types/browsersetting/clear/index.md b/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/clear/index.md index be8094166a..b62028504f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/clear/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/clear/index.md @@ -12,41 +12,41 @@ tags: - clear translation_of: Mozilla/Add-ons/WebExtensions/API/types/BrowserSetting/clear --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>Utilisez <code>BrowserSetting.clear()</code> pour effacer toutes les modification apportĂ©es Ă l'extension du navigateur. Le paramĂštre du navigateur revient Ă sa valeur prĂ©cĂ©dente.</p> +Utilisez `BrowserSetting.clear()` pour effacer toutes les modification apportĂ©es Ă l'extension du navigateur. Le paramĂštre du navigateur revient Ă sa valeur prĂ©cĂ©dente. -<p>L'extensions annulera Ă©galement le contrĂŽle du paramĂštre, permettant une extension avec une ancienne prĂ©cĂ©dente (c'est Ă dire, une extensions qui a Ă©tĂ© installĂ©e avant celle-ci) Ă modifier la paramĂštre. Voir <code><a href="/fr/Add-ons/WebExtensions/API/privacy/BrowserSetting/set">BrowserSetting.set()</a></code> pour en savoir plus sur le contrĂŽle des paramĂštres.</p> +L'extensions annulera Ă©galement le contrĂŽle du paramĂštre, permettant une extension avec une ancienne prĂ©cĂ©dente (c'est Ă dire, une extensions qui a Ă©tĂ© installĂ©e avant celle-ci) Ă modifier la paramĂštre. Voir [`BrowserSetting.set()`](/fr/Add-ons/WebExtensions/API/privacy/BrowserSetting/set) pour en savoir plus sur le contrĂŽle des paramĂštres. -<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>. Si la compensation a Ă©chouĂ©, la promesse renvoie une valeur Ă <code>false</code>. Si l'effacement de la valeur a rĂ©ussi, il se rĂ©sout Ă <code>true</code>.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si la compensation a Ă©chouĂ©, la promesse renvoie une valeur Ă `false`. Si l'effacement de la valeur a rĂ©ussi, il se rĂ©sout Ă `true`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var clearing = setting.clear( +```js +var clearing = setting.clear( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd>Un objet vide</dd> -</dl> +- `details` + - : Un objet vide -<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 <code>boolĂ©en</code>: <code>true</code> Si le paramĂštre est effacĂ©, <code>false</code> sinon.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rempli avec un `boolĂ©en`: `true` Si le paramĂštre est effacĂ©, `false` sinon. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>Voir {{WebExtAPIRef("types.BrowserSetting")}}.</p> +Voir {{WebExtAPIRef("types.BrowserSetting")}}. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>Effacer le paramĂštre <code>webRTCIPHandlingPolicy</code> :</p> +Effacer le paramĂštre `webRTCIPHandlingPolicy` : -<pre class="brush: js">function onCleared(result) { +```js +function onCleared(result) { if (result) { console.log("Setting was cleared"); } else { @@ -55,19 +55,18 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/types/BrowserSetting/clear } var clearing = browser.privacy.network.webRTCIPHandlingPolicy.clear({}); -clearing.then(onCleared);</pre> +clearing.then(onCleared); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.types`](https://developer.chrome.com/extensions/types). +> +> 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/types"><code>chrome.types</code></a>.</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 @@ -94,5 +93,4 @@ clearing.then(onCleared);</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/types/browsersetting/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/get/index.md index e4e5e2c0dd..59b6f046b1 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/get/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/get/index.md @@ -12,85 +12,82 @@ tags: - get translation_of: Mozilla/Add-ons/WebExtensions/API/types/BrowserSetting/get --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La mĂ©thode <code>BrowserSetting.get()</code> obtient la valeur actuelle du paramĂštre du navigateur et une Ă©numĂ©ration indiquant comment la valeur du paramĂštre est actuellement controlĂ©ee..</p> +La mĂ©thode `BrowserSetting.get()` obtient la valeur actuelle du paramĂštre du navigateur et une Ă©numĂ©ration indiquant comment la valeur du paramĂštre est actuellement controlĂ©ee.. -<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 getting = setting.get( +```js +var getting = setting.get( details // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>dĂ©tails</code></dt> - <dd>Un objet vide.</dd> -</dl> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet avec les propriĂ©tĂ©s suivantes :</p> - -<dl> - <dt><code>value</code></dt> - <dd>La valeur du paramĂštre. Le type de cette propriĂ©tĂ© est dĂ©terminĂ© par le paramĂštre particulier.</dd> - <dt><code>levelOfControl</code></dt> - <dd><code>string</code>. Cela reprĂ©sente la façon dont la paramĂštre est actuellement controllĂ©. Vous pouvez l'utiliser pour vĂ©rifier si vous pouvez modifier le paramĂštre. Voir <code><a href="/fr/Add-ons/WebExtensions/API/privacy/BrowserSetting/set">BrowserSetting.set()</a></code> pour plus dĂ©tails. Sa valeur peut-ĂȘtre l'une des suivantes : - <table class="standard-table"> - <tbody> - <tr> - <td><code>"not_controllable"</code></td> - <td>Les extensions ne sont pas autorisĂ©es Ă modifier le paramĂštre.</td> - </tr> - <tr> - <td><code>"controlled_by_other_extensions"</code></td> - <td>Une autre extension qui a Ă©tĂ© installĂ©e aprĂšs celle-ci a modifiĂ© ce paramĂštre</td> - </tr> - <tr> - <td><code>"controllable_by_this_extension"</code></td> - <td>Cette extension est autorisĂ©e Ă modifier le paramĂštre.</td> - </tr> - <tr> - <td><code>"controlled_by_this_extension"</code></td> - <td>Cette extensions a dĂ©jĂ modifi le paramĂštre.</td> - </tr> - </tbody> - </table> - </dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>Voir {{WebExtAPIRef("types.BrowserSetting")}}.</p> - -<h2 id="Exemple">Exemple</h2> - -<p>Enregitrez la valeur et le niveau de contrĂŽle de la propriĂ©tĂ© <code>networkPredictionEnabled</code> de l'objet {{WebExtAPIRef("privacy.network")}}, pour les fenĂȘtres de navigations privĂ©es. Notez que cela nĂ©cessite la permission du navigateur "privacy".</p> - -<pre class="brush: js">var getting = browser.privacy.network.networkPredictionEnabled.get({}); - -getting.then((got) => { +``` + +### ParamĂštres + +- `dĂ©tails` + - : Un objet vide. + +### Valeur de retour + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet avec les propriĂ©tĂ©s suivantes : + +- `value` + - : La valeur du paramĂštre. Le type de cette propriĂ©tĂ© est dĂ©terminĂ© par le paramĂštre particulier. +- `levelOfControl` + - : `string`. Cela reprĂ©sente la façon dont la paramĂštre est actuellement controllĂ©. Vous pouvez l'utiliser pour vĂ©rifier si vous pouvez modifier le paramĂštre. Voir [`BrowserSetting.set()`](/fr/Add-ons/WebExtensions/API/privacy/BrowserSetting/set) pour plus dĂ©tails. Sa valeur peut-ĂȘtre l'une des suivantes :<table class="standard-table"> + <tbody> + <tr> + <td><code>"not_controllable"</code></td> + <td>Les extensions ne sont pas autorisĂ©es Ă modifier le paramĂštre.</td> + </tr> + <tr> + <td><code>"controlled_by_other_extensions"</code></td> + <td> + Une autre extension qui a Ă©tĂ© installĂ©e aprĂšs celle-ci a modifiĂ© ce + paramĂštre + </td> + </tr> + <tr> + <td><code>"controllable_by_this_extension"</code></td> + <td>Cette extension est autorisĂ©e Ă modifier le paramĂštre.</td> + </tr> + <tr> + <td><code>"controlled_by_this_extension"</code></td> + <td>Cette extensions a dĂ©jĂ modifi le paramĂštre.</td> + </tr> + </tbody> + </table> + +## CompatibilitĂ© du navigateur + +Voir {{WebExtAPIRef("types.BrowserSetting")}}. + +## Exemple + +Enregitrez la valeur et le niveau de contrĂŽle de la propriĂ©tĂ© `networkPredictionEnabled` de l'objet {{WebExtAPIRef("privacy.network")}}, pour les fenĂȘtres de navigations privĂ©es. Notez que cela nĂ©cessite la permission du navigateur "privacy". + +```js +var getting = browser.privacy.network.networkPredictionEnabled.get({}); + +getting.then((got) => { console.log(`Value: ${got.value}`); console.log(`Control: ${got.levelOfControl}`); }); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.types`](https://developer.chrome.com/extensions/types). +> +> 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/types"><code>chrome.types</code></a>.</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 @@ -117,5 +114,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/types/browsersetting/index.md b/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/index.md index 2840431254..59787ee837 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/index.md @@ -12,49 +12,41 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/types/BrowserSetting --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un <code>BrowserSetting</code> est un objet reprĂ©sentant un paramĂštre de navigateur.</p> +Un `BrowserSetting` est un objet reprĂ©sentant un paramĂštre de navigateur. -<p>Il fournit des mĂ©thodes pour dĂ©finir et obtenir la valeur sous-jacente du paramĂštre, pour effacer tout changement que vous avez apportĂ© et pour Ă©couter les modifications apportĂ©es Ă sa valeur.</p> +Il fournit des mĂ©thodes pour dĂ©finir et obtenir la valeur sous-jacente du paramĂštre, pour effacer tout changement que vous avez apportĂ© et pour Ă©couter les modifications apportĂ©es Ă sa valeur. -<p>Notez que si cet objet est basĂ© sur le type <a href="https://developer.chrome.com/extensions/types#type-ChromeSetting">ChromeSetting</a>, cet objet ne fait pas de distinction entre le rĂ©glage de la valeur dans les fenĂȘtres de navigation privĂ©es. Cela signifie que toutes les parties de l'API relatives Ă la navigation privĂ©e (telles que l'option <code>scope</code> de <code>ChromeSetting.set()</code>) ne sont pas implĂ©mentĂ©es.</p> +Notez que si cet objet est basĂ© sur le type [ChromeSetting](https://developer.chrome.com/extensions/types#type-ChromeSetting), cet objet ne fait pas de distinction entre le rĂ©glage de la valeur dans les fenĂȘtres de navigation privĂ©es. Cela signifie que toutes les parties de l'API relatives Ă la navigation privĂ©e (telles que l'option `scope` de `ChromeSetting.set()`) ne sont pas implĂ©mentĂ©es. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +## MĂ©thodes -<dl> - <dt>{{WebExtAPIRef("types.BrowserSetting.get()")}}</dt> - <dd>Obtenez la valeur actuelle du paramĂštre et une Ă©numĂ©ration reprĂ©sentant la façon dont le paramĂštre est actuellement contrĂŽlĂ©.</dd> - <dt>{{WebExtAPIRef("types.BrowserSetting.set()")}}</dt> - <dd>RĂ©glez le paramĂštre sur une nouvelle valeur.</dd> - <dt>{{WebExtAPIRef("types.BrowserSetting.clear()")}}</dt> - <dd>Effacez toute modification apportĂ©e au paramĂštre par cette extension.</dd> -</dl> +- {{WebExtAPIRef("types.BrowserSetting.get()")}} + - : Obtenez la valeur actuelle du paramĂštre et une Ă©numĂ©ration reprĂ©sentant la façon dont le paramĂštre est actuellement contrĂŽlĂ©. +- {{WebExtAPIRef("types.BrowserSetting.set()")}} + - : RĂ©glez le paramĂštre sur une nouvelle valeur. +- {{WebExtAPIRef("types.BrowserSetting.clear()")}} + - : Effacez toute modification apportĂ©e au paramĂštre par cette extension. -<h2 id="EvĂ©nements">EvĂ©nements</h2> +## EvĂ©nements -<dl> - <dt>{{WebExtAPIRef("types.BrowserSetting.onChange")}}</dt> - <dd>DĂ©finit lorsque la valeur du paramĂštre change.</dd> -</dl> +- {{WebExtAPIRef("types.BrowserSetting.onChange")}} + - : DĂ©finit lorsque la valeur du paramĂštre change. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<h2 id="Browser_compatibility">Browser compatibility</h2> +## Browser compatibility +{{Compat("webextensions.api.types.BrowserSetting")}} +{{WebExtExamples}} -<p>{{Compat("webextensions.api.types.BrowserSetting")}}</p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.types`](https://developer.chrome.com/extensions/types). -<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/types"><code>chrome.types</code></a>.</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 @@ -81,5 +73,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/types/BrowserSetting // 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/types/browsersetting/onchange/index.md b/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/onchange/index.md index ba8fee4bbc..9becaece98 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/onchange/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/onchange/index.md @@ -13,91 +13,81 @@ tags: - onchange translation_of: Mozilla/Add-ons/WebExtensions/API/types/BrowserSetting/onChange --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>L'Ă©vĂ©nement <code>BrowserSetting.onChanged</code> est dĂ©clenchĂ© lorsque le paramĂštre est modifiĂ©.</p> +L'Ă©vĂ©nement `BrowserSetting.onChanged` est dĂ©clenchĂ© lorsque le paramĂštre est modifiĂ©. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">BrowserSetting.onChanged.addListener(listener) +```js +BrowserSetting.onChanged.addListener(listener) BrowserSetting.onChanged.removeListener(listener) BrowserSetting.onChanged.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nement ont trois fonctions :</p> - -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajout un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifier si l'auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> si elle Ă©coute, <code>false</code> sinon.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction passera les arguments suivants :</p> - - <dl> - <dt><code>details</code></dt> - <dd>Un <code>object</code> contenant des dĂ©tails sur le changement survenu. Ses propriĂ©tĂ© sont les suivantes : - <dl> - <dt><code>value</code></dt> - <dd>La nouvelle valeur du paramĂštre. Le type de cette propriĂ©tĂ© est dĂ©terminĂ© par le paramĂštre particulier.</dd> - <dt><code>levelOfControl</code></dt> - <dd><code>string</code>. Cela reprĂ©sente la façon dont le paramĂštre est actuellement controlĂ©. Vous pouvez l'utiliser pour vĂ©rifier si vous pouvez modifier le rĂ©glage. Voir <code><a href="/fr/Add-ons/WebExtensions/API/privacy/BrowserSetting/set">BrowserSetting.set()</a></code> pour plus dĂ©tails. Sa valeur peut-ĂȘtre l'une des suivantes : - <table class="standard-table"> - <tbody> - <tr> - <td><code>"not_controllable"</code></td> - <td>Les extensions ne sont pas autorisĂ©es Ă modifier ce paramĂštre.</td> - </tr> - <tr> - <td><code>"controlled_by_other_extensions"</code></td> - <td>Une autre extensions qui a Ă©tĂ© installĂ©e aprĂšs celle-ci a modifiĂ© ce paramĂštre.</td> - </tr> - <tr> - <td><code>"controllable_by_this_extension"</code></td> - <td>Cette extensions est autorisĂ©e Ă modifier le paramĂštre.</td> - </tr> - <tr> - <td><code>controlled_by_this_extension"</code></td> - <td>Cette extensions a dĂ©jĂ modifiĂ© le paramĂštre.</td> - </tr> - </tbody> - </table> - </dd> - </dl> - </dd> - </dl> - </dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - - - -<p>{{Compat("webextensions.api.types.BrowserSetting.onChange")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<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/types"><code>chrome.types</code></a>.</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. +``` + +Les Ă©vĂ©nement ont trois fonctions : + +- `addListener(listener)` + - : Ajout un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifier si l'auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` si elle Ă©coute, `false` sinon. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Une fonction de rappel qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction passera les arguments suivants : + + - `details` + + - : Un `object` contenant des dĂ©tails sur le changement survenu. Ses propriĂ©tĂ© sont les suivantes : + + - `value` + - : La nouvelle valeur du paramĂštre. Le type de cette propriĂ©tĂ© est dĂ©terminĂ© par le paramĂštre particulier. + - `levelOfControl` + - : `string`. Cela reprĂ©sente la façon dont le paramĂštre est actuellement controlĂ©. Vous pouvez l'utiliser pour vĂ©rifier si vous pouvez modifier le rĂ©glage. Voir [`BrowserSetting.set()`](/fr/Add-ons/WebExtensions/API/privacy/BrowserSetting/set) pour plus dĂ©tails. Sa valeur peut-ĂȘtre l'une des suivantes :<table class="standard-table"> + <tbody> + <tr> + <td><code>"not_controllable"</code></td> + <td>Les extensions ne sont pas autorisĂ©es Ă modifier ce paramĂštre.</td> + </tr> + <tr> + <td><code>"controlled_by_other_extensions"</code></td> + <td> + Une autre extensions qui a Ă©tĂ© installĂ©e aprĂšs celle-ci a modifiĂ© ce + paramĂštre. + </td> + </tr> + <tr> + <td><code>"controllable_by_this_extension"</code></td> + <td>Cette extensions est autorisĂ©e Ă modifier le paramĂštre.</td> + </tr> + <tr> + <td><code>controlled_by_this_extension"</code></td> + <td>Cette extensions a dĂ©jĂ modifiĂ© le paramĂštre.</td> + </tr> + </tbody> + </table> + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.types.BrowserSetting.onChange")}} + +## Exemples + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.types`](https://developer.chrome.com/extensions/types). +> +> 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 @@ -124,5 +114,4 @@ BrowserSetting.onChanged.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/types/browsersetting/set/index.md b/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/set/index.md index 0ff0d05fbc..7bd801375f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/set/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/types/browsersetting/set/index.md @@ -12,62 +12,57 @@ tags: - set translation_of: Mozilla/Add-ons/WebExtensions/API/types/BrowserSetting/set --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Utilisez <code>BrowserSetting.set()</code> pour modifier le paramĂštre du navigateur vers une nouvelle valeur.</p> +Utilisez `BrowserSetting.set()` pour modifier le paramĂštre du navigateur vers une nouvelle valeur. -<p>Certaines rĂšgles peuvent ĂȘtre restreintes lorsque les extensions sont capables de modifier les paramĂštres :</p> +Certaines rĂšgles peuvent ĂȘtre restreintes lorsque les extensions sont capables de modifier les paramĂštres : -<ul> - <li>Certains paramĂštres sont verrouillĂ©s, de sorte qu'ils ne peuvent pas ĂȘtre modifiĂ©s par les extensions</li> - <li>Si plusieurs extensions tentent de modifier le mĂȘme paramĂštre, les extensions reçoivent un ordre de prioritĂ© en fonction de leur installation. Plus rĂ©cemment, les extensions installĂ©es ont prioritĂ© sur l'extension installĂ©e rĂ©cemment.</li> -</ul> +- Certains paramĂštres sont verrouillĂ©s, de sorte qu'ils ne peuvent pas ĂȘtre modifiĂ©s par les extensions +- Si plusieurs extensions tentent de modifier le mĂȘme paramĂštre, les extensions reçoivent un ordre de prioritĂ© en fonction de leur installation. Plus rĂ©cemment, les extensions installĂ©es ont prioritĂ© sur l'extension installĂ©e rĂ©cemment. -<p>Cela signifie que si l'extension X essaie de modifier un paramĂštre :</p> +Cela signifie que si l'extension X essaie de modifier un paramĂštre : -<ol> - <li>Si le rĂ©glage est verrouillĂ©, le rĂ©glage n'est pas modifiĂ©. Cependant, le changement de X est rappelĂ©, et il est stockĂ© dans une file d'attente, commandĂ© par la prioritĂ© de X par rapport Ă toutes les autres extensions qui ont essayĂ© de modifier le paramĂštre. Si le rĂ©glage devient dĂ©verrouillĂ© plus tard, la premiĂšre extension de la file d'attente permet de modifier le rĂ©glage.</li> - <li>Sinon, si aucune autre extension n'a dĂ©jĂ changĂ© le paramĂštre, X rĂ©ussit Ă modifier le rĂ©glage, puis on dit "contrĂŽler" le rĂ©glage.</li> - <li>Sinon, si une extension de prioritĂ© infĂ©rieure Y a dĂ©jĂ changĂ© le paramĂštre, X rĂ©ussit Ă modifier le rĂ©glage et maintenant le rĂ©glage. However, Y's change is remembered, and is stored in a queue in precedence order. Cependant, le changement de Y est rappelĂ© et est stockĂ© dans une file d'attente dans l'ordre de prioritĂ©. Si X efface ensuite sa valeur, ou si X est dĂ©sactivĂ© ou dĂ©sinstallĂ©, la premiĂšre extension de la file d'attente permet de modifier sa valeur.</li> - <li>Sinon, si une extension de prioritĂ© supĂ©rieure Z a dĂ©jĂ changĂ© le paramĂštre, X ne rĂ©ussit pas Ă modifier le paramĂštre, mais sa modification est mise en file d'attente. Si Z efface ensuite sa valeur, ou si Z est dĂ©sactivĂ© ou dĂ©sinstallĂ©, la premiĂšre extension de la file d'attente permet de modifier sa valeur.</li> -</ol> +1. Si le rĂ©glage est verrouillĂ©, le rĂ©glage n'est pas modifiĂ©. Cependant, le changement de X est rappelĂ©, et il est stockĂ© dans une file d'attente, commandĂ© par la prioritĂ© de X par rapport Ă toutes les autres extensions qui ont essayĂ© de modifier le paramĂštre. Si le rĂ©glage devient dĂ©verrouillĂ© plus tard, la premiĂšre extension de la file d'attente permet de modifier le rĂ©glage. +2. Sinon, si aucune autre extension n'a dĂ©jĂ changĂ© le paramĂštre, X rĂ©ussit Ă modifier le rĂ©glage, puis on dit "contrĂŽler" le rĂ©glage. +3. Sinon, si une extension de prioritĂ© infĂ©rieure Y a dĂ©jĂ changĂ© le paramĂštre, X rĂ©ussit Ă modifier le rĂ©glage et maintenant le rĂ©glage. However, Y's change is remembered, and is stored in a queue in precedence order. Cependant, le changement de Y est rappelĂ© et est stockĂ© dans une file d'attente dans l'ordre de prioritĂ©. Si X efface ensuite sa valeur, ou si X est dĂ©sactivĂ© ou dĂ©sinstallĂ©, la premiĂšre extension de la file d'attente permet de modifier sa valeur. +4. Sinon, si une extension de prioritĂ© supĂ©rieure Z a dĂ©jĂ changĂ© le paramĂštre, X ne rĂ©ussit pas Ă modifier le paramĂštre, mais sa modification est mise en file d'attente. Si Z efface ensuite sa valeur, ou si Z est dĂ©sactivĂ© ou dĂ©sinstallĂ©, la premiĂšre extension de la file d'attente permet de modifier sa valeur. -<p>Une extension peut dĂ©terminer lequel de ces scĂ©narios s'applique en examinant la propriĂ©tĂ© "<code>levelOfControl</code>" renvoyĂ©e d'un appel Ă <code><a href="/fr/Add-ons/WebExtensions/API/privacy/BrowserSetting/get">BrowserSetting.get()</a></code>.</p> +Une extension peut dĂ©terminer lequel de ces scĂ©narios s'applique en examinant la propriĂ©tĂ© "`levelOfControl`" renvoyĂ©e d'un appel Ă [`BrowserSetting.get()`](/fr/Add-ons/WebExtensions/API/privacy/BrowserSetting/get). -<p>la mĂ©thode <code><a href="/fr/Add-ons/WebExtensions/API/privacy/BrowserSetting/set">BrowserSetting.set()</a></code> renvoie une promesse qui rĂ©sout un boolĂ©en : Si une tentative de modification d'un paramĂštre aboutit Ă la modification du paramĂštre (scenarios 2 et 3 ci-dessus) le boolĂ©en est <code>true</code>: sinon il est <code>false</code>.</p> +la mĂ©thode [`BrowserSetting.set()`](/fr/Add-ons/WebExtensions/API/privacy/BrowserSetting/set) renvoie une promesse qui rĂ©sout un boolĂ©en : Si une tentative de modification d'un paramĂštre aboutit Ă la modification du paramĂštre (scenarios 2 et 3 ci-dessus) le boolĂ©en est `true`: sinon il est `false`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var setting = setting.set( +```js +var setting = setting.set( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p>Un objet qui doit contenir la propriĂ©tĂ© suivante :</p> - <dl> - <dt><code>value</code></dt> - <dd><code>any</code>. La valeur Ă laquelle vous souhaitez modifier le paramĂštre. Son type dĂ©pend du rĂ©glage particulier.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : Un objet qui doit contenir la propriĂ©tĂ© suivante : -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un <code>boolĂ©en</code>: <code>true</code> si le paramĂštre a Ă©tĂ© modifiĂ©, <code>false</code> sinon (par exemple, parce que l'extension n'a pas contrĂŽlĂ© le paramĂštre).</p> + - `value` + - : `any`. La valeur Ă laquelle vous souhaitez modifier le paramĂštre. Son type dĂ©pend du rĂ©glage particulier. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>Voir {{WebExtAPIRef("types.BrowserSetting")}}.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un `boolĂ©en`: `true` si le paramĂštre a Ă©tĂ© modifiĂ©, `false` sinon (par exemple, parce que l'extension n'a pas contrĂŽlĂ© le paramĂštre). -<h2 id="Exemple">Exemple</h2> +## CompatibilitĂ© du navigateur -<p>Modifiez le paramĂštre <code>hyperlinkAuditingEnabled</code> (ceci nĂ©cessite la permission "privacy") :</p> +Voir {{WebExtAPIRef("types.BrowserSetting")}}. -<pre class="brush: js">function onSet(result) { +## Exemple + +Modifiez le paramĂštre `hyperlinkAuditingEnabled` (ceci nĂ©cessite la permission "privacy") : + +```js +function onSet(result) { if (result) { console.log("Value was updated"); } else { @@ -75,7 +70,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/types/BrowserSetting/set } } -browser.browserAction.onClicked.addListener(() => { +browser.browserAction.onClicked.addListener(() => { var setting = browser.privacy.websites.hyperlinkAuditingEnabled.set({ value: false @@ -83,19 +78,17 @@ browser.browserAction.onClicked.addListener(() => { setting.then(onSet); }); -</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/types"><code>chrome.types</code></a>.</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.types`](https://developer.chrome.com/extensions/types). +> +> 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 @@ -122,5 +115,4 @@ browser.browserAction.onClicked.addListener(() => { // 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/types/index.md b/files/fr/mozilla/add-ons/webextensions/api/types/index.md index 2952e0121d..ee9d128103 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/types/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/types/index.md @@ -10,30 +10,26 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/types --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}} -<p>DĂ©finit le type <code>BrowserSetting</code> , qui est utilisĂ© pour reprĂ©senter un paramĂštre de navigateur.</p> +DĂ©finit le type `BrowserSetting` , qui est utilisĂ© pour reprĂ©senter un paramĂštre de navigateur. -<h2 id="Types">Types</h2> +## Types -<dl> - <dt>{{WebExtAPIRef("types.BrowserSetting")}}</dt> - <dd>ReprĂ©sente un paramĂštre de navigateur.</dd> -</dl> +- {{WebExtAPIRef("types.BrowserSetting")}} + - : ReprĂ©sente un paramĂštre de navigateur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{WebExtExamples("h2")}}</p> +{{WebExtExamples("h2")}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.types`](https://developer.chrome.com/extensions/types). +> +> 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/types"><code>chrome.types</code></a>.</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 @@ -60,5 +56,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/types // 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/userscripts/index.md b/files/fr/mozilla/add-ons/webextensions/api/userscripts/index.md index df5b5f08d0..1a9432e314 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/userscripts/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/userscripts/index.md @@ -12,57 +12,42 @@ tags: - userScripts translation_of: Mozilla/Add-ons/WebExtensions/API/userScripts --- -<p>{{AddonSidebar}}</p> +{{AddonSidebar}} -<p>Utilisez cette API pour enregistrer des scripts utilisateurs, des scripts tiers conçus pour manipuler des pages web ou fournir de nouvelles fonctionnalitĂ©s. L'enregistrement d'un script utilisateur indique au navigateur de joindre le script aux pages qui correspondent aux modĂšles d'URL spĂ©cifiĂ©s lors de l'enregistrement.</p> +Utilisez cette API pour enregistrer des scripts utilisateurs, des scripts tiers conçus pour manipuler des pages web ou fournir de nouvelles fonctionnalitĂ©s. L'enregistrement d'un script utilisateur indique au navigateur de joindre le script aux pages qui correspondent aux modĂšles d'URL spĂ©cifiĂ©s lors de l'enregistrement. -<p>Cette API offre des capacitĂ©s similaires Ă {{WebExtAPIRef("contentScripts")}} mais avec des fonctionnalitĂ©s adaptĂ©es Ă la gestion de scripts tiers :</p> +Cette API offre des capacitĂ©s similaires Ă {{WebExtAPIRef("contentScripts")}} mais avec des fonctionnalitĂ©s adaptĂ©es Ă la gestion de scripts tiers : -<ul> - <li>l'exĂ©cution se fait dans une sandbox isolĂ©e : chaque script utilisateur est exĂ©cutĂ© dans une sandbox isolĂ©e au sein des processus de contenu web, ce qui empĂȘche toute interfĂ©rence accidentelle ou dĂ©libĂ©rĂ©e entre les scripts.</li> - <li>l'accĂšs Ă la <code>fenĂȘtre</code> et aux valeurs globales du <code>document</code> liĂ©es Ă la page web Ă laquelle le script utilisateur est attachĂ©.</li> - <li>aucun accĂšs aux API de WebExtension ou aux autorisations associĂ©es accordĂ©es Ă l'extension : le script API, qui hĂ©rite des autorisations de l'extension, peut fournir des API de WebExtension packagĂ©es aux scripts utilisateur enregistrĂ©s. Un script API est dĂ©clarĂ© dans le fichier manifeste de l'extension en utilisant la clĂ© du manifeste "user_scripts".</li> -</ul> +- l'exĂ©cution se fait dans une sandbox isolĂ©e : chaque script utilisateur est exĂ©cutĂ© dans une sandbox isolĂ©e au sein des processus de contenu web, ce qui empĂȘche toute interfĂ©rence accidentelle ou dĂ©libĂ©rĂ©e entre les scripts. +- l'accĂšs Ă la `fenĂȘtre` et aux valeurs globales du `document` liĂ©es Ă la page web Ă laquelle le script utilisateur est attachĂ©. +- aucun accĂšs aux API de WebExtension ou aux autorisations associĂ©es accordĂ©es Ă l'extension : le script API, qui hĂ©rite des autorisations de l'extension, peut fournir des API de WebExtension packagĂ©es aux scripts utilisateur enregistrĂ©s. Un script API est dĂ©clarĂ© dans le fichier manifeste de l'extension en utilisant la clĂ© du manifeste "user_scripts". -<div class="warning"> -<p><strong>Attention :</strong> Cette API requiert la prĂ©sence de la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts">user_scripts</a></code> dans le manifest.json, mĂȘme si aucun script API n'est spĂ©cifiĂ©. Par exemple, <code>user_scripts: {}</code>.</p> -</div> +> **Attention :** Cette API requiert la prĂ©sence de la clĂ© [`user_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts) dans le manifest.json, mĂȘme si aucun script API n'est spĂ©cifiĂ©. Par exemple, `user_scripts: {}`. -<p>Pour utiliser l'API, appelez <code>{{WebExtAPIRef("userScripts.register","register()")}}</code> en passant un objet dĂ©finissant les scripts Ă enregistrer. La mĂ©thode renvoie une promesse qui est rĂ©solue par un objet <code>{{WebExtAPIRef("userScripts.RegisteredUserScript","RegisteredUserScript")}}</code>.</p> +Pour utiliser l'API, appelez `{{WebExtAPIRef("userScripts.register","register()")}}` en passant un objet dĂ©finissant les scripts Ă enregistrer. La mĂ©thode renvoie une promesse qui est rĂ©solue par un objet `{{WebExtAPIRef("userScripts.RegisteredUserScript","RegisteredUserScript")}}`. -<div class="note"> -<p><strong>Note :</strong> Les scripts utilisateur sont dĂ©senregistrĂ©s lorsque la page d'extension correspondante (Ă partir de laquelle les scripts utilisateur ont Ă©tĂ© enregistrĂ©s) est dĂ©chargĂ©e, vous devez donc enregistrer un script utilisateur depuis une page d'extension qui persiste au moins aussi longtemps que vous voulez que les scripts utilisateur restent enregistrĂ©s</p> -</div> +> **Note :** Les scripts utilisateur sont dĂ©senregistrĂ©s lorsque la page d'extension correspondante (Ă partir de laquelle les scripts utilisateur ont Ă©tĂ© enregistrĂ©s) est dĂ©chargĂ©e, vous devez donc enregistrer un script utilisateur depuis une page d'extension qui persiste au moins aussi longtemps que vous voulez que les scripts utilisateur restent enregistrĂ©s +## Types -<h2 id="Types">Types</h2> +- {{WebExtAPIRef("userScripts.RegisteredUserScript")}} + - : L'`object` renvoyĂ© par la mĂ©thode {{WebExtAPIRef("userScripts.register","register()")}}. Il reprĂ©sente les scripts utilisateur enregistrĂ©s et est utilisĂ© pour dĂ©senregistrer les scripts utilisateur. -<dl> - <dt>{{WebExtAPIRef("userScripts.RegisteredUserScript")}}</dt> - <dd>L'<code>object</code> renvoyĂ© par la mĂ©thode {{WebExtAPIRef("userScripts.register","register()")}}. Il reprĂ©sente les scripts utilisateur enregistrĂ©s et est utilisĂ© pour dĂ©senregistrer les scripts utilisateur.</dd> -</dl> +## MĂ©thodes -<h2 id="MĂ©thodes">MĂ©thodes</h2> +- {{WebExtAPIRef("userScripts.register()")}} + - : Enregistre les scripts utilisateur donnĂ©s. -<dl> - <dt>{{WebExtAPIRef("userScripts.register()")}}</dt> - <dd>Enregistre les scripts utilisateur donnĂ©s.</dd> -</dl> +## EvĂ©nements -<h2 id="EvĂ©nements">EvĂ©nements</h2> +- {{WebExtAPIRef("userScripts.onBeforeScript")}} + - : Un Ă©vĂ©nement disponible pour le script API, enregistrĂ© dans [`"user_scripts"`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts), qui s'exĂ©cute avant qu'un script utilisateur ne s'exĂ©cute. Utilisez-le pour dĂ©clencher l'exportation des API supplĂ©mentaires fournies par le script API, afin qu'elles soient disponibles pour le script utilisateur. -<dl> - <dt>{{WebExtAPIRef("userScripts.onBeforeScript")}}</dt> - <dd>Un Ă©vĂ©nement disponible pour le script API, enregistrĂ© dans <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts">"user_scripts"</a></code>, qui s'exĂ©cute avant qu'un script utilisateur ne s'exĂ©cute. Utilisez-le pour dĂ©clencher l'exportation des API supplĂ©mentaires fournies par le script API, afin qu'elles soient disponibles pour le script utilisateur.</dd> -</dl> +## CompatibilitĂ© du navigateur -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{Compat("webextensions.api.userScripts", 10, 1)}} -<p>{{Compat("webextensions.api.userScripts", 10, 1)}}</p> +## Voir aussi -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/userScripts/Working_with_userScripts">Working with <code>userScripts</code></a></li> - <li>{{WebExtAPIRef("contentScripts","browser.contentScripts")}}</li> -</ul> +- [Working with `userScripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/userScripts/Working_with_userScripts) +- {{WebExtAPIRef("contentScripts","browser.contentScripts")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/userscripts/onbeforescript/index.md b/files/fr/mozilla/add-ons/webextensions/api/userscripts/onbeforescript/index.md index 2b5db17c64..4b1e284d5a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/userscripts/onbeforescript/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/userscripts/onbeforescript/index.md @@ -14,38 +14,29 @@ tags: - userScripts translation_of: Mozilla/Add-ons/WebExtensions/API/userScripts/onBeforeScript --- -<div>{{AddonSidebar}}</div> +{{AddonSidebar}}La propriĂ©tĂ© **`onBeforeScript`** de l'Ă©vĂ©nement {{WebExtAPIRef("userScripts","browser.userScripts")}} est un {{event("Event_handlers", "event handler")}} qui traite {{event("beforeScript")}}. -<div>La propriĂ©tĂ© <strong><code>onBeforeScript</code></strong> de l'Ă©vĂ©nement {{WebExtAPIRef("userScripts","browser.userScripts")}} est un {{event("Event_handlers", "event handler")}} qui traite {{event("beforeScript")}}.</div> +L'Ă©vĂ©nement `beforeScript` se dĂ©clenche juste avant l'exĂ©cution d'un script utilisateur correspondant, permettant Ă APIScript d'exporter des mĂ©thodes API personnalisĂ©es vers le script utilisateur. -<p>L'Ă©vĂ©nement <code>beforeScript</code> se dĂ©clenche juste avant l'exĂ©cution d'un script utilisateur correspondant, permettant Ă APIScript d'exporter des mĂ©thodes API personnalisĂ©es vers le script utilisateur.</p> +## Syntaxe -<h2 id="Syntaxe">Syntaxe</h2> + browser.userScripts.onBeforeScript = functionRef + browser.userScripts.onBeforeScript.addListener(functionRef) + browser.userScripts.onBeforeScript.removeListener(functionRef) + browser.userScripts.onBeforeScript.hasListener(functionRef) -<pre class="syntaxbox"><code>browser.userScripts.onBeforeScript = </code>functionRef -<code>browser.userScripts.onBeforeScript.addListener(</code>functionRef<code>) -browser.userScripts.onBeforeScript.removeListener(</code>functionRef<code>) -browser.userScripts.onBeforeScript.hasListener(</code>functionRef<code>)</code> -</pre> +### Value -<h3 id="Value">Value</h3> +`functionRef` est la function de gestionnaire Ă appeler lorsque l'Ă©vĂ©nement `beforeScript` du script utilisateur se dĂ©clenche. -<p><code>functionRef</code> est la function de gestionnaire Ă appeler lorsque l'Ă©vĂ©nement <code>beforeScript</code> du script utilisateur se dĂ©clenche.</p> +## Exemples -<h2 id="Exemples">Exemples</h2> +Voir [ce billet de blog](https://blog.mozilla.org/addons/2019/03/26/extensions-in-firefox-67/#userscripts) pour des exemples dĂ©taillĂ©s -<p>Voir <a href="https://blog.mozilla.org/addons/2019/03/26/extensions-in-firefox-67/#userscripts">ce billet de blog</a> pour des exemples dĂ©taillĂ©s</p> +## CompatibilitĂ© du navigateur -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +{{Compat("webextensions.api.userScripts.onBeforeScript")}} -<div> +## Voir aussi - -<p>{{Compat("webextensions.api.userScripts.onBeforeScript")}}</p> -</div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{WebExtAPIRef("contentScripts")}}</li> -</ul> +- {{WebExtAPIRef("contentScripts")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/userscripts/register/index.md b/files/fr/mozilla/add-ons/webextensions/api/userscripts/register/index.md index 6de0d24988..59496030d3 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/userscripts/register/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/userscripts/register/index.md @@ -11,66 +11,62 @@ tags: - userScripts translation_of: Mozilla/Add-ons/WebExtensions/API/userScripts/register --- -<p>{{AddonSidebar}}</p> +{{AddonSidebar}} -<p>Dans les pages d'une extension (comme la page d'arriĂšre plan), l'API userScripts fournit une mĂ©thode API {{WebExtAPIRef("userScripts.register","register()")}}. Cette mĂ©thode est trĂšs similaire Ă la mĂ©thode API {{WebExtAPIRef("contentScripts.register","contentScripts.register()")}} (par exemple, ils retournent tous les deux une promise qui est rĂ©solue Ă un objet API qui fournit un  {{WebExtAPIRef("userScripts.RegisteredUserScript.unregister","unregister()")}} pour la dĂ©sinscription du script enregistrĂ© de tous les processus enfants), avec quelques diffĂ©rences dans les options prises en charge.</p> +Dans les pages d'une extension (comme la page d'arriĂšre plan), l'API userScripts fournit une mĂ©thode API {{WebExtAPIRef("userScripts.register","register()")}}. Cette mĂ©thode est trĂšs similaire Ă la mĂ©thode API {{WebExtAPIRef("contentScripts.register","contentScripts.register()")}} (par exemple, ils retournent tous les deux une promise qui est rĂ©solue Ă un objet API qui fournit un  {{WebExtAPIRef("userScripts.RegisteredUserScript.unregister","unregister()")}} pour la dĂ©sinscription du script enregistrĂ© de tous les processus enfants), avec quelques diffĂ©rences dans les options prises en charge. -<p>C'est une mĂ©thode asynchrone qui retourne un {{JSxRef("Promise")}}.</p> +C'est une mĂ©thode asynchrone qui retourne un {{JSxRef("Promise")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">const registeredUserScript = await browser.userScripts.register( +```js +const registeredUserScript = await browser.userScripts.register( userScriptOptions // object ); âŠ. -await registeredUserScript.unregister();</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>userScriptOptions</code></dt> - <dd><p><code>object</code>. Un objet <code>UserScriptOptions</code> reprĂ©sentant les scripts de contenu Ă enregistrer. Il a une syntaxe similaire aux options supportĂ©es par {{WebExtAPIRef("contentScripts.register","contentScripts.register()")}}.</p> - <p>L'objet <code>UserScriptOptions</code> possĂšde les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt>scriptMetadata <code>{{Optional_Inline}}</code></dt> - <dd>Un objet <code>JSON</code> qui contient certaines propriĂ©tĂ©s de mĂ©tadonnĂ©es associĂ©es aux <code>userScripts</code> enregistrĂ©s</dd> - <dt><code>allFrames {{Optional_Inline}}</code></dt> - <dd>Identiques Ă <code>all_frames</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts">user_scripts</a></code>.</dd> - <dt><code>excludeGlobs</code> {{Optional_Inline}}</dt> - <dd>Identique Ă <code>exclude_globs</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts">user_scripts</a></code>.</dd> - <dt><code>excludeMatches</code> {{Optional_Inline}}</dt> - <dd>Identique Ă <code>exclude_matches</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts">user_scripts</a></code>.</dd> - <dt><code>includeGlobs</code> {{Optional_Inline}}</dt> - <dd>Identique Ă <code>include_globs</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts">user_scripts</a></code>.</dd> - <dt><code>js</code> {{Optional_Inline}}</dt> - <dd>Un tableau d'objets. Chaque objet a soit une propriĂ©tĂ© nommĂ©e <code>file</code>, qui est une URL commençant par le fichier manifest.json de l'extension et pointant vers un fichier JavaScript Ă enregistrer, soit une propriĂ©tĂ© nommĂ©e <code>code</code>, qui est un code JavaScript Ă enregistrer.</dd> - <dt><code>matchAboutBlank</code> {{Optional_Inline}}</dt> - <dd>Identique Ă <code>match_about_blank</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts">user_scripts</a></code>.</dd> - <dt><code>matches</code></dt> - <dd>Identique Ă <code>matches</code> dans la clĂ©Â <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts">user_scripts</a></code>.</dd> - <dt><code>runAt</code> {{Optional_Inline}}</dt> - <dd>Identique Ă <code>run_at</code> dans la clĂ©Â <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts">user_scripts</a></code>.</dd> - </dl> - </dd> -</dl> - -<p>Contrairement aux options de script de contenu, l'objet userScriptOptions n'a pas de propriĂ©tĂ© css. Utilisez {{WebExtAPIRef("contentScripts.register","contentScripts.register()")}} pour enregistrer/dĂ©senregistrer dynamiquement les feuilles de style).</p> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une {{JSxRef("Promise")}} qui sera rempli avec un objet {{WebExtAPIRef("userScripts.RegisteredUserScript","RegisteredUserScript")}} que vous pouvez utiliser pour dĂ©sinscrire ce script utilisateur particulier.</p> - -<div class="note"> -<p><strong>Note :</strong> Actuellement, les scripts utilisateur sont dĂ©senregistrĂ©s lorsque la page d'extension correspondante (Ă partir de laquelle les scripts utilisateur ont Ă©tĂ© enregistrĂ©s) est dĂ©chargĂ©e, vous devez donc enregistrer un script utilisateur depuis une page d'extension qui persiste au moins aussi longtemps que vous voulez que les scripts utilisateur restent enregistrĂ©s.</p> -</div> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.userScripts.register", 10)}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{WebExtAPIRef("contentScripts.register","contentScripts.register()")}}</li> - <li>{{WebExtAPIRef("userScripts.RegisteredUserScript.unregister","RegisteredUserScript.unregister()")}}</li> -</ul> +await registeredUserScript.unregister(); +``` + +### ParamĂštres + +- `userScriptOptions` + + - : `object`. Un objet `UserScriptOptions` reprĂ©sentant les scripts de contenu Ă enregistrer. Il a une syntaxe similaire aux options supportĂ©es par {{WebExtAPIRef("contentScripts.register","contentScripts.register()")}}. + + L'objet `UserScriptOptions` possĂšde les propriĂ©tĂ©s suivantes : + + - scriptMetadata `{{Optional_Inline}}` + - : Un objet `JSON` qui contient certaines propriĂ©tĂ©s de mĂ©tadonnĂ©es associĂ©es aux `userScripts` enregistrĂ©s + - `allFrames {{Optional_Inline}}` + - : Identiques Ă `all_frames` dans la clĂ© [`user_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts). + - `excludeGlobs` {{Optional_Inline}} + - : Identique Ă `exclude_globs` dans la clĂ© [`user_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts). + - `excludeMatches` {{Optional_Inline}} + - : Identique Ă `exclude_matches` dans la clĂ© [`user_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts). + - `includeGlobs` {{Optional_Inline}} + - : Identique Ă `include_globs` dans la clĂ© [`user_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts). + - `js` {{Optional_Inline}} + - : Un tableau d'objets. Chaque objet a soit une propriĂ©tĂ© nommĂ©e `file`, qui est une URL commençant par le fichier manifest.json de l'extension et pointant vers un fichier JavaScript Ă enregistrer, soit une propriĂ©tĂ© nommĂ©e `code`, qui est un code JavaScript Ă enregistrer. + - `matchAboutBlank` {{Optional_Inline}} + - : Identique Ă `match_about_blank` dans la clĂ© [`user_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts). + - `matches` + - : Identique Ă `matches` dans la clĂ©Â [`user_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts). + - `runAt` {{Optional_Inline}} + - : Identique Ă `run_at` dans la clĂ©Â [`user_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts). + +Contrairement aux options de script de contenu, l'objet userScriptOptions n'a pas de propriĂ©tĂ© css. Utilisez {{WebExtAPIRef("contentScripts.register","contentScripts.register()")}} pour enregistrer/dĂ©senregistrer dynamiquement les feuilles de style). + +### Valeur retournĂ©e + +Une {{JSxRef("Promise")}} qui sera rempli avec un objet {{WebExtAPIRef("userScripts.RegisteredUserScript","RegisteredUserScript")}} que vous pouvez utiliser pour dĂ©sinscrire ce script utilisateur particulier. + +> **Note :** Actuellement, les scripts utilisateur sont dĂ©senregistrĂ©s lorsque la page d'extension correspondante (Ă partir de laquelle les scripts utilisateur ont Ă©tĂ© enregistrĂ©s) est dĂ©chargĂ©e, vous devez donc enregistrer un script utilisateur depuis une page d'extension qui persiste au moins aussi longtemps que vous voulez que les scripts utilisateur restent enregistrĂ©s. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.userScripts.register", 10)}} + +## Voir aussi + +- {{WebExtAPIRef("contentScripts.register","contentScripts.register()")}} +- {{WebExtAPIRef("userScripts.RegisteredUserScript.unregister","RegisteredUserScript.unregister()")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/userscripts/registereduserscript/index.md b/files/fr/mozilla/add-ons/webextensions/api/userscripts/registereduserscript/index.md index 1499868cbc..9b1c23358a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/userscripts/registereduserscript/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/userscripts/registereduserscript/index.md @@ -10,23 +10,19 @@ tags: - userScripts translation_of: Mozilla/Add-ons/WebExtensions/API/userScripts/RegisteredUserScript --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>Un RegisteredUserScript est retournĂ© par un appel Ă {{WebExtAPIRef("userScripts.register","userScripts.register()")}} et reprĂ©sente les scripts utilisateur enregistrĂ©s dans cet appel.</p> +Un RegisteredUserScript est retournĂ© par un appel Ă {{WebExtAPIRef("userScripts.register","userScripts.register()")}} et reprĂ©sente les scripts utilisateur enregistrĂ©s dans cet appel. -<p>L'objet dĂ©finit une mĂ©thode unique, {{WebExtAPIRef("userScripts.RegisteredUserScript.unregister","unregister()")}}, qui peut ĂȘtre utilisĂ©e pour dĂ©sinscrire les scripts utilisateur.</p> +L'objet dĂ©finit une mĂ©thode unique, {{WebExtAPIRef("userScripts.RegisteredUserScript.unregister","unregister()")}}, qui peut ĂȘtre utilisĂ©e pour dĂ©sinscrire les scripts utilisateur. -<div class="blockIndicator note"> -<p><strong>Note:</strong> Si cet objet est dĂ©truit (par exemple parce qu'il sort du champ d'application), les scripts associĂ©s seront automatiquement dĂ©senregistrĂ©s, vous devez donc conserver une rĂ©fĂ©rence Ă cet objet aussi longtemps que vous voulez que les scripts de contenu restent enregistrĂ©s.</p> -</div> +> **Note :** Si cet objet est dĂ©truit (par exemple parce qu'il sort du champ d'application), les scripts associĂ©s seront automatiquement dĂ©senregistrĂ©s, vous devez donc conserver une rĂ©fĂ©rence Ă cet objet aussi longtemps que vous voulez que les scripts de contenu restent enregistrĂ©s. -<h2 id="MĂ©thodes">MĂ©thodes</h2> +## MĂ©thodes -<dl> - <dt>{{WebExtAPIRef("userScripts.RegisteredUserScript.unregister","unregister()")}}</dt> - <dd>DĂ©senregistre les scripts utilisateurs reprĂ©sentĂ©s par cet objet.</dd> -</dl> +- {{WebExtAPIRef("userScripts.RegisteredUserScript.unregister","unregister()")}} + - : DĂ©senregistre les scripts utilisateurs reprĂ©sentĂ©s par cet objet. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.userScripts.RegisteredUserScript", 10)}}</p> +{{Compat("webextensions.api.userScripts.RegisteredUserScript", 10)}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/userscripts/registereduserscript/unregister/index.md b/files/fr/mozilla/add-ons/webextensions/api/userscripts/registereduserscript/unregister/index.md index fb1508e240..b3a69c7c42 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/userscripts/registereduserscript/unregister/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/userscripts/registereduserscript/unregister/index.md @@ -11,37 +11,35 @@ tags: - userScripts translation_of: Mozilla/Add-ons/WebExtensions/API/userScripts/RegisteredUserScript/unregister --- -<p>{{AddonSidebar}}</p> +{{AddonSidebar}} -<p>La mĂ©thode <code>unregister()</code> de l'interface {{WebExtAPIRef("userScripts.RegisteredUserScript","RegisteredUserScript")}} dĂ©senregistre le script utilisateur reprĂ©sentĂ© par cette instance d'interface et prĂ©cĂ©demment enregistrĂ© via {{WebExtAPIRef("userScripts.register","userScripts.register()")}}.</p> +La mĂ©thode `unregister()` de l'interface {{WebExtAPIRef("userScripts.RegisteredUserScript","RegisteredUserScript")}} dĂ©senregistre le script utilisateur reprĂ©sentĂ© par cette instance d'interface et prĂ©cĂ©demment enregistrĂ© via {{WebExtAPIRef("userScripts.register","userScripts.register()")}}. -<div class="blockIndicator note"> -<p><strong>Note:</strong> Les scripts utilisateur sont automatiquement dĂ©senregistrĂ©s lorsque la page d'extension correspondante (Ă partir de laquelle les scripts utilisateur ont Ă©tĂ© enregistrĂ©s) est dĂ©chargĂ©e, vous devez donc enregistrer un script utilisateur depuis une page d'extension qui persiste au moins aussi longtemps que vous voulez que les scripts utilisateur restent enregistrĂ©s..</p> -</div> +> **Note :** Les scripts utilisateur sont automatiquement dĂ©senregistrĂ©s lorsque la page d'extension correspondante (Ă partir de laquelle les scripts utilisateur ont Ă©tĂ© enregistrĂ©s) est dĂ©chargĂ©e, vous devez donc enregistrer un script utilisateur depuis une page d'extension qui persiste au moins aussi longtemps que vous voulez que les scripts utilisateur restent enregistrĂ©s.. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">const registeredUserScript = await browser.userScripts.register( +```js +const registeredUserScript = await browser.userScripts.register( userScriptOptions // object ); ⊠-await registeredUserScript.unregister()</pre> +await registeredUserScript.unregister() +``` -<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 {{JSxRef("Promise")}} qui sera rĂ©solu une fois le script utilisateur dĂ©senregistrĂ©. La promesse ne rapporte rien.</p> +Une {{JSxRef("Promise")}} qui sera rĂ©solu une fois le script utilisateur dĂ©senregistrĂ©. La promesse ne rapporte rien. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.userScripts.RegisteredUserScript.unregister")}}</p> +{{Compat("webextensions.api.userScripts.RegisteredUserScript.unregister")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{WebExtAPIRef("userScripts.register","userScripts.register()")}}</li> - <li>{{WebExtAPIRef("userScripts.RegisteredUserScript","RegisteredUserScript")}}</li> -</ul> +- {{WebExtAPIRef("userScripts.register","userScripts.register()")}} +- {{WebExtAPIRef("userScripts.RegisteredUserScript","RegisteredUserScript")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/userscripts/userscriptoptions/index.md b/files/fr/mozilla/add-ons/webextensions/api/userscripts/userscriptoptions/index.md index 2df59cf18b..c73128dc6a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/userscripts/userscriptoptions/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/userscripts/userscriptoptions/index.md @@ -13,36 +13,32 @@ tags: - userScripts translation_of: Mozilla/Add-ons/WebExtensions/API/userScripts/UserScriptOptions --- -<p>{{AddonSidebar}}</p> +{{AddonSidebar}} -<p>L'objet UserScriptOptions reprĂ©sente les scripts de contenu Ă enregistrer. Sa syntaxe est similaire Ă celle des options contentScript prises en charge par browser.contentScripts.register. Les diffĂ©rences sont les suivantes :</p> +L'objet UserScriptOptions reprĂ©sente les scripts de contenu Ă enregistrer. Sa syntaxe est similaire Ă celle des options contentScript prises en charge par browser.contentScripts.register. Les diffĂ©rences sont les suivantes : -<ul> - <li>il ne prend pas en charge une propriĂ©tĂ© css (utilisez browser.contentScripts.register pour enregistrer/dĂ©senregistrer dynamiquement les feuilles de style)</li> - <li>Il supporte une propriĂ©tĂ© optionnelle scriptMetadata (comme un objet JSON simple qui contient certaines propriĂ©tĂ©s de mĂ©tadonnĂ©es associĂ©es aux userScripts enregistrĂ©s)</li> -</ul> +- il ne prend pas en charge une propriĂ©tĂ© css (utilisez browser.contentScripts.register pour enregistrer/dĂ©senregistrer dynamiquement les feuilles de style) +- Il supporte une propriĂ©tĂ© optionnelle scriptMetadata (comme un objet JSON simple qui contient certaines propriĂ©tĂ©s de mĂ©tadonnĂ©es associĂ©es aux userScripts enregistrĂ©s) -<p>L'objet UserScriptOptions a les propriĂ©tĂ©s suivantes :</p> +L'objet UserScriptOptions a les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>allFrames</code>{{optional_inline}}</dt> - <dd>MĂȘme chose que <code>all_frames</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>excludeGlobs</code>{{optional_inline}}</dt> - <dd>MĂȘme chose que <code>exclude_globs</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>excludeMatches</code>{{optional_inline}}</dt> - <dd>MĂȘme chose que <code>exclude_matches</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>includeGlobs</code>{{optional_inline}}</dt> - <dd>MĂȘme chose que <code>include_globs</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>js</code>{{optional_inline}}</dt> - <dd>Un ensemble d'objets. Chaque objet a soit une propriĂ©tĂ© nommĂ©e <code>file</code>, qui est une URL commençant Ă l'extension manifest.json et pointant vers un fichier JavaScript Ă enregistrer, soit une propriĂ©tĂ© nommĂ©e <code>code</code>, qui est un code JavaScript Ă enregistrer.</dd> - <dt><code>matchAboutBlank</code>{{optional_inline}}</dt> - <dd>MĂȘme chose que <code>match_about_blank</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>matches</code></dt> - <dd>MĂȘme chose que <code>matches</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>runAt</code>{{optional_inline}}</dt> - <dd>MĂȘme chose que <code>run_at</code> dans la clĂ© <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code>.</dd> - <dt><code>scriptMetadata</code> {{optional_inline}}</dt> - <dd>Une valeur de mĂ©tadonnĂ©es de script utilisateur</dd> -</dl> +- `allFrames`{{optional_inline}} + - : MĂȘme chose que `all_frames` dans la clĂ© [`content_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts). +- `excludeGlobs`{{optional_inline}} + - : MĂȘme chose que `exclude_globs` dans la clĂ© [`content_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts). +- `excludeMatches`{{optional_inline}} + - : MĂȘme chose que `exclude_matches` dans la clĂ© [`content_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts). +- `includeGlobs`{{optional_inline}} + - : MĂȘme chose que `include_globs` dans la clĂ© [`content_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts). +- `js`{{optional_inline}} + - : Un ensemble d'objets. Chaque objet a soit une propriĂ©tĂ© nommĂ©e `file`, qui est une URL commençant Ă l'extension manifest.json et pointant vers un fichier JavaScript Ă enregistrer, soit une propriĂ©tĂ© nommĂ©e `code`, qui est un code JavaScript Ă enregistrer. +- `matchAboutBlank`{{optional_inline}} + - : MĂȘme chose que `match_about_blank` dans la clĂ© [`content_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts). +- `matches` + - : MĂȘme chose que `matches` dans la clĂ© [`content_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts). +- `runAt`{{optional_inline}} + - : MĂȘme chose que `run_at` dans la clĂ© [`content_scripts`](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts). +- `scriptMetadata` {{optional_inline}} + - : Une valeur de mĂ©tadonnĂ©es de script utilisateur -<p>Sa syntaxe est similaire Ă celle des options contentScript prises en charge par browser.contentScripts.register.</p> +Sa syntaxe est similaire Ă celle des options contentScript prises en charge par browser.contentScripts.register. diff --git a/files/fr/mozilla/add-ons/webextensions/api/userscripts/working_with_userscripts/index.md b/files/fr/mozilla/add-ons/webextensions/api/userscripts/working_with_userscripts/index.md index 4e6c4824a3..db86b92a39 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/userscripts/working_with_userscripts/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/userscripts/working_with_userscripts/index.md @@ -10,51 +10,52 @@ tags: translation_of: Mozilla/Add-ons/WebExtensions/API/userScripts/Working_with_userScripts original_slug: Mozilla/Add-ons/WebExtensions/API/userScripts/travailler_avec_userScripts --- -<p>{{draft}}</p> +{{draft}} -<p>{{AddonSidebar}}</p> +{{AddonSidebar}} -<p>En implĂ©mentant userScripts, les dĂ©veloppeurs d'extension peuvent modifier l'apparence et/ou le fonctionnement des sites pour mieux rĂ©pondre aux besoins des utilisateurs.</p> +En implĂ©mentant userScripts, les dĂ©veloppeurs d'extension peuvent modifier l'apparence et/ou le fonctionnement des sites pour mieux rĂ©pondre aux besoins des utilisateurs. -<p>ImplĂ©mentez userScripts dans votre extension en suivant les Ă©tapes suivantes :</p> +ImplĂ©mentez userScripts dans votre extension en suivant les Ă©tapes suivantes : -<ol> - <li>DĂ©finissez le script dans le manifeste de l'extension Ă l'aide de la clĂ© <code>"user_scripts"</code>.</li> - <li>Enregistrer le userScript</li> - <li>ImplĂ©menter les fonctions userScript</li> -</ol> +1. DĂ©finissez le script dans le manifeste de l'extension Ă l'aide de la clĂ© `"user_scripts"`. +2. Enregistrer le userScript +3. ImplĂ©menter les fonctions userScript -<p>Passons en revue les processus Ă l'aide d'un petit exemple d'extension Web qui illustre le processus. L'exemple est disponible dans le dĂ©pĂŽt <a href="https://github.com/mdn/webextensions-examples">webextensions-examples</a> sur GitHub.</p> +Passons en revue les processus Ă l'aide d'un petit exemple d'extension Web qui illustre le processus. L'exemple est disponible dans le dĂ©pĂŽt [webextensions-examples](https://github.com/mdn/webextensions-examples) sur GitHub. -<h2 id="Manifest_userScripts">Manifest userScripts</h2> +## Manifest userScripts -<p>Un script utilisateur est identifiĂ© par le contenu de la clĂ© <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts">user_scripts</a> du manifeste des extensions. L'information minimale pour la clĂ© <code>user_scripts</code> serait :</p> +Un script utilisateur est identifiĂ© par le contenu de la clĂ© [user_scripts](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/user_scripts) du manifeste des extensions. L'information minimale pour la clĂ© `user_scripts` serait : -<pre class="brush: json"> "user_scripts": { +```json + "user_scripts": { "api_script": "customUserScriptAPIs.js" - }</pre> + } +``` -<p>La propriĂ©tĂ© "api_script" indique le chemin d'accĂšs au fichier JavaScript qui contient le code du <code>userScript</code>.</p> +La propriĂ©tĂ© "api_script" indique le chemin d'accĂšs au fichier JavaScript qui contient le code du `userScript`. -<h2 id="Charge_lextension_dexemple">Charge l'extension d'exemple</h2> +## Charge l'extension d'exemple -<p>Une fois que vous avez tĂ©lĂ©chargĂ© l'exemple :</p> +Une fois que vous avez tĂ©lĂ©chargĂ© l'exemple : -<p>Naviguez jusqu'Ă about:debugging, cliquez sur <strong>Charger temporairement une extension... </strong>et double-cliquez sur le manifest des extensions.</p> +Naviguez jusqu'Ă about:debugging, cliquez sur **Charger temporairement une extension...** et double-cliquez sur le manifest des extensions. -<p>/Le code par dĂ©faut inclus dans l'exemple vous permet de charger un <code>userScript</code> qui va "manger" le contenu des pages correspondant Ă l'entrĂ©e Hosts. Effectuez tous les changements que vous voulez faire avant de cliquer sur le bouton <strong>Enregistrer le script</strong> au bas du panneau.</p> +/Le code par dĂ©faut inclus dans l'exemple vous permet de charger un `userScript` qui va "manger" le contenu des pages correspondant Ă l'entrĂ©e Hosts. Effectuez tous les changements que vous voulez faire avant de cliquer sur le bouton **Enregistrer le script** au bas du panneau. -<p>Dans l'image suivante, l'extension va "manger" le contenu des pages dont le nom de domaine se termine par.org. C'est le comportement par dĂ©faut pour cette extension.</p> +Dans l'image suivante, l'extension va "manger" le contenu des pages dont le nom de domaine se termine par.org. C'est le comportement par dĂ©faut pour cette extension. -<p><img alt="" src="userScriptExample.png"></p> +![](userScriptExample.png) -<p>Rien ne se passera tant que vous n'aurez pas cliquĂ© sur le bouton <strong>Enregistrer le script</strong>. Le bouton implĂ©mente le script utilisateur en fonction des paramĂštres de cette boĂźte de dialogue. Cela signifie que vous pouvez expĂ©rimenter le comportement du script sans avoir Ă implĂ©menter une extension vous-mĂȘme.</p> +Rien ne se passera tant que vous n'aurez pas cliquĂ© sur le bouton **Enregistrer le script**. Le bouton implĂ©mente le script utilisateur en fonction des paramĂštres de cette boĂźte de dialogue. Cela signifie que vous pouvez expĂ©rimenter le comportement du script sans avoir Ă implĂ©menter une extension vous-mĂȘme. -<h2 id="Register_the_userScript">Register the userScript</h2> +## Register the userScript -<p>Avant qu'un userScript puisse ĂȘtre exĂ©cutĂ©, il doit ĂȘtre enregistrĂ© en utilisant la mĂ©thode <code>userScripts.register()</code>. Voici le code pour enregistrer l'extension d'exemple :</p> +Avant qu'un userScript puisse ĂȘtre exĂ©cutĂ©, il doit ĂȘtre enregistrĂ© en utilisant la mĂ©thode `userScripts.register()`. Voici le code pour enregistrer l'extension d'exemple : -<pre class="brush: js">async function registerScript() { +```js +async function registerScript() { const params = { hosts: stringToArray(hostsInput.value), code: codeInput.value, @@ -97,20 +98,19 @@ original_slug: Mozilla/Add-ons/WebExtensions/API/userScripts/travailler_avec_use // Store the last error. await browser.storage.local.set({lastError}); } -}</pre> +} +``` -<p>Ce code initialise d'abord l'objet params pour passer les valeurs Ă la mĂ©thode <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/userScripts/register">userScripts.register</a>.</p> +Ce code initialise d'abord l'objet params pour passer les valeurs Ă la mĂ©thode [userScripts.register](/fr/docs/Mozilla/Add-ons/WebExtensions/API/userScripts/register). -<h2 id="Implementer_les_fonctions_userScript">Implementer les fonctions userScript</h2> +## Implementer les fonctions userScript -<p>Une fois le script enregistrĂ©, naviguez vers une page dont le nom de domaine se termine par .org, et vous verrez quelque chose comme ceci :</p> +Une fois le script enregistrĂ©, naviguez vers une page dont le nom de domaine se termine par .org, et vous verrez quelque chose comme ceci : -<p><img alt="" src="user_script_in_action.png"></p> +![](user_script_in_action.png) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{WebExtAPIRef("userScripts")}}</li> - <li>{{WebExtAPIRef("userScripts.register()", "userScripts.register()")}}</li> - <li>{{WebExtAPIRef("userScripts.onBeforeScript")}}</li> -</ul> +- {{WebExtAPIRef("userScripts")}} +- {{WebExtAPIRef("userScripts.register()", "userScripts.register()")}} +- {{WebExtAPIRef("userScripts.onBeforeScript")}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/getallframes/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/getallframes/index.md index c29b1fbdac..25144e780d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/getallframes/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/getallframes/index.md @@ -13,59 +13,56 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/getAllFrames --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ătant donnĂ© un ID d'onglet, rĂ©cupĂšre des informations sur toutes les images qu'il contient.</p> +Ătant donnĂ© un ID d'onglet, rĂ©cupĂšre des informations sur toutes les images qu'il contient. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est 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 gettingFrames = browser.webNavigation.getAllFrames( +```js +var gettingFrames = browser.webNavigation.getAllFrames( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Informations sur l'onglet pour rĂ©cupĂ©rer toutes les images.</p> - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'identifiant de l'onglet</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. Informations sur l'onglet pour rĂ©cupĂ©rer toutes les images. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera accompli avec un tableau d'objets, dont chacun a les propriĂ©tĂ©s suivantes :</p> + - `tabId` + - : `integer`. L'identifiant de l'onglet -<dl> - <dt><code>errorOccurred</code></dt> - <dd><code>boolean</code>. Vrai si la derniĂšre navigation dans cette trame a Ă©tĂ© interrompue par une erreur, c'est-Ă -dire l'Ă©vĂ©nement {{WebExtAPIRef("webNavigation.onErrorOccurred", "onErrorOccurred")}} dĂ©clenchĂ©.</dd> - <dt><code>processId</code></dt> - <dd><code>integer</code>. L'ID du processus exĂ©cutant le moteur de rendu pour cet onglet.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. L'identifiant de l'image Si c'est l'image principale, alors <code>frameId</code> est nul.</dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. ID du parent de cette image. C'est -1 s'il n'y a pas de cadre parent: c'est-Ă -dire si ce cadre est le contexte de navigation de niveau supĂ©rieur dans l'onglet.</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL actuellement associĂ©e Ă ce cadre.</dd> -</dl> +### Valeur retournĂ©e -<p>Si l'onglet spĂ©cifiĂ© n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera accompli avec un tableau d'objets, dont chacun a les propriĂ©tĂ©s suivantes : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- `errorOccurred` + - : `boolean`. Vrai si la derniĂšre navigation dans cette trame a Ă©tĂ© interrompue par une erreur, c'est-Ă -dire l'Ă©vĂ©nement {{WebExtAPIRef("webNavigation.onErrorOccurred", "onErrorOccurred")}} dĂ©clenchĂ©. +- `processId` + - : `integer`. L'ID du processus exĂ©cutant le moteur de rendu pour cet onglet. +- `frameId` + - : `integer`. L'identifiant de l'image Si c'est l'image principale, alors `frameId` est nul. +- `parentFrameId` + - : `integer`. ID du parent de cette image. C'est -1 s'il n'y a pas de cadre parent: c'est-Ă -dire si ce cadre est le contexte de navigation de niveau supĂ©rieur dans l'onglet. +- `url` + - : `string`. L'URL actuellement associĂ©e Ă ce cadre. -<p>{{Compat("webextensions.api.webNavigation.getAllFrames")}}</p> +Si l'onglet spĂ©cifiĂ© n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Ce code enregistre les URL de toutes les images dans l'onglet actif, lorsque l'utilisateur clique sur une action du navigateur :</p> +{{Compat("webextensions.api.webNavigation.getAllFrames")}} -<pre class="brush: js">function logFrameInfo(framesInfo) { +## Exemples + +Ce code enregistre les URL de toutes les images dans l'onglet actif, lorsque l'utilisateur clique sur une action du navigateur : + +```js +function logFrameInfo(framesInfo) { for (frameInfo of framesInfo) { console.log(frameInfo); } @@ -89,19 +86,18 @@ browser.browserAction.onClicked.addListener(function() { querying.then(logAllFrames, onError); -});</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/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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 @@ -128,5 +124,4 @@ browser.browserAction.onClicked.addListener(function() { // 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/webnavigation/getframe/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/getframe/index.md index 01224eafff..a2bc25de1c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/getframe/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/getframe/index.md @@ -13,57 +13,54 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/getFrame --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>RĂ©cupĂšre des informations sur un cadre particulier. Un cadre peut ĂȘtre l'image de niveau supĂ©rieur dans un onglet ou un <a href="/fr/docs/Web/HTML/Element/iframe">iframe</a> imbriquĂ©, et est identifiĂ© de maniĂšre unique par un ID de tabulation et un ID de cadre.</p> +RĂ©cupĂšre des informations sur un cadre particulier. Un cadre peut ĂȘtre l'image de niveau supĂ©rieur dans un onglet ou un [iframe](/fr/docs/Web/HTML/Element/iframe) imbriquĂ©, et est identifiĂ© de maniĂšre unique par un ID de tabulation et un ID de cadre. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var gettingFrame = browser.webNavigation.getFrame( +```js +var gettingFrame = browser.webNavigation.getFrame( details // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Informations sur le cadre pour rĂ©cupĂ©rer des informations sur :</p> - <dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet dans lequel se trouve le cadre.</dd> - <dt><code>processId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. L'ID du processus exĂ©cutant le moteur de rendu pour cet onglet.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. L'ID du cadre dans l'onglet donnĂ©.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. Informations sur le cadre pour rĂ©cupĂ©rer des informations sur : -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promise</a></code> qui sera rempli avec un objet contenant les propriĂ©tĂ©s suivantes :</p> + - `tabId` + - : `integer`. L'ID de l'onglet dans lequel se trouve le cadre. + - `processId` {{optional_inline}} + - : `integer`. L'ID du processus exĂ©cutant le moteur de rendu pour cet onglet. + - `frameId` + - : `integer`. L'ID du cadre dans l'onglet donnĂ©. -<dl> - <dt><code>errorOccurred</code></dt> - <dd><code>boolean</code>. Vrai si la derniĂšre navigation dans cette trame a Ă©tĂ© interrompue par une erreur, c'est-Ă -dire l'Ă©vĂ©nement {{WebExtAPIRef("webNavigation.onErrorOccurred", "onErrorOccurred")}} dĂ©clenchĂ©.</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL actuellement associĂ©e Ă cette trame, si la trame identifiĂ©e par <code>frameId</code> existait Ă un point de l'onglet identifiĂ© par <code>tabId</code>. Le fait qu'une URL soit associĂ©e Ă un <code>frameId</code> donnĂ© n'implique pas que la trame correspondante existe toujours.</dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. ID du parent de cette image. C'est -1 s'il n'y a pas de cadre parent: c'est-Ă -dire si ce cadre est le contexte de navigation de niveau supĂ©rieur dans l'onglet.</dd> -</dl> +### Valeur retournĂ©e -<p>Si l'onglet ou l'ID de trame spĂ©cifiĂ© n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise) qui sera rempli avec un objet contenant les propriĂ©tĂ©s suivantes : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- `errorOccurred` + - : `boolean`. Vrai si la derniĂšre navigation dans cette trame a Ă©tĂ© interrompue par une erreur, c'est-Ă -dire l'Ă©vĂ©nement {{WebExtAPIRef("webNavigation.onErrorOccurred", "onErrorOccurred")}} dĂ©clenchĂ©. +- `url` + - : `string`. L'URL actuellement associĂ©e Ă cette trame, si la trame identifiĂ©e par `frameId` existait Ă un point de l'onglet identifiĂ© par `tabId`. Le fait qu'une URL soit associĂ©e Ă un `frameId` donnĂ© n'implique pas que la trame correspondante existe toujours. +- `parentFrameId` + - : `integer`. ID du parent de cette image. C'est -1 s'il n'y a pas de cadre parent: c'est-Ă -dire si ce cadre est le contexte de navigation de niveau supĂ©rieur dans l'onglet. -<p>{{Compat("webextensions.api.webNavigation.getFrame")}}</p> +Si l'onglet ou l'ID de trame spĂ©cifiĂ© n'a pas pu ĂȘtre trouvĂ© ou qu'une autre erreur se produit, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<pre class="brush: js">function onGot(frameInfo) { +{{Compat("webextensions.api.webNavigation.getFrame")}} + +## Exemples + +```js +function onGot(frameInfo) { console.log(frameInfo); } @@ -80,19 +77,17 @@ var gettingFrame = browser.webNavigation.getFrame({ //var gettingFrame = browser.webNavigation.getFrame({ tabId: 19, processId: 0, frameId: 1537 }); gettingFrame.then(onGot, onError); -</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/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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 @@ -119,5 +114,4 @@ gettingFrame.then(onGot, onError); // 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/webnavigation/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/index.md index d1cb34e07f..a188bd08e6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/index.md @@ -12,107 +12,86 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation --- -<div>{{AddonSidebar}}</div> - -<p>Ajouter des Ă©couteurs d'Ă©vĂ©nement pour les diffĂ©rentes Ă©tapes d'une navigation. Une navigation se compose d'un cadre dans le navigateur passant d'une URL Ă l'autre, gĂ©nĂ©ralement (mais pas toujours) en rĂ©ponse Ă une action de l'utilisateur comme cliquer sur un lien ou entrer une URL dans la barre d'adresse.</p> - -<p>Comparable Ă l'API {{WebExtAPIRef("webRequest")}}: Les navigations entrainent le navigateur Ă faire des requetes web, mais l'API webRequest travaille au niveau infĂ©rieur de la couche HTTP, contrairement Ă l'API webNavigation qui travaille directement au niveau de l'interface utilisateur du navigateur elle-mĂȘme.</p> - -<p>Chaque evenement correspond directement Ă un Ă©tat prĂ©cis dans la navigation. La sĂ©quence des Ă©venements est comme suit:</p> - -<p><img alt="" src="we-flow.png"></p> - -<ul> - <li>Le flux primaire est : - <ul> - <li><code>{{WebExtAPIRef("webNavigation.onBeforeNavigate", "onBeforeNavigate")}}</code></li> - <li><code>{{WebExtAPIRef("webNavigation.onCommitted", "onCommitted")}}</code></li> - <li><code>{{WebExtAPIRef("webNavigation.onDOMContentLoaded", "onDOMContentLoaded")}}</code></li> - <li><code>{{WebExtAPIRef("webNavigation.onCompleted", "onCompleted")}}</code>.</li> - </ul> - </li> - <li>Adionellement : - <ul> - <li><code>{{WebExtAPIRef("webNavigation.onCreatedNavigationTarget", "onCreatedNavigationTarget")}}</code> est dĂ©clenchĂ© avant <code>onBeforeNavigate</code> si le navigateur a besoin de crĂ©er un nouvel onglet ou une nouvelle fenĂȘtre pour la navigation (par exemple, parce que l'utilisateur a ouvert un lien dans un nouvel onglet).</li> - <li>{{WebExtAPIRef("webNavigation.onHistoryStateUpdated", "onHistoryStateUpdated")}} est dĂ©clenchĂ© si une page utilise l'<a href="http://diveintohtml5.info/history.html">API historique</a> pour mettre Ă jour l'URL affichĂ©e dans la barre d'adresse du navigateur.</li> - <li>{{WebExtAPIRef("webNavigation.onReferenceFragmentUpdated", "onReferenceFragmentUpdated")}} est dĂ©clenchĂ© si <a href="https://en.wikipedia.org/wiki/Fragment_identifier">fl'identificateur de fragment</a> d'une page est modifiĂ©.</li> - <li>{{WebExtAPIRef("webNavigation.onErrorOccurred", "onErrorOccurred")}} peut ĂȘtre dĂ©clenchĂ© Ă tout moment.</li> - </ul> - </li> -</ul> - -<p>Chaque navigation est une transition d'URL dans un cadre de navigateur particulier. Le cadre du navigateur est identifiĂ© par un ID d'onglet et un ID de trame. Le cadre peut ĂȘtre le contexte de navigation de niveau supĂ©rieur dans l'onglet ou peut ĂȘtre un contexte de navigation imbriquĂ© implĂ©mentĂ© en tant qu'<a href="/fr/docs/Web/HTML/Element/iframe">iframe</a>.</p> - -<p>L'appel <code>addListener()</code> de chaque Ă©vĂ©nement accepte un paramĂštre de filtre facultatif. Le filtre spĂ©cifiera un ou plusieurs modĂšles d'URL, et l'Ă©vĂ©nement ne sera alors dĂ©clenchĂ© que pour les navigations dans lesquelles l'URL cible correspond Ă l'un des modĂšles.</p> - -<p>L'Ă©couteur d'Ă©vĂ©nement <code>onCommitted</code>reçoit deux propriĂ©tĂ©s supplĂ©mentaires : un {{WebExtAPIRef("webNavigation.TransitionType","TransitionType")}} indiquant la cause de la navigation (par exemple, parce que l'utilisateur a cliquĂ© sur un lien ou parce que l'utilisateur a sĂ©lectionnĂ© un signet), et un {{WebExtAPIRef("webNavigation.TransitionQualifier","TransitionQualifier")}} fournissant plus d'informations sur la navigation.</p> - -<p>Pour utiliser cette API, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "webNavigation".</p> - -<h2 id="Types">Types</h2> - -<dl> - <dt>{{WebExtAPIRef("webNavigation.TransitionType")}}</dt> - <dd>Cause de la navigation: par exemple, l'utilisateur a cliquĂ© sur un lien, ou a tapĂ© une adresse, ou a cliquĂ© sur un signet.</dd> - <dt>{{WebExtAPIRef("webNavigation.TransitionQualifier")}}</dt> - <dd> - <div>Informations supplĂ©mentaires sur une transition.</div> - </dd> -</dl> - -<h2 id="Functions">Functions</h2> - -<dl> - <dt>{{WebExtAPIRef("webNavigation.getFrame()")}}</dt> - <dd>RĂ©cupĂšre des informations sur un cadre particulier. Ce cadre peut ĂȘtre le cadre de niveau supĂ©rieur dans un onglet ou un <a href="/fr/docs/Web/HTML/Element/iframe">iframe</a> imbriquĂ©, et est identifiĂ© de maniĂšre unique par un ID d'onglet et un ID de <em>frame</em>.</dd> - <dt>{{WebExtAPIRef("webNavigation.getAllFrames()")}}</dt> - <dd> - <p>Ătant donnĂ© un ID d'onglet, rĂ©cupĂšre des informations sur tous les cadres qu'il contient.</p> - </dd> -</dl> - -<h2 id="Events">Events</h2> - -<dl> - <dt>{{WebExtAPIRef("webNavigation.onBeforeNavigate")}}</dt> - <dd> - <p>LancĂ© lorsque le navigateur est sur le point de dĂ©marrer un Ă©vĂ©nement de navigation.</p> - </dd> - <dt>{{WebExtAPIRef("webNavigation.onCommitted")}}</dt> - <dd>LancĂ© lorsqu'une navigation est validĂ©e. Au moins une partie du nouveau document a Ă©tĂ© reçue du serveur et le navigateur a dĂ©cidĂ© de passer au nouveau document.</dd> - <dt>{{WebExtAPIRef("webNavigation.onDOMContentLoaded")}}</dt> - <dd>LancĂ© lorsque l'Ă©vĂ©nement <a href="/fr/docs/Web/Events/DOMContentLoaded">DOMContentLoaded</a> est dĂ©clenchĂ© dans la page.</dd> - <dt>{{WebExtAPIRef("webNavigation.onCompleted")}}</dt> - <dd>LancĂ© lorsqu'un document, y compris les ressources auxquelles il fait rĂ©fĂ©rence, est complĂštement chargĂ© et initialisĂ©. Ceci est Ă©quivalent Ă l'Ă©vĂ©nement de <code><a href="/fr/docs/Web/Events/load">chargement</a></code> du DOM.</dd> - <dt>{{WebExtAPIRef("webNavigation.onErrorOccurred")}}</dt> - <dd>LancĂ© lorsqu'une erreur se produit et que la navigation est annulĂ©e. Cela peut se produire si une erreur rĂ©seau s'est produite ou si l'utilisateur a interrompu la navigation.</dd> - <dt>{{WebExtAPIRef("webNavigation.onCreatedNavigationTarget")}}</dt> - <dd>LancĂ© lorsqu'une nouvelle fenĂȘtre ou un nouvel onglet dans une fenĂȘtre existante est crĂ©Ă© pour hĂ©berger une navigation: par exemple, si l'utilisateur ouvre un lien dans un nouvel onglet.</dd> - <dt>{{WebExtAPIRef("webNavigation.onReferenceFragmentUpdated")}}</dt> - <dd>LancĂ© si l' <a href="https://en.wikipedia.org/wiki/Fragment_identifier">identificateur de fragment</a> d'une page a Ă©tĂ© modifiĂ©.</dd> - <dt>{{WebExtAPIRef("webNavigation.onTabReplaced")}}</dt> - <dd> - <p>LancĂ© lorsque le contenu de l'onglet est remplacĂ© par un onglet diffĂ©rent (gĂ©nĂ©ralement prĂ©cĂ©demment prĂ©-rendu).</p> - </dd> - <dt>{{WebExtAPIRef("webNavigation.onHistoryStateUpdated")}}</dt> - <dd>LancĂ© lorsque la page a utilisĂ© l' <a href="http://diveintohtml5.info/history.html">API d'histoirique</a> pour mettre Ă jour l'URL affichĂ©e dans la barre d'adresse du navigateur.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webNavigation")}}</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/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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}} + +Ajouter des Ă©couteurs d'Ă©vĂ©nement pour les diffĂ©rentes Ă©tapes d'une navigation. Une navigation se compose d'un cadre dans le navigateur passant d'une URL Ă l'autre, gĂ©nĂ©ralement (mais pas toujours) en rĂ©ponse Ă une action de l'utilisateur comme cliquer sur un lien ou entrer une URL dans la barre d'adresse. + +Comparable Ă l'API {{WebExtAPIRef("webRequest")}}: Les navigations entrainent le navigateur Ă faire des requetes web, mais l'API webRequest travaille au niveau infĂ©rieur de la couche HTTP, contrairement Ă l'API webNavigation qui travaille directement au niveau de l'interface utilisateur du navigateur elle-mĂȘme. + +Chaque evenement correspond directement Ă un Ă©tat prĂ©cis dans la navigation. La sĂ©quence des Ă©venements est comme suit: + +![](we-flow.png) + +- Le flux primaire est : + + - `{{WebExtAPIRef("webNavigation.onBeforeNavigate", "onBeforeNavigate")}}` + - `{{WebExtAPIRef("webNavigation.onCommitted", "onCommitted")}}` + - `{{WebExtAPIRef("webNavigation.onDOMContentLoaded", "onDOMContentLoaded")}}` + - `{{WebExtAPIRef("webNavigation.onCompleted", "onCompleted")}}`. + +- Adionellement : + + - `{{WebExtAPIRef("webNavigation.onCreatedNavigationTarget", "onCreatedNavigationTarget")}}` est dĂ©clenchĂ© avant `onBeforeNavigate` si le navigateur a besoin de crĂ©er un nouvel onglet ou une nouvelle fenĂȘtre pour la navigation (par exemple, parce que l'utilisateur a ouvert un lien dans un nouvel onglet). + - {{WebExtAPIRef("webNavigation.onHistoryStateUpdated", "onHistoryStateUpdated")}} est dĂ©clenchĂ© si une page utilise l'[API historique](http://diveintohtml5.info/history.html) pour mettre Ă jour l'URL affichĂ©e dans la barre d'adresse du navigateur. + - {{WebExtAPIRef("webNavigation.onReferenceFragmentUpdated", "onReferenceFragmentUpdated")}} est dĂ©clenchĂ© si [fl'identificateur de fragment](https://en.wikipedia.org/wiki/Fragment_identifier) d'une page est modifiĂ©. + - {{WebExtAPIRef("webNavigation.onErrorOccurred", "onErrorOccurred")}} peut ĂȘtre dĂ©clenchĂ© Ă tout moment. + +Chaque navigation est une transition d'URL dans un cadre de navigateur particulier. Le cadre du navigateur est identifiĂ© par un ID d'onglet et un ID de trame. Le cadre peut ĂȘtre le contexte de navigation de niveau supĂ©rieur dans l'onglet ou peut ĂȘtre un contexte de navigation imbriquĂ© implĂ©mentĂ© en tant qu'[iframe](/fr/docs/Web/HTML/Element/iframe). + +L'appel `addListener()` de chaque Ă©vĂ©nement accepte un paramĂštre de filtre facultatif. Le filtre spĂ©cifiera un ou plusieurs modĂšles d'URL, et l'Ă©vĂ©nement ne sera alors dĂ©clenchĂ© que pour les navigations dans lesquelles l'URL cible correspond Ă l'un des modĂšles. + +L'Ă©couteur d'Ă©vĂ©nement `onCommitted`reçoit deux propriĂ©tĂ©s supplĂ©mentaires : un {{WebExtAPIRef("webNavigation.TransitionType","TransitionType")}} indiquant la cause de la navigation (par exemple, parce que l'utilisateur a cliquĂ© sur un lien ou parce que l'utilisateur a sĂ©lectionnĂ© un signet), et un {{WebExtAPIRef("webNavigation.TransitionQualifier","TransitionQualifier")}} fournissant plus d'informations sur la navigation. + +Pour utiliser cette API, vous devez avoir la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "webNavigation". + +## Types + +- {{WebExtAPIRef("webNavigation.TransitionType")}} + - : Cause de la navigation: par exemple, l'utilisateur a cliquĂ© sur un lien, ou a tapĂ© une adresse, ou a cliquĂ© sur un signet. +- {{WebExtAPIRef("webNavigation.TransitionQualifier")}} + - : Informations supplĂ©mentaires sur une transition. + +## Functions + +- {{WebExtAPIRef("webNavigation.getFrame()")}} + - : RĂ©cupĂšre des informations sur un cadre particulier. Ce cadre peut ĂȘtre le cadre de niveau supĂ©rieur dans un onglet ou un [iframe](/fr/docs/Web/HTML/Element/iframe) imbriquĂ©, et est identifiĂ© de maniĂšre unique par un ID d'onglet et un ID de _frame_. +- {{WebExtAPIRef("webNavigation.getAllFrames()")}} + - : Ătant donnĂ© un ID d'onglet, rĂ©cupĂšre des informations sur tous les cadres qu'il contient. + +## Events + +- {{WebExtAPIRef("webNavigation.onBeforeNavigate")}} + - : LancĂ© lorsque le navigateur est sur le point de dĂ©marrer un Ă©vĂ©nement de navigation. +- {{WebExtAPIRef("webNavigation.onCommitted")}} + - : LancĂ© lorsqu'une navigation est validĂ©e. Au moins une partie du nouveau document a Ă©tĂ© reçue du serveur et le navigateur a dĂ©cidĂ© de passer au nouveau document. +- {{WebExtAPIRef("webNavigation.onDOMContentLoaded")}} + - : LancĂ© lorsque l'Ă©vĂ©nement [DOMContentLoaded](/fr/docs/Web/Events/DOMContentLoaded) est dĂ©clenchĂ© dans la page. +- {{WebExtAPIRef("webNavigation.onCompleted")}} + - : LancĂ© lorsqu'un document, y compris les ressources auxquelles il fait rĂ©fĂ©rence, est complĂštement chargĂ© et initialisĂ©. Ceci est Ă©quivalent Ă l'Ă©vĂ©nement de [`chargement`](/fr/docs/Web/Events/load) du DOM. +- {{WebExtAPIRef("webNavigation.onErrorOccurred")}} + - : LancĂ© lorsqu'une erreur se produit et que la navigation est annulĂ©e. Cela peut se produire si une erreur rĂ©seau s'est produite ou si l'utilisateur a interrompu la navigation. +- {{WebExtAPIRef("webNavigation.onCreatedNavigationTarget")}} + - : LancĂ© lorsqu'une nouvelle fenĂȘtre ou un nouvel onglet dans une fenĂȘtre existante est crĂ©Ă© pour hĂ©berger une navigation: par exemple, si l'utilisateur ouvre un lien dans un nouvel onglet. +- {{WebExtAPIRef("webNavigation.onReferenceFragmentUpdated")}} + - : LancĂ© si l' [identificateur de fragment](https://en.wikipedia.org/wiki/Fragment_identifier) d'une page a Ă©tĂ© modifiĂ©. +- {{WebExtAPIRef("webNavigation.onTabReplaced")}} + - : LancĂ© lorsque le contenu de l'onglet est remplacĂ© par un onglet diffĂ©rent (gĂ©nĂ©ralement prĂ©cĂ©demment prĂ©-rendu). +- {{WebExtAPIRef("webNavigation.onHistoryStateUpdated")}} + - : LancĂ© lorsque la page a utilisĂ© l' [API d'histoirique](http://diveintohtml5.info/history.html) pour mettre Ă jour l'URL affichĂ©e dans la barre d'adresse du navigateur. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webNavigation")}} + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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 @@ -139,5 +118,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation // 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/webnavigation/onbeforenavigate/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onbeforenavigate/index.md index 2f335ff61c..6e12941043 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onbeforenavigate/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onbeforenavigate/index.md @@ -13,79 +13,71 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/onBeforeNavigate --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque le navigateur est sur le point de dĂ©marrer un Ă©vĂ©nement de navigation.</p> +LancĂ© lorsque le navigateur est sur le point de dĂ©marrer un Ă©vĂ©nement de navigation. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webNavigation.onBeforeNavigate.addListener( +```js +browser.webNavigation.onBeforeNavigate.addListener( listener, // function filter // optional object ) browser.webNavigation.onBeforeNavigate.removeListener(listener) browser.webNavigation.onBeforeNavigate.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> - -<h2 id="syntaxe_addListener">syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> - - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur l'Ă©vĂ©nement de navigation.</dd> - </dl> - </dd> - <dt><code>filter</code>{{optional_inline}}</dt> - <dd> - <p><code>object</code>. Un objet contenant une seule propriĂ©tĂ© <code>url</code>, qui est un <code>tableau</code> d'objets {{WebExtAPIRef("events.UrlFilter")}} objects.Un objet contenant une seule propriĂ©tĂ©Â qui correspondent Ă au moins un <code>UrlFilter</code> dans le tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions.</p> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet dans lequel la navigation est sur le point de se produire.</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL Ă laquelle le cadre donnĂ© va naviguer.</dd> - <dt><code>processId</code></dt> - <dd><code>integer</code>. L'ID du processus dans lequel cet onglet est rendu (Cette propriĂ©tĂ© <strong>n'est pas pris en charge sur Firefox</strong> et c'est <strong>dĂ©prĂ©ciĂ© sur Chrome</strong>).</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. Cadre dans lequel la navigation est sur le point de se produire. 0 indique que la navigation se dĂ©roule dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un <a href="/fr/docs/Web/HTML/Element/iframe">iframe</a> imbriquĂ©. Une valeur positive indique que la navigation se dĂ©roule dans un iframe imbriquĂ©. Les ID de cadre sont uniques pour un onglet et un processus donnĂ©s.</dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. ID du parent de cette image. DĂ©fini Ă -1 s'il s'agit d'un cadre de niveau supĂ©rieur.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle le navigateur est sur le point de dĂ©marrer la navigation, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webNavigation.onBeforeNavigate")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Logs les URL cibles de <code>onBeforeNavigate</code>, si le nom d'hĂŽte de la cible contient "example.com" ou commence avec "developer".</p> - -<pre class="brush: js">var filter = { +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il est Ă©coutĂ©, sinon `false`. + +## syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : + + - `details` + - : [`object`](#details). DĂ©tails sur l'Ă©vĂ©nement de navigation. + +- `filter`{{optional_inline}} + - : `object`. Un objet contenant une seule propriĂ©tĂ© `url`, qui est un `tableau` d'objets {{WebExtAPIRef("events.UrlFilter")}} objects.Un objet contenant une seule propriĂ©tĂ©Â qui correspondent Ă au moins un `UrlFilter` dans le tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions. + +## Objets supplĂ©mentaires + +### dĂ©tails + +- `tabId` + - : `integer`. L'ID de l'onglet dans lequel la navigation est sur le point de se produire. +- `url` + - : `string`. L'URL Ă laquelle le cadre donnĂ© va naviguer. +- `processId` + - : `integer`. L'ID du processus dans lequel cet onglet est rendu (Cette propriĂ©tĂ© **n'est pas pris en charge sur Firefox** et c'est **dĂ©prĂ©ciĂ© sur Chrome**). +- `frameId` + - : `integer`. Cadre dans lequel la navigation est sur le point de se produire. 0 indique que la navigation se dĂ©roule dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un [iframe](/fr/docs/Web/HTML/Element/iframe) imbriquĂ©. Une valeur positive indique que la navigation se dĂ©roule dans un iframe imbriquĂ©. Les ID de cadre sont uniques pour un onglet et un processus donnĂ©s. +- `parentFrameId` + - : `integer`. ID du parent de cette image. DĂ©fini Ă -1 s'il s'agit d'un cadre de niveau supĂ©rieur. +- `timeStamp` + - : `number`. L'heure Ă laquelle le navigateur est sur le point de dĂ©marrer la navigation, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webNavigation.onBeforeNavigate")}} + +## Exemples + +Logs les URL cibles de `onBeforeNavigate`, si le nom d'hĂŽte de la cible contient "example.com" ou commence avec "developer". + +```js +var filter = { url: [ {hostContains: "example.com"}, @@ -97,19 +89,18 @@ function logOnBefore(details) { console.log("onBeforeNavigate to: " + details.url); } -browser.webNavigation.onBeforeNavigate.addListener(logOnBefore, filter);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.webNavigation.onBeforeNavigate.addListener(logOnBefore, filter); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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 @@ -136,5 +127,4 @@ browser.webNavigation.onBeforeNavigate.addListener(logOnBefore, filter);</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/webnavigation/oncommitted/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/oncommitted/index.md index f45939e36e..c48b02d40a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/oncommitted/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/oncommitted/index.md @@ -13,83 +13,75 @@ tags: - webNavigations translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/onCommitted --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'une navigation est validĂ©e. Au moins une partie du nouveau document a Ă©tĂ© reçue du serveur et le navigateur a dĂ©cidĂ© de passer au nouveau document.</p> +LancĂ© lorsqu'une navigation est validĂ©e. Au moins une partie du nouveau document a Ă©tĂ© reçue du serveur et le navigateur a dĂ©cidĂ© de passer au nouveau document. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webNavigation.onCommitted.addListener( +```js +browser.webNavigation.onCommitted.addListener( listener, // function filter // optional object ) browser.webNavigation.onCommitted.removeListener(listener) browser.webNavigation.onCommitted.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> - - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur l'Ă©vĂ©nement de navigation.</dd> - </dl> - </dd> - <dt><code>filter</code>{{optional_inline}}</dt> - <dd> - <p><code>object</code>. Un objet contenant une seule propriĂ©tĂ© url, qui est un <code>tableau</code> d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un <code>UrlFilter</code> dans le tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions.</p> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet dans lequel la navigation est sur le point de se produire.</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL Ă laquelle le cadre donnĂ© va naviguer.</dd> - <dt><code>processId</code></dt> - <dd><code>integer</code>. L'ID du processus dans lequel cet onglet est rendu.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. Frame dans lequel la navigation aura lieu. 0 indique que la navigation se dĂ©roule dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un <a href="/frS/docs/Web/HTML/Element/iframe">iframe</a> imbriquĂ©. A positive value indicates that navigation happens in a nested iframe. Les ID de frame sont uniques pour un onglet et un processus donnĂ©s.</dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. ID du parent de cette image. RĂ©glez Ă -1 s'il s'agit d'un cadre de niveau supĂ©rieur.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle la navigation a Ă©tĂ© validĂ©e, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>transitionType</code></dt> - <dd><code>{{WebExtAPIRef("webNavigation.transitionType", "transitionType")}}</code>. La raison de la navigation : par exemple, <code>"link"</code> si l'utilisateur a cliquĂ© sur un lien, ou <code>"reload"</code> si l'utilisateur a rechargĂ© la page.</dd> - <dt><code>transitionQualifiers</code></dt> - <dd><code>Array</code> de <code>{{WebExtAPIRef("webNavigation.transitionQualifier", "transitionQualifier")}}</code>. Informations supplĂ©mentaires sur la navigation : par exemple, s'il existait une redirection de serveur ou de client.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webNavigation.onCommitted")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Logs les URL cibles et les informations de transition supplĂ©mentaires pour <code>onCommitted</code>, si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence avec "developer".</p> - -<pre class="brush: js">var filter = { +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il est Ă©coutĂ©, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : + + - `details` + - : [`object`](#details). DĂ©tails sur l'Ă©vĂ©nement de navigation. + +- `filter`{{optional_inline}} + - : `object`. Un objet contenant une seule propriĂ©tĂ© url, qui est un `tableau` d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un `UrlFilter` dans le tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions. + +## Objets supplĂ©mentaires + +### dĂ©tails + +- `tabId` + - : `integer`. L'ID de l'onglet dans lequel la navigation est sur le point de se produire. +- `url` + - : `string`. L'URL Ă laquelle le cadre donnĂ© va naviguer. +- `processId` + - : `integer`. L'ID du processus dans lequel cet onglet est rendu. +- `frameId` + - : `integer`. Frame dans lequel la navigation aura lieu. 0 indique que la navigation se dĂ©roule dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un [iframe](/frS/docs/Web/HTML/Element/iframe) imbriquĂ©. A positive value indicates that navigation happens in a nested iframe. Les ID de frame sont uniques pour un onglet et un processus donnĂ©s. +- `parentFrameId` + - : `integer`. ID du parent de cette image. RĂ©glez Ă -1 s'il s'agit d'un cadre de niveau supĂ©rieur. +- `timeStamp` + - : `number`. L'heure Ă laquelle la navigation a Ă©tĂ© validĂ©e, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `transitionType` + - : `{{WebExtAPIRef("webNavigation.transitionType", "transitionType")}}`. La raison de la navigation : par exemple, `"link"` si l'utilisateur a cliquĂ© sur un lien, ou `"reload"` si l'utilisateur a rechargĂ© la page. +- `transitionQualifiers` + - : `Array` de `{{WebExtAPIRef("webNavigation.transitionQualifier", "transitionQualifier")}}`. Informations supplĂ©mentaires sur la navigation : par exemple, s'il existait une redirection de serveur ou de client. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webNavigation.onCommitted")}} + +## Exemples + +Logs les URL cibles et les informations de transition supplĂ©mentaires pour `onCommitted`, si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence avec "developer". + +```js +var filter = { url: [ {hostContains: "example.com"}, @@ -103,19 +95,18 @@ function logOnCommitted(details) { console.log("transition qualifiers: " + details.transitionQualifiers); } -browser.webNavigation.onCommitted.addListener(logOnCommitted, filter);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.webNavigation.onCommitted.addListener(logOnCommitted, filter); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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 @@ -142,5 +133,4 @@ browser.webNavigation.onCommitted.addListener(logOnCommitted, filter);</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/webnavigation/oncompleted/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/oncompleted/index.md index dbe90ddd25..d308e07d56 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/oncompleted/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/oncompleted/index.md @@ -13,77 +13,69 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/onCompleted --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'un document, y compris les ressources auxquelles il fait rĂ©fĂ©rence, est complĂštement chargĂ© et initialisĂ©. Ceci est Ă©quivalent Ă l'Ă©vĂ©nement <code><a href="/fr/docs/Web/Events/load">chargement</a></code> du DOM.</p> +LancĂ© lorsqu'un document, y compris les ressources auxquelles il fait rĂ©fĂ©rence, est complĂštement chargĂ© et initialisĂ©. Ceci est Ă©quivalent Ă l'Ă©vĂ©nement [`chargement`](/fr/docs/Web/Events/load) du DOM. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webNavigation.onCompleted.addListener( +```js +browser.webNavigation.onCompleted.addListener( listener, // function filter // optional object ) browser.webNavigation.onCompleted.removeListener(listener) browser.webNavigation.onCompleted.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il est Ă©coutĂ©, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants:</p> +- `callback` - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur l'Ă©vĂ©nement de navigation.</dd> - </dl> - </dd> - <dt><code>filter</code>{{optional_inline}}</dt> - <dd> - <p><code>object</code>. Un objet contenant une seule propriĂ©tĂ© <code>url</code>, qui est un <code>Array</code> d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un <code>UrlFilter</code> dans le tableau.Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions.</p> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants: -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + - `details` + - : [`object`](#details). DĂ©tails sur l'Ă©vĂ©nement de navigation. -<h3 id="dĂ©tails">dĂ©tails</h3> +- `filter`{{optional_inline}} + - : `object`. Un objet contenant une seule propriĂ©tĂ© `url`, qui est un `Array` d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un `UrlFilter` dans le tableau.Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions. -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet dans lequel la navigation s'est produite.</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL Ă laquelle le cadre donnĂ© a naviguĂ©.</dd> - <dt><code>processId</code></dt> - <dd><code>integer</code>. L'ID du processus dans lequel cet onglet est rendu.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>.  Cadre dans lequel la navigation s'est produite. 0 indique que la navigation s'est dĂ©roulĂ©e dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un <a href="/fr/docs/Web/HTML/Element/iframe">iframe</a> imbriquĂ©. Une valeur positive indique que la navigation s'est dĂ©roulĂ©e dans un iframe imbriquĂ©. Les ID de cadre sont uniques pour un onglet et un processus donnĂ©s.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle la page a terminĂ© le chargement, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### dĂ©tails -<p>{{Compat("webextensions.api.webNavigation.onCompleted")}}</p> +- `tabId` + - : `integer`. L'ID de l'onglet dans lequel la navigation s'est produite. +- `url` + - : `string`. L'URL Ă laquelle le cadre donnĂ© a naviguĂ©. +- `processId` + - : `integer`. L'ID du processus dans lequel cet onglet est rendu. +- `frameId` + - : `integer`.  Cadre dans lequel la navigation s'est produite. 0 indique que la navigation s'est dĂ©roulĂ©e dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un [iframe](/fr/docs/Web/HTML/Element/iframe) imbriquĂ©. Une valeur positive indique que la navigation s'est dĂ©roulĂ©e dans un iframe imbriquĂ©. Les ID de cadre sont uniques pour un onglet et un processus donnĂ©s. +- `timeStamp` + - : `number`. L'heure Ă laquelle la page a terminĂ© le chargement, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Consigne les URL cibles de <code>onCompleted</code>, si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence avec "developer".</p> +{{Compat("webextensions.api.webNavigation.onCompleted")}} -<pre class="brush: js">var filter = { +## Exemples + +Consigne les URL cibles de `onCompleted`, si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence avec "developer". + +```js +var filter = { url: [ {hostContains: "example.com"}, @@ -96,19 +88,17 @@ function logOnCompleted(details) { } browser.webNavigation.onCompleted.addListener(logOnCompleted, filter); -</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/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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 @@ -135,5 +125,4 @@ browser.webNavigation.onCompleted.addListener(logOnCompleted, filter); // 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/webnavigation/oncreatednavigationtarget/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/oncreatednavigationtarget/index.md index 8047b759c7..9ca661d78b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/oncreatednavigationtarget/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/oncreatednavigationtarget/index.md @@ -13,90 +13,80 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/onCreatedNavigationTarget --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'une nouvelle fenĂȘtre ou un nouvel onglet dans une fenĂȘtre existante est crĂ©Ă© pour hĂ©berger la cible d'une navigation. Par exemple, cet Ă©vĂ©nement est envoyĂ© lorsque :</p> +LancĂ© lorsqu'une nouvelle fenĂȘtre ou un nouvel onglet dans une fenĂȘtre existante est crĂ©Ă© pour hĂ©berger la cible d'une navigation. Par exemple, cet Ă©vĂ©nement est envoyĂ© lorsque : -<ul> - <li>l'utilisateur ouvre un lien dans un nouvel onglet ou une nouvelle fenĂȘtre</li> - <li>une page Web charge une ressource dans un nouvel onglet ou une nouvelle fenĂȘtre en utilisant <code><a href="/fr/docs/Web/API/Window/open">window.open()</a></code> (mais notez que l'Ă©vĂ©nement n'est pas envoyĂ© si le bloqueur de popup du navigateur bloque le chargement).</li> -</ul> +- l'utilisateur ouvre un lien dans un nouvel onglet ou une nouvelle fenĂȘtre +- une page Web charge une ressource dans un nouvel onglet ou une nouvelle fenĂȘtre en utilisant [`window.open()`](/fr/docs/Web/API/Window/open) (mais notez que l'Ă©vĂ©nement n'est pas envoyĂ© si le bloqueur de popup du navigateur bloque le chargement). -<p>L'Ă©vĂ©nement n'est pas envoyĂ© si un onglet ou une fenĂȘtre est crĂ©Ă© sans cible de navigation (par exemple, si l'utilisateur ouvre un nouvel onglet en appuyant sur Ctrl+T).</p> +L'Ă©vĂ©nement n'est pas envoyĂ© si un onglet ou une fenĂȘtre est crĂ©Ă© sans cible de navigation (par exemple, si l'utilisateur ouvre un nouvel onglet en appuyant sur Ctrl+T). -<p>Si cet Ă©vĂ©nement est dĂ©clenchĂ©, il sera dĂ©clenchĂ© avant {{WebExtAPIRef("webNavigation.onBeforeNavigate")}}.</p> +Si cet Ă©vĂ©nement est dĂ©clenchĂ©, il sera dĂ©clenchĂ© avant {{WebExtAPIRef("webNavigation.onBeforeNavigate")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webNavigation.onCreatedNavigationTarget.addListener( +```js +browser.webNavigation.onCreatedNavigationTarget.addListener( listener, // function filter // optional object ) browser.webNavigation.onCreatedNavigationTarget.removeListener(listener) browser.webNavigation.onCreatedNavigationTarget.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> - -<h2 id="addListener_syntax">addListener syntax</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> - - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur l'Ă©vĂ©nement de navigation Voir les <a href="#details">dĂ©tails</a> ci-dessous.</dd> - </dl> - </dd> - <dt><code>filter</code>{{optional_inline}}</dt> - <dd> - <p><code>object</code>. Un objet contenant une seule propriĂ©tĂ© <code>url</code>, qui est un <code>Array</code> d'objets {{WebExtAPIRef("events.UrlFilter")}}.  Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un <code>UrlFilter</code> dans le tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions. Notez que le <code>filtre</code>n'est pas supportĂ© dans Firefox.</p> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>sourceFrameId</code></dt> - <dd><code>integer</code>. ID de l'image Ă partir de laquelle la navigation est initiĂ©e. 0 indique que le cadre est le contexte de navigation de niveau supĂ©rieur de l'onglet, et non un <a href="/fr/docs/Web/HTML/Element/iframe">iframe</a> imbriquĂ©. Une valeur positive indique que la navigation est initiĂ©e Ă partir d'un iframe imbriquĂ©. Les ID de cadre sont uniques pour un onglet et un processus donnĂ©s.</dd> - <dt><code>sourceProcessId</code></dt> - <dd><code>integer</code>. L'ID du processus Ă partir duquel la navigation est initiĂ©e.</dd> - <dt><code>sourceTabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet Ă partir duquel la navigation est initiĂ©e. Par exemple, si l'utilisateur ouvre un lien dans un nouvel onglet, ce sera l'identifiant de l'onglet contenant le lien.</dd> - <dt><code>tabId</code></dt> - <dd>integer: L'ID de l'onglet nouvellement crĂ©Ă©.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle le navigateur a crĂ©Ă© la cible de navigation, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL qui sera chargĂ©e dans le nouvel onglet.</dd> - <dt><code>windowId</code></dt> - <dd>number. L'ID de la fenĂȘtre dans laquelle le nouvel onglet est crĂ©Ă©.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webNavigation.onCreatedNavigationTarget")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Logs l'URL cible, l'ID de la table source et l'ID de la trame source pour <code>onCreatedNavigationTarget</code>, si le nom d'hĂŽte de la cible contient "example.com" ou commence par "developer".</p> - -<pre class="brush: js">var filter = { +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il est Ă©coutĂ©, sinon `false`. + +## addListener syntax + +### ParamĂštres + +- `callback` + + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : + + - `details` + - : [`object`](#details). DĂ©tails sur l'Ă©vĂ©nement de navigation Voir les [dĂ©tails](#details) ci-dessous. + +- `filter`{{optional_inline}} + - : `object`. Un objet contenant une seule propriĂ©tĂ© `url`, qui est un `Array` d'objets {{WebExtAPIRef("events.UrlFilter")}}.  Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un `UrlFilter` dans le tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions. Notez que le `filtre`n'est pas supportĂ© dans Firefox. + +## Objets supplĂ©mentaires + +### dĂ©tails + +- `sourceFrameId` + - : `integer`. ID de l'image Ă partir de laquelle la navigation est initiĂ©e. 0 indique que le cadre est le contexte de navigation de niveau supĂ©rieur de l'onglet, et non un [iframe](/fr/docs/Web/HTML/Element/iframe) imbriquĂ©. Une valeur positive indique que la navigation est initiĂ©e Ă partir d'un iframe imbriquĂ©. Les ID de cadre sont uniques pour un onglet et un processus donnĂ©s. +- `sourceProcessId` + - : `integer`. L'ID du processus Ă partir duquel la navigation est initiĂ©e. +- `sourceTabId` + - : `integer`. L'ID de l'onglet Ă partir duquel la navigation est initiĂ©e. Par exemple, si l'utilisateur ouvre un lien dans un nouvel onglet, ce sera l'identifiant de l'onglet contenant le lien. +- `tabId` + - : integer: L'ID de l'onglet nouvellement crĂ©Ă©. +- `timeStamp` + - : `number`. L'heure Ă laquelle le navigateur a crĂ©Ă© la cible de navigation, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `url` + - : `string`. L'URL qui sera chargĂ©e dans le nouvel onglet. +- `windowId` + - : number. L'ID de la fenĂȘtre dans laquelle le nouvel onglet est crĂ©Ă©. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webNavigation.onCreatedNavigationTarget")}} + +## Exemples + +Logs l'URL cible, l'ID de la table source et l'ID de la trame source pour `onCreatedNavigationTarget`, si le nom d'hĂŽte de la cible contient "example.com" ou commence par "developer". + +```js +var filter = { url: [ {hostContains: "example.com"}, @@ -111,19 +101,17 @@ function logOnCreatedNavigationTarget(details) { } browser.webNavigation.onCreatedNavigationTarget.addListener(logOnCreatedNavigationTarget, filter); -</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/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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 @@ -150,5 +138,4 @@ browser.webNavigation.onCreatedNavigationTarget.addListener(logOnCreatedNavigati // 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/webnavigation/ondomcontentloaded/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/ondomcontentloaded/index.md index cb28eb158c..a04a9f39a5 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/ondomcontentloaded/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/ondomcontentloaded/index.md @@ -13,77 +13,69 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/onDOMContentLoaded --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque l'Ă©vĂ©nement <a href="/fr/docs/Web/Events/DOMContentLoaded">DOMContentLoaded</a> est dĂ©clenchĂ© dans la page. Ă ce stade, le document est chargĂ© et analysĂ©, et le DOM est entiĂšrement construit, mais les ressources liĂ©es telles que les images, les feuilles de style et les sous-trames peuvent ne pas encore ĂȘtre chargĂ©es.</p> +LancĂ© lorsque l'Ă©vĂ©nement [DOMContentLoaded](/fr/docs/Web/Events/DOMContentLoaded) est dĂ©clenchĂ© dans la page. Ă ce stade, le document est chargĂ© et analysĂ©, et le DOM est entiĂšrement construit, mais les ressources liĂ©es telles que les images, les feuilles de style et les sous-trames peuvent ne pas encore ĂȘtre chargĂ©es. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webNavigation.onDOMContentLoaded.addListener( +```js +browser.webNavigation.onDOMContentLoaded.addListener( listener, // function filter // optional object ) browser.webNavigation.onDOMContentLoaded.removeListener(listener) browser.webNavigation.onDOMContentLoaded.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il est Ă©coutĂ©, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur l'Ă©vĂ©nement de navigation</dd> - </dl> - </dd> - <dt><code>filter</code>{{optional_inline}}</dt> - <dd> - <p><code>object</code>. Un objet contenant une seule propriĂ©tĂ© <code>url</code>, qui est un <code>tableau</code> d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un <code>UrlFilter</code> dans un tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions.</p> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + - `details` + - : [`object`](#details). DĂ©tails sur l'Ă©vĂ©nement de navigation -<h3 id="dĂ©tails">dĂ©tails</h3> +- `filter`{{optional_inline}} + - : `object`. Un objet contenant une seule propriĂ©tĂ© `url`, qui est un `tableau` d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un `UrlFilter` dans un tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions. -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet dans lequel la navigation s'est produite.</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL Ă laquelle le cadre donnĂ© a naviguĂ©.</dd> - <dt><code>processId</code></dt> - <dd><code>integer</code>.  L'ID du processus dans lequel cet onglet est rendu.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. Frame dans lequel la navigation est en cours. 0 indique que la navigation se dĂ©roule dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un <a href="/fr/docs/Web/HTML/Element/iframe">iframe</a> imbriquĂ©. Une valeur positive indique que la navigation se dĂ©roule dans un iframe imbriquĂ©. Les ID <em>frames</em> sont uniques pour un onglet et un processus donnĂ©s.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle <code>DOMContentLoaded</code> a Ă©tĂ© dĂ©clenchĂ©e, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### dĂ©tails -<p>{{Compat("webextensions.api.webNavigation.onDOMContentLoaded")}}</p> +- `tabId` + - : `integer`. L'ID de l'onglet dans lequel la navigation s'est produite. +- `url` + - : `string`. L'URL Ă laquelle le cadre donnĂ© a naviguĂ©. +- `processId` + - : `integer`.  L'ID du processus dans lequel cet onglet est rendu. +- `frameId` + - : `integer`. Frame dans lequel la navigation est en cours. 0 indique que la navigation se dĂ©roule dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un [iframe](/fr/docs/Web/HTML/Element/iframe) imbriquĂ©. Une valeur positive indique que la navigation se dĂ©roule dans un iframe imbriquĂ©. Les ID _frames_ sont uniques pour un onglet et un processus donnĂ©s. +- `timeStamp` + - : `number`. L'heure Ă laquelle `DOMContentLoaded` a Ă©tĂ© dĂ©clenchĂ©e, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Logs les URL cibles pour <code>onDOMContentLoaded</code>,si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence par "developer".</p> +{{Compat("webextensions.api.webNavigation.onDOMContentLoaded")}} -<pre class="brush: js">var filter = { +## Exemples + +Logs les URL cibles pour `onDOMContentLoaded`,si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence par "developer". + +```js +var filter = { url: [ {hostContains: "example.com"}, @@ -95,21 +87,18 @@ function logOnDOMContentLoaded(details) { console.log("onDOMContentLoaded: " + details.url); } -browser.webNavigation.<code>onDOMContentLoaded</code>.addListener(logOnDOMContentLoaded, filter); - -</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.webNavigation.onDOMContentLoaded.addListener(logOnDOMContentLoaded, filter); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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 @@ -136,5 +125,4 @@ browser.webNavigation.<code>onDOMContentLoaded</code>.addListener(logOnDOMConten // 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/webnavigation/onerroroccurred/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onerroroccurred/index.md index 2fde94a888..176fc28b18 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onerroroccurred/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onerroroccurred/index.md @@ -13,79 +13,71 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/onErrorOccurred --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsqu'une erreur se produit et que la navigation est annulĂ©e. Cela peut se produire si une erreur rĂ©seau s'est produite ou si l'utilisateur a interrompu la navigation.</p> +LancĂ© lorsqu'une erreur se produit et que la navigation est annulĂ©e. Cela peut se produire si une erreur rĂ©seau s'est produite ou si l'utilisateur a interrompu la navigation. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webNavigation.onErrorOccurred.addListener( +```js +browser.webNavigation.onErrorOccurred.addListener( listener, // function filter // optional object ) browser.webNavigation.onErrorOccurred.removeListener(listener) browser.webNavigation.onErrorOccurred.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants:</p> - - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur l'Ă©vĂ©nement de navigation.</dd> - </dl> - </dd> - <dt><code>filter</code>{{optional_inline}}</dt> - <dd> - <p><code>object</code>. Un objet contenant une seule propriĂ©tĂ© <code>url</code>, qui est un <code>tableau</code> d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un <code>UrlFilter</code> dans un tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions.</p> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="details">details</h3> - -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet dans lequel la navigation se passait.</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL Ă laquelle le cadre donnĂ© naviguait.</dd> - <dt><code>processId</code></dt> - <dd><code>integer</code>. L'ID du processus dans lequel cet onglet est rendu.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. Cadre dans lequel la navigation se passait. 0 indique que la navigation s'est dĂ©roulĂ©e dans le contexte de navigation de niveau supĂ©rieur de l'onglet,et non dans un <a href="/fr/docs/Web/HTML/Element/iframe">iframe</a> imbriquĂ©. Une valeur positive indique que la navigation s'est dĂ©roulĂ©e dans un iframe imbriquĂ©. Les ID de cadre sont uniques pour un onglet et un processus donnĂ©s.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle l'erreur s'est produite, en <a href="https://en.wikipedia.org/wiki/Unix_time">milliseconde depuis l'Ă©poque</a>.</dd> - <dt><code>error</code></dt> - <dd><code>string</code>. Le code d'erreur. Il s'agit d'un code d'erreur interne qui n'est pas garanti pour rester identique ou ĂȘtre cohĂ©rent d'un navigateur Ă l'autre.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webNavigation.onErrorOccurred")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Logs les URL cibles de <code>onErrorOccurred</code>, si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence par "developer".</p> - -<pre class="brush: js">var filter = { +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il est Ă©coutĂ©, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants: + + - `details` + - : [`object`](#details). DĂ©tails sur l'Ă©vĂ©nement de navigation. + +- `filter`{{optional_inline}} + - : `object`. Un objet contenant une seule propriĂ©tĂ© `url`, qui est un `tableau` d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un `UrlFilter` dans un tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions. + +## Objets supplĂ©mentaires + +### details + +- `tabId` + - : `integer`. L'ID de l'onglet dans lequel la navigation se passait. +- `url` + - : `string`. L'URL Ă laquelle le cadre donnĂ© naviguait. +- `processId` + - : `integer`. L'ID du processus dans lequel cet onglet est rendu. +- `frameId` + - : `integer`. Cadre dans lequel la navigation se passait. 0 indique que la navigation s'est dĂ©roulĂ©e dans le contexte de navigation de niveau supĂ©rieur de l'onglet,et non dans un [iframe](/fr/docs/Web/HTML/Element/iframe) imbriquĂ©. Une valeur positive indique que la navigation s'est dĂ©roulĂ©e dans un iframe imbriquĂ©. Les ID de cadre sont uniques pour un onglet et un processus donnĂ©s. +- `timeStamp` + - : `number`. L'heure Ă laquelle l'erreur s'est produite, en [milliseconde depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `error` + - : `string`. Le code d'erreur. Il s'agit d'un code d'erreur interne qui n'est pas garanti pour rester identique ou ĂȘtre cohĂ©rent d'un navigateur Ă l'autre. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webNavigation.onErrorOccurred")}} + +## Exemples + +Logs les URL cibles de `onErrorOccurred`, si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence par "developer". + +```js +var filter = { url: [ {hostContains: "example.com"}, @@ -99,19 +91,17 @@ function logOnErrorOccurred(details) { } browser.webNavigation.onErrorOccurred.addListener(logOnErrorOccurred, filter); -</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/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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 @@ -138,5 +128,4 @@ browser.webNavigation.onErrorOccurred.addListener(logOnErrorOccurred, filter); // 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/webnavigation/onhistorystateupdated/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onhistorystateupdated/index.md index ee2c8062e7..782769e6ac 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onhistorystateupdated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onhistorystateupdated/index.md @@ -13,83 +13,73 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/onHistoryStateUpdated --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque la page a utilisĂ© l'<a href="http://diveintohtml5.info/history.html">API history</a> pour mettre Ă jour l'URL affichĂ©e dans la barre d'adresse du navigateur. Tous les Ă©vĂ©nements futurs de ce cadre utiliseront l'URL mise Ă jour.</p> +LancĂ© lorsque la page a utilisĂ© l'[API history](http://diveintohtml5.info/history.html) pour mettre Ă jour l'URL affichĂ©e dans la barre d'adresse du navigateur. Tous les Ă©vĂ©nements futurs de ce cadre utiliseront l'URL mise Ă jour. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webNavigation.onHistoryStateUpdated.addListener( +```js +browser.webNavigation.onHistoryStateUpdated.addListener( listener, // function filter // optional object ) browser.webNavigation.onHistoryStateUpdated.removeListener(listener) browser.webNavigation.onHistoryStateUpdated.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il est Ă©coutĂ©, sinon `false`. -<h2 id="syntaxe_addListener">syntaxe addListener</h2> +## syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur l'Ă©vĂ©nement de navigation.</dd> - </dl> - </dd> - <dt><code>filter</code>{{optional_inline}}</dt> - <dd> - <p><code>object</code>. Un objet contenant une seule propriĂ©tĂ© <code>url</code>, qui est un <code>tableau</code> d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un <code>UrlFilter</code> dans un tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions.</p> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + - `details` + - : [`object`](#details). DĂ©tails sur l'Ă©vĂ©nement de navigation. -<h3 id="dĂ©tails">dĂ©tails</h3> +- `filter`{{optional_inline}} + - : `object`. Un objet contenant une seule propriĂ©tĂ© `url`, qui est un `tableau` d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un `UrlFilter` dans un tableau. Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions. -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet dans lequel la navigation est sur le point de se produire.</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL Ă laquelle le cadre donnĂ© va naviguer.</dd> - <dt><code>processId</code></dt> - <dd><code>integer</code>. L'ID du processus dans lequel cet onglet est rendu.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. Frame dans lequel la navigation aura lieu. 0 indique que la navigation se dĂ©roule dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un <a href="/fr/docs/Web/HTML/Element/iframe">iframe</a> imbriquĂ©. Une valeur positive indique que la navigation se dĂ©roule dans un iframe imbriquĂ©. Les ID de <em>frames</em> sont uniques pour un onglet et un processus donnĂ©s.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle la navigation a Ă©tĂ© validĂ©e, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'origine</a>.</dd> - <dt><code>transitionType</code></dt> - <dd><code>{{WebExtAPIRef("webNavigation.transitionType", "transitionType")}}</code>.La raison de la navigation: par exemple, <code>"link"</code> si l'utilisateur a cliquĂ© sur un lien.</dd> - <dt><code>transitionQualifiers</code></dt> - <dd><code>Array</code> de <code>{{WebExtAPIRef("webNavigation.transitionQualifier", "transitionQualifier")}}</code>. Informations supplĂ©mentaires sur la navigation : par exemple, s'il existait une redirection de serveur ou de client.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### dĂ©tails +- `tabId` + - : `integer`. L'ID de l'onglet dans lequel la navigation est sur le point de se produire. +- `url` + - : `string`. L'URL Ă laquelle le cadre donnĂ© va naviguer. +- `processId` + - : `integer`. L'ID du processus dans lequel cet onglet est rendu. +- `frameId` + - : `integer`. Frame dans lequel la navigation aura lieu. 0 indique que la navigation se dĂ©roule dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un [iframe](/fr/docs/Web/HTML/Element/iframe) imbriquĂ©. Une valeur positive indique que la navigation se dĂ©roule dans un iframe imbriquĂ©. Les ID de _frames_ sont uniques pour un onglet et un processus donnĂ©s. +- `timeStamp` + - : `number`. L'heure Ă laquelle la navigation a Ă©tĂ© validĂ©e, en [millisecondes depuis l'origine](https://en.wikipedia.org/wiki/Unix_time). +- `transitionType` + - : `{{WebExtAPIRef("webNavigation.transitionType", "transitionType")}}`.La raison de la navigation: par exemple, `"link"` si l'utilisateur a cliquĂ© sur un lien. +- `transitionQualifiers` + - : `Array` de `{{WebExtAPIRef("webNavigation.transitionQualifier", "transitionQualifier")}}`. Informations supplĂ©mentaires sur la navigation : par exemple, s'il existait une redirection de serveur ou de client. +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webNavigation.onHistoryStateUpdated")}}</p> +{{Compat("webextensions.api.webNavigation.onHistoryStateUpdated")}} -<h2 id="Examples">Examples</h2> +## Examples -<p>Logs les URL cibles et les informations de transition supplĂ©mentaires pour <code>onHistoryStateUpdated</code>, si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence par "developer".</p> +Logs les URL cibles et les informations de transition supplĂ©mentaires pour `onHistoryStateUpdated`, si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence par "developer". -<pre class="brush: js">var filter = { +```js +var filter = { url: [ {hostContains: "example.com"}, @@ -104,19 +94,17 @@ function logOnHistoryStateUpdated(details) { } browser.webNavigation.onHistoryStateUpdated.addListener(logOnHistoryStateUpdated, filter); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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 @@ -143,5 +131,4 @@ browser.webNavigation.onHistoryStateUpdated.addListener(logOnHistoryStateUpdated // 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/webnavigation/onreferencefragmentupdated/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onreferencefragmentupdated/index.md index d483ee6a67..cb00e7f509 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onreferencefragmentupdated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/onreferencefragmentupdated/index.md @@ -13,85 +13,71 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/onReferenceFragmentUpdated --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}LancĂ© si [identificateur dee fragment](https://en.wikipedia.org/wiki/Fragment_identifier) d'une page est modifiĂ©. Par exemple, si une page implĂ©mente une table des matiĂšres Ă l'aide de fragments et que l'utilisateur clique sur une entrĂ©e dans la table des matiĂšres, cet Ă©vĂ©nement se dĂ©clenche. Tous les Ă©vĂ©nements futurs de ce cadre utiliseront l'URL mise Ă jour. -<div>LancĂ© si <a href="https://en.wikipedia.org/wiki/Fragment_identifier">identificateur dee fragment</a> d'une page est modifiĂ©. Par exemple, si une page implĂ©mente une table des matiĂšres Ă l'aide de fragments et que l'utilisateur clique sur une entrĂ©e dans la table des matiĂšres, cet Ă©vĂ©nement se dĂ©clenche. Tous les Ă©vĂ©nements futurs de ce cadre utiliseront l'URL mise Ă jour.</div> +## Syntaxe -<div></div> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">browser.webNavigation.onReferenceFragmentUpdated.addListener( +```js +browser.webNavigation.onReferenceFragmentUpdated.addListener( listener, // function filter // optional object ) browser.webNavigation.onReferenceFragmentUpdated.removeListener(listener) browser.webNavigation.onReferenceFragmentUpdated.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>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il est Ă©coutĂ©, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants:</p> +- `callback` - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur l'Ă©vĂ©nement de navigation.</dd> - </dl> - </dd> - <dt><code>filter</code>{{optional_inline}}</dt> - <dd> - <p><code>object</code>. Un objet contenant une seule propriĂ©tĂ© <code>url</code>, qui est un <code>Array</code> d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un <code>UrlFilter</code> dans le tableau.Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions.</p> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants: -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> + - `details` + - : [`object`](#details). DĂ©tails sur l'Ă©vĂ©nement de navigation. -<h3 id="dĂ©tails">dĂ©tails</h3> +- `filter`{{optional_inline}} + - : `object`. Un objet contenant une seule propriĂ©tĂ© `url`, qui est un `Array` d'objets {{WebExtAPIRef("events.UrlFilter")}}. Si vous incluez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera uniquement pour les transitions vers les URL qui correspondent Ă au moins un `UrlFilter` dans le tableau.Si vous omettez ce paramĂštre, l'Ă©vĂ©nement se dĂ©clenchera pour toutes les transitions. -<dl> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet dans lequel la navigation est sur le point de se produire.</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL Ă laquelle le cadre donnĂ© va naviguer.</dd> - <dt><code>processId</code></dt> - <dd><code>integer</code>. L'ID du processus dans lequel cet onglet est rendu.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>.Cadre dans lequel la navigation aura lieu. 0 indique que la navigation se dĂ©roule dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un <a href="/fr/docs/Web/HTML/Element/iframe">iframe</a> imbriquĂ©. Une valeur positive indique que la navigation se dĂ©roule dans un iframe imbriquĂ©. Les ID de cadre sont uniques pour un onglet et un processus donnĂ©s.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle la navigation a Ă©tĂ© validĂ©e, en <a href="https://en.wikipedia.org/wiki/Unix_time">milliseconde depuis l'Ă©poque</a>.</dd> - <dt><code>transitionType</code></dt> - <dd><code>{{WebExtAPIRef("webNavigation.transitionType", "transitionType")}}</code>. La raison de la navigation: par exemple, <code>"link"</code> si l'utilisateur a cliquĂ© sur un lien.</dd> - <dt><code>transitionQualifiers</code></dt> - <dd><code>Array</code> de <code>{{WebExtAPIRef("webNavigation.transitionQualifier", "transitionQualifier")}}</code>. Informations supplĂ©mentaires sur la navigation : par exemple, s'il existait une redirection de serveur ou de client.</dd> -</dl> +## Objets supplĂ©mentaires -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### dĂ©tails +- `tabId` + - : `integer`. L'ID de l'onglet dans lequel la navigation est sur le point de se produire. +- `url` + - : `string`. L'URL Ă laquelle le cadre donnĂ© va naviguer. +- `processId` + - : `integer`. L'ID du processus dans lequel cet onglet est rendu. +- `frameId` + - : `integer`.Cadre dans lequel la navigation aura lieu. 0 indique que la navigation se dĂ©roule dans le contexte de navigation de niveau supĂ©rieur de l'onglet, et non dans un [iframe](/fr/docs/Web/HTML/Element/iframe) imbriquĂ©. Une valeur positive indique que la navigation se dĂ©roule dans un iframe imbriquĂ©. Les ID de cadre sont uniques pour un onglet et un processus donnĂ©s. +- `timeStamp` + - : `number`. L'heure Ă laquelle la navigation a Ă©tĂ© validĂ©e, en [milliseconde depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `transitionType` + - : `{{WebExtAPIRef("webNavigation.transitionType", "transitionType")}}`. La raison de la navigation: par exemple, `"link"` si l'utilisateur a cliquĂ© sur un lien. +- `transitionQualifiers` + - : `Array` de `{{WebExtAPIRef("webNavigation.transitionQualifier", "transitionQualifier")}}`. Informations supplĂ©mentaires sur la navigation : par exemple, s'il existait une redirection de serveur ou de client. +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webNavigation.onReferenceFragmentUpdated")}}</p> +{{Compat("webextensions.api.webNavigation.onReferenceFragmentUpdated")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Consigne les URL cibles et les informations de transition supplĂ©mentaires pour <code>onReferenceFragmentUpdated</code>, si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence par "developer".</p> +Consigne les URL cibles et les informations de transition supplĂ©mentaires pour `onReferenceFragmentUpdated`, si le nom d'hĂŽte de l'URL cible contient "example.com" ou commence par "developer". -<pre class="brush: js">var filter = { +```js +var filter = { url: [ {hostContains: "example.com"}, @@ -106,19 +92,17 @@ function logOnReferenceFragmentUpdated(details) { } browser.webNavigation.onReferenceFragmentUpdated.addListener(logOnReferenceFragmentUpdated, filter); -</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/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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 @@ -145,5 +129,4 @@ browser.webNavigation.onReferenceFragmentUpdated.addListener(logOnReferenceFragm // 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/webnavigation/ontabreplaced/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/ontabreplaced/index.md index 8f6e159331..f4a3496b0d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/ontabreplaced/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/ontabreplaced/index.md @@ -13,89 +13,75 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/onTabReplaced --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque le contenu de l'onglet est remplacĂ© par un onglet diffĂ©rent (gĂ©nĂ©ralement prĂ©cĂ©demment prĂ©-rendu).</p> +LancĂ© lorsque le contenu de l'onglet est remplacĂ© par un onglet diffĂ©rent (gĂ©nĂ©ralement prĂ©cĂ©demment prĂ©-rendu). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webNavigation.onTabReplaced.addListener( +```js +browser.webNavigation.onTabReplaced.addListener( listener, // function filter // optional object ); browser.webNavigation.onTabReplaced.removeListener(listener) browser.webNavigation.onTabReplaced.hasListener(listener) -</pre> +``` +Les Ă©vĂ©nements ont trois fonctions : +- `addListener(callback)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie `true` s'il est Ă©coutĂ©, sinon `false`. -<p>Les Ă©vĂ©nements ont trois fonctions :</p> +## Syntaxe addListener -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> +### ParamĂštres +- `callback` + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants : -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> + - `details` + - : [`object`](#details). -<h3 id="ParamĂštres">ParamĂštres</h3> +## Objets supplĂ©mentaires -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produit. La fonction recevra les arguments suivants :</p> +### dĂ©tails - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>.</dd> - </dl> - </dd> -</dl> +- `replacedTabId` + - : `integer`. L'ID de l'onglet qui a Ă©tĂ© remplacĂ©. +- `tabId` + - : `integer`. L'ID de l'onglet qui a remplacĂ© l'ancien onglet. +- `timeStamp` + - : `number`. Le moment oĂč le remplacement s'est produit, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> +## CompatibilitĂ© du navigateur -<h3 id="dĂ©tails">dĂ©tails</h3> +{{Compat("webextensions.api.webNavigation.onTabReplaced")}} -<dl> - <dt><code>replacedTabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet qui a Ă©tĂ© remplacĂ©.</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. L'ID de l'onglet qui a remplacĂ© l'ancien onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. Le moment oĂč le remplacement s'est produit, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> -</dl> +## Exemples -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - - - -<p>{{Compat("webextensions.api.webNavigation.onTabReplaced")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">function logOnTabReplaced(details) { +```js +function logOnTabReplaced(details) { console.log("onTabReplaced: " + details); } -browser.webNavigation.onTabReplaced.addListener(logOnTabReplaced);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.webNavigation.onTabReplaced.addListener(logOnTabReplaced); +``` -<p>This API is based on Chromium's <a href="https://developer.chrome.com/extensions/webNavigation#event-onTabReplaced"><code>chrome.webNavigation</code></a> API. This documentation is derived from <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.json</code></a> in the Chromium code.</p> +{{WebExtExamples}} -<p>Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.</p> -</div> +> **Note :** +> +> This API is based on Chromium's [`chrome.webNavigation`](https://developer.chrome.com/extensions/webNavigation#event-onTabReplaced) API. This documentation is derived from [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json) in the Chromium code. +> +> Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License. -<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 @@ -122,5 +108,4 @@ browser.webNavigation.onTabReplaced.addListener(logOnTabReplaced);</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/webnavigation/transitionqualifier/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/transitionqualifier/index.md index c977cb27a3..f11e055a92 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/transitionqualifier/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/transitionqualifier/index.md @@ -13,46 +13,34 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/TransitionQualifier --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Informations supplĂ©mentaires sur une transition.Notez que beaucoup de valeurs ne sont actuellement pas supportĂ©es dans Firefox : voir la [table de compatibilitĂ©](/fr/Add-ons/WebExtensions/API/WebNavigation/TransitionQualifier#Browser_compatibility) pour plus de dĂ©tails. -<div>Informations supplĂ©mentaires sur une transition.</div> +## Type -<div></div> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<div>Notez que beaucoup de valeurs ne sont actuellement pas supportĂ©es dans Firefox : voir la <a href="/fr/Add-ons/WebExtensions/API/WebNavigation/TransitionQualifier#Browser_compatibility">table de compatibilitĂ©</a> pour plus de dĂ©tails.</div> +- "client_redirect" + - : Redirection(s) provoquĂ©e par le JavaScript en cours d'exĂ©cution dans la page ou un pragma "actualiser" dans la balise [meta](/fr/docs/Web/HTML/Element/meta) de la page. +- "server_redirect" + - : Redirection(s) provoquĂ©e par un [code status HTTP 3XX](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#3xx_Redirection) envoyĂ© par le serveur. +- "forward_back" + - : L'utilisateur a utilisĂ© le bouton avant ou arriĂšre pour dĂ©clencher la navigation.. +- "from_address_bar" + - : L'utilisateur a dĂ©clenchĂ© la navigation depuis la barre d'adresse. -<div></div> +## CompatibilitĂ© du navigateur -<h2 id="Type">Type</h2> +{{Compat("webextensions.api.webNavigation.TransitionQualifier")}} -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +{{WebExtExamples}} -<dl> - <dt>"client_redirect"</dt> - <dd>Redirection(s) provoquĂ©e par le JavaScript en cours d'exĂ©cution dans la page ou un pragma "actualiser" dans la balise <a href="/fr/docs/Web/HTML/Element/meta">meta</a> de la page.</dd> - <dt>"server_redirect"</dt> - <dd>Redirection(s) provoquĂ©e par un <a href="https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#3xx_Redirection">code status HTTP 3XX</a> envoyĂ© par le serveur.</dd> - <dt>"forward_back"</dt> - <dd>L'utilisateur a utilisĂ© le bouton avant ou arriĂšre pour dĂ©clencher la navigation..</dd> - <dt>"from_address_bar"</dt> - <dd>L'utilisateur a dĂ©clenchĂ© la navigation depuis la barre d'adresse.</dd> -</dl> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webNavigation.TransitionQualifier")}}</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/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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 @@ -79,5 +67,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/TransitionQualif // 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/webnavigation/transitiontype/index.md b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/transitiontype/index.md index e0ae49815a..79772863e7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webnavigation/transitiontype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webnavigation/transitiontype/index.md @@ -13,56 +13,52 @@ tags: - webNavigation translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/TransitionType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Cause de la navigation: par exemple, l'utilisateur a cliquĂ© sur un lien, ou a tapĂ© une adresse, ou a cliquĂ© sur un signet.</p> +Cause de la navigation: par exemple, l'utilisateur a cliquĂ© sur un lien, ou a tapĂ© une adresse, ou a cliquĂ© sur un signet. -<p>Notez que beaucoup de valeurs ne sont actuellement pas supportĂ©es dans Firefox : voir la <a href="/fr/Add-ons/WebExtensions/API/WebNavigation/TransitionType#Browser_compatibility">table de compatibilitĂ© du navigateur</a> pour plus de dĂ©tails.</p> +Notez que beaucoup de valeurs ne sont actuellement pas supportĂ©es dans Firefox : voir la [table de compatibilitĂ© du navigateur](/fr/Add-ons/WebExtensions/API/WebNavigation/TransitionType#Browser_compatibility) pour plus de dĂ©tails. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<dl> - <dt>"link"</dt> - <dd>L'utilisateur a cliquĂ© sur un lien dans une autre page.</dd> - <dt>"typed"</dt> - <dd>L'utilisateur a tapĂ© l'URL dans la barre d'adresse. Ceci est Ă©galement utilisĂ© si l'utilisateur a commencĂ© Ă taper dans la barre d'adresse, puis sĂ©lectionnĂ© une URL parmi les suggestions qu'il a proposĂ©es. Voir aussi " generated".</dd> - <dt>"auto_bookmark"</dt> - <dd>L'utilisateur a cliquĂ© sur un signet ou un Ă©lĂ©ment dans l'historique du navigateur.</dd> - <dt>"auto_subframe"</dt> - <dd>Les iframes imbriquĂ©s qui sont automatiquement chargĂ©s par leur parent.</dd> - <dt>"manual_subframe"</dt> - <dd>Les iframes imbriquĂ©s chargĂ©s en tant qu'action utilisateur explicite. Le chargement d'une telle iframe gĂ©nĂ©rera une entrĂ©e dans la liste de navigation avant/arriĂšre.</dd> - <dt>"generated"</dt> - <dd>L'utilisateur a commencĂ© Ă taper dans la barre d'adresse, puis a cliquĂ© sur une entrĂ©e suggĂ©rĂ©e qui ne contenait pas d'URL.</dd> - <dt>"start_page"</dt> - <dd>La page a Ă©tĂ© passĂ©e Ă la ligne de commande ou est la page de dĂ©marrage.</dd> - <dt>"form_submit"</dt> - <dd>L'utilisateur a soumis un formulaire. Notez que dans certaines situations, par exemple lorsqu'un formulaire utilise un script pour soumettre son contenu, l'envoi d'un formulaire n'entraĂźne pas ce type de transition.</dd> - <dt>"reload"</dt> - <dd>L'utilisateur a rechargĂ© la page en utilisant le bouton Recharger ou en appuyant sur EntrĂ©e dans la barre d'adresse. Ceci est Ă©galement utilisĂ© pour la restauration de session et la rĂ©ouverture des onglets fermĂ©s.</dd> - <dt>"keyword"</dt> - <dd>L'URL a Ă©tĂ© gĂ©nĂ©rĂ©e Ă l'aide d'une <a href="https://support.mozilla.org/fr/kb/comment-rechercher-site-barre-adresse">rechercher par mot</a> configurĂ©e par l'utilisateur.</dd> - <dt>"keyword_generated"</dt> - <dd>Correspond Ă une visite gĂ©nĂ©rĂ©e pour un mot clĂ©.</dd> -</dl> +- "link" + - : L'utilisateur a cliquĂ© sur un lien dans une autre page. +- "typed" + - : L'utilisateur a tapĂ© l'URL dans la barre d'adresse. Ceci est Ă©galement utilisĂ© si l'utilisateur a commencĂ© Ă taper dans la barre d'adresse, puis sĂ©lectionnĂ© une URL parmi les suggestions qu'il a proposĂ©es. Voir aussi " generated". +- "auto_bookmark" + - : L'utilisateur a cliquĂ© sur un signet ou un Ă©lĂ©ment dans l'historique du navigateur. +- "auto_subframe" + - : Les iframes imbriquĂ©s qui sont automatiquement chargĂ©s par leur parent. +- "manual_subframe" + - : Les iframes imbriquĂ©s chargĂ©s en tant qu'action utilisateur explicite. Le chargement d'une telle iframe gĂ©nĂ©rera une entrĂ©e dans la liste de navigation avant/arriĂšre. +- "generated" + - : L'utilisateur a commencĂ© Ă taper dans la barre d'adresse, puis a cliquĂ© sur une entrĂ©e suggĂ©rĂ©e qui ne contenait pas d'URL. +- "start_page" + - : La page a Ă©tĂ© passĂ©e Ă la ligne de commande ou est la page de dĂ©marrage. +- "form_submit" + - : L'utilisateur a soumis un formulaire. Notez que dans certaines situations, par exemple lorsqu'un formulaire utilise un script pour soumettre son contenu, l'envoi d'un formulaire n'entraĂźne pas ce type de transition. +- "reload" + - : L'utilisateur a rechargĂ© la page en utilisant le bouton Recharger ou en appuyant sur EntrĂ©e dans la barre d'adresse. Ceci est Ă©galement utilisĂ© pour la restauration de session et la rĂ©ouverture des onglets fermĂ©s. +- "keyword" + - : L'URL a Ă©tĂ© gĂ©nĂ©rĂ©e Ă l'aide d'une [rechercher par mot](https://support.mozilla.org/fr/kb/comment-rechercher-site-barre-adresse) configurĂ©e par l'utilisateur. +- "keyword_generated" + - : Correspond Ă une visite gĂ©nĂ©rĂ©e pour un mot clĂ©. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webNavigation.TransitionType")}}</p> +{{Compat("webextensions.api.webNavigation.TransitionType")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.webNavigation`](https://developer.chrome.com/extensions/webNavigation). Cette documentation est dĂ©rivĂ©e de [`web_navigation.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.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/webNavigation"><code>chrome.webNavigation</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/web_navigation.json"><code>web_navigation.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 @@ -89,5 +85,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webNavigation/TransitionType // 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/webrequest/blockingresponse/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/blockingresponse/index.md index 3308f35fc6..8d19a6f4f9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/blockingresponse/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/blockingresponse/index.md @@ -13,57 +13,55 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/BlockingResponse --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet de ce type est renvoyĂ© par les auditeurs d'Ă©vĂ©nements qui ont dĂ©fini le <code>"blocking"</code> dans leur argument <code>extraInfoSpec</code>.</p> +Un objet de ce type est renvoyĂ© par les auditeurs d'Ă©vĂ©nements qui ont dĂ©fini le `"blocking"` dans leur argument `extraInfoSpec`. -<p>En dĂ©finissant des propriĂ©tĂ©s particuliĂšres dans <code>BlockingResponse</code>, l'auditeur peut modifier les requĂȘtes rĂ©seau.</p> +En dĂ©finissant des propriĂ©tĂ©s particuliĂšres dans `BlockingResponse`, l'auditeur peut modifier les requĂȘtes rĂ©seau. -<p>Notez que vous ne pouvez pas dĂ©finir toutes les propriĂ©tĂ©s de cet objet dans chaque auditeur : les propriĂ©tĂ©s que vous pouvez dĂ©finir dĂ©pendent de l'Ă©vĂ©nement qui a dĂ©clenchĂ© cet auditeur, comme dĂ©taillĂ© ci-dessous.</p> +Notez que vous ne pouvez pas dĂ©finir toutes les propriĂ©tĂ©s de cet objet dans chaque auditeur : les propriĂ©tĂ©s que vous pouvez dĂ©finir dĂ©pendent de l'Ă©vĂ©nement qui a dĂ©clenchĂ© cet auditeur, comme dĂ©taillĂ© ci-dessous. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>authCredentials</code>{{optional_inline}}</dt> - <dd><p><code>object</code>. Si elle est dĂ©finie, la demande est faite en utilisant les informations d'identification donnĂ©es. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© que dans {{WebExtAPIRef("webRequest.onAuthRequired", "onAuthRequired")}}. La propriĂ©tĂ© <code>authCredentials</code> est un objet avec les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur Ă fournir.</dd> - <dt><code>password</code></dt> - <dd><code>string</code>. Mot de passe Ă fournir.</dd> - </dl> - </dd> - <dt><code>cancel</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si <code>true</code>, la demande est annulĂ©e. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© dans {{WebExtAPIRef("webRequest.onBeforeRequest", "onBeforeRequest")}}, {{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}}, {{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}}, et {{WebExtAPIRef("webRequest.onAuthRequired", "onAuthRequired")}}.</dd> - <dt><code>redirectUrl</code>{{optional_inline}}</dt> - <dd><p><code>string</code>. Il s'agit d'une URL, et si elle est dĂ©finie, la requĂȘte originale est redirigĂ©e vers cette URL. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© que dans {{WebExtAPIRef("webRequest.onBeforeRequest", "onBeforeRequest")}} ou {{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}}.</p> - <p>Les redirections vers des schĂ©mas non-HTTP tels que data : sont autorisĂ©es, mais elles ne sont pas prises en charge actuellement ({{bug("707624")}}). Les redirections utilisent la mĂȘme mĂ©thode de requĂȘte que la requĂȘte originale Ă moins qu'elle ne soit initiĂ©e Ă partir de l'Ă©tape <code>onHeadersReceived</code>, auquel cas la redirection utilise la mĂ©thode GET.</p> - <p>Si une extension veut rediriger une URL publique (par exemple HTTPS) vers une <a href="/fr/Add-ons/WebExtensions/user_interface/Extension_pages">page d'extension</a>, le fichier manifest.json de l'extension doit contenir une clĂ© <a href="/fr/Add-ons/WebExtensions/manifest.json/web_accessible_resources">web_accessible_resources</a> qui liste l'URL de la page d'extension.</p></dd> - <dt><code>requestHeaders</code>{{optional_inline}}</dt> - <dd> - <p>{{WebExtAPIRef('webRequest.HttpHeaders')}}. C'est un objet {{WebExtAPIRef('webRequest.HttpHeaders', "HttpHeaders")}}, un tableau dans lequel chaque objet reprĂ©sente un en-tĂȘte. Si elle est dĂ©finie, la demande est faite avec ces en-tĂȘtes plutĂŽt qu'avec les en-tĂȘtes d'origine. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© que dans {{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}} .</p> - </dd> - <dt><code>responseHeaders</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('webRequest.HttpHeaders')}}. C'est un objet {{WebExtAPIRef('webRequest.HttpHeaders', "HttpHeaders")}}, un tableau dans lequel chaque objet reprĂ©sente un en-tĂȘte. Si elle est dĂ©finie, le serveur est supposĂ© avoir rĂ©pondu avec ces en-tĂȘtes de rĂ©ponse au lieu des originaux. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© que dans {{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}}. Si plusieurs extensions tentent de dĂ©finir le mĂȘme en-tĂȘte (par exemple, <code>Content-Security-Policy</code>), une seule des modifications sera rĂ©ussie.</dd> - <dt><code>upgradeToSecure</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si la valeur <code>true</code> est est dĂ©finie et que la requĂȘte originale est une requĂȘte HTTP, cela empĂȘchera l'envoi de la requĂȘte originale et fera plutĂŽt une requĂȘte sĂ©curisĂ©e (HTTPS). Si une extension renvoie <code>redirectUrl</code> dans <code>onBeforeRequest</code>, alors <code>upgradeToSecure</code> sera ignorĂ© pour cette requĂȘte. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© que dans {{WebExtAPIRef("webRequest.onBeforeRequest", "onBeforeRequest")}}.</dd> -</dl> +- `authCredentials`{{optional_inline}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - : `object`. Si elle est dĂ©finie, la demande est faite en utilisant les informations d'identification donnĂ©es. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© que dans {{WebExtAPIRef("webRequest.onAuthRequired", "onAuthRequired")}}. La propriĂ©tĂ© `authCredentials` est un objet avec les propriĂ©tĂ©s suivantes : -<p>{{Compat("webextensions.api.webRequest.BlockingResponse")}}</p> + - `username` + - : `string`. Nom d'utilisateur Ă fournir. + - `password` + - : `string`. Mot de passe Ă fournir. -<p>{{WebExtExamples}}</p> +- `cancel`{{optional_inline}} + - : `boolean`. Si `true`, la demande est annulĂ©e. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© dans {{WebExtAPIRef("webRequest.onBeforeRequest", "onBeforeRequest")}}, {{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}}, {{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}}, et {{WebExtAPIRef("webRequest.onAuthRequired", "onAuthRequired")}}. +- `redirectUrl`{{optional_inline}} -<div class="note"><p><strong>Note :</strong></p> + - : `string`. Il s'agit d'une URL, et si elle est dĂ©finie, la requĂȘte originale est redirigĂ©e vers cette URL. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© que dans {{WebExtAPIRef("webRequest.onBeforeRequest", "onBeforeRequest")}} ou {{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}}. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</p> -</div> + Les redirections vers des schĂ©mas non-HTTP tels que data : sont autorisĂ©es, mais elles ne sont pas prises en charge actuellement ({{bug("707624")}}). Les redirections utilisent la mĂȘme mĂ©thode de requĂȘte que la requĂȘte originale Ă moins qu'elle ne soit initiĂ©e Ă partir de l'Ă©tape `onHeadersReceived`, auquel cas la redirection utilise la mĂ©thode GET. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. + Si une extension veut rediriger une URL publique (par exemple HTTPS) vers une [page d'extension](/fr/Add-ons/WebExtensions/user_interface/Extension_pages), le fichier manifest.json de l'extension doit contenir une clĂ© [web_accessible_resources](/fr/Add-ons/WebExtensions/manifest.json/web_accessible_resources) qui liste l'URL de la page d'extension. + +- `requestHeaders`{{optional_inline}} + - : {{WebExtAPIRef('webRequest.HttpHeaders')}}. C'est un objet {{WebExtAPIRef('webRequest.HttpHeaders', "HttpHeaders")}}, un tableau dans lequel chaque objet reprĂ©sente un en-tĂȘte. Si elle est dĂ©finie, la demande est faite avec ces en-tĂȘtes plutĂŽt qu'avec les en-tĂȘtes d'origine. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© que dans {{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}} . +- `responseHeaders`{{optional_inline}} + - : {{WebExtAPIRef('webRequest.HttpHeaders')}}. C'est un objet {{WebExtAPIRef('webRequest.HttpHeaders', "HttpHeaders")}}, un tableau dans lequel chaque objet reprĂ©sente un en-tĂȘte. Si elle est dĂ©finie, le serveur est supposĂ© avoir rĂ©pondu avec ces en-tĂȘtes de rĂ©ponse au lieu des originaux. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© que dans {{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}}. Si plusieurs extensions tentent de dĂ©finir le mĂȘme en-tĂȘte (par exemple, `Content-Security-Policy`), une seule des modifications sera rĂ©ussie. +- `upgradeToSecure`{{optional_inline}} + - : `boolean`. Si la valeur `true` est est dĂ©finie et que la requĂȘte originale est une requĂȘte HTTP, cela empĂȘchera l'envoi de la requĂȘte originale et fera plutĂŽt une requĂȘte sĂ©curisĂ©e (HTTPS). Si une extension renvoie `redirectUrl` dans `onBeforeRequest`, alors `upgradeToSecure` sera ignorĂ© pour cette requĂȘte. Vous ne pouvez dĂ©finir cette propriĂ©tĂ© que dans {{WebExtAPIRef("webRequest.onBeforeRequest", "onBeforeRequest")}}. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.BlockingResponse")}} + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. + +<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 +88,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/BlockingResponse // 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/webrequest/certificateinfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/certificateinfo/index.md index dd93db7d77..fec092c8e5 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/certificateinfo/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/certificateinfo/index.md @@ -12,64 +12,61 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/CertificateInfo --- -<div>{{AddonSidebar()}}</div> - -<p>Un objet dĂ©crivant un seul <a href="https://tools.ietf.org/html/rfc5280">certificat X.509</a>.</p> - -<p>L'objet {{WebExtAPIRef("webRequest.SecurityInfo", "SecurityInfo")}} retournĂ© par l'objet {{WebExtAPIRef("webRequest.getSecurityInfo()")}} API inclut une propriĂ©tĂ© de <code>certificats</code> qui est un tableau de ces objets.</p> - -<h2 id="Type">Type</h2> - -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> - -<dl> - <dt><code>fingerprint</code></dt> - <dd><p><code>Object</code>. Un objet avec les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>sha1</code></dt> - <dd><code>String</code>. SHA-1 hash de l'encodage DER du certificat.</dd> - <dt><code>sha256</code></dt> - <dd><code>String</code>. SHA-256 hash de l'encodage DER du certificat.</dd> - </dl> - </dd> - <dt><code>isBuiltInRoot</code></dt> - <dd> - <p><code>Boolean</code>. <code>true</code> si le certificat est l'une des racines de confiance installĂ©es dans le navigateur, sinon <code>false</code>.</p> - </dd> - <dt><code>issuer</code></dt> - <dd><p><code>String</code>. Nom de l'organisation qui a dĂ©livrĂ© ce certificat, reprĂ©sentĂ© par un nom distinctif et formatĂ© sous la forme d'une liste de noms distinctifs relatifs sĂ©parĂ©s par des virgules, chacun de la forme "type=value".</p> - <p>Par exemple: "CN=DigiCert SHA2 Secure Server CA,O=DigiCert Inc,C=US".</p></dd> - <dt><code>rawDER</code></dt> - <dd><code>Array</code> de <code>Number</code>. Si <a href="/fr/Add-ons/WebExtensions/API/webRequest/getSecurityInfo"><code>webRequest.getSecurityInfo()</code></a> a Ă©tĂ© appelĂ© avec l'option <code>rawDER</code> prĂ©sent et mis Ă <code>true</code>, ceci contiendra l'encodage DER du certificat.</dd> - <dt><code>serialNumber</code></dt> - <dd><code>String</code>. Le <a href="https://tools.ietf.org/html/rfc5280#section-4.1.2.2">numĂ©ro de sĂ©rie</a> du certificat.</dd> - <dt><code>subject</code></dt> - <dd><p><code>String</code>. Nom de l'organisation qui a dĂ©livrĂ© ce certificat, reprĂ©sentĂ© par un nom distinctif et formatĂ© sous la forme d'une liste de noms distinctifs relatifs sĂ©parĂ©s par des virgules, chacun de la forme "type=value".</p> - <p>Par exemple: "CN=*.cdn.mozilla.net,O=Mozilla Corporation,L=Mountain View,ST=California,C=US".</p></dd> - <dt><code>subjectPublicKeyInfoDigest</code></dt> - <dd> - <p><code>Object</code>. Un objet contenant les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>sha256</code></dt> - <dd><code>String</code>. Base64 encodĂ© SHA-256 hash de l'<a href="https://tools.ietf.org/html/rfc5280#section-4.1.2.7">information de clĂ© publique</a> codĂ©e DER.</dd> - </dl> - </dd> - <dt><code>validity</code></dt> - <dd> - <p><code>Object</code>. PĂ©riode de validitĂ© du certificat. Un objet contenant les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>start</code></dt> - <dd><code>Number</code>. Le dĂ©but de la pĂ©riode de validitĂ© du certificat, en <a href="https://en.wikipedia.org/wiki/Unix_time" rel="noopener">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>end</code></dt> - <dd><code>Number</code>. La fin de la pĂ©riode de validitĂ© du certificat, en <a href="https://en.wikipedia.org/wiki/Unix_time" rel="noopener">millisecondes depuis l'Ă©poque</a>.</dd> - </dl> - </dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.CertificateInfo", 10)}}</p> - -<p>{{WebExtExamples}}</p> +{{AddonSidebar()}} + +Un objet dĂ©crivant un seul [certificat X.509](https://tools.ietf.org/html/rfc5280). + +L'objet {{WebExtAPIRef("webRequest.SecurityInfo", "SecurityInfo")}} retournĂ© par l'objet {{WebExtAPIRef("webRequest.getSecurityInfo()")}} API inclut une propriĂ©tĂ© de `certificats` qui est un tableau de ces objets. + +## Type + +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : + +- `fingerprint` + + - : `Object`. Un objet avec les propriĂ©tĂ©s suivantes : + + - `sha1` + - : `String`. SHA-1 hash de l'encodage DER du certificat. + - `sha256` + - : `String`. SHA-256 hash de l'encodage DER du certificat. + +- `isBuiltInRoot` + - : `Boolean`. `true` si le certificat est l'une des racines de confiance installĂ©es dans le navigateur, sinon `false`. +- `issuer` + + - : `String`. Nom de l'organisation qui a dĂ©livrĂ© ce certificat, reprĂ©sentĂ© par un nom distinctif et formatĂ© sous la forme d'une liste de noms distinctifs relatifs sĂ©parĂ©s par des virgules, chacun de la forme "type=value". + + Par exemple: "CN=DigiCert SHA2 Secure Server CA,O=DigiCert Inc,C=US". + +- `rawDER` + - : `Array` de `Number`. Si [`webRequest.getSecurityInfo()`](/fr/Add-ons/WebExtensions/API/webRequest/getSecurityInfo) a Ă©tĂ© appelĂ© avec l'option `rawDER` prĂ©sent et mis Ă `true`, ceci contiendra l'encodage DER du certificat. +- `serialNumber` + - : `String`. Le [numĂ©ro de sĂ©rie](https://tools.ietf.org/html/rfc5280#section-4.1.2.2) du certificat. +- `subject` + + - : `String`. Nom de l'organisation qui a dĂ©livrĂ© ce certificat, reprĂ©sentĂ© par un nom distinctif et formatĂ© sous la forme d'une liste de noms distinctifs relatifs sĂ©parĂ©s par des virgules, chacun de la forme "type=value". + + Par exemple: "CN=\*.cdn.mozilla.net,O=Mozilla Corporation,L=Mountain View,ST=California,C=US". + +- `subjectPublicKeyInfoDigest` + + - : `Object`. Un objet contenant les propriĂ©tĂ©s suivantes : + + - `sha256` + - : `String`. Base64 encodĂ© SHA-256 hash de l'[information de clĂ© publique](https://tools.ietf.org/html/rfc5280#section-4.1.2.7) codĂ©e DER. + +- `validity` + + - : `Object`. PĂ©riode de validitĂ© du certificat. Un objet contenant les propriĂ©tĂ©s suivantes : + + - `start` + - : `Number`. Le dĂ©but de la pĂ©riode de validitĂ© du certificat, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). + - `end` + - : `Number`. La fin de la pĂ©riode de validitĂ© du certificat, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.CertificateInfo", 10)}} + +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/filterresponsedata/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/filterresponsedata/index.md index 07ded4756a..f3b657221f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/filterresponsedata/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/filterresponsedata/index.md @@ -12,41 +12,41 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/filterResponseData --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Utilisez cette fonction pour crĂ©er un objet {{WebExtAPIRef("webRequest.StreamFilter")}} pour une requĂȘte particuliĂšre.<br> - Vous pouvez ensuite utiliser le filtre de flux pour surveiller et modifier la rĂ©ponse. Vous appelez typiquement cette fonction Ă partir d'un Ă©couteur d'Ă©vĂ©nements <code>webRequest</code>.</p> +Utilisez cette fonction pour crĂ©er un objet {{WebExtAPIRef("webRequest.StreamFilter")}} pour une requĂȘte particuliĂšre. +Vous pouvez ensuite utiliser le filtre de flux pour surveiller et modifier la rĂ©ponse. Vous appelez typiquement cette fonction Ă partir d'un Ă©couteur d'Ă©vĂ©nements `webRequest`. -<p>Pour utiliser cette API, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission de l'API</a> "webRequestBlocking", ainsi que les permissions normales nĂ©cessaires Ă l'auditeur de l'Ă©vĂ©nement (la permission "webRequest" et la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permission hĂŽte </a>pour l'hĂŽte).</p> +Pour utiliser cette API, vous devez avoir la [permission de l'API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "webRequestBlocking", ainsi que les permissions normales nĂ©cessaires Ă l'auditeur de l'Ă©vĂ©nement (la permission "webRequest" et la [permission hĂŽte ](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions)pour l'hĂŽte). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var filter = browser.webRequest.filterResponseData( +```js +var filter = browser.webRequest.filterResponseData( requestId // string ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>requestId</code></dt> - <dd><code>string</code>. ID de la requĂȘte Ă filtrer. Vous pouvez l'obtenir Ă partir de l'objet de <code>details</code> qui est passĂ© dans n'importe quel Ă©couteur d'Ă©vĂ©nement <code>webRequest</code>.</dd> -</dl> +- `requestId` + - : `string`. ID de la requĂȘte Ă filtrer. Vous pouvez l'obtenir Ă partir de l'objet de `details` qui est passĂ© dans n'importe quel Ă©couteur d'Ă©vĂ©nement `webRequest`. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p>Un objet {{WebExtAPIRef("webRequest.StreamFilter")}} que vous pouvez utiliser pour surveiller et modifier la rĂ©ponse.</p> +Un objet {{WebExtAPIRef("webRequest.StreamFilter")}} que vous pouvez utiliser pour surveiller et modifier la rĂ©ponse. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple, tirĂ© de l'extension <a href="https://github.com/mdn/webextensions-examples/tree/master/http-response">http-response</a>, crĂ©e un filtre dans {{WebExtAPIRef("webRequest.onBeforeRequest")}} et l'utilise pour modifier la rĂ©ponse :</p> +Cet exemple, tirĂ© de l'extension [http-response](https://github.com/mdn/webextensions-examples/tree/master/http-response), crĂ©e un filtre dans {{WebExtAPIRef("webRequest.onBeforeRequest")}} et l'utilise pour modifier la rĂ©ponse : -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); let decoder = new TextDecoder("utf-8"); let encoder = new TextEncoder(); - filter.ondata = event => { + filter.ondata = event => { let str = decoder.decode(event.data, {stream: true}); // Just change any instance of Example in the HTTP response // to WebExtension Example. @@ -63,10 +63,10 @@ browser.webRequest.onBeforeRequest.addListener( {urls: ["https://example.com/*"], types: ["main_frame"]}, ["blocking"] ); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.filterResponseData", 10)}}</p> +{{Compat("webextensions.api.webRequest.filterResponseData", 10)}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/getsecurityinfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/getsecurityinfo/index.md index 5ab5f213f6..466ff2d36b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/getsecurityinfo/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/getsecurityinfo/index.md @@ -12,54 +12,53 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/getSecurityInfo --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Utilisez cette fonction pour obtenir des informations dĂ©taillĂ©es sur la connexion <a href="/fr/docs/Glossaire/TLS">TLS</a> associĂ©e Ă une demande particuliĂšre..</p> +Utilisez cette fonction pour obtenir des informations dĂ©taillĂ©es sur la connexion [TLS](/fr/docs/Glossaire/TLS) associĂ©e Ă une demande particuliĂšre.. -<p>Vous passez Ă cette fonction la <code>requestId</code> pour la requĂȘte en question, et quelques paramĂštres supplĂ©mentaires optionnels. Il retourne une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera rĂ©solue Ă un objet {{WebExtAPIRef("webRequest.SecurityInfo", "SecurityInfo")}}.</p> +Vous passez Ă cette fonction la `requestId` pour la requĂȘte en question, et quelques paramĂštres supplĂ©mentaires optionnels. Il retourne une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera rĂ©solue Ă un objet {{WebExtAPIRef("webRequest.SecurityInfo", "SecurityInfo")}}. -<p>Vous ne pouvez appeler cette fonction qu'Ă partir de l'Ă©couteur {{WebExtAPIRef("webRequest.onHeadersReceived")}}. La <code>requestId</code> peut ĂȘtre trouvĂ©e dans l'objet <code>details</code> object qui est passĂ© dans l'Ă©couteur.</p> +Vous ne pouvez appeler cette fonction qu'Ă partir de l'Ă©couteur {{WebExtAPIRef("webRequest.onHeadersReceived")}}. La `requestId` peut ĂȘtre trouvĂ©e dans l'objet `details` object qui est passĂ© dans l'Ă©couteur. -<p>Vous devez Ă©galement passer l'option "blocking" Ă Â <code>webRequest.onHeadersReceived.addListener()</code>. Ainsi, pour utiliser cette API, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission de l'API</a> "webRequestBlocking", ainsi que les permissions normales nĂ©cessaires pour utiliser les Ă©couteurs <code>webRequest</code> (la permission "webRequest" et la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permission hĂŽte</a> pour le hĂŽte).</p> +Vous devez Ă©galement passer l'option "blocking" Ă Â `webRequest.onHeadersReceived.addListener()`. Ainsi, pour utiliser cette API, vous devez avoir la [permission de l'API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "webRequestBlocking", ainsi que les permissions normales nĂ©cessaires pour utiliser les Ă©couteurs `webRequest` (la permission "webRequest" et la [permission hĂŽte](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions) pour le hĂŽte). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var gettingInfo = browser.webRequest.getSecurityInfo( +```js +var gettingInfo = browser.webRequest.getSecurityInfo( requestId, // string options // object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>requestId</code></dt> - <dd><code>string</code>. ID de la requĂȘte pour laquelle vous souhaitez obtenir des informations de sĂ©curitĂ©. Vous pouvez l'obtenir Ă partir de l'objet de <code>details</code> qui est passĂ© dans n'importe quel Ă©couteur d'Ă©vĂ©nement <code>webRequest</code>.</dd> - <dt><code>options</code></dt> - <dd><p><code>object</code>. Un objet qui peut contenir l'une des propriĂ©tĂ©s suivantes, toutes facultatives :</p> - <dl> - <dt><code>certificateChain</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si <code>true</code>, l'objet {{WebExtAPIRef("webRequest.SecurityInfo", "SecurityInfo")}} retournĂ© inclura toute la chaĂźne de certificats jusqu'Ă et y compris la racine de confiance. Si <code>false</code>, <br> - il n'inclura que le certificat du serveur. La valeur par dĂ©faut est <code>false</code>.</dd> - <dt><code>rawDER</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si true, chaque propriĂ©tĂ© {{WebExtAPIRef("webRequest.CertificateInfo", "CertificateInfo")}} dans le {{WebExtAPIRef("webRequest.SecurityInfo", "SecurityInfo.certificates")}} contiendra une propriĂ©tĂ© <code>rawDER</code>. Il contient le DER-encoded ASN.1 qui comprend les donnĂ©es du certificat.</dd> - </dl> - </dd> -</dl> +- `requestId` + - : `string`. ID de la requĂȘte pour laquelle vous souhaitez obtenir des informations de sĂ©curitĂ©. Vous pouvez l'obtenir Ă partir de l'objet de `details` qui est passĂ© dans n'importe quel Ă©couteur d'Ă©vĂ©nement `webRequest`. +- `options` -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. Un objet qui peut contenir l'une des propriĂ©tĂ©s suivantes, toutes facultatives : -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui se rĂ©sout en un objet {{WebExtAPIRef("webRequest.SecurityInfo", "SecurityInfo")}}.</p> + - `certificateChain` {{optional_inline}} + - : `boolean`. Si `true`, l'objet {{WebExtAPIRef("webRequest.SecurityInfo", "SecurityInfo")}} retournĂ© inclura toute la chaĂźne de certificats jusqu'Ă et y compris la racine de confiance. Si `false`, + il n'inclura que le certificat du serveur. La valeur par dĂ©faut est `false`. + - `rawDER` {{optional_inline}} + - : `boolean`. Si true, chaque propriĂ©tĂ© {{WebExtAPIRef("webRequest.CertificateInfo", "CertificateInfo")}} dans le {{WebExtAPIRef("webRequest.SecurityInfo", "SecurityInfo.certificates")}} contiendra une propriĂ©tĂ© `rawDER`. Il contient le DER-encoded ASN.1 qui comprend les donnĂ©es du certificat. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.webRequest.getSecurityInfo", 10)}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui se rĂ©sout en un objet {{WebExtAPIRef("webRequest.SecurityInfo", "SecurityInfo")}}. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Cet exemple Ă©coute toutes les requĂȘtes HTTPS Ă "mozilla.org" ou ses sous-domaines, et enregistre le nom de l'objet dans le certificat du serveur :</p> +{{Compat("webextensions.api.webRequest.getSecurityInfo", 10)}} -<pre class="brush: js">async function logSubject(details) { +## Exemples + +Cet exemple Ă©coute toutes les requĂȘtes HTTPS Ă "mozilla.org" ou ses sous-domaines, et enregistre le nom de l'objet dans le certificat du serveur : + +```js +async function logSubject(details) { try { let securityInfo = await browser.webRequest.getSecurityInfo(details.requestId, {}); console.log(details.url); @@ -75,11 +74,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/getSecurityInfo browser.webRequest.onHeadersReceived.addListener(logSubject, {urls: ["https://*.mozilla.org/*"]}, ["blocking"] -);</pre> +); +``` -<p>Cet exemple Ă©coute toutes les requĂȘtes HTTPS Ă "mozilla.org" ou ses sous-domaines, et enregistre le nom dans le certificat racine de confiance :</p> +Cet exemple Ă©coute toutes les requĂȘtes HTTPS Ă "mozilla.org" ou ses sous-domaines, et enregistre le nom dans le certificat racine de confiance : -<pre class="brush: js">async function logRoot(details) { +```js +async function logRoot(details) { try { let securityInfo = await browser.webRequest.getSecurityInfo( details.requestId, @@ -98,6 +99,7 @@ browser.webRequest.onHeadersReceived.addListener(logSubject, browser.webRequest.onHeadersReceived.addListener(logRoot, {urls: ["https://*.mozilla.org/*"]}, ["blocking"] -);</pre> +); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/handlerbehaviorchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/handlerbehaviorchanged/index.md index c1848d3c92..4dd6c859f1 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/handlerbehaviorchanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/handlerbehaviorchanged/index.md @@ -13,55 +13,49 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/handlerBehaviorChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Cette fonction peut ĂȘtre utilisĂ©e pour s'assurer que les auditeurs d'Ă©vĂ©nements sont appliquĂ©s correctement lorsque les pages se trouvent dans le cache en mĂ©moire du navigateur.Si le navigateur a chargĂ© une page et que la page est rechargĂ©e, le navigateur peut recharger la page Ă partir de son cache en mĂ©moire, et dans ce cas, les Ă©vĂ©nements ne seront pas dĂ©clenchĂ©s pour la demande. -<div>Cette fonction peut ĂȘtre utilisĂ©e pour s'assurer que les auditeurs d'Ă©vĂ©nements sont appliquĂ©s correctement lorsque les pages se trouvent dans le cache en mĂ©moire du navigateur.</div> +Supposons que le travail d'une extension consiste Ă bloquer les requĂȘtes Web par rapport Ă un modĂšle, et le scĂ©nario suivant se produit : -<div></div> +- L'utilisateur charge une page qui inclut une requĂȘte particuliĂšre, et le modĂšle permet la requĂȘte. +- La ressource est chargĂ©e et mise en cache en mĂ©moire. +- Les modĂšles de l'extension sont mis Ă jour, de telle sorte que la ressource ne serait plus autorisĂ©e. +- L'utilisateur recharge la page. -<div>Si le navigateur a chargĂ© une page et que la page est rechargĂ©e, le navigateur peut recharger la page Ă partir de son cache en mĂ©moire, et dans ce cas, les Ă©vĂ©nements ne seront pas dĂ©clenchĂ©s pour la demande.</div> +Comme la page sera rechargĂ©e Ă partir du cache mĂ©moire, il se peut que l'auditeur ne soit plus appelĂ© et que la requĂȘte soit chargĂ©e malgrĂ© la nouvelle stratĂ©gie de l'extension. -<p>Supposons que le travail d'une extension consiste Ă bloquer les requĂȘtes Web par rapport Ă un modĂšle, et le scĂ©nario suivant se produit :</p> +La fonction `handlerBehaviorChanged()` est conçue pour rĂ©soudre ce problĂšme. Il vide le cache en mĂ©moire, de sorte que les rechargements de page dĂ©clenchent les auditeurs d'Ă©vĂ©nements. -<ul> - <li>L'utilisateur charge une page qui inclut une requĂȘte particuliĂšre, et le modĂšle permet la requĂȘte.</li> - <li>La ressource est chargĂ©e et mise en cache en mĂ©moire.</li> - <li>Les modĂšles de l'extension sont mis Ă jour, de telle sorte que la ressource ne serait plus autorisĂ©e.</li> - <li>L'utilisateur recharge la page.</li> -</ul> +Parce que `handlerBehaviorChanged()` nettoie le cache, cela peut ĂȘtre coĂ»teux et mauvais pour la performance. Le module webRequest dĂ©finit une propriĂ©tĂ© en lecture seule {{WebExtAPIRef("webRequest.MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES", "MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES")}} : faire plus d'appels que ce nombre en 10 minutes n'aura aucun effet. -<p>Comme la page sera rechargĂ©e Ă partir du cache mĂ©moire, il se peut que l'auditeur ne soit plus appelĂ© et que la requĂȘte soit chargĂ©e malgrĂ© la nouvelle stratĂ©gie de l'extension.</p> +L'implĂ©mentation de la mise en cache, d'oĂč la nĂ©cessitĂ© de cette fonction, varie d'un navigateur Ă l'autre, de sorte que dans certains navigateurs, cette fonction ne fait rien. -<p>La fonction <code>handlerBehaviorChanged()</code> est conçue pour rĂ©soudre ce problĂšme. Il vide le cache en mĂ©moire, de sorte que les rechargements de page dĂ©clenchent les auditeurs d'Ă©vĂ©nements.</p> +Il s'agit d'une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<p>Parce que <code>handlerBehaviorChanged()</code> nettoie le cache, cela peut ĂȘtre coĂ»teux et mauvais pour la performance. Le module webRequest dĂ©finit une propriĂ©tĂ© en lecture seule {{WebExtAPIRef("webRequest.MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES", "MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES")}} : faire plus d'appels que ce nombre en 10 minutes n'aura aucun effet.</p> +## Syntaxe -<p>L'implĂ©mentation de la mise en cache, d'oĂč la nĂ©cessitĂ© de cette fonction, varie d'un navigateur Ă l'autre, de sorte que dans certains navigateurs, cette fonction ne fait rien.</p> +```js +var flushingCache = browser.webRequest.handlerBehaviorChanged() +``` -<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> +### ParamĂštres -<h2 id="Syntaxe">Syntaxe</h2> +None. -<pre class="brush: js">var flushingCache = browser.webRequest.handlerBehaviorChanged() -</pre> +### Valeur retournĂ©e -<h3 id="ParamĂštres">ParamĂštres</h3> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments, lorsque l'opĂ©ration sera terminĂ©e. -<p>None.</p> +## CompatibilitĂ© du navigateur -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +{{Compat("webextensions.api.webRequest.handlerBehaviorChanged")}} -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie sans arguments, lorsque l'opĂ©ration sera terminĂ©e.</p> +## Exemples -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +Dans le snippet suivant, nous vidons le cache en mĂ©moire via un appel Ă `handlerBehaviorChanged()`, et signalons cette action en enregistrant un message appropriĂ© Ă la console. -<p>{{Compat("webextensions.api.webRequest.handlerBehaviorChanged")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Dans le snippet suivant, nous vidons le cache en mĂ©moire via un appel Ă <code>handlerBehaviorChanged()</code>, et signalons cette action en enregistrant un message appropriĂ© Ă la console.</p> - -<pre class="brush: js">function onFlushed() { +```js +function onFlushed() { console.log(`In-memory cache flushed`); } @@ -70,19 +64,18 @@ function onError(error) { } var flushingCache = browser.webRequest.handlerBehaviorChanged(); -flushingCache.then(onFlushed, onError);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +flushingCache.then(onFlushed, onError); +``` -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -109,5 +102,4 @@ flushingCache.then(onFlushed, onError);</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/webrequest/httpheaders/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/httpheaders/index.md index 675f9ce1cb..d5dd446ed2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/httpheaders/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/httpheaders/index.md @@ -13,38 +13,34 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/HttpHeaders --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un tableau d'en-tetes HTTP. Chaque en-tĂȘte est reprĂ©sentĂ© comme un objet avec deux propriĂ©tĂ©s : <code>name</code> et <code>valeur</code> ou <code>binaryValue</code>.</p> +Un tableau d'en-tetes HTTP. Chaque en-tĂȘte est reprĂ©sentĂ© comme un objet avec deux propriĂ©tĂ©s : `name` et `valeur` ou `binaryValue`. -<h2 id="Type">Type</h2> +## Type -<p>Un <code>tableau</code> d'<code>objet</code>s. Chaque objet a les propriĂ©tĂ©s suivantes :</p> +Un `tableau` d'`objet`s. Chaque objet a les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>name</code></dt> - <dd><code>string</code>. Nom de l'en-tĂȘte HTTP.</dd> - <dt><code>value</code>{{optional_inline}}</dt> - <dd><code>string</code>. Valeur de l'en-tete HTTP si elle peut ĂȘtre reprĂ©sentĂ©e par UTF-8. Cette propriĂ©tĂ© ou valeur binaire doit ĂȘtre prĂ©sente.</dd> - <dt><code>binaryValue</code>{{optional_inline}}</dt> - <dd><code>array</code> d'<code><code>integer</code></code>. Valeur de l'en-tĂȘte HTTP s'il ne peut pas ĂȘtre reprĂ©sentĂ© par UTF-8, reprĂ©sentĂ© par en octets (0..255). Soit cette propriĂ©tĂ© ou cette <code>valeur</code> doit ĂȘtre prĂ©sente.</dd> -</dl> +- `name` + - : `string`. Nom de l'en-tĂȘte HTTP. +- `value`{{optional_inline}} + - : `string`. Valeur de l'en-tete HTTP si elle peut ĂȘtre reprĂ©sentĂ©e par UTF-8. Cette propriĂ©tĂ© ou valeur binaire doit ĂȘtre prĂ©sente. +- `binaryValue`{{optional_inline}} + - : `array` d'`integer`. Valeur de l'en-tĂȘte HTTP s'il ne peut pas ĂȘtre reprĂ©sentĂ© par UTF-8, reprĂ©sentĂ© par en octets (0..255). Soit cette propriĂ©tĂ© ou cette `valeur` doit ĂȘtre prĂ©sente. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.HttpHeaders")}}</p> +{{Compat("webextensions.api.webRequest.HttpHeaders")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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 @@ -71,5 +67,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/HttpHeaders // 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/webrequest/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/index.md index f5c4b587ca..59598f83ff 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/index.md @@ -12,164 +12,140 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest --- -<p>{{AddonSidebar}}</p> - -<p>Ajout d'Ă©couteurs d'Ă©vĂ©nements pour les diffĂ©rentes Ă©tapes d'une requĂȘte HTTP. L'Ă©couteur de l'Ă©vĂ©nement reçoit des informations dĂ©taillĂ©es sur la demande et peut modifier ou annuler la demande.</p> - -<p>Chaque Ă©vĂ©nement est dĂ©clenchĂ© Ă un stade particulier de la demande. La sĂ©quence typique des Ă©vĂ©nements est la suivante :</p> - -<p><img alt="" src="webRequest-flow.png"></p> - -<p>{{WebExtAPIRef("webRequest.onErrorOccurred", "onErrorOccurred")}} peut ĂȘtre tirĂ© Ă tout moment pendant la requĂȘte. Notez Ă©galement que parfois la sĂ©quence des Ă©vĂ©nements peut diffĂ©rer de ceci : par exemple, dans Firefox, lors d'une mise Ă niveau <a href="/fr/docs/SĂ©curitĂ©/HTTP_Strict_Transport_Security">HSTS</a>, l'Ă©vĂ©nement <code>onBeforeRedirect</code> sera dĂ©clenchĂ© immĂ©diatement aprĂšs <code>onBeforeRequest</code>.</p> - -<p>Tous les Ă©vĂšnements (exceptĂ© <code>onErrorOccurred</code>) peuvent prendre trois arguments pour <code>addListener()</code>:</p> - -<ul> - <li>Le receveur d'Ă©vĂšnements lui-mĂȘme</li> - <li>un {{WebExtAPIRef("webRequest.RequestFilter", "filter")}} objet, afin de n'ĂȘtre notifiĂ© que pour les requĂȘtes effectuĂ©s par des URLs particuliĂšres ou pour un type particulier de ressources.</li> - <li>un <code>extraInfoSpec</code> objet optionnel. Vous pouvez utiliser celui-ci pour passer des instructions spĂ©cifiques Ă l'Ă©vĂšnement supplĂ©mentaires.</li> -</ul> - -<p>Une fonction d'Ă©coute reçoit un objet <code>details</code> qui contient des informations Ă propos de la requĂȘte. Il inclut un ID de requĂȘte, fourni afin de permettre Ă une extension de relier des Ă©vĂšnements associĂ©s Ă une mĂȘme requĂȘte. Il est unique Ă chaque session de navigation et Ă l'extension. Il reste le mĂȘme tout au long d'une requĂȘte, mĂȘme durant les redirections et les Ă©changes d'authentifications.</p> - -<p>Pour utiliser l'API webRequest pour un hĂŽte donnĂ©, une extension doit avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission API</a> "webRequest" et la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permission hĂŽte </a>pour cet hĂŽte. Pour utiliser la fonction "blocking", l'extension doit Ă©galement avoir la permission API "webRequestBlocking".</p> - -<p>Pour intercepter des ressources chargĂ©es par une page (comme des images, des scripts ou des feuilles de style), l'extension doit avoir la permission de l'hĂŽte pour la ressource ainsi que pour la page principale demandant la ressource. Par exemple, si une page Ă Â "https://developer.mozilla.org" charge une image Ă partir de "https://mdn.mozillademos.org", alors une extension doit avoir les deux permissions d'hĂŽte si elle doit intercepter la demande d'image.</p> - -<h2 id="Modifier_une_requĂȘte">Modifier une requĂȘte</h2> - -<p>Sur certains de ces Ă©vĂ©nements, vous pouvez modifier la demande. Plus prĂ©cisĂ©ment, vous pouvez :</p> - -<ul> - <li>Annuler une requĂȘte avec: - <ul> - <li>{{WebExtAPIRef("webRequest.onBeforeRequest", "onBeforeRequest")}}</li> - <li>{{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}}</li> - <li>{{WebExtAPIRef("webRequest.onAuthRequired", "onAuthRequired")}}</li> - </ul> - </li> - <li>Rediriger une requĂȘte avec: - <ul> - <li>{{WebExtAPIRef("webRequest.onBeforeRequest", "onBeforeRequest")}}</li> - <li>{{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}}</li> - </ul> - </li> - <li>Modifier des en-tĂȘtes de requĂȘtes avec: - <ul> - <li>{{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}}</li> - </ul> - </li> - <li>Modifier des rĂ©ponses d'en-tĂȘtes avec: - <ul> - <li>{{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}}</li> - </ul> - </li> - <li>Fournir des informations d'authentifications avec: - <ul> - <li>{{WebExtAPIRef("webRequest.onAuthRequired", "onAuthRequired")}}</li> - </ul> - </li> -</ul> - -<p>Pour ce faire, vous devez transmettre une option avec la valeur "blocking" dans l'argument <code>extraInfoSpec</code> Ă la fonction <code>addListener()</code> de l'Ă©vĂ©nement. Cela rend l'auditeur synchrone. Dans l'Ă©couteur, vous pouvez alors renvoyer un objet {{WebExtAPIRef("webRequest.BlockingResponse", "BlockingResponse")}}, qui indique la modification Ă apporter : par exemple, l'en-tĂȘte de requĂȘte modifiĂ© que vous souhaitez envoyer.</p> - -<div class="warning"> -<p><strong>Attention :</strong> Les protocoles non-HTTP(S) ne supportent pas actuellement la fonctionnalitĂ© de "<code>blockage</code>", donc la modification de ces requĂȘtes n'est pas disponible pour le moment. Voir {{bug(1475832)}} pour plus de dĂ©tails.</p> -</div> - -<h2 id="AccĂ©der_aux_informations_de_sĂ©curitĂ©">AccĂ©der aux informations de sĂ©curitĂ©</h2> - -<p>Dans l'Ă©couteur {{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}} vous pouvez accĂ©der aux propriĂ©tĂ©s <a href="/fr/docs/Glossaire/TLS">TLS</a> d'une requĂȘte en appelant {{WebExtAPIRef("webRequest.getSecurityInfo()", "getSecurityInfo()")}}. Pour ce faire, vous devez Ă©galement transmettre le "blockage" dans l'argument <code>extraInfoSpec</code> Ă la fonction <code>addListener()</code> de l'Ă©vĂšnement.</p> - -<p>Vous pouvez lire les dĂ©tails de la prise de contact TLS, mais vous ne pouvez pas les modifier ou remplacer les dĂ©cisions de confiance du navigateur.</p> - -<h2 id="Modifier_les_rĂ©ponses">Modifier les rĂ©ponses</h2> - -<p>Pour modifier les corps de rĂ©ponse HTTP pour une requĂȘte, appelez {{WebExtAPIRef("webRequest.filterResponseData")}}, en lui transmettant l'ID de la requĂȘte. Cela renvoie un objet {{WebExtAPIRef("webRequest.StreamFilter")}} que vous pouvez utiliser pour examiner et modifier les donnĂ©es reçues par le navigateur.</p> - -<p>Pour ce faire, vous devez disposer de la permission de l'API "webRequestBlocking" ainsi que la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission de l'API</a> "webRequest" et la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permission de l'hĂŽte </a>pour l'hĂŽte concernĂ©.</p> - -<h2 id="Types">Types</h2> - -<dl> - <dt>{{WebExtAPIRef("webRequest.BlockingResponse")}}</dt> - <dd> - <p>Un objet de ce type est renvoyĂ© par les auditeurs d'Ă©vĂ©nements qui ont dĂ©fini le <code>"blockage"</code> dans leur argument <code>extraInfoSpec</code>. En dĂ©finissant des propriĂ©tĂ©s particuliĂšres dans <code>BlockingResponse</code>, the listener can modify network requests.</p> - </dd> - <dt>{{WebExtAPIRef("webRequest.CertificateInfo")}}</dt> - <dd>Un objet dĂ©crivant un seul certificat X.509.</dd> - <dt>{{WebExtAPIRef("webRequest.HttpHeaders")}}</dt> - <dd>Un tableau d'en-tĂȘtes HTTP. Chaque en-tĂȘte est reprĂ©sentĂ© comme un objet avec deux propriĂ©tĂ©s : <code>name</code> et <code>valeur</code> ou <code>binaryValue</code>.</dd> - <dt>{{WebExtAPIRef("webRequest.RequestFilter")}}</dt> - <dd>Un objet dĂ©crivant les filtres Ă appliquer aux Ă©vĂ©nements webRequest.</dd> - <dt>{{WebExtAPIRef("webRequest.ResourceType")}}</dt> - <dd>ReprĂ©sente un type particulier de ressources rĂ©cupĂ©rĂ©es dans une requĂȘte Web.</dd> - <dt>{{WebExtAPIRef("webRequest.SecurityInfo")}}</dt> - <dd>Un objet dĂ©crivant les propriĂ©tĂ©s de sĂ©curitĂ© d'une requĂȘte Web particuliĂšre.</dd> - <dt>{{WebExtAPIRef("webRequest.StreamFilter")}}</dt> - <dd>Un objet qui peut ĂȘtre utilisĂ© pour surveiller et modifier les rĂ©ponses HTTP pendant leur rĂ©ception.</dd> - <dt>{{WebExtAPIRef("webRequest.UploadData")}}</dt> - <dd>Contient des donnĂ©es tĂ©lĂ©chargĂ©es dans une requĂȘte URL.</dd> -</dl> - -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> - -<dl> - <dt>{{WebExtAPIRef("webRequest.MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES", "webRequest.MAX_âHANDLER_âBEHAVIOR_âCHANGED_âCALLS_âPER_â10_âMINUTES")}}</dt> - <dd>Le nombre de fois que <a href="/fr/Add-ons/WebExtensions/API/WebRequest/handlerBehaviorChanged"><code>handlerBehaviorChanged()</code></a> peut ĂȘtre appelĂ© dans une pĂ©riode de 10 minutes.</dd> -</dl> - -<h2 id="MĂ©thodes">MĂ©thodes</h2> - -<dl> - <dt>{{WebExtAPIRef("webRequest.handlerBehaviorChanged()")}}</dt> - <dd>Cette fonction peut ĂȘtre utilisĂ©e pour s'assurer que les Ă©couteurs d'Ă©vĂ©nements sont appliquĂ©s correctement lorsque les pages se trouvent dans le cache en mĂ©moire du navigateur.</dd> - <dt>{{WebExtAPIRef("webRequest.filterResponseData()")}}</dt> - <dd>Retourne un objet {{WebExtAPIRef("webRequest.StreamFilter")}} pour une requĂȘte donnĂ©e.</dd> - <dt>{{WebExtAPIRef("webRequest.getSecurityInfo()")}}</dt> - <dd>Obtient des informations dĂ©taillĂ©es sur la connexion <a href="/fr/docs/Glossaire/TLS">TLS</a> associĂ©e Ă une requĂȘte donnĂ©e.</dd> -</dl> - -<h2 id="EvĂ©nements">EvĂ©nements</h2> - -<dl> - <dt>{{WebExtAPIRef("webRequest.onBeforeRequest")}}</dt> - <dd>LancĂ© lorsqu'une demande est sur le point d'ĂȘtre faite, et avant que les en-tĂȘtes ne soient disponibles. C'est un bon endroit pour Ă©couter si vous voulez annuler ou rediriger la demande.</dd> - <dt>{{WebExtAPIRef("webRequest.onBeforeSendHeaders")}}</dt> - <dd>CĂąblĂ© avant d'envoyer des donnĂ©es HTTP, mais aprĂšs que les en-tĂȘtes HTTP soient disponibles. C'est un bon endroit pour Ă©couter si vous voulez modifier les en-tĂȘtes de requĂȘte HTTP.</dd> - <dt>{{WebExtAPIRef("webRequest.onSendHeaders")}}</dt> - <dd>LancĂ© juste avant l'envoi des en-tĂȘtes. Si votre add-on ou d'autres en-tĂȘtes modifiĂ©s dans <code>{{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}}</code>, vous verrez la version modifiĂ©e ici.</dd> - <dt>{{WebExtAPIRef("webRequest.onHeadersReceived")}}</dt> - <dd>LancĂ© lorsque les en-tĂȘtes de rĂ©ponse HTTP associĂ©s Ă une requĂȘte ont Ă©tĂ© reçus. Vous pouvez utiliser cet Ă©vĂ©nement pour modifier les en-tĂȘtes de rĂ©ponse HTTP.</dd> - <dt>{{WebExtAPIRef("webRequest.onAuthRequired")}}</dt> - <dd>DĂ©clenchĂ© lorsque le serveur demande au client de fournir des informations d'authentification. L'auditeur ne peut rien faire, annuler la demande ou fournir des informations d'authentification.</dd> - <dt>{{WebExtAPIRef("webRequest.onResponseStarted")}}</dt> - <dd>LancĂ© lorsque le premier octet du corps de rĂ©ponse est reçu. Pour les requĂȘtes HTTP, cela signifie que la ligne d'Ă©tat et les en-tĂȘtes de rĂ©ponse sont disponibles.</dd> - <dt>{{WebExtAPIRef("webRequest.onBeforeRedirect")}}</dt> - <dd>DĂ©clenchĂ© lorsqu'une redirection initiĂ©e par le serveur est sur le point de se produirer.</dd> - <dt>{{WebExtAPIRef("webRequest.onCompleted")}}</dt> - <dd>C'est dĂ©clenchĂ© lorsqu'une demande est complĂ©tĂ©e.</dd> - <dt>{{WebExtAPIRef("webRequest.onErrorOccurred")}}</dt> - <dd>DĂ©clenchĂ© lorsqu'une erreur se produit.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest")}}</p> - -<p><a href="/docs/Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities#webRequest_incompatibilities">Extra notes on Chrome incompatibilities</a>.</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/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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}} + +Ajout d'Ă©couteurs d'Ă©vĂ©nements pour les diffĂ©rentes Ă©tapes d'une requĂȘte HTTP. L'Ă©couteur de l'Ă©vĂ©nement reçoit des informations dĂ©taillĂ©es sur la demande et peut modifier ou annuler la demande. + +Chaque Ă©vĂ©nement est dĂ©clenchĂ© Ă un stade particulier de la demande. La sĂ©quence typique des Ă©vĂ©nements est la suivante : + +![](webRequest-flow.png) + +{{WebExtAPIRef("webRequest.onErrorOccurred", "onErrorOccurred")}} peut ĂȘtre tirĂ© Ă tout moment pendant la requĂȘte. Notez Ă©galement que parfois la sĂ©quence des Ă©vĂ©nements peut diffĂ©rer de ceci : par exemple, dans Firefox, lors d'une mise Ă niveau [HSTS](/fr/docs/SĂ©curitĂ©/HTTP_Strict_Transport_Security), l'Ă©vĂ©nement `onBeforeRedirect` sera dĂ©clenchĂ© immĂ©diatement aprĂšs `onBeforeRequest`. + +Tous les Ă©vĂšnements (exceptĂ© `onErrorOccurred`) peuvent prendre trois arguments pour `addListener()`: + +- Le receveur d'Ă©vĂšnements lui-mĂȘme +- un {{WebExtAPIRef("webRequest.RequestFilter", "filter")}} objet, afin de n'ĂȘtre notifiĂ© que pour les requĂȘtes effectuĂ©s par des URLs particuliĂšres ou pour un type particulier de ressources. +- un `extraInfoSpec` objet optionnel. Vous pouvez utiliser celui-ci pour passer des instructions spĂ©cifiques Ă l'Ă©vĂšnement supplĂ©mentaires. + +Une fonction d'Ă©coute reçoit un objet `details` qui contient des informations Ă propos de la requĂȘte. Il inclut un ID de requĂȘte, fourni afin de permettre Ă une extension de relier des Ă©vĂšnements associĂ©s Ă une mĂȘme requĂȘte. Il est unique Ă chaque session de navigation et Ă l'extension. Il reste le mĂȘme tout au long d'une requĂȘte, mĂȘme durant les redirections et les Ă©changes d'authentifications. + +Pour utiliser l'API webRequest pour un hĂŽte donnĂ©, une extension doit avoir la [permission API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "webRequest" et la [permission hĂŽte ](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions)pour cet hĂŽte. Pour utiliser la fonction "blocking", l'extension doit Ă©galement avoir la permission API "webRequestBlocking". + +Pour intercepter des ressources chargĂ©es par une page (comme des images, des scripts ou des feuilles de style), l'extension doit avoir la permission de l'hĂŽte pour la ressource ainsi que pour la page principale demandant la ressource. Par exemple, si une page Ă Â "https\://developer.mozilla.org" charge une image Ă partir de "https\://mdn.mozillademos.org", alors une extension doit avoir les deux permissions d'hĂŽte si elle doit intercepter la demande d'image. + +## Modifier une requĂȘte + +Sur certains de ces Ă©vĂ©nements, vous pouvez modifier la demande. Plus prĂ©cisĂ©ment, vous pouvez : + +- Annuler une requĂȘte avec: + + - {{WebExtAPIRef("webRequest.onBeforeRequest", "onBeforeRequest")}} + - {{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}} + - {{WebExtAPIRef("webRequest.onAuthRequired", "onAuthRequired")}} + +- Rediriger une requĂȘte avec: + + - {{WebExtAPIRef("webRequest.onBeforeRequest", "onBeforeRequest")}} + - {{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}} + +- Modifier des en-tĂȘtes de requĂȘtes avec: + + - {{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}} + +- Modifier des rĂ©ponses d'en-tĂȘtes avec: + + - {{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}} + +- Fournir des informations d'authentifications avec: + + - {{WebExtAPIRef("webRequest.onAuthRequired", "onAuthRequired")}} + +Pour ce faire, vous devez transmettre une option avec la valeur "blocking" dans l'argument `extraInfoSpec` Ă la fonction `addListener()` de l'Ă©vĂ©nement. Cela rend l'auditeur synchrone. Dans l'Ă©couteur, vous pouvez alors renvoyer un objet {{WebExtAPIRef("webRequest.BlockingResponse", "BlockingResponse")}}, qui indique la modification Ă apporter : par exemple, l'en-tĂȘte de requĂȘte modifiĂ© que vous souhaitez envoyer. + +> **Attention :** Les protocoles non-HTTP(S) ne supportent pas actuellement la fonctionnalitĂ© de "`blockage`", donc la modification de ces requĂȘtes n'est pas disponible pour le moment. Voir {{bug(1475832)}} pour plus de dĂ©tails. + +## AccĂ©der aux informations de sĂ©curitĂ© + +Dans l'Ă©couteur {{WebExtAPIRef("webRequest.onHeadersReceived", "onHeadersReceived")}} vous pouvez accĂ©der aux propriĂ©tĂ©s [TLS](/fr/docs/Glossaire/TLS) d'une requĂȘte en appelant {{WebExtAPIRef("webRequest.getSecurityInfo()", "getSecurityInfo()")}}. Pour ce faire, vous devez Ă©galement transmettre le "blockage" dans l'argument `extraInfoSpec` Ă la fonction `addListener()` de l'Ă©vĂšnement. + +Vous pouvez lire les dĂ©tails de la prise de contact TLS, mais vous ne pouvez pas les modifier ou remplacer les dĂ©cisions de confiance du navigateur. + +## Modifier les rĂ©ponses + +Pour modifier les corps de rĂ©ponse HTTP pour une requĂȘte, appelez {{WebExtAPIRef("webRequest.filterResponseData")}}, en lui transmettant l'ID de la requĂȘte. Cela renvoie un objet {{WebExtAPIRef("webRequest.StreamFilter")}} que vous pouvez utiliser pour examiner et modifier les donnĂ©es reçues par le navigateur. + +Pour ce faire, vous devez disposer de la permission de l'API "webRequestBlocking" ainsi que la [permission de l'API](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "webRequest" et la [permission de l'hĂŽte ](/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions)pour l'hĂŽte concernĂ©. + +## Types + +- {{WebExtAPIRef("webRequest.BlockingResponse")}} + - : Un objet de ce type est renvoyĂ© par les auditeurs d'Ă©vĂ©nements qui ont dĂ©fini le `"blockage"` dans leur argument `extraInfoSpec`. En dĂ©finissant des propriĂ©tĂ©s particuliĂšres dans `BlockingResponse`, the listener can modify network requests. +- {{WebExtAPIRef("webRequest.CertificateInfo")}} + - : Un objet dĂ©crivant un seul certificat X.509. +- {{WebExtAPIRef("webRequest.HttpHeaders")}} + - : Un tableau d'en-tĂȘtes HTTP. Chaque en-tĂȘte est reprĂ©sentĂ© comme un objet avec deux propriĂ©tĂ©s : `name` et `valeur` ou `binaryValue`. +- {{WebExtAPIRef("webRequest.RequestFilter")}} + - : Un objet dĂ©crivant les filtres Ă appliquer aux Ă©vĂ©nements webRequest. +- {{WebExtAPIRef("webRequest.ResourceType")}} + - : ReprĂ©sente un type particulier de ressources rĂ©cupĂ©rĂ©es dans une requĂȘte Web. +- {{WebExtAPIRef("webRequest.SecurityInfo")}} + - : Un objet dĂ©crivant les propriĂ©tĂ©s de sĂ©curitĂ© d'une requĂȘte Web particuliĂšre. +- {{WebExtAPIRef("webRequest.StreamFilter")}} + - : Un objet qui peut ĂȘtre utilisĂ© pour surveiller et modifier les rĂ©ponses HTTP pendant leur rĂ©ception. +- {{WebExtAPIRef("webRequest.UploadData")}} + - : Contient des donnĂ©es tĂ©lĂ©chargĂ©es dans une requĂȘte URL. + +## PropriĂ©tĂ©s + +- {{WebExtAPIRef("webRequest.MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES", "webRequest.MAX_âHANDLER_âBEHAVIOR_âCHANGED_âCALLS_âPER_â10_âMINUTES")}} + - : Le nombre de fois que [`handlerBehaviorChanged()`](/fr/Add-ons/WebExtensions/API/WebRequest/handlerBehaviorChanged) peut ĂȘtre appelĂ© dans une pĂ©riode de 10 minutes. + +## MĂ©thodes + +- {{WebExtAPIRef("webRequest.handlerBehaviorChanged()")}} + - : Cette fonction peut ĂȘtre utilisĂ©e pour s'assurer que les Ă©couteurs d'Ă©vĂ©nements sont appliquĂ©s correctement lorsque les pages se trouvent dans le cache en mĂ©moire du navigateur. +- {{WebExtAPIRef("webRequest.filterResponseData()")}} + - : Retourne un objet {{WebExtAPIRef("webRequest.StreamFilter")}} pour une requĂȘte donnĂ©e. +- {{WebExtAPIRef("webRequest.getSecurityInfo()")}} + - : Obtient des informations dĂ©taillĂ©es sur la connexion [TLS](/fr/docs/Glossaire/TLS) associĂ©e Ă une requĂȘte donnĂ©e. + +## EvĂ©nements + +- {{WebExtAPIRef("webRequest.onBeforeRequest")}} + - : LancĂ© lorsqu'une demande est sur le point d'ĂȘtre faite, et avant que les en-tĂȘtes ne soient disponibles. C'est un bon endroit pour Ă©couter si vous voulez annuler ou rediriger la demande. +- {{WebExtAPIRef("webRequest.onBeforeSendHeaders")}} + - : CĂąblĂ© avant d'envoyer des donnĂ©es HTTP, mais aprĂšs que les en-tĂȘtes HTTP soient disponibles. C'est un bon endroit pour Ă©couter si vous voulez modifier les en-tĂȘtes de requĂȘte HTTP. +- {{WebExtAPIRef("webRequest.onSendHeaders")}} + - : LancĂ© juste avant l'envoi des en-tĂȘtes. Si votre add-on ou d'autres en-tĂȘtes modifiĂ©s dans `{{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}}`, vous verrez la version modifiĂ©e ici. +- {{WebExtAPIRef("webRequest.onHeadersReceived")}} + - : LancĂ© lorsque les en-tĂȘtes de rĂ©ponse HTTP associĂ©s Ă une requĂȘte ont Ă©tĂ© reçus. Vous pouvez utiliser cet Ă©vĂ©nement pour modifier les en-tĂȘtes de rĂ©ponse HTTP. +- {{WebExtAPIRef("webRequest.onAuthRequired")}} + - : DĂ©clenchĂ© lorsque le serveur demande au client de fournir des informations d'authentification. L'auditeur ne peut rien faire, annuler la demande ou fournir des informations d'authentification. +- {{WebExtAPIRef("webRequest.onResponseStarted")}} + - : LancĂ© lorsque le premier octet du corps de rĂ©ponse est reçu. Pour les requĂȘtes HTTP, cela signifie que la ligne d'Ă©tat et les en-tĂȘtes de rĂ©ponse sont disponibles. +- {{WebExtAPIRef("webRequest.onBeforeRedirect")}} + - : DĂ©clenchĂ© lorsqu'une redirection initiĂ©e par le serveur est sur le point de se produirer. +- {{WebExtAPIRef("webRequest.onCompleted")}} + - : C'est dĂ©clenchĂ© lorsqu'une demande est complĂ©tĂ©e. +- {{WebExtAPIRef("webRequest.onErrorOccurred")}} + - : DĂ©clenchĂ© lorsqu'une erreur se produit. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest")}} + +[Extra notes on Chrome incompatibilities](/docs/Mozilla/Add-ons/WebExtensions/Chrome_incompatibilities#webRequest_incompatibilities). + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. + +<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 @@ -196,5 +172,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest // 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/webrequest/max_handler_behavior_changed_calls_per_10_minutes/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/max_handler_behavior_changed_calls_per_10_minutes/index.md index 97022ec8f4..9d00d01cd5 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/max_handler_behavior_changed_calls_per_10_minutes/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/max_handler_behavior_changed_calls_per_10_minutes/index.md @@ -15,27 +15,25 @@ tags: translation_of: >- Mozilla/Add-ons/WebExtensions/API/webRequest/MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES --- -<p>{{AddonSidebar}}</p> +{{AddonSidebar}} -<p>Le nombre maximum de fois que <code>{{WebExtAPIRef("webRequest.handlerBehaviorChanged", "handlerBehaviorChanged()")}}</code> peut ĂȘtre appelĂ© dans une pĂ©riode de 10 minutes.</p> +Le nombre maximum de fois que `{{WebExtAPIRef("webRequest.handlerBehaviorChanged", "handlerBehaviorChanged()")}}` peut ĂȘtre appelĂ© dans une pĂ©riode de 10 minutes. -<p>Cette propriĂ©tĂ© est en lecture seule.</p> +Cette propriĂ©tĂ© est en lecture seule. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES")}}</p> +{{Compat("webextensions.api.webRequest.MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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 @@ -62,5 +60,4 @@ translation_of: >- // 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/webrequest/onauthrequired/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onauthrequired/index.md index 28ed6d02c6..afadf2b721 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/onauthrequired/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onauthrequired/index.md @@ -13,184 +13,167 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/onAuthRequired --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Mise en place quand le serveur envoie un code status 401 ou 407 : c'est-Ă -dire lorsque le serveur demande au client de fournir des informations d'authentification telles qu'un nom d'utilisateur et un mot de passe.</p> +Mise en place quand le serveur envoie un code status 401 ou 407 : c'est-Ă -dire lorsque le serveur demande au client de fournir des informations d'authentification telles qu'un nom d'utilisateur et un mot de passe. -<p>L'auditeur peut rĂ©pondre de l'une des quatre façons suivantes :</p> +L'auditeur peut rĂ©pondre de l'une des quatre façons suivantes : -<p><strong>Ne rien faire </strong>: l'auditeur ne peut rien faire, il suffit d'observer la demande. Si cela se produit, cela n'aura aucun effet sur le traitement de la demande, et le navigateur demandera probablement simplement Ă l'utilisateur de se connecter.</p> +**Ne rien faire** : l'auditeur ne peut rien faire, il suffit d'observer la demande. Si cela se produit, cela n'aura aucun effet sur le traitement de la demande, et le navigateur demandera probablement simplement Ă l'utilisateur de se connecter. -<p><strong>Annuler la demande </strong>: l'auditeur peut annuler la demande. S'ils le font, l'authentification Ă©chouera et l'utilisateur ne sera pas invitĂ© Ă se connecter. Les prolongations peuvent annuler les demandes comme suit :</p> +**Annuler la demande** : l'auditeur peut annuler la demande. S'ils le font, l'authentification Ă©chouera et l'utilisateur ne sera pas invitĂ© Ă se connecter. Les prolongations peuvent annuler les demandes comme suit : -<ul> - <li>dans addListener, passez <code>"blocking"</code> dans le paramĂštre <code>extraInfoSpec </code></li> - <li>dans l'Ă©couteur lui-mĂȘme, retourne un objet avec une propriĂ©tĂ© <code>cancel</code> dĂ©finie Ă Â <code>true</code></li> -</ul> +- dans addListener, passez `"blocking"` dans le paramĂštre `extraInfoSpec` +- dans l'Ă©couteur lui-mĂȘme, retourne un objet avec une propriĂ©tĂ© `cancel` dĂ©finie Ă Â `true` -<p><strong>Fournir des informations d'identification de maniĂšre synchrone </strong>: si les informations d'identification sont disponibles de maniĂšre synchrone, l'extension peut les fournir de maniĂšre synchrone. Si l'extension fait cela, le navigateur tentera de se connecter avec les informations d'identification donnĂ©es.<br> - L'auditeur peut fournir des informations d'identification de maniĂšre synchrone comme suit :</p> +**Fournir des informations d'identification de maniĂšre synchrone** : si les informations d'identification sont disponibles de maniĂšre synchrone, l'extension peut les fournir de maniĂšre synchrone. Si l'extension fait cela, le navigateur tentera de se connecter avec les informations d'identification donnĂ©es. +L'auditeur peut fournir des informations d'identification de maniĂšre synchrone comme suit : -<ul> - <li>dans addListener, passez <code>"blocking"</code> dans le paramĂštre <code>extraInfoSpec</code></li> - <li>dans l'auditeur, retourner un objet avec une propriĂ©tĂ©Â <code>authCredentials</code> dĂ©finie sur les informations d'identification Ă fournir</li> -</ul> +- dans addListener, passez `"blocking"` dans le paramĂštre `extraInfoSpec` +- dans l'auditeur, retourner un objet avec une propriĂ©tĂ©Â `authCredentials` dĂ©finie sur les informations d'identification Ă fournir -<p><strong>Fournir les informations d'identification de maniĂšre asynchrone </strong>: l'extension peut avoir besoin de rĂ©cupĂ©rer les informations d'identification de maniĂšre asynchrone. Par exemple, l'extension peut avoir besoin d'extraire les informations d'identification du stockage ou de demander Ă l'utilisateur. Dans ce cas, l'auditeur peut fournir des informations d'identification de maniĂšre asynchrone comme suit :</p> +**Fournir les informations d'identification de maniĂšre asynchrone** : l'extension peut avoir besoin de rĂ©cupĂ©rer les informations d'identification de maniĂšre asynchrone. Par exemple, l'extension peut avoir besoin d'extraire les informations d'identification du stockage ou de demander Ă l'utilisateur. Dans ce cas, l'auditeur peut fournir des informations d'identification de maniĂšre asynchrone comme suit : -<ul> - <li>dans addListener, passez <code>"blocking"</code> dans le paramĂšre <code>extraInfoSpec</code></li> - <li>dans l'auditeur, retourner une <code>Promise</code> qui est rĂ©solue avec un objet contenant une propriĂ©tĂ© <code>authCredentials</code>, dĂ©finie sur les credentials Ă fournir.</li> -</ul> +- dans addListener, passez `"blocking"` dans le paramĂšre `extraInfoSpec` +- dans l'auditeur, retourner une `Promise` qui est rĂ©solue avec un objet contenant une propriĂ©tĂ© `authCredentials`, dĂ©finie sur les credentials Ă fournir. -<p>Voir <a href="/fr/Add-ons/WebExtensions/API/webRequest/onAuthRequired#Examples">Exemples</a>.</p> +Voir [Exemples](/fr/Add-ons/WebExtensions/API/webRequest/onAuthRequired#Examples). -<p>Si vous utilisez le <code>"blockage"</code> vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission de l'API "webRequestBlocking"</a> dans votre manifest.json.</p> +Si vous utilisez le `"blockage"` vous devez avoir la [permission de l'API "webRequestBlocking"](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) dans votre manifest.json. -<p>Si votre poste fournit de mauvaises informations d'identification, l'auditeur sera rappelĂ©. Pour cette raison, veillez Ă ne pas entrer dans une boucle infinie en fournissant Ă plusieurs reprises de mauvaises informations d'identification.</p> +Si votre poste fournit de mauvaises informations d'identification, l'auditeur sera rappelĂ©. Pour cette raison, veillez Ă ne pas entrer dans une boucle infinie en fournissant Ă plusieurs reprises de mauvaises informations d'identification. -<h2 id="Autorisation_de_proxy">Autorisation de proxy</h2> +## Autorisation de proxy -<p>En gĂ©nĂ©ral, Firefox ne dĂ©clenche pas d'Ă©vĂ©nements <code>webRequest</code> pour les requĂȘtes systĂšme, telles que les mises Ă jour de navigateur ou d'extension, ou les requĂȘtes des moteurs de recherche. Pour permettre Ă l'autorisation de proxy de fonctionner sans problĂšme pour les requĂȘtes systĂšme, Ă partir de la version 57 Firefox implĂ©mente une exception Ă cette rĂšgle.</p> +En gĂ©nĂ©ral, Firefox ne dĂ©clenche pas d'Ă©vĂ©nements `webRequest` pour les requĂȘtes systĂšme, telles que les mises Ă jour de navigateur ou d'extension, ou les requĂȘtes des moteurs de recherche. Pour permettre Ă l'autorisation de proxy de fonctionner sans problĂšme pour les requĂȘtes systĂšme, Ă partir de la version 57 Firefox implĂ©mente une exception Ă cette rĂšgle. -<p>Si une extension a les permissions "webRequest", "webRequestBlocking", "proxy", et "<all_urls>", alors elle pourra utiliser <code>onAuthRequired</code> pour fournir des informations d'identification pour l'autorisation de proxy (mais pas pour l'autorisation web normale). L'auditeur ne sera pas en mesure d'annuler les demandes du systĂšme ou d'apporter d'autres modifications aux demandes du systĂšme.</p> +Si une extension a les permissions "webRequest", "webRequestBlocking", "proxy", et "\<all_urls>", alors elle pourra utiliser `onAuthRequired` pour fournir des informations d'identification pour l'autorisation de proxy (mais pas pour l'autorisation web normale). L'auditeur ne sera pas en mesure d'annuler les demandes du systĂšme ou d'apporter d'autres modifications aux demandes du systĂšme. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webRequest.onAuthRequired.addListener( +```js +browser.webRequest.onAuthRequired.addListener( listener, // function filter, // object extraInfoSpec // optional array of strings ) browser.webRequest.onAuthRequired.removeListener(listener) browser.webRequest.onAuthRequired.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback, filter, extraInfoSpec)</code></dt> - <dd>Ajoute un Ă©couteur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>Ă©couteur</code> est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne <code>true</code> s'il est Ă l'Ă©coute, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd><p>Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants :</p> - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur la demande. Voir les <code><a href="#details">dĂ©tails</a></code> ci-dessous.</dd> - </dl> - - <p>Retourne : {{WebExtAPIRef('webRequest.BlockingResponse')}} ou une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> - - <ul> - <li>Pour traiter la requĂȘte de maniĂšre synchrone, inclure<code>"blocking"</code> dans le paramĂštre <code>extraInfoSpec</code> et retourner un objet <code>BlockingResponse</code>, avec son <code>cancel</code> ou ses propriĂ©tĂ©s <code>authCredentials</code>.</li> - <li>Pour traiter la requĂȘte de maniĂšre asynchrone, inclure <code>"blocking"</code> dans le paramĂštre <code>extraInfoSpec</code> et retourner une <code>Promise</code> qui est rĂ©solue avec un objet <code>BlockingResponse</code>, avec son <code>cancel</code> ou ses propriĂ©tĂ©s <code>authCredentials</code>.</li> - </ul> - </dd> - <dt><code>filter</code></dt> - <dd>{{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur.</dd> - <dt><code>extraInfoSpec</code>{{optional_inline}}</dt> - <dd><p><code>array</code> de <code>string</code>. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous pouvez passer n'importe laquelle des valeurs suivantes :</p> - <ul> - <li><code>"blocking"</code>: faire le blocage de la demande, afin que vous puissiez annuler la demande ou fournir des informations d'authentification.</li> - <li><code>"</code><code>responseHeaders</code><code>"</code>: inclure <code>responseHeaders</code> dans l'objet <code>details</code> transmis Ă l'auditeur</li> - </ul> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>challenger</code></dt> - <dd><p><code>object</code>. Le serveur demandant l'authentification. C'est un objet avec les propriĂ©tĂ©s suivantes :</p> - <dl> - <dt><code>host</code></dt> - <dd><code>string</code>. Le <a href="https://en.wikipedia.org/wiki/Hostname#Internet_hostnames">nom d'hĂŽte</a> du serveur.<br> - <strong>Warning</strong>: Contrairement Ă chrome, Firefox retournera l'hĂŽte demandĂ© au lieu du proxy demandant l'authentification, mĂȘme si <code>isProxy</code> est <code>true</code>.</dd> - <dt><code>port</code></dt> - <dd><code>integer</code>. Le numĂ©ro de port du serveur.</dd> - </dl> - </dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (<code>type</code> is <code>main_frame</code> or <code>sub_frame</code>), <code>frameId</code> indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet.</dd> - <dt><code>isProxy</code></dt> - <dd><code>boolean</code>. <code>true</code> pour Proxy-Authenticate, <code>false</code> pour WWW-Authenticate. <strong>Note</strong>: <code>webRequest.onAuthRequired</code> n'est appelĂ© que pour les serveurs proxy HTTP et HTTPS/SSL nĂ©cessitant une authentification, et non pour les serveurs proxy SOCKS nĂ©cessitant une authentification.</dd> - <dt><code>method</code></dt> - <dd><code>string</code>. MĂ©thode HTTP standard : par exemple, "GET" ou "POST".</dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent.</dd> - <dt><code>proxyInfo</code></dt> - <dd> - <p><code>object</code>. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>host</code></dt> - <dd><code>string</code>. Le nom d'hĂŽte du serveur proxy.</dd> - <dt><code>port</code></dt> - <dd><code>integer</code>. Le numĂ©ro de port du serveur proxy.</dd> - <dt><code>type</code></dt> - <dd> - <p><code>string</code>. Le type de serveur proxy. L'un des :</p> - - <ul> - <li>"http": proxy HTTP (ou SSL CONNECT pour HTTPS)</li> - <li>"https": proxy HTTP sur connexion TLS vers proxy</li> - <li>"socks": SOCKS v5 proxy</li> - <li>"socks4": SOCKS v4 proxy</li> - <li>"direct": pas de proxy</li> - <li>"unknown": proxy inconnu</li> - </ul> - </dd> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur pour le service proxy.</dd> - <dt><code>proxyDNS</code></dt> - <dd><code>boolean</code>. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS.</dd> - <dt><code>failoverTimeout</code></dt> - <dd><code>integer</code>. DĂ©lai d'attente de basculement en secondes. Si la connexion ne parvient pas Ă connecter le serveur proxy aprĂšs ce nombre de secondes, le serveur proxy suivant dans le tableau renvoyĂ© par <a href="/fr/docs/Add-ons/WebExtensions/API/proxy#FindProxyForURL()_return_value">FindProxyForURL()</a> sera utilisĂ©.</dd> - </dl> - </dd> - <dt><code>realm</code>{{optional_inline}}</dt> - <dd><code>string</code>. La zone d'authentification <a href="https://tools.ietf.org/html/rfc1945#section-11">realm</a> fournie par le serveur, s'il y en a un.</dd> - <dt><code>requestId</code></dt> - <dd><code>string</code>. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte.</dd> - <dt><code>responseHeaders</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse.</dd> - <dt><code>scheme</code></dt> - <dd><code>string</code>. Le schĂ©ma d'authentification : <code>"basic"</code> ou <code>"digest</code>".</dd> - <dt><code>statusCode</code></dt> - <dd><code>integer</code>. Code d'Ă©tat HTTP standard renvoyĂ© par le serveur.</dd> - <dt><code>statusLine</code></dt> - <dd><code>string</code>. Status d'Ă©tat HTTP de la rĂ©ponse ou la chaĂźne 'HTTP/0.9 200 OK' pour les rĂ©ponses HTTP/0.9 (c'est-Ă -dire les rĂ©ponses qui n'ont pas de ligne d'Ă©tat) ou une chaĂźne vide s'il n'y a pas d'en-tĂȘtes</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet".</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. Cible de la demande.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.onAuthRequired", 10)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Ce code n'observe que les demandes d'authentification pour l'URL cible :</p> - -<pre class="brush: js">var target = "https://intranet.company.com/"; +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback, filter, extraInfoSpec)` + - : Ajoute un Ă©couteur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `Ă©couteur` est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne `true` s'il est Ă l'Ă©coute, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants : + + - `details` + - : [`object`](#details). DĂ©tails sur la demande. Voir les [`dĂ©tails`](#details) ci-dessous. + + Retourne : {{WebExtAPIRef('webRequest.BlockingResponse')}} ou une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). + + - Pour traiter la requĂȘte de maniĂšre synchrone, inclure`"blocking"` dans le paramĂštre `extraInfoSpec` et retourner un objet `BlockingResponse`, avec son `cancel` ou ses propriĂ©tĂ©s `authCredentials`. + - Pour traiter la requĂȘte de maniĂšre asynchrone, inclure `"blocking"` dans le paramĂštre `extraInfoSpec` et retourner une `Promise` qui est rĂ©solue avec un objet `BlockingResponse`, avec son `cancel` ou ses propriĂ©tĂ©s `authCredentials`. + +- `filter` + - : {{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur. +- `extraInfoSpec`{{optional_inline}} + + - : `array` de `string`. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous pouvez passer n'importe laquelle des valeurs suivantes : + + - `"blocking"`: faire le blocage de la demande, afin que vous puissiez annuler la demande ou fournir des informations d'authentification. + - ` "``responseHeaders``" `: inclure `responseHeaders` dans l'objet `details` transmis Ă l'auditeur + +## Objets supplĂ©mentaires + +### dĂ©tails + +- `challenger` + + - : `object`. Le serveur demandant l'authentification. C'est un objet avec les propriĂ©tĂ©s suivantes : + + - `host` + - : `string`. Le [nom d'hĂŽte](https://en.wikipedia.org/wiki/Hostname#Internet_hostnames) du serveur. + **Warning**: Contrairement Ă chrome, Firefox retournera l'hĂŽte demandĂ© au lieu du proxy demandant l'authentification, mĂȘme si `isProxy` est `true`. + - `port` + - : `integer`. Le numĂ©ro de port du serveur. + +- `frameId` + - : `integer`. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (`type` is `main_frame` or `sub_frame`), `frameId` indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet. +- `isProxy` + - : `boolean`. `true` pour Proxy-Authenticate, `false` pour WWW-Authenticate. **Note**: `webRequest.onAuthRequired` n'est appelĂ© que pour les serveurs proxy HTTP et HTTPS/SSL nĂ©cessitant une authentification, et non pour les serveurs proxy SOCKS nĂ©cessitant une authentification. +- `method` + - : `string`. MĂ©thode HTTP standard : par exemple, "GET" ou "POST". +- `parentFrameId` + - : `integer`. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent. +- `proxyInfo` + + - : `object`. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes : + + - `host` + - : `string`. Le nom d'hĂŽte du serveur proxy. + - `port` + - : `integer`. Le numĂ©ro de port du serveur proxy. + - `type` + + - : `string`. Le type de serveur proxy. L'un des : + + - "http": proxy HTTP (ou SSL CONNECT pour HTTPS) + - "https": proxy HTTP sur connexion TLS vers proxy + - "socks": SOCKS v5 proxy + - "socks4": SOCKS v4 proxy + - "direct": pas de proxy + - "unknown": proxy inconnu + + - `username` + - : `string`. Nom d'utilisateur pour le service proxy. + - `proxyDNS` + - : `boolean`. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS. + - `failoverTimeout` + - : `integer`. DĂ©lai d'attente de basculement en secondes. Si la connexion ne parvient pas Ă connecter le serveur proxy aprĂšs ce nombre de secondes, le serveur proxy suivant dans le tableau renvoyĂ© par [FindProxyForURL()](</fr/docs/Add-ons/WebExtensions/API/proxy#FindProxyForURL()_return_value>) sera utilisĂ©. + +- `realm`{{optional_inline}} + - : `string`. La zone d'authentification [realm](https://tools.ietf.org/html/rfc1945#section-11) fournie par le serveur, s'il y en a un. +- `requestId` + - : `string`. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte. +- `responseHeaders`{{optional_inline}} + - : {{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse. +- `scheme` + - : `string`. Le schĂ©ma d'authentification : `"basic"` ou `"digest`". +- `statusCode` + - : `integer`. Code d'Ă©tat HTTP standard renvoyĂ© par le serveur. +- `statusLine` + - : `string`. Status d'Ă©tat HTTP de la rĂ©ponse ou la chaĂźne 'HTTP/0.9 200 OK' pour les rĂ©ponses HTTP/0.9 (c'est-Ă -dire les rĂ©ponses qui n'ont pas de ligne d'Ă©tat) ou une chaĂźne vide s'il n'y a pas d'en-tĂȘtes +- `tabId` + - : `integer`. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet. +- `timeStamp` + - : `number`. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `type` + - : {{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet". +- `url` + - : `string`. Cible de la demande. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.onAuthRequired", 10)}} + +## Exemples + +Ce code n'observe que les demandes d'authentification pour l'URL cible : + +```js +var target = "https://intranet.company.com/"; function observe(requestDetails) { console.log("observing: " + requestDetails.requestId); @@ -199,11 +182,13 @@ function observe(requestDetails) { browser.webRequest.onAuthRequired.addListener( observe, {urls: [target]} -);</pre> +); +``` -<p>Ce code annule les demandes d'authentification pour l'URL cible :</p> +Ce code annule les demandes d'authentification pour l'URL cible : -<pre class="brush: js">var target = "https://intranet.company.com/"; +```js +var target = "https://intranet.company.com/"; function cancel(requestDetails) { console.log("canceling: " + requestDetails.requestId); @@ -214,11 +199,13 @@ browser.webRequest.onAuthRequired.addListener( cancel, {urls: [target]}, ["blocking"] -);</pre> +); +``` -<p>Ce code fournit les informations d'identification de maniĂšre synchrone. Il doit garder une trace des demandes en suspens, pour s'assurer qu'il n'essaie pas Ă plusieurs reprises de soumettre de mauvaises rĂ©fĂ©rences :</p> +Ce code fournit les informations d'identification de maniĂšre synchrone. Il doit garder une trace des demandes en suspens, pour s'assurer qu'il n'essaie pas Ă plusieurs reprises de soumettre de mauvaises rĂ©fĂ©rences : -<pre class="brush: js">var target = "https://intranet.company.com/"; +```js +var target = "https://intranet.company.com/"; var myCredentials = { username: "me@company.com", @@ -232,7 +219,7 @@ var pendingRequests = []; function completed(requestDetails) { console.log("completed: " + requestDetails.requestId); var index = pendingRequests.indexOf(requestDetails.requestId); - if (index > -1) { + if (index > -1) { pendingRequests.splice(index, 1); } } @@ -263,11 +250,13 @@ browser.webRequest.onCompleted.addListener( browser.webRequest.onErrorOccurred.addListener( completed, {urls: [target]} -);</pre> +); +``` -<p>Ce code fournit les informations d'identification de maniĂšre asynchrone, en les rĂ©cupĂ©rant Ă partir du stockage. Il doit Ă©galement assurer le suivi des demandes en suspens, afin de s'assurer qu'il n'essaie pas Ă plusieurs reprises de soumettre de mauvaises rĂ©fĂ©rences :</p> +Ce code fournit les informations d'identification de maniĂšre asynchrone, en les rĂ©cupĂ©rant Ă partir du stockage. Il doit Ă©galement assurer le suivi des demandes en suspens, afin de s'assurer qu'il n'essaie pas Ă plusieurs reprises de soumettre de mauvaises rĂ©fĂ©rences : -<pre class="brush: js">var target = "https://httpbin.org/basic-auth/*"; +```js +var target = "https://httpbin.org/basic-auth/*"; var pendingRequests = []; @@ -277,7 +266,7 @@ A request has completed. We can stop worrying about it. function completed(requestDetails) { console.log("completed: " + requestDetails.requestId); var index = pendingRequests.indexOf(requestDetails.requestId); - if (index > -1) { + if (index > -1) { pendingRequests.splice(index, 1); } } @@ -314,19 +303,17 @@ browser.webRequest.onErrorOccurred.addListener( completed, {urls: [target]} ); -</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/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -353,5 +340,4 @@ browser.webRequest.onErrorOccurred.addListener( // 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/webrequest/onbeforeredirect/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onbeforeredirect/index.md index db3c1dc5f7..c4d0f75101 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/onbeforeredirect/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onbeforeredirect/index.md @@ -13,140 +13,127 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/onBeforeRedirect --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>DĂ©clenchĂ© lorsqu'une redirection initiĂ©e par le serveur est sur le point de se produire.</p> +DĂ©clenchĂ© lorsqu'une redirection initiĂ©e par le serveur est sur le point de se produire. -<p>Notez que vous ne pouvez pas passer le <code>"blockage"</code> pour cet Ă©vĂ©nement, donc vous ne pouvez pas modifier ou annuler la demande de cet Ă©vĂ©nement : c'est uniquement Ă titre d'information.</p> +Notez que vous ne pouvez pas passer le `"blockage"` pour cet Ă©vĂ©nement, donc vous ne pouvez pas modifier ou annuler la demande de cet Ă©vĂ©nement : c'est uniquement Ă titre d'information. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webRequest.onBeforeRedirect.addListener( +```js +browser.webRequest.onBeforeRedirect.addListener( listener, // function filter, // object extraInfoSpec // optional array of strings ) browser.webRequest.onBeforeRedirect.removeListener(listener) browser.webRequest.onBeforeRedirect.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback, filter, extraInfoSpec)</code></dt> - <dd>Ajouter un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants :</p> - - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur la demande. Voir les <code><a href="#details">dĂ©tails</a></code> ci-dessous.</dd> - </dl> - </dd> - <dt><code>filter</code></dt> - <dd>{{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur.</dd> - <dt><code>extraInfoSpec</code>{{optional_inline}}</dt> - <dd><p><code>array</code> de <code>string</code>. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous ne pouvez passer qu'une seule valeur :</p> - <ul> - <li><code>"</code><code>responseHeaders</code><code>"</code>: inclure <code>responseHeaders</code> dans l'objet <code>dĂ©tails</code> transmis Ă l'auditeur.</li> - </ul> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>documentUrl</code></dt> - <dd><code>string</code>. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https://example.com" contient une image ou un iframe, alors le <code>documentUrl</code> pour l'image ou l'iframe sera "https://example.com". Pour un document de niveau supĂ©rieur, <code>documentUrl</code> n'est pas dĂ©fini.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (<code>type</code> is <code>main_frame</code> or <code>sub_frame</code>), <code>frameId</code> indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet.</dd> - <dt><code>fromCache</code></dt> - <dd><code>boolean</code>. Indique si cette rĂ©ponse a Ă©tĂ© rĂ©cupĂ©rĂ©e dans le cache du disque.</dd> - <dt><code>ip</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse IP du serveur Ă laquelle la requĂȘte a Ă©tĂ© envoyĂ©e. Notez qu'il peut s'agir d'une adresse IPv6 littĂ©rale.</dd> - <dt><code>method</code></dt> - <dd><code>string</code>. MĂ©thode HTTP standard : par exemple, "GET" ou "POST".</dd> - <dt><code>originUrl</code></dt> - <dd> - <p><code>string</code>. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors <code>originUrl</code> de la requĂȘte rĂ©sultante est "https://example.com".</p> - - <p>L'<code>originUrl</code> est souvent mais pas toujours la mĂȘme chose que <code>documentUrl</code>.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le <code>documentUrl</code> pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'<code>originUrl</code> sera l'URL du document dans l'iframe qui contenait le lien.</p> - - - </dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent.</dd> - <dt><code>proxyInfo</code></dt> - <dd> - <p><code>object</code>. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>host</code></dt> - <dd><code>string</code>. Le nom d'hĂŽte du serveur proxy.</dd> - <dt><code>port</code></dt> - <dd><code>integer</code>. Le numĂ©ro de port du serveur proxy.</dd> - <dt><code>type</code></dt> - <dd> - <p><code>string</code>. Le type de serveur proxy. L'un des :</p> - - <ul> - <li>"http": proxy HTTP (ou SSL CONNECT pour HTTPS)</li> - <li>"https": proxy HTTP sur connexion TLS vers proxy</li> - <li>"socks": SOCKS v5 proxy</li> - <li>"socks4": SOCKS v4 proxy</li> - <li>"direct": pas de proxy</li> - <li>"unknown": proxy inconnu</li> - </ul> - </dd> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur pour le service proxy.</dd> - <dt><code>proxyDNS</code></dt> - <dd><code>boolean</code>. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS.</dd> - <dt><code>failoverTimeout</code></dt> - <dd><code>integer</code>. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode.</dd> - </dl> - </dd> - <dt><code>redirectUrl</code></dt> - <dd><code>string</code>. La nouvelle URL.</dd> - <dt><code>requestId</code></dt> - <dd><code>string</code>. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte.</dd> - <dt><code>responseHeaders</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse.</dd> - <dt><code>statusCode</code></dt> - <dd><code>integer</code>. Code d'Ă©tat HTTP standard renvoyĂ© par le serveur.</dd> - <dt><code>statusLine</code></dt> - <dd><code>string</code>. Status d'Ă©tat HTTP de la rĂ©ponse ou la chaĂźne 'HTTP/0.9 200 OK' pour les rĂ©ponses HTTP/0.9 (c'est-Ă -dire les rĂ©ponses qui n'ont pas de ligne d'Ă©tat) ou une chaĂźne vide s'il n'y a pas d'en-tĂȘtes</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet".</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. Cible de la demande.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.onBeforeRedirect", 10)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">var target = "https://developer.mozilla.org/*"; +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback, filter, extraInfoSpec)` + - : Ajouter un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne `true` s'il est Ă©coutĂ©, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants : + + - `details` + - : [`object`](#details). DĂ©tails sur la demande. Voir les [`dĂ©tails`](#details) ci-dessous. + +- `filter` + - : {{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur. +- `extraInfoSpec`{{optional_inline}} + + - : `array` de `string`. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous ne pouvez passer qu'une seule valeur : + + - ` "``responseHeaders``" `: inclure `responseHeaders` dans l'objet `dĂ©tails` transmis Ă l'auditeur. + +## Objets supplĂ©mentaires + +### dĂ©tails + +- `documentUrl` + - : `string`. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https\://example.com" contient une image ou un iframe, alors le `documentUrl` pour l'image ou l'iframe sera "https\://example.com". Pour un document de niveau supĂ©rieur, `documentUrl` n'est pas dĂ©fini. +- `frameId` + - : `integer`. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (`type` is `main_frame` or `sub_frame`), `frameId` indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet. +- `fromCache` + - : `boolean`. Indique si cette rĂ©ponse a Ă©tĂ© rĂ©cupĂ©rĂ©e dans le cache du disque. +- `ip`{{optional_inline}} + - : `string`. L'adresse IP du serveur Ă laquelle la requĂȘte a Ă©tĂ© envoyĂ©e. Notez qu'il peut s'agir d'une adresse IPv6 littĂ©rale. +- `method` + - : `string`. MĂ©thode HTTP standard : par exemple, "GET" ou "POST". +- `originUrl` + + - : `string`. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https\://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors `originUrl` de la requĂȘte rĂ©sultante est "https\://example.com". + + L'`originUrl` est souvent mais pas toujours la mĂȘme chose que `documentUrl`.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le `documentUrl` pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'`originUrl` sera l'URL du document dans l'iframe qui contenait le lien. + +- `parentFrameId` + - : `integer`. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent. +- `proxyInfo` + + - : `object`. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes : + + - `host` + - : `string`. Le nom d'hĂŽte du serveur proxy. + - `port` + - : `integer`. Le numĂ©ro de port du serveur proxy. + - `type` + + - : `string`. Le type de serveur proxy. L'un des : + + - "http": proxy HTTP (ou SSL CONNECT pour HTTPS) + - "https": proxy HTTP sur connexion TLS vers proxy + - "socks": SOCKS v5 proxy + - "socks4": SOCKS v4 proxy + - "direct": pas de proxy + - "unknown": proxy inconnu + + - `username` + - : `string`. Nom d'utilisateur pour le service proxy. + - `proxyDNS` + - : `boolean`. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS. + - `failoverTimeout` + - : `integer`. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode. + +- `redirectUrl` + - : `string`. La nouvelle URL. +- `requestId` + - : `string`. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte. +- `responseHeaders`{{optional_inline}} + - : {{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse. +- `statusCode` + - : `integer`. Code d'Ă©tat HTTP standard renvoyĂ© par le serveur. +- `statusLine` + - : `string`. Status d'Ă©tat HTTP de la rĂ©ponse ou la chaĂźne 'HTTP/0.9 200 OK' pour les rĂ©ponses HTTP/0.9 (c'est-Ă -dire les rĂ©ponses qui n'ont pas de ligne d'Ă©tat) ou une chaĂźne vide s'il n'y a pas d'en-tĂȘtes +- `tabId` + - : `integer`. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet. +- `timeStamp` + - : `number`. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `type` + - : {{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet". +- `url` + - : `string`. Cible de la demande. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.onBeforeRedirect", 10)}} + +## Exemples + +```js +var target = "https://developer.mozilla.org/*"; /* e.g. @@ -162,19 +149,17 @@ browser.webRequest.onBeforeRedirect.addListener( logResponse, {urls: [target]} ); -</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/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -201,5 +186,4 @@ browser.webRequest.onBeforeRedirect.addListener( // 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/webrequest/onbeforerequest/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onbeforerequest/index.md index 199b8d49d0..1fe48946a1 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/onbeforerequest/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onbeforerequest/index.md @@ -13,177 +13,172 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/onBeforeRequest --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Cet Ă©vĂ©nement est dĂ©clenchĂ© lorsqu'une demande est sur le point d'ĂȘtre faite et avant que les en-tĂȘtes ne soient disponibles. C'est un bon endroit pour Ă©couter si vous voulez annuler ou rediriger la demande.</p> +Cet Ă©vĂ©nement est dĂ©clenchĂ© lorsqu'une demande est sur le point d'ĂȘtre faite et avant que les en-tĂȘtes ne soient disponibles. C'est un bon endroit pour Ă©couter si vous voulez annuler ou rediriger la demande. -<p>Pour annuler ou rediriger la requĂȘte, incluez d'abord <code>"blocking"</code> dans l'argument tableau <code>extraInfoSpec</code> pour <code>addListener()</code>. Ensuite, dans la fonction Listener, retournez un objet {{WebExtAPIRef("webRequest.BlockingResponse", "BlockingResponse")}}, en dĂ©finissant la propriĂ©tĂ© appropriĂ©e :</p> +Pour annuler ou rediriger la requĂȘte, incluez d'abord `"blocking"` dans l'argument tableau `extraInfoSpec` pour `addListener()`. Ensuite, dans la fonction Listener, retournez un objet {{WebExtAPIRef("webRequest.BlockingResponse", "BlockingResponse")}}, en dĂ©finissant la propriĂ©tĂ© appropriĂ©e : -<ul> - <li>pour annuler la demande, inclure une propriĂ©tĂ© <code>cancel</code> avec la valeur <code>true</code>.</li> - <li>pour rediriger la requĂȘte, inclure une propriĂ©tĂ© <code>redirectUrl</code> avec la valeur fixĂ©e Ă l'URL vers laquelle vous voulez rediriger.</li> -</ul> +- pour annuler la demande, inclure une propriĂ©tĂ© `cancel` avec la valeur `true`. +- pour rediriger la requĂȘte, inclure une propriĂ©tĂ© `redirectUrl` avec la valeur fixĂ©e Ă l'URL vers laquelle vous voulez rediriger. -<p>Si une extension veut rediriger une URL publique (par exemple HTTPS) ver une <a href="/fr/Add-ons/WebExtensions/user_interface/Extension_pages">page d'extension</a>, de l'extension doit contenir une clĂ© <a href="/fr/Add-ons/WebExtensions/manifest.json/web_accessible_resources">web_accessible_resources</a> qui liste l'URL de la page d'extension.</p> +Si une extension veut rediriger une URL publique (par exemple HTTPS) ver une [page d'extension](/fr/Add-ons/WebExtensions/user_interface/Extension_pages), de l'extension doit contenir une clĂ© [web_accessible_resources](/fr/Add-ons/WebExtensions/manifest.json/web_accessible_resources) qui liste l'URL de la page d'extension. -<p>Lorsque plusieurs gestionnaires de blocage modifient une requĂȘte, une seule sĂ©rie de modifications prend effet. Les redirections et les annulations ont la mĂȘme prioritĂ©. Ainsi, si vous avez annulĂ© une requĂȘte, vous pouvez voir une autre requĂȘte avec la mĂȘme <code>requestId</code> Ă nouveau si un autre gestionnaire de blocage a redirigĂ© la requĂȘte.</p> +Lorsque plusieurs gestionnaires de blocage modifient une requĂȘte, une seule sĂ©rie de modifications prend effet. Les redirections et les annulations ont la mĂȘme prioritĂ©. Ainsi, si vous avez annulĂ© une requĂȘte, vous pouvez voir une autre requĂȘte avec la mĂȘme `requestId` Ă nouveau si un autre gestionnaire de blocage a redirigĂ© la requĂȘte. -<p>A partir de Firefox 52, au lieu de renvoyer <code>BlockingResponse</code>, l'auditeur peut renvoyer une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui est rĂ©solue avec un <code>BlockingResponse</code>. Ceci permet Ă l'auditeur de traiter la demande de maniĂšre asynchrone.</p> +A partir de Firefox 52, au lieu de renvoyer `BlockingResponse`, l'auditeur peut renvoyer une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est rĂ©solue avec un `BlockingResponse`. Ceci permet Ă l'auditeur de traiter la demande de maniĂšre asynchrone. -<p>Si vous utilisez le <code>"blocking"</code>, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission de l'API "webRequestBlocking"</a> dans votre manifest.json.</p> +Si vous utilisez le `"blocking"`, vous devez avoir la [permission de l'API "webRequestBlocking"](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) dans votre manifest.json. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webRequest.onBeforeRequest.addListener( +```js +browser.webRequest.onBeforeRequest.addListener( listener, // function filter, // object extraInfoSpec // optional array of strings ) browser.webRequest.onBeforeRequest.removeListener(listener) browser.webRequest.onBeforeRequest.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback, filter, extraInfoSpec)</code></dt> - <dd>Ajoute un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'<code>Ă©couteur</code> est l'Ă©couteur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>l'Ă©couteur</code> est inscrit Ă cet Ă©vĂ©nement. Renvoie <code>true</code> s'il est Ă l'Ă©coute, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd><p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants :</p> - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur la demande. Voir les <code><a href="#details">details</a></code> ci-dessous.</dd> - </dl> - <p>Les retours : {{WebExtAPIRef('webRequest.BlockingResponse')}}. Si <code>"blocking"</code>est spĂ©cifiĂ© dans le paramĂštre <code>extraInfoSpec</code>, l'auditeur d'Ă©vĂ©nement doit retourner un objet <code>BlockingResponse</code>, et peut dĂ©finir soit son <code>annulation</code>, soit ses propriĂ©tĂ©s <code>redirectUrl</code>. A partir de Firefox 52, au lieu de renvoyer <code>BlockingResponse</code>,l'auditeur peut renvoyer une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui est rĂ©solue avec un <code>BlockingResponse</code>. Ceci permet Ă l'auditeur de traiter la demande de maniĂšre asynchrone.</p> - </dd> - <dt><code>filter</code></dt> - <dd>{{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur.</dd> - <dt><code>extraInfoSpec</code>{{optional_inline}}</dt> - <dd><p><code>array</code> de <code>string</code>. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous pouvez passer n'importe laquelle des valeurs suivantes :</p> - <ul> - <li><code>"blocking"</code>: rendre la requĂȘte synchrone, de sorte que vous pouvez annuler ou rediriger la requĂȘte</li> - <li><code>"requestBody"</code>: include <code>requestBody</code> dans l'objet <code>details</code> transmis Ă l'auditeur</li> - </ul> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>documentUrl</code></dt> - <dd><code>string</code>. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https://example.com" contient une image ou un iframe, alors le <code>documentUrl</code> pour l'image ou l'iframe sera "https://example.com". Pour un document de niveau supĂ©rieur, <code>documentUrl</code> n'est pas dĂ©fini.</dd> - <dt><code>frameAncestors</code></dt> - <dd><p><code>array</code>. Contient des informations pour chaque document dans la hiĂ©rarchie des cadres jusqu'au document de niveau supĂ©rieur. Le premier Ă©lĂ©ment du tableau contient des informations sur le parent immĂ©diat du document demandĂ©, et le dernier Ă©lĂ©ment contient des informations sur le document de niveau supĂ©rieur. Si la charge est rĂ©ellement pour le document de niveau supĂ©rieur, alors ce tableau est vide.</p> - <dl> - <dt><code>url</code></dt> - <dd><code>string</code>. URL Ă partir de laquelle le document a Ă©tĂ© chargĂ©.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. Le <code>frameId</code> du document. <code>details.frameAncestors[0].frameId</code> est le mĂȘme que <code>details.parentFrameId</code>.</dd> - </dl> - </dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (<code>type</code> is <code>main_frame</code> or <code>sub_frame</code>), <code>frameId</code> indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet.</dd> - <dt><code>method</code></dt> - <dd><code>string</code>. MĂ©thode HTTP standard : par exemple, "GET" ou "POST".</dd> - <dt><code>originUrl</code></dt> - <dd> - <p><code>string</code>. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors <code>originUrl</code> de la requĂȘte rĂ©sultante est "https://example.com".</p> - - <p>L'<code>originUrl</code> est souvent mais pas toujours la mĂȘme chose que <code>documentUrl</code>.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le <code>documentUrl</code> pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'<code>originUrl</code> sera l'URL du document dans l'iframe qui contenait le lien.</p> - </dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent.</dd> - <dt><code>proxyInfo</code></dt> - <dd> - <p><code>object</code>. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>host</code></dt> - <dd><code>string</code>. Le nom d'hĂŽte du serveur proxy.</dd> - <dt><code>port</code></dt> - <dd><code>integer</code>. Le numĂ©ro de port du serveur proxy.</dd> - <dt><code>type</code></dt> - <dd> - <p><code>string</code>. Le type de serveur proxy. L'un des :</p> - - <ul> - <li>"http": proxy HTTP (ou SSL CONNECT pour HTTPS)</li> - <li>"https": proxy HTTP sur connexion TLS vers proxy</li> - <li>"socks": SOCKS v5 proxy</li> - <li>"socks4": SOCKS v4 proxy</li> - <li>"direct": pas de proxy</li> - <li>"unknown": proxy inconnu</li> - </ul> - </dd> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur pour le service proxy.</dd> - <dt><code>proxyDNS</code></dt> - <dd><code>boolean</code>. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS.</dd> - <dt><code>failoverTimeout</code></dt> - <dd><code>integer</code>. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode.</dd> - </dl> - </dd> - <dt><code>requestBody</code>{{optional_inline}}</dt> - <dd><p><code>object</code>. Contient les donnĂ©es du corps de la requĂȘte HTTP. Seulement si <code>extraInfoSpec</code> contient <code>"requestBody"</code>.</p> - <dl> - <dt><code>error</code>{{optional_inline}}</dt> - <dd><code>string</code>. Ce paramĂštre est dĂ©fini si des erreurs ont Ă©tĂ© rencontrĂ©es lors de l'obtention des donnĂ©es du corps de la demande.</dd> - <dt><code>formData</code>{{optional_inline}}</dt> - <dd><p><code>object</code>. Cet objet est prĂ©sent si la mĂ©thode de requĂȘte est POST et que le corps est une sĂ©quence de paires clĂ©-valeur codĂ©es en UTF-8 sous la forme "multipart/form-data" ou "application/x-www-form-urlencoded".</p> - <p>Il s'agit d'un dictionnaire dans lequel chaque clĂ© contient la liste de toutes les valeurs de cette clĂ©. Par exemple: <code>{'key': ['value1', 'value2']}</code>. Si les donnĂ©es sont d'un autre type de support, ou si elles sont malformĂ©es, l'objet n'est pas prĂ©sent.</p></dd> - <dt><code>raw</code>{{optional_inline}}</dt> - <dd><code>array</code> of <code>{{WebExtAPIRef('webRequest.UploadData')}}</code>. Si la mĂ©thode de requĂȘte est PUT ou POST, et que le corps n'est pas dĂ©jĂ analysĂ© dans <code>formData</code>, alors ce tableau contient les Ă©lĂ©ments de corps de requĂȘte non analysĂ©s.</dd> - </dl> - </dd> - <dt><code>requestId</code></dt> - <dd><code>string</code>. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte.</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet".</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. Cible de la demande.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.onBeforeRequest", 10)}}</p> - -<h3 id="Ordre_de_rĂ©solution_DNS_lorsque_BlockingResponse_est_utilisĂ©">Ordre de rĂ©solution DNS lorsque BlockingResponse est utilisĂ©</h3> - -<p>En ce qui concerne la rĂ©solution DNS lorsque BlockingResponse est utilisĂ© avec OnBeforeRequest : Dans le canal HTTP, avec rĂ©ponse de blocage se produit avant la rĂ©solution DNS et avant la connexion spĂ©culative. Pour les autres canaux, une connexion spĂ©culative peut provoquer des requĂȘtes DNS avant onBeforeRequest. Cet ordre n'est pas quelque chose sur quoi un dĂ©veloppeur d'extension devrait se fier, car il peut varier d'un navigateur Ă l'autre, et encore moins d'une version de navigateur Ă l'autre, et encore moins d'un canal de requĂȘte Ă l'autre. RĂ©fĂ©rez-vous <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1466099">Ă la clarification du problĂšme de BugZilla fournie par les dĂ©veloppeurs Mozilla sur la commande de la rĂ©solution DNS</a></p> - -<h2 id="Exemples">Exemples</h2> - -<p>Ce code enregistre l'URL de chaque ressource demandĂ©e qui correspond au modĂšle <a href="/fr/Add-ons/WebExtensions/Match_patterns#<all_urls>"><all_urls></a> :</p> - -<pre class="brush: js">function logURL(requestDetails) { +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback, filter, extraInfoSpec)` + - : Ajoute un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'`Ă©couteur` est l'Ă©couteur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `l'Ă©couteur` est inscrit Ă cet Ă©vĂ©nement. Renvoie `true` s'il est Ă l'Ă©coute, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants : + + - `details` + - : [`object`](#details). DĂ©tails sur la demande. Voir les [`details`](#details) ci-dessous. + + Les retours : {{WebExtAPIRef('webRequest.BlockingResponse')}}. Si `"blocking"`est spĂ©cifiĂ© dans le paramĂštre `extraInfoSpec`, l'auditeur d'Ă©vĂ©nement doit retourner un objet `BlockingResponse`, et peut dĂ©finir soit son `annulation`, soit ses propriĂ©tĂ©s `redirectUrl`. A partir de Firefox 52, au lieu de renvoyer `BlockingResponse`,l'auditeur peut renvoyer une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est rĂ©solue avec un `BlockingResponse`. Ceci permet Ă l'auditeur de traiter la demande de maniĂšre asynchrone. + +- `filter` + - : {{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur. +- `extraInfoSpec`{{optional_inline}} + + - : `array` de `string`. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous pouvez passer n'importe laquelle des valeurs suivantes : + + - `"blocking"`: rendre la requĂȘte synchrone, de sorte que vous pouvez annuler ou rediriger la requĂȘte + - `"requestBody"`: include `requestBody` dans l'objet `details` transmis Ă l'auditeur + +## Objets supplĂ©mentaires + +### dĂ©tails + +- `documentUrl` + - : `string`. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https\://example.com" contient une image ou un iframe, alors le `documentUrl` pour l'image ou l'iframe sera "https\://example.com". Pour un document de niveau supĂ©rieur, `documentUrl` n'est pas dĂ©fini. +- `frameAncestors` + + - : `array`. Contient des informations pour chaque document dans la hiĂ©rarchie des cadres jusqu'au document de niveau supĂ©rieur. Le premier Ă©lĂ©ment du tableau contient des informations sur le parent immĂ©diat du document demandĂ©, et le dernier Ă©lĂ©ment contient des informations sur le document de niveau supĂ©rieur. Si la charge est rĂ©ellement pour le document de niveau supĂ©rieur, alors ce tableau est vide. + + - `url` + - : `string`. URL Ă partir de laquelle le document a Ă©tĂ© chargĂ©. + - `frameId` + - : `integer`. Le `frameId` du document. `details.frameAncestors[0].frameId` est le mĂȘme que `details.parentFrameId`. + +- `frameId` + - : `integer`. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (`type` is `main_frame` or `sub_frame`), `frameId` indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet. +- `method` + - : `string`. MĂ©thode HTTP standard : par exemple, "GET" ou "POST". +- `originUrl` + + - : `string`. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https\://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors `originUrl` de la requĂȘte rĂ©sultante est "https\://example.com". + + L'`originUrl` est souvent mais pas toujours la mĂȘme chose que `documentUrl`.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le `documentUrl` pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'`originUrl` sera l'URL du document dans l'iframe qui contenait le lien. + +- `parentFrameId` + - : `integer`. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent. +- `proxyInfo` + + - : `object`. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes : + + - `host` + - : `string`. Le nom d'hĂŽte du serveur proxy. + - `port` + - : `integer`. Le numĂ©ro de port du serveur proxy. + - `type` + + - : `string`. Le type de serveur proxy. L'un des : + + - "http": proxy HTTP (ou SSL CONNECT pour HTTPS) + - "https": proxy HTTP sur connexion TLS vers proxy + - "socks": SOCKS v5 proxy + - "socks4": SOCKS v4 proxy + - "direct": pas de proxy + - "unknown": proxy inconnu + + - `username` + - : `string`. Nom d'utilisateur pour le service proxy. + - `proxyDNS` + - : `boolean`. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS. + - `failoverTimeout` + - : `integer`. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode. + +- `requestBody`{{optional_inline}} + + - : `object`. Contient les donnĂ©es du corps de la requĂȘte HTTP. Seulement si `extraInfoSpec` contient `"requestBody"`. + + - `error`{{optional_inline}} + - : `string`. Ce paramĂštre est dĂ©fini si des erreurs ont Ă©tĂ© rencontrĂ©es lors de l'obtention des donnĂ©es du corps de la demande. + - `formData`{{optional_inline}} + + - : `object`. Cet objet est prĂ©sent si la mĂ©thode de requĂȘte est POST et que le corps est une sĂ©quence de paires clĂ©-valeur codĂ©es en UTF-8 sous la forme "multipart/form-data" ou "application/x-www-form-urlencoded". + + Il s'agit d'un dictionnaire dans lequel chaque clĂ© contient la liste de toutes les valeurs de cette clĂ©. Par exemple: `{'key': ['value1', 'value2']}`. Si les donnĂ©es sont d'un autre type de support, ou si elles sont malformĂ©es, l'objet n'est pas prĂ©sent. + + - `raw`{{optional_inline}} + - : `array` of `{{WebExtAPIRef('webRequest.UploadData')}}`. Si la mĂ©thode de requĂȘte est PUT ou POST, et que le corps n'est pas dĂ©jĂ analysĂ© dans `formData`, alors ce tableau contient les Ă©lĂ©ments de corps de requĂȘte non analysĂ©s. + +- `requestId` + - : `string`. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte. +- `tabId` + - : `integer`. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet. +- `timeStamp` + - : `number`. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `type` + - : {{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet". +- `url` + - : `string`. Cible de la demande. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.onBeforeRequest", 10)}} + +### Ordre de rĂ©solution DNS lorsque BlockingResponse est utilisĂ© + +En ce qui concerne la rĂ©solution DNS lorsque BlockingResponse est utilisĂ© avec OnBeforeRequest : Dans le canal HTTP, avec rĂ©ponse de blocage se produit avant la rĂ©solution DNS et avant la connexion spĂ©culative. Pour les autres canaux, une connexion spĂ©culative peut provoquer des requĂȘtes DNS avant onBeforeRequest. Cet ordre n'est pas quelque chose sur quoi un dĂ©veloppeur d'extension devrait se fier, car il peut varier d'un navigateur Ă l'autre, et encore moins d'une version de navigateur Ă l'autre, et encore moins d'un canal de requĂȘte Ă l'autre. RĂ©fĂ©rez-vous [Ă la clarification du problĂšme de BugZilla fournie par les dĂ©veloppeurs Mozilla sur la commande de la rĂ©solution DNS](https://bugzilla.mozilla.org/show_bug.cgi?id=1466099) + +## Exemples + +Ce code enregistre l'URL de chaque ressource demandĂ©e qui correspond au modĂšle [\<all_urls>](/fr/Add-ons/WebExtensions/Match_patterns#<all_urls>) : + +```js +function logURL(requestDetails) { console.log("Loading: " + requestDetails.url); } browser.webRequest.onBeforeRequest.addListener( logURL, - {urls: ["<all_urls>"]} -);</pre> + {urls: ["<all_urls>"]} +); +``` -<p>Ce code annule les demandes d'images qui sont faites aux URLs sous "https://mdn.mozillademos.org/" (pour voir l'effet, visitez n'importe quelle page de MDN qui contient des images, comme <a href="/fr/docs/Mozilla/Firefox/Developer_Edition">Firefox Developer Edition</a>):</p> +Ce code annule les demandes d'images qui sont faites aux URLs sous "https\://mdn.mozillademos.org/" (pour voir l'effet, visitez n'importe quelle page de MDN qui contient des images, comme [Firefox Developer Edition](/fr/docs/Mozilla/Firefox/Developer_Edition)): -<pre class="brush: js">// match pattern for the URLs to redirect +```js +// match pattern for the URLs to redirect var pattern = "https://mdn.mozillademos.org/*"; // cancel function returns an object @@ -200,11 +195,12 @@ browser.webRequest.onBeforeRequest.addListener( {urls: [pattern], types: ["image"]}, ["blocking"] ); -</pre> +``` -<p>Ce code remplace, par redirection, toutes les demandes de rĂ©seau pour des images qui sont faites Ă des URLs sous "https://mdn.mozillademos.org/" (pour voir l'effet, visitez n'importe quelle page de MDN qui contient des images, comme <a href="/fr/docs/Mozilla/Firefox/Developer_Edition">Firefox Developer Edition</a>) :</p> +Ce code remplace, par redirection, toutes les demandes de rĂ©seau pour des images qui sont faites Ă des URLs sous "https\://mdn.mozillademos.org/" (pour voir l'effet, visitez n'importe quelle page de MDN qui contient des images, comme [Firefox Developer Edition](/fr/docs/Mozilla/Firefox/Developer_Edition)) : -<pre class="brush: js">// match pattern for the URLs to redirect +```js +// match pattern for the URLs to redirect var pattern = "https://mdn.mozillademos.org/*"; // redirect function @@ -223,11 +219,13 @@ browser.webRequest.onBeforeRequest.addListener( redirect, {urls:[pattern], types:["image"]}, ["blocking"] -);</pre> +); +``` -<p>Ce code est exactement comme l'exemple prĂ©cĂ©dent, sauf que l'auditeur traite la requĂȘte de maniĂšre asynchrone. Il renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui dĂ©finit une minuterie et se rĂ©sout avec l'URL de redirection lorsque la minuterie expire :</p> +Ce code est exactement comme l'exemple prĂ©cĂ©dent, sauf que l'auditeur traite la requĂȘte de maniĂšre asynchrone. Il renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui dĂ©finit une minuterie et se rĂ©sout avec l'URL de redirection lorsque la minuterie expire : -<pre class="brush: js">// match pattern for the URLs to redirect +```js +// match pattern for the URLs to redirect var pattern = "https://mdn.mozillademos.org/*"; // URL we will redirect to @@ -237,8 +235,8 @@ var redirectUrl = "https://38.media.tumblr.com/tumblr_ldbj01lZiP1qe0eclo1_500.gi // which is resolved with the redirect URL when a timer expires function redirectAsync(requestDetails) { console.log("Redirecting async: " + requestDetails.url); - return new Promise((resolve, reject) => { - window.setTimeout(() => { + return new Promise((resolve, reject) => { + window.setTimeout(() => { resolve({redirectUrl}); }, 2000); }); @@ -250,19 +248,18 @@ browser.webRequest.onBeforeRequest.addListener( redirectAsync, {urls: [pattern], types: ["image"]}, ["blocking"] -);</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/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -289,5 +286,4 @@ browser.webRequest.onBeforeRequest.addListener( // 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/webrequest/onbeforesendheaders/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onbeforesendheaders/index.md index e5c2fc28b5..40b32f8165 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/onbeforesendheaders/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onbeforesendheaders/index.md @@ -13,153 +13,144 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/onBeforeSendHeaders --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Cet Ă©vĂ©nement est dĂ©clenchĂ© avant l'envoi de donnĂ©es HTTP, mais aprĂšs que tous les en-tĂȘtes HTTP soient disponibles. C'est un bon endroit pour Ă©couter si vous voulez modifier les en-tĂȘtes de requĂȘte HTTP.</p> +Cet Ă©vĂ©nement est dĂ©clenchĂ© avant l'envoi de donnĂ©es HTTP, mais aprĂšs que tous les en-tĂȘtes HTTP soient disponibles. C'est un bon endroit pour Ă©couter si vous voulez modifier les en-tĂȘtes de requĂȘte HTTP. -<p>Pour que les en-tĂȘtes de requĂȘte soient passĂ©s dans l'Ă©couteur avec le reste des donnĂ©es de requĂȘte, passez <code>"requestHeaders"</code> dans un tableau <code>extraInfoSpec</code>.</p> +Pour que les en-tĂȘtes de requĂȘte soient passĂ©s dans l'Ă©couteur avec le reste des donnĂ©es de requĂȘte, passez `"requestHeaders"` dans un tableau `extraInfoSpec`. -<p>Pour modifier les en-tĂȘtes de façon synchrone : passez <code>"blocking"</code> dans <code>extraInfoSpec</code>, puis dans votre Ă©vĂ©nement Ă©coutĂ©, retournez un <a href="/fr/Add-ons/WebExtensions/API/webRequest/BlockingResponse" title='An object of this type is returned by event listeners that have set "blocking" in their extraInfoSpec argument.'><code>BlockingResponse</code></a> avec une propriĂ©tĂ© nommĂ©e <code>requestHeaders</code>, dont la valeur est l'ensemble des en-tĂȘtes de requĂȘte Ă envoyer.</p> +Pour modifier les en-tĂȘtes de façon synchrone : passez `"blocking"` dans `extraInfoSpec`, puis dans votre Ă©vĂ©nement Ă©coutĂ©, retournez un [`BlockingResponse`](/fr/Add-ons/WebExtensions/API/webRequest/BlockingResponse 'An object of this type is returned by event listeners that have set "blocking" in their extraInfoSpec argument.') avec une propriĂ©tĂ© nommĂ©e `requestHeaders`, dont la valeur est l'ensemble des en-tĂȘtes de requĂȘte Ă envoyer. -<p>Pour modifier les en-tĂȘtes de façon asynchrone : passez <code>"blocking"</code> dans <code>extraInfoSpec</code>, puis dans votre event listener, retournez une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui est rĂ©solue avec une <code>BlockingResponse</code>.</p> +Pour modifier les en-tĂȘtes de façon asynchrone : passez `"blocking"` dans `extraInfoSpec`, puis dans votre event listener, retournez une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est rĂ©solue avec une `BlockingResponse`. -<p>Si vous utilisez le <code>"blocking"</code>, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">"permission de l'API "webRequestBlocking"</a> dans votre manifest.json.</p> +Si vous utilisez le `"blocking"`, vous devez avoir la ["permission de l'API "webRequestBlocking"](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) dans votre manifest.json. -<p>Il est possible d'Ă©tendre le conflit ici. Si deux extensions Ă©coutent <code>onBeforeSendHeaders</code> pour la mĂȘme requĂȘte, le deuxiĂšme auditeur verra les modifications apportĂ©es par le premier auditeur et pourra annuler les modifications apportĂ©es par le premier auditeur. Par exemple, si le premier auditeur ajoute un en-tĂȘte <code>Cookie</code>, et que le deuxiĂšme auditeur supprime tous les en-tĂȘtes <code>Cookie</code>, les modifications apportĂ©es par le premier auditeur seront perdues. Si vous voulez voir les en-tĂȘtes qui sont effectivement envoyĂ©s, sans risque qu'une autre extension les modifie par la suite, utilisez {{WebExtAPIRef("webRequest.onSendHeaders", "onSendHeaders")}}, bien que vous ne puissiez pas modifier les en-tĂȘtes sur cet Ă©vĂ©nement.</p> +Il est possible d'Ă©tendre le conflit ici. Si deux extensions Ă©coutent `onBeforeSendHeaders` pour la mĂȘme requĂȘte, le deuxiĂšme auditeur verra les modifications apportĂ©es par le premier auditeur et pourra annuler les modifications apportĂ©es par le premier auditeur. Par exemple, si le premier auditeur ajoute un en-tĂȘte `Cookie`, et que le deuxiĂšme auditeur supprime tous les en-tĂȘtes `Cookie`, les modifications apportĂ©es par le premier auditeur seront perdues. Si vous voulez voir les en-tĂȘtes qui sont effectivement envoyĂ©s, sans risque qu'une autre extension les modifie par la suite, utilisez {{WebExtAPIRef("webRequest.onSendHeaders", "onSendHeaders")}}, bien que vous ne puissiez pas modifier les en-tĂȘtes sur cet Ă©vĂ©nement. -<p>Tous les en-tĂȘtes rĂ©ellement envoyĂ©s ne sont pas toujours inclus dans <code>requestHeaders</code>. En particulier, les en-tĂȘtes liĂ©s Ă la mise en cache (par exemple, <code>Cache-Control</code>, <code>If-Modified-Since</code>, <code>If-None-Match</code>) ne sont jamais envoyĂ©s. De plus, le comportement peut diffĂ©rer d'un navigateur Ă l'autre.</p> +Tous les en-tĂȘtes rĂ©ellement envoyĂ©s ne sont pas toujours inclus dans `requestHeaders`. En particulier, les en-tĂȘtes liĂ©s Ă la mise en cache (par exemple, `Cache-Control`, `If-Modified-Since`, `If-None-Match`) ne sont jamais envoyĂ©s. De plus, le comportement peut diffĂ©rer d'un navigateur Ă l'autre. -<p>Selon la spĂ©cification, les noms d'en-tĂȘte sont insensibles Ă la casse. Cela signifie que pour ĂȘtre sĂ»r de faire correspondre un en-tĂȘte particulier, l'auditeur devrait minuscules le nom avant de le comparer :</p> +Selon la spĂ©cification, les noms d'en-tĂȘte sont insensibles Ă la casse. Cela signifie que pour ĂȘtre sĂ»r de faire correspondre un en-tĂȘte particulier, l'auditeur devrait minuscules le nom avant de le comparer : -<pre class="brush: js">for (let header of e.requestHeaders) { +```js +for (let header of e.requestHeaders) { if (header.name.toLowerCase() === desiredHeader) { // process header } -}</pre> +} +``` -<p>Le navigateur conserve la casse originale du nom de l'en-tĂȘte tel qu'il a Ă©tĂ© gĂ©nĂ©rĂ© par le navigateur. Si l'auditeur de l'extension change la casse, ce changement ne sera pas conservĂ©.</p> +Le navigateur conserve la casse originale du nom de l'en-tĂȘte tel qu'il a Ă©tĂ© gĂ©nĂ©rĂ© par le navigateur. Si l'auditeur de l'extension change la casse, ce changement ne sera pas conservĂ©. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webRequest.onBeforeSendHeaders.addListener( +```js +browser.webRequest.onBeforeSendHeaders.addListener( listener, // function filter, // object extraInfoSpec // optional array of strings ) browser.webRequest.onBeforeSendHeaders.removeListener(listener) browser.webRequest.onBeforeSendHeaders.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback, filter, extraInfoSpec)</code></dt> - <dd>Ajouter un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants :</p> - - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails de la demande. Ceci inclura les en-tĂȘtes de demande si vous avez inclus <code>"requestHeaders"</code> dans <code>extraInfoSpec</code>.</dd> - </dl> - - <p>Retourne : {{WebExtAPIRef('webRequest.BlockingResponse')}}. si <code>"blocking"</code> est spĂ©cifiĂ© dans le paramĂštre <code>extraInfoSpec</code>, l'auditeur d'Ă©vĂ©nement doit retourner un objet <code>BlockingResponse</code>, et peut dĂ©finir sa propriĂ©tĂ© <code>requestHeaders</code>.</p> - </dd> - <dt><code>filter</code></dt> - <dd>{{WebExtAPIRef('webRequest.RequestFilter')}}. Un ensemble de filtres qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur.</dd> - <dt><code>extraInfoSpec</code>{{optional_inline}}</dt> - <dd><p><code>array</code> de <code>string</code>. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous pouvez passer n'importe laquelle des valeurs suivantes :</p> - <ul> - <li><code>"blocking"</code>: rendre la requĂȘte synchrone, ce qui vous permet de modifier les en-tĂȘtes de requĂȘte</li> - <li><code>"requestHeaders"</code>: inclure les en-tĂȘtes de requĂȘte dans l'objet <code>details</code> transmis Ă l'auditeur</li> - </ul> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>documentUrl</code></dt> - <dd><code>string</code>. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https://example.com" contient une image ou un iframe, alors le <code>documentUrl</code> pour l'image ou l'iframe sera "https://example.com". Pour un document de niveau supĂ©rieur, <code>documentUrl</code> n'est pas dĂ©fini.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (<code>type</code> is <code>main_frame</code> or <code>sub_frame</code>), <code>frameId</code> indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet.</dd> - <dt><code>method</code></dt> - <dd><code>string</code>. MĂ©thode HTTP standard : par exemple, "GET" ou "POST".</dd> - <dt><code>originUrl</code></dt> - <dd> - <p><code>string</code>. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors <code>originUrl</code> de la requĂȘte rĂ©sultante est "https://example.com".</p> - - <p>L'<code>originUrl</code> est souvent mais pas toujours la mĂȘme chose que <code>documentUrl</code>.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le <code>documentUrl</code> pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'<code>originUrl</code> sera l'URL du document dans l'iframe qui contenait le lien.</p> - </dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent.</dd> - <dt><code>proxyInfo</code></dt> - <dd> - <p><code>object</code>. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>host</code></dt> - <dd><code>string</code>. Le nom d'hĂŽte du serveur proxy.</dd> - <dt><code>port</code></dt> - <dd><code>integer</code>. Le numĂ©ro de port du serveur proxy.</dd> - <dt><code>type</code></dt> - <dd> - <p><code>string</code>. Le type de serveur proxy. L'un des :</p> - - <ul> - <li>"http": proxy HTTP (ou SSL CONNECT pour HTTPS)</li> - <li>"https": proxy HTTP sur connexion TLS vers proxy</li> - <li>"socks": SOCKS v5 proxy</li> - <li>"socks4": SOCKS v4 proxy</li> - <li>"direct": pas de proxy</li> - <li>"unknown": proxy inconnu</li> - </ul> - </dd> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur pour le service proxy.</dd> - <dt><code>proxyDNS</code></dt> - <dd><code>boolean</code>. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS.</dd> - <dt><code>failoverTimeout</code></dt> - <dd><code>integer</code>. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode.</dd> - </dl> - </dd> - <dt><code>requestHeaders</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse.</dd> - <dt><code>requestId</code></dt> - <dd><code>string</code>. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte.</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet".</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. Cible de la demande.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.onBeforeSendHeaders", 10)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Ce code modifie l'en-tĂȘte "User-Agent" pour que le navigateur s'identifie comme Ă©tant Opera 12.16, mais uniquement lors de la visite des pages sous "https://httpbin.org/".</p> - -<pre class="brush: js">"use strict"; +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback, filter, extraInfoSpec)` + - : Ajouter un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne `true` s'il est Ă©coutĂ©, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants : + + - `details` + - : [`object`](#details). DĂ©tails de la demande. Ceci inclura les en-tĂȘtes de demande si vous avez inclus `"requestHeaders"` dans `extraInfoSpec`. + + Retourne : {{WebExtAPIRef('webRequest.BlockingResponse')}}. si `"blocking"` est spĂ©cifiĂ© dans le paramĂštre `extraInfoSpec`, l'auditeur d'Ă©vĂ©nement doit retourner un objet `BlockingResponse`, et peut dĂ©finir sa propriĂ©tĂ© `requestHeaders`. + +- `filter` + - : {{WebExtAPIRef('webRequest.RequestFilter')}}. Un ensemble de filtres qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur. +- `extraInfoSpec`{{optional_inline}} + + - : `array` de `string`. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous pouvez passer n'importe laquelle des valeurs suivantes : + + - `"blocking"`: rendre la requĂȘte synchrone, ce qui vous permet de modifier les en-tĂȘtes de requĂȘte + - `"requestHeaders"`: inclure les en-tĂȘtes de requĂȘte dans l'objet `details` transmis Ă l'auditeur + +## Objets supplĂ©mentaires + +### dĂ©tails + +- `documentUrl` + - : `string`. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https\://example.com" contient une image ou un iframe, alors le `documentUrl` pour l'image ou l'iframe sera "https\://example.com". Pour un document de niveau supĂ©rieur, `documentUrl` n'est pas dĂ©fini. +- `frameId` + - : `integer`. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (`type` is `main_frame` or `sub_frame`), `frameId` indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet. +- `method` + - : `string`. MĂ©thode HTTP standard : par exemple, "GET" ou "POST". +- `originUrl` + + - : `string`. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https\://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors `originUrl` de la requĂȘte rĂ©sultante est "https\://example.com". + + L'`originUrl` est souvent mais pas toujours la mĂȘme chose que `documentUrl`.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le `documentUrl` pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'`originUrl` sera l'URL du document dans l'iframe qui contenait le lien. + +- `parentFrameId` + - : `integer`. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent. +- `proxyInfo` + + - : `object`. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes : + + - `host` + - : `string`. Le nom d'hĂŽte du serveur proxy. + - `port` + - : `integer`. Le numĂ©ro de port du serveur proxy. + - `type` + + - : `string`. Le type de serveur proxy. L'un des : + + - "http": proxy HTTP (ou SSL CONNECT pour HTTPS) + - "https": proxy HTTP sur connexion TLS vers proxy + - "socks": SOCKS v5 proxy + - "socks4": SOCKS v4 proxy + - "direct": pas de proxy + - "unknown": proxy inconnu + + - `username` + - : `string`. Nom d'utilisateur pour le service proxy. + - `proxyDNS` + - : `boolean`. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS. + - `failoverTimeout` + - : `integer`. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode. + +- `requestHeaders`{{optional_inline}} + - : {{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse. +- `requestId` + - : `string`. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte. +- `tabId` + - : `integer`. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet. +- `timeStamp` + - : `number`. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `type` + - : {{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet". +- `url` + - : `string`. Cible de la demande. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.onBeforeSendHeaders", 10)}} + +## Exemples + +Ce code modifie l'en-tĂȘte "User-Agent" pour que le navigateur s'identifie comme Ă©tant Opera 12.16, mais uniquement lors de la visite des pages sous "https\://httpbin.org/". + +```js +"use strict"; /* This is the page for which we want to rewrite the User-Agent header. @@ -194,11 +185,12 @@ browser.webRequest.onBeforeSendHeaders.addListener( {urls: [targetPage]}, ["blocking", "requestHeaders"] ); -</pre> +``` -<p>Ce code est exactement comme l'exemple prĂ©cĂ©dent, sauf que l'auditeur est asynchrone, retournant une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui est rĂ©solue avec les nouveaux en-tĂȘtes :</p> +Ce code est exactement comme l'exemple prĂ©cĂ©dent, sauf que l'auditeur est asynchrone, retournant une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est rĂ©solue avec les nouveaux en-tĂȘtes : -<pre class="brush: js">"use strict"; +```js +"use strict"; /* This is the page for which we want to rewrite the User-Agent header. @@ -214,8 +206,8 @@ var ua = "Opera/9.80 (X11; Linux i686; Ubuntu/14.10) Presto/2.12.388 Version/12. Rewrite the User-Agent header to "ua". */ function rewriteUserAgentHeaderAsync(e) { - var asyncRewrite = new Promise((resolve, reject) => { - window.setTimeout(() => { + var asyncRewrite = new Promise((resolve, reject) => { + window.setTimeout(() => { for (var header of e.requestHeaders) { if (header.name.toLowerCase() === "user-agent") { header.value = ua; @@ -239,20 +231,17 @@ browser.webRequest.onBeforeSendHeaders.addListener( {urls: [targetPage]}, ["blocking", "requestHeaders"] ); +``` -</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/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -279,5 +268,4 @@ browser.webRequest.onBeforeSendHeaders.addListener( // 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/webrequest/oncompleted/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/oncompleted/index.md index e83f60fed7..741667185e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/oncompleted/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/oncompleted/index.md @@ -13,136 +13,125 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/onCompleted --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>UtilisĂ© lorsqu'une demande est complĂ©tĂ©e.</p> +UtilisĂ© lorsqu'une demande est complĂ©tĂ©e. -<p>Cet Ă©vĂ©nement est Ă titre d'information seulement.</p> +Cet Ă©vĂ©nement est Ă titre d'information seulement. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webRequest.onCompleted.addListener( +```js +browser.webRequest.onCompleted.addListener( listener, // function filter, // object extraInfoSpec // optional array of strings ) browser.webRequest.onCompleted.removeListener(listener) browser.webRequest.onCompleted.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback, filter, extraInfoSpec)</code></dt> - <dd>Ajouter un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants :</p> - - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. Details sur la demande. voir les <code><a href="#details">dĂ©tails</a></code> ci-dessous.</dd> - </dl> - </dd> - <dt><code>filter</code></dt> - <dd>{{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur.</dd> - <dt><code>extraInfoSpec</code>{{optional_inline}}</dt> - <dd><p><code>array</code> of <code>string</code>. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous ne pouvez passer qu'une seule valeur :</p> - <ul> - <li><code>"</code><code>responseHeaders</code><code>"</code>: inclure <code>responseHeaders</code> dans l'objet <code>details</code> transmis Ă l'auditeur</li> - </ul> - </dd> -</dl> - -<h2 id="objets_supplĂ©mentaires">objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>documentUrl</code></dt> - <dd><code>string</code>. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https://example.com" contient une image ou un iframe, alors le <code>documentUrl</code> pour l'image ou l'iframe sera "https://example.com". Pour un document de niveau supĂ©rieur, <code>documentUrl</code> n'est pas dĂ©fini.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (<code>type</code> is <code>main_frame</code> or <code>sub_frame</code>), <code>frameId</code> indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet.</dd> - <dt><code>fromCache</code></dt> - <dd><code>boolean</code>. Indique si cette rĂ©ponse a Ă©tĂ© rĂ©cupĂ©rĂ©e dans le cache du disque.</dd> - <dt><code>ip</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse IP du serveur Ă laquelle la requĂȘte a Ă©tĂ© envoyĂ©e. Notez qu'il peut s'agir d'une adresse IPv6 littĂ©rale.</dd> - <dt><code>method</code></dt> - <dd><code>string</code>. MĂ©thode HTTP standard : par exemple, "GET" ou "POST".</dd> - <dt><code>originUrl</code></dt> - <dd> - <p><code>string</code>. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors <code>originUrl</code> de la requĂȘte rĂ©sultante est "https://example.com".</p> - - <p>L'<code>originUrl</code> est souvent mais pas toujours la mĂȘme chose que <code>documentUrl</code>.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le <code>documentUrl</code> pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'<code>originUrl</code> sera l'URL du document dans l'iframe qui contenait le lien.</p> - </dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent.</dd> - <dt><code>proxyInfo</code></dt> - <dd> - <p><code>object</code>. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>host</code></dt> - <dd><code>string</code>. Le nom d'hĂŽte du serveur proxy.</dd> - <dt><code>port</code></dt> - <dd><code>integer</code>. Le numĂ©ro de port du serveur proxy.</dd> - <dt><code>type</code></dt> - <dd> - <p><code>string</code>. Le type de serveur proxy. L'un des :</p> - - <ul> - <li>"http": proxy HTTP (ou SSL CONNECT pour HTTPS)</li> - <li>"https": proxy HTTP sur connexion TLS vers proxy</li> - <li>"socks": SOCKS v5 proxy</li> - <li>"socks4": SOCKS v4 proxy</li> - <li>"direct": pas de proxy</li> - <li>"unknown": proxy inconnu</li> - </ul> - </dd> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur pour le service proxy.</dd> - <dt><code>proxyDNS</code></dt> - <dd><code>boolean</code>. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS.</dd> - <dt><code>failoverTimeout</code></dt> - <dd><code>integer</code>. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode.</dd> - </dl> - </dd> - <dt><code>requestId</code></dt> - <dd><code>string</code>. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte.</dd> - <dt><code>responseHeaders</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse.</dd> - <dt><code>statusCode</code></dt> - <dd><code>integer</code>. Code d'Ă©tat HTTP standard renvoyĂ© par le serveur.</dd> - <dt><code>statusLine</code></dt> - <dd><code>string</code>. Status d'Ă©tat HTTP de la rĂ©ponse ou la chaĂźne 'HTTP/0.9 200 OK' pour les rĂ©ponses HTTP/0.9 (c'est-Ă -dire les rĂ©ponses qui n'ont pas de ligne d'Ă©tat) ou une chaĂźne vide s'il n'y a pas d'en-tĂȘtes</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet".</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. Cible de la demande.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.onCompleted", 10)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">var target = "https://developer.mozilla.org/*"; +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback, filter, extraInfoSpec)` + - : Ajouter un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne `true` s'il est Ă©coutĂ©, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants : + + - `details` + - : [`object`](#details). Details sur la demande. voir les [`dĂ©tails`](#details) ci-dessous. + +- `filter` + - : {{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur. +- `extraInfoSpec`{{optional_inline}} + + - : `array` of `string`. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous ne pouvez passer qu'une seule valeur : + + - ` "``responseHeaders``" `: inclure `responseHeaders` dans l'objet `details` transmis Ă l'auditeur + +## objets supplĂ©mentaires + +### dĂ©tails + +- `documentUrl` + - : `string`. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https\://example.com" contient une image ou un iframe, alors le `documentUrl` pour l'image ou l'iframe sera "https\://example.com". Pour un document de niveau supĂ©rieur, `documentUrl` n'est pas dĂ©fini. +- `frameId` + - : `integer`. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (`type` is `main_frame` or `sub_frame`), `frameId` indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet. +- `fromCache` + - : `boolean`. Indique si cette rĂ©ponse a Ă©tĂ© rĂ©cupĂ©rĂ©e dans le cache du disque. +- `ip`{{optional_inline}} + - : `string`. L'adresse IP du serveur Ă laquelle la requĂȘte a Ă©tĂ© envoyĂ©e. Notez qu'il peut s'agir d'une adresse IPv6 littĂ©rale. +- `method` + - : `string`. MĂ©thode HTTP standard : par exemple, "GET" ou "POST". +- `originUrl` + + - : `string`. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https\://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors `originUrl` de la requĂȘte rĂ©sultante est "https\://example.com". + + L'`originUrl` est souvent mais pas toujours la mĂȘme chose que `documentUrl`.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le `documentUrl` pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'`originUrl` sera l'URL du document dans l'iframe qui contenait le lien. + +- `parentFrameId` + - : `integer`. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent. +- `proxyInfo` + + - : `object`. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes : + + - `host` + - : `string`. Le nom d'hĂŽte du serveur proxy. + - `port` + - : `integer`. Le numĂ©ro de port du serveur proxy. + - `type` + + - : `string`. Le type de serveur proxy. L'un des : + + - "http": proxy HTTP (ou SSL CONNECT pour HTTPS) + - "https": proxy HTTP sur connexion TLS vers proxy + - "socks": SOCKS v5 proxy + - "socks4": SOCKS v4 proxy + - "direct": pas de proxy + - "unknown": proxy inconnu + + - `username` + - : `string`. Nom d'utilisateur pour le service proxy. + - `proxyDNS` + - : `boolean`. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS. + - `failoverTimeout` + - : `integer`. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode. + +- `requestId` + - : `string`. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte. +- `responseHeaders`{{optional_inline}} + - : {{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse. +- `statusCode` + - : `integer`. Code d'Ă©tat HTTP standard renvoyĂ© par le serveur. +- `statusLine` + - : `string`. Status d'Ă©tat HTTP de la rĂ©ponse ou la chaĂźne 'HTTP/0.9 200 OK' pour les rĂ©ponses HTTP/0.9 (c'est-Ă -dire les rĂ©ponses qui n'ont pas de ligne d'Ă©tat) ou une chaĂźne vide s'il n'y a pas d'en-tĂȘtes +- `tabId` + - : `integer`. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet. +- `timeStamp` + - : `number`. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `type` + - : {{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet". +- `url` + - : `string`. Cible de la demande. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.onCompleted", 10)}} + +## Exemples + +```js +var target = "https://developer.mozilla.org/*"; /* e.g. @@ -163,19 +152,17 @@ browser.webRequest.onCompleted.addListener( logResponse, {urls: [target]} ); -</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/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -202,5 +189,4 @@ browser.webRequest.onCompleted.addListener( // 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/webrequest/onerroroccurred/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onerroroccurred/index.md index 07a82c4a5e..c0fe196659 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/onerroroccurred/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onerroroccurred/index.md @@ -13,129 +13,119 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/onErrorOccurred --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>UtilisĂ© lorsqu'une demande n'a pas pu ĂȘtre traitĂ©e en raison d'une erreur : par exemple, un manque de connectivitĂ© Internet.</p> +UtilisĂ© lorsqu'une demande n'a pas pu ĂȘtre traitĂ©e en raison d'une erreur : par exemple, un manque de connectivitĂ© Internet. -<p>L'erreur est transmise Ă l'auditeur en tant que propriĂ©tĂ© d'<code>erreur</code> de l'objet <code><a href="#details">details</a></code>.</p> +L'erreur est transmise Ă l'auditeur en tant que propriĂ©tĂ© d'`erreur` de l'objet [`details`](#details). -<p>Notez que cet Ă©vĂ©nement n'est pas dĂ©clenchĂ© pour les erreurs HTTP (rĂ©ponses 4XX ou 5XX) : celles-ci passent par les Ă©tapes normales d'une requĂȘte, en appelant n'importe quel auditeur d'Ă©vĂ©nement et en dĂ©finissant <code>details.statusCode</code> pour signaler l'erreur.</p> +Notez que cet Ă©vĂ©nement n'est pas dĂ©clenchĂ© pour les erreurs HTTP (rĂ©ponses 4XX ou 5XX) : celles-ci passent par les Ă©tapes normales d'une requĂȘte, en appelant n'importe quel auditeur d'Ă©vĂ©nement et en dĂ©finissant `details.statusCode` pour signaler l'erreur. -<p>Cet Ă©vĂ©nement est Ă titre d'information seulement.</p> +Cet Ă©vĂ©nement est Ă titre d'information seulement. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webRequest.onErrorOccurred.addListener( +```js +browser.webRequest.onErrorOccurred.addListener( listener, // function filter // object ) browser.webRequest.onErrorOccurred.removeListener(listener) browser.webRequest.onErrorOccurred.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback, filter, extraInfoSpec)</code></dt> - <dd>Ajouter un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants :</p> - - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur la demande. Voir les <code><a href="#details">details</a></code> ci-dessous.</dd> - </dl> - </dd> - <dt><code>filter</code></dt> - <dd>{{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur.</dd> -</dl> - -<h2 id="objets_supplĂ©mentaires">objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>documentUrl</code></dt> - <dd><code>string</code>. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https://example.com" contient une image ou un iframe, alors le <code>documentUrl</code> pour l'image ou l'iframe sera "https://example.com". Pour un document de niveau supĂ©rieur, <code>documentUrl</code> n'est pas dĂ©fini.</dd> - <dt><code>error</code></dt> - <dd><code>string</code>. La description de l'erreur. Cette chaĂźne est une chaĂźne d'erreur interne, peut varier d'un navigateur Ă l'autre et n'est pas garantie de rester la mĂȘme entre les versions.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (<code>type</code> is <code>main_frame</code> or <code>sub_frame</code>), <code>frameId</code> indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet.</dd> - <dt><code>fromCache</code></dt> - <dd><code>boolean</code>. Indique si cette rĂ©ponse a Ă©tĂ© rĂ©cupĂ©rĂ©e dans le cache du disque.</dd> - <dt><code>ip</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse IP du serveur Ă laquelle la requĂȘte a Ă©tĂ© envoyĂ©e. Notez qu'il peut s'agir d'une adresse IPv6 littĂ©rale.</dd> - <dt><code>method</code></dt> - <dd><code>string</code>. MĂ©thode HTTP standard : par exemple, "GET" ou "POST".</dd> - <dt><code>originUrl</code></dt> - <dd> - <p><code>string</code>. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors <code>originUrl</code> de la requĂȘte rĂ©sultante est "https://example.com".</p> - - <p>L'<code>originUrl</code> est souvent mais pas toujours la mĂȘme chose que <code>documentUrl</code>.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le <code>documentUrl</code> pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'<code>originUrl</code> sera l'URL du document dans l'iframe qui contenait le lien.</p> - </dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent.</dd> - <dt><code>proxyInfo</code></dt> - <dd> - <p><code>object</code>. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>host</code></dt> - <dd><code>string</code>. Le nom d'hĂŽte du serveur proxy.</dd> - <dt><code>port</code></dt> - <dd><code>integer</code>. Le numĂ©ro de port du serveur proxy.</dd> - <dt><code>type</code></dt> - <dd> - <p><code>string</code>. Le type de serveur proxy. L'un des :</p> - - <ul> - <li>"http": proxy HTTP (ou SSL CONNECT pour HTTPS)</li> - <li>"https": proxy HTTP sur connexion TLS vers proxy</li> - <li>"socks": SOCKS v5 proxy</li> - <li>"socks4": SOCKS v4 proxy</li> - <li>"direct": pas de proxy</li> - <li>"unknown": proxy inconnu</li> - </ul> - </dd> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur pour le service proxy.</dd> - <dt><code>proxyDNS</code></dt> - <dd><code>boolean</code>. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS.</dd> - <dt><code>failoverTimeout</code></dt> - <dd><code>integer</code>. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode.</dd> - </dl> - </dd> - <dt><code>requestId</code></dt> - <dd><code>string</code>. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte.</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet".</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. Cible de la demande.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.onErrorOccurred", 10)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">var target = "<all_urls>"; +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback, filter, extraInfoSpec)` + - : Ajouter un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne `true` s'il est Ă©coutĂ©, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants : + + - `details` + - : [`object`](#details). DĂ©tails sur la demande. Voir les [`details`](#details) ci-dessous. + +- `filter` + - : {{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur. + +## objets supplĂ©mentaires + +### dĂ©tails + +- `documentUrl` + - : `string`. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https\://example.com" contient une image ou un iframe, alors le `documentUrl` pour l'image ou l'iframe sera "https\://example.com". Pour un document de niveau supĂ©rieur, `documentUrl` n'est pas dĂ©fini. +- `error` + - : `string`. La description de l'erreur. Cette chaĂźne est une chaĂźne d'erreur interne, peut varier d'un navigateur Ă l'autre et n'est pas garantie de rester la mĂȘme entre les versions. +- `frameId` + - : `integer`. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (`type` is `main_frame` or `sub_frame`), `frameId` indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet. +- `fromCache` + - : `boolean`. Indique si cette rĂ©ponse a Ă©tĂ© rĂ©cupĂ©rĂ©e dans le cache du disque. +- `ip`{{optional_inline}} + - : `string`. L'adresse IP du serveur Ă laquelle la requĂȘte a Ă©tĂ© envoyĂ©e. Notez qu'il peut s'agir d'une adresse IPv6 littĂ©rale. +- `method` + - : `string`. MĂ©thode HTTP standard : par exemple, "GET" ou "POST". +- `originUrl` + + - : `string`. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https\://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors `originUrl` de la requĂȘte rĂ©sultante est "https\://example.com". + + L'`originUrl` est souvent mais pas toujours la mĂȘme chose que `documentUrl`.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le `documentUrl` pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'`originUrl` sera l'URL du document dans l'iframe qui contenait le lien. + +- `parentFrameId` + - : `integer`. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent. +- `proxyInfo` + + - : `object`. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes : + + - `host` + - : `string`. Le nom d'hĂŽte du serveur proxy. + - `port` + - : `integer`. Le numĂ©ro de port du serveur proxy. + - `type` + + - : `string`. Le type de serveur proxy. L'un des : + + - "http": proxy HTTP (ou SSL CONNECT pour HTTPS) + - "https": proxy HTTP sur connexion TLS vers proxy + - "socks": SOCKS v5 proxy + - "socks4": SOCKS v4 proxy + - "direct": pas de proxy + - "unknown": proxy inconnu + + - `username` + - : `string`. Nom d'utilisateur pour le service proxy. + - `proxyDNS` + - : `boolean`. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS. + - `failoverTimeout` + - : `integer`. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode. + +- `requestId` + - : `string`. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte. +- `tabId` + - : `integer`. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet. +- `timeStamp` + - : `number`. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `type` + - : {{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet". +- `url` + - : `string`. Cible de la demande. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.onErrorOccurred", 10)}} + +## Exemples + +```js +var target = "<all_urls>"; /* e.g., with no network: @@ -151,19 +141,18 @@ function logError(responseDetails) { browser.webRequest.onErrorOccurred.addListener( logError, {urls: [target]} -);</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/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -190,5 +179,4 @@ browser.webRequest.onErrorOccurred.addListener( // 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/webrequest/onheadersreceived/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onheadersreceived/index.md index 9a67cebc8f..0088f750c2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/onheadersreceived/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onheadersreceived/index.md @@ -13,146 +13,136 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/onHeadersReceived --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque les en-tĂȘtes de rĂ©ponse HTTP associĂ©s Ă une requĂȘte ont Ă©tĂ© reçus. Vous pouvez utiliser cet Ă©vĂ©nement pour modifier les en-tĂȘtes de rĂ©ponse HTTP.</p> +LancĂ© lorsque les en-tĂȘtes de rĂ©ponse HTTP associĂ©s Ă une requĂȘte ont Ă©tĂ© reçus. Vous pouvez utiliser cet Ă©vĂ©nement pour modifier les en-tĂȘtes de rĂ©ponse HTTP. -<p>Pour que les en-tĂȘtes de rĂ©ponse soient passĂ©s dans l'Ă©couteur avec le reste des donnĂ©es de la requĂȘte, passez <code>"responseHeaders"</code> dans le tableau <code>extraInfoSpec</code>.</p> +Pour que les en-tĂȘtes de rĂ©ponse soient passĂ©s dans l'Ă©couteur avec le reste des donnĂ©es de la requĂȘte, passez `"responseHeaders"` dans le tableau `extraInfoSpec`. -<p>Pour modifier les en-tĂȘtes, passez <code>"blocking"</code> dans <code>extraInfoSpec</code>. Ensuite, dans votre Ă©couteur d'Ă©vĂ©nements, retournez un objet avec une propriĂ©tĂ© nommĂ©e <code>responseHeaders</code>, dont la valeur est l'ensemble des en-tĂȘtes de rĂ©ponse Ă utiliser. Le navigateur se comportera comme si le serveur avait envoyĂ© les en-tĂȘtes modifiĂ©es.</p> +Pour modifier les en-tĂȘtes, passez `"blocking"` dans `extraInfoSpec`. Ensuite, dans votre Ă©couteur d'Ă©vĂ©nements, retournez un objet avec une propriĂ©tĂ© nommĂ©e `responseHeaders`, dont la valeur est l'ensemble des en-tĂȘtes de rĂ©ponse Ă utiliser. Le navigateur se comportera comme si le serveur avait envoyĂ© les en-tĂȘtes modifiĂ©es. -<p>A partir de Firefox 52, au lieu de renvoyer <code>BlockingResponse</code>, l'auditeur peut renvoyer une Promesse qui est rĂ©solue avec un <code>BlockingResponse</code>. Ceci permet Ă l'auditeur de traiter la demande de maniĂšre asynchrone.</p> +A partir de Firefox 52, au lieu de renvoyer `BlockingResponse`, l'auditeur peut renvoyer une Promesse qui est rĂ©solue avec un `BlockingResponse`. Ceci permet Ă l'auditeur de traiter la demande de maniĂšre asynchrone. -<p>Si vous utilisez le <code>"blocking"</code>, vous devez avoir la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permission de l'API "webRequestBlocking" </a>dans votre manifest.json.</p> +Si vous utilisez le `"blocking"`, vous devez avoir la [permission de l'API "webRequestBlocking" ](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions)dans votre manifest.json. -<p>Notez qu'il est possible que des extensions entrent en conflit ici. Si deux extensions Ă©coutent <code>onHeadersReceived</code> pour la mĂȘme requĂȘte et retournent <code>responseHeaders</code> essayant de dĂ©finir le mĂȘme en-tĂȘte (par exemple, <code>Content-Security-Policy</code>), seule une des modifications sera rĂ©ussie. Si vous voulez voir les en-tĂȘtes qui sont effectivement traitĂ©s par le systĂšme, sans risque qu'une autre extension les modifie par la suite, utilisez {{WebExtAPIRef("webRequest.onResponseStarted", "onResponseStarted", "onResponseStarted")}}, mais vous ne pouvez pas modifier les entĂȘtes sur cet Ă©vĂ©nement<br> -  </p> +Notez qu'il est possible que des extensions entrent en conflit ici. Si deux extensions Ă©coutent `onHeadersReceived` pour la mĂȘme requĂȘte et retournent `responseHeaders` essayant de dĂ©finir le mĂȘme en-tĂȘte (par exemple, `Content-Security-Policy`), seule une des modifications sera rĂ©ussie. Si vous voulez voir les en-tĂȘtes qui sont effectivement traitĂ©s par le systĂšme, sans risque qu'une autre extension les modifie par la suite, utilisez {{WebExtAPIRef("webRequest.onResponseStarted", "onResponseStarted", "onResponseStarted")}}, mais vous ne pouvez pas modifier les entĂȘtes sur cet Ă©vĂ©nement -<h2 id="Syntaxe">Syntaxe</h2> -<pre class="brush: js">browser.webRequest.onHeadersReceived.addListener( + +## Syntaxe + +```js +browser.webRequest.onHeadersReceived.addListener( listener, // function filter, // object extraInfoSpec // optional array of strings ) browser.webRequest.onHeadersReceived.removeListener(listener) browser.webRequest.onHeadersReceived.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback, filter, extraInfoSpec)</code></dt> - <dd>Ajouter un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants :</p> - - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails de la demande. Ceci inclura les en-tĂȘtes de rĂ©ponse si vous avez inclus <code>"responseHeaders"</code> dans <code>extraInfoSpec</code>.</dd> - </dl> - - <p>Retourne : {{WebExtAPIRef('webRequest.BlockingResponse')}}. Si <code>"blocking"</code> est spĂ©cifiĂ© dans le paramĂštre <code>extraInfoSpec</code>, l'auditeur d'Ă©vĂ©nement doit retourner un objet <code>BlockingResponse</code>, et peut dĂ©finir sa propriĂ©tĂ© <code>responseHeaders</code>.</p> - </dd> - <dt><code>filter</code></dt> - <dd>{{WebExtAPIRef('webRequest.RequestFilter')}}. Un ensemble de filtres qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur.</dd> - <dt><code>extraInfoSpec</code>{{optional_inline}}</dt> - <dd><p><code>array</code> de <code>string</code>. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous pouvez passer n'importe laquelle des valeurs suivantes :</p> - <ul> - <li><code>"blocking"</code> pour rendre la requĂȘte synchrone, de sorte que vous pouvez modifier les en-tĂȘtes de requĂȘte et rĂ©ponse.</li> - <li><code>"responseHeaders"</code> pour inclure les en-tĂȘtes de rĂ©ponse dans l'objet <code>dĂ©tails</code> transmis Ă l'auditeur</li> - </ul> - </dd> -</dl> - -<h2 id="objets_supplĂ©mentaires">objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>documentUrl</code></dt> - <dd><code>string</code>. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https://example.com" contient une image ou un iframe, alors le <code>documentUrl</code> pour l'image ou l'iframe sera "https://example.com". Pour un document de niveau supĂ©rieur, <code>documentUrl</code> n'est pas dĂ©fini.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (<code>type</code> is <code>main_frame</code> or <code>sub_frame</code>), <code>frameId</code> indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet.</dd> - <dt><code>method</code></dt> - <dd><code>string</code>. MĂ©thode HTTP standard : par exemple, "GET" ou "POST".</dd> - <dt><code>originUrl</code></dt> - <dd> - <p><code>string</code>. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors <code>originUrl</code> de la requĂȘte rĂ©sultante est "https://example.com".</p> - - <p>L'<code>originUrl</code> est souvent mais pas toujours la mĂȘme chose que <code>documentUrl</code>.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le <code>documentUrl</code> pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'<code>originUrl</code> sera l'URL du document dans l'iframe qui contenait le lien.</p> - </dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent.</dd> - <dt><code>proxyInfo</code></dt> - <dd> - <p><code>object</code>. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>host</code></dt> - <dd><code>string</code>. Le nom d'hĂŽte du serveur proxy.</dd> - <dt><code>port</code></dt> - <dd><code>integer</code>. Le numĂ©ro de port du serveur proxy.</dd> - <dt><code>type</code></dt> - <dd> - <p><code>string</code>. Le type de serveur proxy. L'un des :</p> - - <ul> - <li>"http": proxy HTTP (ou SSL CONNECT pour HTTPS)</li> - <li>"https": proxy HTTP sur connexion TLS vers proxy</li> - <li>"socks": SOCKS v5 proxy</li> - <li>"socks4": SOCKS v4 proxy</li> - <li>"direct": pas de proxy</li> - <li>"unknown": proxy inconnu</li> - </ul> - </dd> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur pour le service proxy.</dd> - <dt><code>proxyDNS</code></dt> - <dd><code>boolean</code>. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS.</dd> - <dt><code>failoverTimeout</code></dt> - <dd><code>integer</code>. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode.</dd> - </dl> - </dd> - <dt><code>requestId</code></dt> - <dd><code>string</code>. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte.</dd> - <dt><code>responseHeaders</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse.</dd> - <dt><code>statusCode</code></dt> - <dd><code>integer</code>. Code d'Ă©tat HTTP standard renvoyĂ© par le serveur.</dd> - <dt><code>statusLine</code></dt> - <dd><code>string</code>. Status d'Ă©tat HTTP de la rĂ©ponse ou la chaĂźne 'HTTP/0.9 200 OK' pour les rĂ©ponses HTTP/0.9 (c'est-Ă -dire les rĂ©ponses qui n'ont pas de ligne d'Ă©tat) ou une chaĂźne vide s'il n'y a pas d'en-tĂȘtes</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet".</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. Cible de la demande.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.onHeadersReceived", 10)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Ce code dĂ©finit un cookie supplĂ©mentaire lors de la demande d'une ressource Ă partir de l'URL cible :</p> - -<pre class="brush: js">var targetPage = "https://developer.mozilla.org/en-US/Firefox/Developer_Edition"; +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback, filter, extraInfoSpec)` + - : Ajouter un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne `true` s'il est Ă©coutĂ©, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants : + + - `details` + - : [`object`](#details). DĂ©tails de la demande. Ceci inclura les en-tĂȘtes de rĂ©ponse si vous avez inclus `"responseHeaders"` dans `extraInfoSpec`. + + Retourne : {{WebExtAPIRef('webRequest.BlockingResponse')}}. Si `"blocking"` est spĂ©cifiĂ© dans le paramĂštre `extraInfoSpec`, l'auditeur d'Ă©vĂ©nement doit retourner un objet `BlockingResponse`, et peut dĂ©finir sa propriĂ©tĂ© `responseHeaders`. + +- `filter` + - : {{WebExtAPIRef('webRequest.RequestFilter')}}. Un ensemble de filtres qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur. +- `extraInfoSpec`{{optional_inline}} + + - : `array` de `string`. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous pouvez passer n'importe laquelle des valeurs suivantes : + + - `"blocking"` pour rendre la requĂȘte synchrone, de sorte que vous pouvez modifier les en-tĂȘtes de requĂȘte et rĂ©ponse. + - `"responseHeaders"` pour inclure les en-tĂȘtes de rĂ©ponse dans l'objet `dĂ©tails` transmis Ă l'auditeur + +## objets supplĂ©mentaires + +### dĂ©tails + +- `documentUrl` + - : `string`. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https\://example.com" contient une image ou un iframe, alors le `documentUrl` pour l'image ou l'iframe sera "https\://example.com". Pour un document de niveau supĂ©rieur, `documentUrl` n'est pas dĂ©fini. +- `frameId` + - : `integer`. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (`type` is `main_frame` or `sub_frame`), `frameId` indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet. +- `method` + - : `string`. MĂ©thode HTTP standard : par exemple, "GET" ou "POST". +- `originUrl` + + - : `string`. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https\://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors `originUrl` de la requĂȘte rĂ©sultante est "https\://example.com". + + L'`originUrl` est souvent mais pas toujours la mĂȘme chose que `documentUrl`.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le `documentUrl` pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'`originUrl` sera l'URL du document dans l'iframe qui contenait le lien. + +- `parentFrameId` + - : `integer`. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent. +- `proxyInfo` + + - : `object`. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes : + + - `host` + - : `string`. Le nom d'hĂŽte du serveur proxy. + - `port` + - : `integer`. Le numĂ©ro de port du serveur proxy. + - `type` + + - : `string`. Le type de serveur proxy. L'un des : + + - "http": proxy HTTP (ou SSL CONNECT pour HTTPS) + - "https": proxy HTTP sur connexion TLS vers proxy + - "socks": SOCKS v5 proxy + - "socks4": SOCKS v4 proxy + - "direct": pas de proxy + - "unknown": proxy inconnu + + - `username` + - : `string`. Nom d'utilisateur pour le service proxy. + - `proxyDNS` + - : `boolean`. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS. + - `failoverTimeout` + - : `integer`. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode. + +- `requestId` + - : `string`. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte. +- `responseHeaders`{{optional_inline}} + - : {{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse. +- `statusCode` + - : `integer`. Code d'Ă©tat HTTP standard renvoyĂ© par le serveur. +- `statusLine` + - : `string`. Status d'Ă©tat HTTP de la rĂ©ponse ou la chaĂźne 'HTTP/0.9 200 OK' pour les rĂ©ponses HTTP/0.9 (c'est-Ă -dire les rĂ©ponses qui n'ont pas de ligne d'Ă©tat) ou une chaĂźne vide s'il n'y a pas d'en-tĂȘtes +- `tabId` + - : `integer`. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet. +- `timeStamp` + - : `number`. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `type` + - : {{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet". +- `url` + - : `string`. Cible de la demande. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.onHeadersReceived", 10)}} + +## Exemples + +Ce code dĂ©finit un cookie supplĂ©mentaire lors de la demande d'une ressource Ă partir de l'URL cible : + +```js +var targetPage = "https://developer.mozilla.org/en-US/Firefox/Developer_Edition"; // Add the new header to the original array, // and return it. @@ -171,18 +161,20 @@ browser.webRequest.onHeadersReceived.addListener( setCookie, {urls: [targetPage]}, ["blocking", "responseHeaders"] -);</pre> +); +``` -<p>Ce code fait la mĂȘme chose que l'exemple prĂ©cĂ©dent, sauf que l'auditeur est asynchrone, retournant une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui est rĂ©solue avec les nouveaux en-tĂȘtes :</p> +Ce code fait la mĂȘme chose que l'exemple prĂ©cĂ©dent, sauf que l'auditeur est asynchrone, retournant une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui est rĂ©solue avec les nouveaux en-tĂȘtes : -<pre class="brush: js">var targetPage = "https://developer.mozilla.org/en-US/Firefox/Developer_Edition"; +```js +var targetPage = "https://developer.mozilla.org/en-US/Firefox/Developer_Edition"; // Return a Promise that sets a timer. // When the timer fires, resolve the promise with // modified set of response headers. function setCookieAsync(e) { - var asyncSetCookie = new Promise((resolve, reject) => { - window.setTimeout(() => { + var asyncSetCookie = new Promise((resolve, reject) => { + window.setTimeout(() => { var setMyCookie = { name: "Set-Cookie", value: "my-cookie1=my-cookie-value1" @@ -202,19 +194,17 @@ browser.webRequest.onHeadersReceived.addListener( {urls: [targetPage]}, ["blocking", "responseHeaders"] ); -</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/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -241,5 +231,4 @@ browser.webRequest.onHeadersReceived.addListener( // 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/webrequest/onresponsestarted/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onresponsestarted/index.md index 60f8f4a5b2..e91113903f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/onresponsestarted/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onresponsestarted/index.md @@ -13,134 +13,125 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/onResponseStarted --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>LancĂ© lorsque le premier octet du corps de rĂ©ponse est reçu.</p> +LancĂ© lorsque le premier octet du corps de rĂ©ponse est reçu. -<p>Cet Ă©vĂ©nement est Ă titre d'information seulement.</p> +Cet Ă©vĂ©nement est Ă titre d'information seulement. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webRequest.onResponseStarted.addListener( +```js +browser.webRequest.onResponseStarted.addListener( listener, // function filter, // object extraInfoSpec // optional array of strings ) browser.webRequest.onResponseStarted.removeListener(listener) browser.webRequest.onResponseStarted.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback, filter, extraInfoSpec)</code></dt> - <dd>Ajouter un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd><p>Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants :</p> - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur la demande. Voir les <code><a href="#details">details</a></code> ci-dessous.</dd> - </dl> - </dd> - <dt><code>filter</code></dt> - <dd>{{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur.</dd> - <dt><code>extraInfoSpec</code>{{optional_inline}}</dt> - <dd><p><code>array</code> de <code>string</code>. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous ne pouvez passer qu'une seule valeur :</p> - <ul> - <li><code>"</code><code>responseHeaders</code><code>"</code>: inclure <code>responseHeaders</code> dans l'objet <code>dĂ©tails</code> transmis Ă l'auditeur</li> - </ul> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>documentUrl</code></dt> - <dd><code>string</code>. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https://example.com" contient une image ou un iframe, alors le <code>documentUrl</code> pour l'image ou l'iframe sera "https://example.com". Pour un document de niveau supĂ©rieur, <code>documentUrl</code> n'est pas dĂ©fini.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (<code>type</code> is <code>main_frame</code> or <code>sub_frame</code>), <code>frameId</code> indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet.</dd> - <dt><code>fromCache</code></dt> - <dd><code>boolean</code>. Indique si cette rĂ©ponse a Ă©tĂ© rĂ©cupĂ©rĂ©e dans le cache du disque.</dd> - <dt><code>ip</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'adresse IP du serveur Ă laquelle la requĂȘte a Ă©tĂ© envoyĂ©e. Notez qu'il peut s'agir d'une adresse IPv6 littĂ©rale.</dd> - <dt><code>method</code></dt> - <dd><code>string</code>. MĂ©thode HTTP standard : par exemple, "GET" ou "POST".</dd> - <dt><code>originUrl</code></dt> - <dd> - <p><code>string</code>. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors <code>originUrl</code> de la requĂȘte rĂ©sultante est "https://example.com".</p> - - <p>L'<code>originUrl</code> est souvent mais pas toujours la mĂȘme chose que <code>documentUrl</code>.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le <code>documentUrl</code> pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'<code>originUrl</code> sera l'URL du document dans l'iframe qui contenait le lien.</p> - </dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent.</dd> - <dt><code>proxyInfo</code></dt> - <dd> - <p><code>object</code>. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>host</code></dt> - <dd><code>string</code>. Le nom d'hĂŽte du serveur proxy.</dd> - <dt><code>port</code></dt> - <dd><code>integer</code>. Le numĂ©ro de port du serveur proxy.</dd> - <dt><code>type</code></dt> - <dd> - <p><code>string</code>. Le type de serveur proxy. L'un des :</p> - - <ul> - <li>"http": proxy HTTP (ou SSL CONNECT pour HTTPS)</li> - <li>"https": proxy HTTP sur connexion TLS vers proxy</li> - <li>"socks": SOCKS v5 proxy</li> - <li>"socks4": SOCKS v4 proxy</li> - <li>"direct": pas de proxy</li> - <li>"unknown": proxy inconnu</li> - </ul> - </dd> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur pour le service proxy.</dd> - <dt><code>proxyDNS</code></dt> - <dd><code>boolean</code>. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS.</dd> - <dt><code>failoverTimeout</code></dt> - <dd><code>integer</code>. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode.</dd> - </dl> - </dd> - <dt><code>requestId</code></dt> - <dd><code>string</code>. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte.</dd> - <dt><code>responseHeaders</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse.</dd> - <dt><code>statusCode</code></dt> - <dd><code>integer</code>. Code d'Ă©tat HTTP standard renvoyĂ© par le serveur.</dd> - <dt><code>statusLine</code></dt> - <dd><code>string</code>. Status d'Ă©tat HTTP de la rĂ©ponse ou la chaĂźne 'HTTP/0.9 200 OK' pour les rĂ©ponses HTTP/0.9 (c'est-Ă -dire les rĂ©ponses qui n'ont pas de ligne d'Ă©tat) ou une chaĂźne vide s'il n'y a pas d'en-tĂȘtes</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet".</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. Cible de la demande.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.onResponseStarted", 10)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">var target = "https://developer.mozilla.org/*"; +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback, filter, extraInfoSpec)` + - : Ajouter un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne `true` s'il est Ă©coutĂ©, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Une fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants : + + - `details` + - : [`object`](#details). DĂ©tails sur la demande. Voir les [`details`](#details) ci-dessous. + +- `filter` + - : {{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur. +- `extraInfoSpec`{{optional_inline}} + + - : `array` de `string`. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous ne pouvez passer qu'une seule valeur : + + - ` "``responseHeaders``" `: inclure `responseHeaders` dans l'objet `dĂ©tails` transmis Ă l'auditeur + +## Objets supplĂ©mentaires + +### dĂ©tails + +- `documentUrl` + - : `string`. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https\://example.com" contient une image ou un iframe, alors le `documentUrl` pour l'image ou l'iframe sera "https\://example.com". Pour un document de niveau supĂ©rieur, `documentUrl` n'est pas dĂ©fini. +- `frameId` + - : `integer`. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (`type` is `main_frame` or `sub_frame`), `frameId` indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet. +- `fromCache` + - : `boolean`. Indique si cette rĂ©ponse a Ă©tĂ© rĂ©cupĂ©rĂ©e dans le cache du disque. +- `ip`{{optional_inline}} + - : `string`. L'adresse IP du serveur Ă laquelle la requĂȘte a Ă©tĂ© envoyĂ©e. Notez qu'il peut s'agir d'une adresse IPv6 littĂ©rale. +- `method` + - : `string`. MĂ©thode HTTP standard : par exemple, "GET" ou "POST". +- `originUrl` + + - : `string`. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https\://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors `originUrl` de la requĂȘte rĂ©sultante est "https\://example.com". + + L'`originUrl` est souvent mais pas toujours la mĂȘme chose que `documentUrl`.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le `documentUrl` pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'`originUrl` sera l'URL du document dans l'iframe qui contenait le lien. + +- `parentFrameId` + - : `integer`. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent. +- `proxyInfo` + + - : `object`. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes : + + - `host` + - : `string`. Le nom d'hĂŽte du serveur proxy. + - `port` + - : `integer`. Le numĂ©ro de port du serveur proxy. + - `type` + + - : `string`. Le type de serveur proxy. L'un des : + + - "http": proxy HTTP (ou SSL CONNECT pour HTTPS) + - "https": proxy HTTP sur connexion TLS vers proxy + - "socks": SOCKS v5 proxy + - "socks4": SOCKS v4 proxy + - "direct": pas de proxy + - "unknown": proxy inconnu + + - `username` + - : `string`. Nom d'utilisateur pour le service proxy. + - `proxyDNS` + - : `boolean`. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS. + - `failoverTimeout` + - : `integer`. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode. + +- `requestId` + - : `string`. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte. +- `responseHeaders`{{optional_inline}} + - : {{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse. +- `statusCode` + - : `integer`. Code d'Ă©tat HTTP standard renvoyĂ© par le serveur. +- `statusLine` + - : `string`. Status d'Ă©tat HTTP de la rĂ©ponse ou la chaĂźne 'HTTP/0.9 200 OK' pour les rĂ©ponses HTTP/0.9 (c'est-Ă -dire les rĂ©ponses qui n'ont pas de ligne d'Ă©tat) ou une chaĂźne vide s'il n'y a pas d'en-tĂȘtes +- `tabId` + - : `integer`. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet. +- `timeStamp` + - : `number`. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `type` + - : {{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet". +- `url` + - : `string`. Cible de la demande. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.onResponseStarted", 10)}} + +## Exemples + +```js +var target = "https://developer.mozilla.org/*"; /* e.g. @@ -157,19 +148,18 @@ function logResponse(responseDetails) { browser.webRequest.onResponseStarted.addListener( logResponse, {urls: [target]} -);</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/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -196,5 +186,4 @@ browser.webRequest.onResponseStarted.addListener( // 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/webrequest/onsendheaders/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onsendheaders/index.md index c091296420..5bb6919c56 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/onsendheaders/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/onsendheaders/index.md @@ -13,130 +13,119 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/onSendHeaders --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Cet Ă©vĂ©nement est dĂ©clenchĂ© juste avant l'envoi des en-tĂȘtes. Si votre extension ou une autre extension a modifiĂ© les en-tĂȘtes dans <code>{{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}}</code>, vous verrez la version modifiĂ©e ici.</p> +Cet Ă©vĂ©nement est dĂ©clenchĂ© juste avant l'envoi des en-tĂȘtes. Si votre extension ou une autre extension a modifiĂ© les en-tĂȘtes dans `{{WebExtAPIRef("webRequest.onBeforeSendHeaders", "onBeforeSendHeaders")}}`, vous verrez la version modifiĂ©e ici. -<p>Cet Ă©vĂ©nement est Ă titre d'information seulement.</p> +Cet Ă©vĂ©nement est Ă titre d'information seulement. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.webRequest.onSendHeaders.addListener( +```js +browser.webRequest.onSendHeaders.addListener( listener, // function filter, // object extraInfoSpec // optional array of strings ) browser.webRequest.onSendHeaders.removeListener(listener) browser.webRequest.onSendHeaders.hasListener(listener) -</pre> - -<p>Les Ă©vĂ©nements ont trois fonctions :</p> - -<dl> - <dt><code>addListener(callback, filter, extraInfoSpec)</code></dt> - <dd>Ajouter un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument <code>listener</code> est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si <code>listener</code> est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne <code>true</code> s'il est Ă©coutĂ©, sinon <code>false</code>.</dd> -</dl> - -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants :</p> - - <dl> - <dt><code>details</code></dt> - <dd><a href="#details"><code>object</code></a>. DĂ©tails sur la demande. Voir les <code><a href="#details">details</a></code> ci-dessous.</dd> - </dl> - </dd> - <dt><code>filter</code></dt> - <dd>{{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur.</dd> - <dt><code>extraInfoSpec</code>{{optional_inline}}</dt> - <dd><p><code>array</code> de <code>string</code>. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous ne pouvez passer qu'une seule valeur ici :</p> - <ul> - <li><code>"requestHeaders"</code>: inclure les en-tĂȘtes de requĂȘte dans l'objet dĂ©tails transmis Ă l'auditeur</li> - </ul> - </dd> -</dl> - -<h2 id="Objets_supplĂ©mentaires">Objets supplĂ©mentaires</h2> - -<h3 id="dĂ©tails">dĂ©tails</h3> - -<dl> - <dt><code>documentUrl</code></dt> - <dd><code>string</code>. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https://example.com" contient une image ou un iframe, alors le <code>documentUrl</code> pour l'image ou l'iframe sera "https://example.com". Pour un document de niveau supĂ©rieur, <code>documentUrl</code> n'est pas dĂ©fini.</dd> - <dt><code>frameId</code></dt> - <dd><code>integer</code>. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (<code>type</code> is <code>main_frame</code> or <code>sub_frame</code>), <code>frameId</code> indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet.</dd> - <dt><code>method</code></dt> - <dd><code>string</code>. MĂ©thode HTTP standard : par exemple, "GET" ou "POST".</dd> - <dt><code>originUrl</code></dt> - <dd> - <p><code>string</code>. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors <code>originUrl</code> de la requĂȘte rĂ©sultante est "https://example.com".</p> - - <p>L'<code>originUrl</code> est souvent mais pas toujours la mĂȘme chose que <code>documentUrl</code>.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le <code>documentUrl</code> pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'<code>originUrl</code> sera l'URL du document dans l'iframe qui contenait le lien.</p> - </dd> - <dt><code>parentFrameId</code></dt> - <dd><code>integer</code>. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent.</dd> - <dt><code>proxyInfo</code></dt> - <dd> - <p><code>object</code>. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes :</p> - - <dl> - <dt><code>host</code></dt> - <dd><code>string</code>. Le nom d'hĂŽte du serveur proxy.</dd> - <dt><code>port</code></dt> - <dd><code>integer</code>. Le numĂ©ro de port du serveur proxy.</dd> - <dt><code>type</code></dt> - <dd> - <p><code>string</code>. Le type de serveur proxy. L'un des :</p> - - <ul> - <li>"http": proxy HTTP (ou SSL CONNECT pour HTTPS)</li> - <li>"https": proxy HTTP sur connexion TLS vers proxy</li> - <li>"socks": SOCKS v5 proxy</li> - <li>"socks4": SOCKS v4 proxy</li> - <li>"direct": pas de proxy</li> - <li>"unknown": proxy inconnu</li> - </ul> - </dd> - <dt><code>username</code></dt> - <dd><code>string</code>. Nom d'utilisateur pour le service proxy.</dd> - <dt><code>proxyDNS</code></dt> - <dd><code>boolean</code>. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS.</dd> - <dt><code>failoverTimeout</code></dt> - <dd><code>integer</code>. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode.</dd> - </dl> - </dd> - <dt><code>requestId</code></dt> - <dd><code>string</code>. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte.</dd> - <dt><code>requestHeaders</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse.</dd> - <dt><code>tabId</code></dt> - <dd><code>integer</code>. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet.</dd> - <dt><code>timeStamp</code></dt> - <dd><code>number</code>. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'Ă©poque</a>.</dd> - <dt><code>type</code></dt> - <dd>{{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet".</dd> - <dt><code>url</code></dt> - <dd><code>string</code>. Cible de la demande.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.onSendHeaders", 10)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Ce code enregistre tous les cookies qui seront envoyĂ©s en faisant des demandes au <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">modĂšle de match</a> cible :</p> - -<pre class="brush: js">// The target match pattern +``` + +Les Ă©vĂ©nements ont trois fonctions : + +- `addListener(callback, filter, extraInfoSpec)` + - : Ajouter un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument `listener` est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si `listener` est enregistrĂ© Ă cet Ă©vĂ©nement. Retourne `true` s'il est Ă©coutĂ©, sinon `false`. + +## Syntaxe addListener + +### ParamĂštres + +- `callback` + + - : Fonction qui sera appelĂ©e lorsque cet Ă©vĂ©nement se produira. La fonction sera passĂ©e les arguments suivants : + + - `details` + - : [`object`](#details). DĂ©tails sur la demande. Voir les [`details`](#details) ci-dessous. + +- `filter` + - : {{WebExtAPIRef('webRequest.RequestFilter')}}. Un filtre qui restreint les Ă©vĂ©nements qui seront envoyĂ©s Ă cet auditeur. +- `extraInfoSpec`{{optional_inline}} + + - : `array` de `string`. Options supplĂ©mentaires pour l'Ă©vĂ©nement. Vous ne pouvez passer qu'une seule valeur ici : + + - `"requestHeaders"`: inclure les en-tĂȘtes de requĂȘte dans l'objet dĂ©tails transmis Ă l'auditeur + +## Objets supplĂ©mentaires + +### dĂ©tails + +- `documentUrl` + - : `string`. URL du document dans lequel la ressource sera chargĂ©e. Par exemple, si la page web "https\://example.com" contient une image ou un iframe, alors le `documentUrl` pour l'image ou l'iframe sera "https\://example.com". Pour un document de niveau supĂ©rieur, `documentUrl` n'est pas dĂ©fini. +- `frameId` + - : `integer`. ZĂ©ro si la requĂȘte se produit dans le cadre principal ; une valeur positive est l'ID d'une sous-trame dans laquelle la requĂȘte se produit. Si le document d'un (sous-)cadre est chargĂ© (`type` is `main_frame` or `sub_frame`), `frameId` indique l'ID de ce cadre et non l'ID du cadre extĂ©rieur. Les ID de trame sont uniques dans un onglet. +- `method` + - : `string`. MĂ©thode HTTP standard : par exemple, "GET" ou "POST". +- `originUrl` + + - : `string`. URL de la ressource qui a dĂ©clenchĂ© la requĂȘte. Par exemple, si "https\://example.com" contient un lien, et que l'utilisateur clique sur le lien, alors `originUrl` de la requĂȘte rĂ©sultante est "https\://example.com". + + L'`originUrl` est souvent mais pas toujours la mĂȘme chose que `documentUrl`.Par exemple, si une page contient une iframe, et que l'iframe contient un lien qui charge un nouveau document dans l'iframe, alors le `documentUrl` pour la requĂȘte rĂ©sultante sera le document parent de l'iframe, mais l'`originUrl` sera l'URL du document dans l'iframe qui contenait le lien. + +- `parentFrameId` + - : `integer`. de la trame qui contient la trame qui a envoyĂ© la requĂȘte. RĂ©glĂ© Ă -1 s'il n'existe pas de l'iframe parent. +- `proxyInfo` + + - : `object`. Cette propriĂ©tĂ© n'est prĂ©sente que si la demande est proxied. Il contient les propriĂ©tĂ©s suivantes : + + - `host` + - : `string`. Le nom d'hĂŽte du serveur proxy. + - `port` + - : `integer`. Le numĂ©ro de port du serveur proxy. + - `type` + + - : `string`. Le type de serveur proxy. L'un des : + + - "http": proxy HTTP (ou SSL CONNECT pour HTTPS) + - "https": proxy HTTP sur connexion TLS vers proxy + - "socks": SOCKS v5 proxy + - "socks4": SOCKS v4 proxy + - "direct": pas de proxy + - "unknown": proxy inconnu + + - `username` + - : `string`. Nom d'utilisateur pour le service proxy. + - `proxyDNS` + - : `boolean`. Vrai si le proxy exĂ©cutera une rĂ©solution de nom de domaine basĂ©e sur le nom d'hĂŽte fourni, ce qui signifie que le client ne doit pas faire sa propre recherche DNS. + - `failoverTimeout` + - : `integer`. DĂ©lai d'attente de basculement en secondes. Si la connexion par proxy Ă©choue, le proxy ne sera pas utilisĂ© Ă nouveau pendant cette pĂ©riode. + +- `requestId` + - : `string`. L'ID de la demande. Les ID de requĂȘte sont uniques au sein d'une session de navigateur, de sorte que vous pouvez les utiliser pour relier diffĂ©rents Ă©vĂ©nements associĂ©s Ă la mĂȘme requĂȘte. +- `requestHeaders`{{optional_inline}} + - : {{WebExtAPIRef('webRequest.HttpHeaders')}}. Les en-tĂȘtes de rĂ©ponse HTTP qui ont Ă©tĂ© reçus avec cette rĂ©ponse. +- `tabId` + - : `integer`. ID de l'onglet dans lequel la demande a lieu. DĂ©finir Ă -1 si la requĂȘte n'est pas liĂ©e Ă un onglet. +- `timeStamp` + - : `number`. L'heure Ă laquelle cet Ă©vĂ©nement s'est dĂ©clenchĂ©, en [millisecondes depuis l'Ă©poque](https://en.wikipedia.org/wiki/Unix_time). +- `type` + - : {{WebExtAPIRef('webRequest.ResourceType')}}. Le type de ressource demandĂ©e : par exemple, "image", "script", "stylesheet". +- `url` + - : `string`. Cible de la demande. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.onSendHeaders", 10)}} + +## Exemples + +Ce code enregistre tous les cookies qui seront envoyĂ©s en faisant des demandes au [modĂšle de match](/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns) cible : + +```js +// The target match pattern var targetPage = "*://*.google.ca/*"; // Log cookies sent with this request @@ -154,19 +143,18 @@ browser.webRequest.onSendHeaders.addListener( logCookies, {urls: [targetPage]}, ["requestHeaders"] -);</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/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<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 @@ -193,5 +181,4 @@ browser.webRequest.onSendHeaders.addListener( // 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/webrequest/requestfilter/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/requestfilter/index.md index 5136764a13..a8eb210a77 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/requestfilter/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/requestfilter/index.md @@ -13,42 +13,38 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/RequestFilter --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet dĂ©crivant les filtres Ă appliquer aux Ă©vĂ©nements webRequest.</p> +Un objet dĂ©crivant les filtres Ă appliquer aux Ă©vĂ©nements webRequest. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>urls</code></dt> - <dd><code>array</code> de <code><code>string</code></code>. Un tableau de <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns">motifs (Match patterns)</a>. L'auditeur ne sera appelĂ© que pour les demandes dont les cibles correspondent Ă l'un des modĂšles donnĂ©s. Seules les requĂȘtes faites en utilisant HTTP ou HTTPS dĂ©clencheront des Ă©vĂ©nements, mĂȘme si les modĂšles de correspondance peuvent correspondre Ă d'autres protocoles.</dd> - <dt><code>types</code>{{optional_inline}}</dt> - <dd><code>array</code> de <code>{{WebExtAPIRef('webRequest.ResourceType')}}</code>. Une liste des types de ressources (par exemple, feuilles de style, images, scripts). L'auditeur ne sera appelĂ© que pour les demandes de ressources qui sont de l'un des types donnĂ©s.</dd> - <dt><code>tabId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'auditeur ne sera appelĂ© que pour les requĂȘtes provenant du {{WebExtAPIRef("tabs.Tab", "tab")}} identifiĂ© par cet ID.</dd> - <dt><code>windowId</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'auditeur ne sera appelĂ© que pour les requĂȘtes provenant du {{WebExtAPIRef("windows.Window", "window")}} identifiĂ© par cet ID.</dd> - <dt>incognito {{optional_inline}}</dt> - <dd><code>boolean</code>. Si elles sont fournies, les demandes qui ne correspondent pas Ă l'Ă©tat incognito (<code>true</code> ou <code>false</code>) seront filtrĂ©es.</dd> -</dl> +- `urls` + - : `array` de `string`. Un tableau de [motifs (Match patterns)](/fr/docs/Mozilla/Add-ons/WebExtensions/Match_patterns). L'auditeur ne sera appelĂ© que pour les demandes dont les cibles correspondent Ă l'un des modĂšles donnĂ©s. Seules les requĂȘtes faites en utilisant HTTP ou HTTPS dĂ©clencheront des Ă©vĂ©nements, mĂȘme si les modĂšles de correspondance peuvent correspondre Ă d'autres protocoles. +- `types`{{optional_inline}} + - : `array` de `{{WebExtAPIRef('webRequest.ResourceType')}}`. Une liste des types de ressources (par exemple, feuilles de style, images, scripts). L'auditeur ne sera appelĂ© que pour les demandes de ressources qui sont de l'un des types donnĂ©s. +- `tabId`{{optional_inline}} + - : `integer`. L'auditeur ne sera appelĂ© que pour les requĂȘtes provenant du {{WebExtAPIRef("tabs.Tab", "tab")}} identifiĂ© par cet ID. +- `windowId`{{optional_inline}} + - : `integer`. L'auditeur ne sera appelĂ© que pour les requĂȘtes provenant du {{WebExtAPIRef("windows.Window", "window")}} identifiĂ© par cet ID. +- incognito {{optional_inline}} + - : `boolean`. Si elles sont fournies, les demandes qui ne correspondent pas Ă l'Ă©tat incognito (`true` ou `false`) seront filtrĂ©es. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.RequestFilter")}}</p> +{{Compat("webextensions.api.webRequest.RequestFilter")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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 @@ -75,5 +71,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/RequestFilter // 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/webrequest/resourcetype/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/resourcetype/index.md index f3d0726ba2..10a8dc8680 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/resourcetype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/resourcetype/index.md @@ -13,81 +13,83 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/ResourceType --- -<div>{{AddonSidebar()}}</div> - -<p>Ce type est une chaĂźne de caractĂšres, qui reprĂ©sente le contexte dans lequel une ressource a Ă©tĂ© rĂ©cupĂ©rĂ©e dans une requĂȘte web.</p> - -<p>Il est utilisĂ© pour <a href="/fr/Add-ons/WebExtensions/API/WebRequest/RequestFilter">filtrer</a> les requĂȘtes que vous Ă©coutez en utilisant l'API webRequest. Par exemple : vous pouvez Ă©couter les requĂȘtes uniquement pour les images, ou uniquement pour les scripts.</p> - -<h2 id="Type">Type</h2> - -<p>Les valeurs de ce type sont des chaĂźnes de caractĂšres. Les valeurs possibles sont :</p> - -<dl> - <dt><code>beacon</code></dt> - <dd>Demandes envoyĂ©es par le biais de l'<a href="/fr/docs/Web/API/Beacon_API">API Beacon</a>.</dd> - <dt><code>csp_report</code></dt> - <dd>Demandes envoyĂ©es au {{CSP("report-uri")}} donnĂ© dans l'en-tĂȘte {{HTTPHeader("Content-Security-Policy")}}, lorsqu'une tentative de violation de la politique est dĂ©tectĂ©e.</dd> - <dt><code>font</code></dt> - <dd>Polices Web chargĂ©es pour un {{cssxref("@font-face")}} rĂšgle CSS.</dd> - <dt><code>image</code></dt> - <dd>Les ressources chargĂ©es pour ĂȘtre rendues sous forme d'image, Ă l'exception de <code>imageset</code> sur les navigateurs qui prennent en charge ce type (voir la compatibilitĂ© des navigateurs ci-dessous).</dd> - <dt><code>imageset</code></dt> - <dd>Images chargĂ©es par un Ă©lĂ©ment {{HTMLElement("picture")}} ou donnĂ©es dans un attribut {{htmlattrxref("srcset", "img")}} d'un Ă©lement <code><img></code>.</dd> -</dl> - -<dl> - <dt><code>main_frame</code></dt> - <dd>Documents de niveau chargĂ©s dans un objet.</dd> - <dt><code>media</code></dt> - <dd>Ressources chargĂ©es par un Ă©lĂ©ment {{HTMLElement("video")}} ou {{HTMLElement("audio")}}.</dd> - <dt><code>object</code></dt> - <dd><p>Ressources chargĂ©es par un Ă©lĂ©ment {{HTMLElement("object")}} ou {{HTMLElement("embed")}}.</p> - <p>Les navigateurs qui n'ont pas de type <code>object_subrequest</code> dĂ©diĂ© (voir compatibilitĂ© des navigateurs ci-dessous), Ă©tiquettent Ă©galement les requĂȘtes ultĂ©rieures envoyĂ©es par le plugin en tant <code>object</code>.</p></dd> - <dt><code>object_subrequest</code></dt> - <dd>RequĂȘtes envoyĂ©es par plugins.</dd> - <dt><code>ping</code></dt> - <dd><p>Demandes envoyĂ©es Ă l'URL donnĂ©e dans l'attribut {{htmlattrxref("ping", "a")}} d'un hyperlien, lorsque l'hyperlien est suivi.</p> - <p>Les navigateurs qui n'ont pas de type de <code>balise</code> dĂ©diĂ© (voir la compatibilitĂ© des navigateurs ci-dessous), Ă©tiquettent Ă©galement les requĂȘtes envoyĂ©es par l'API Beacon en tant que <code>ping</code>.</p></dd> - <dt><code>script</code></dt> - <dd>Code chargĂ© pour ĂȘtre exĂ©cutĂ© par un Ă©lĂ©ment {{HTMLElement("script")}} ou exĂ©cutĂ© dans un <a href="/fr/docs/Web/API/Web_Workers_API">Worker</a>.</dd> - <dt><code>speculative</code></dt> - <dd>Dans une connexion spĂ©culative, le navigateur a dĂ©terminĂ© qu'une demande d'URI pourrait bientĂŽt arriver, donc il lance immĂ©diatement un handshake TCP et/ou TLS, de sorte qu'il est prĂȘt plus rapidement lorsque la ressource est effectivement demandĂ©e.</dd> - <dt><code>stylesheet</code></dt> - <dd>Feuilles de style <a href="/fr/docs/Web/CSS">CSS</a> chargĂ©es pour dĂ©crire la reprĂ©sentation d'un document.</dd> - <dt><code>sub_frame</code></dt> - <dd>Documents chargĂ©s dans un Ă©lĂ©ment {{HTMLElement("iframe")}} ou {{HTMLElement("frame")}}.</dd> - <dt><code>web_manifest</code></dt> - <dd><a href="/fr/docs/Web/Manifest">Manifests Web App</a> chargĂ©s pour les sites Web qui peuvent ĂȘtre installĂ©s sur l'Ă©cran d'accueil.</dd> - <dt><code>websocket</code></dt> - <dd>RequĂȘtes initiant une connexion Ă un serveur via l'<a href="/fr/docs/WebSockets">API WebSocket</a>.</dd> - <dt><code>xbl</code></dt> - <dd><a href="/fr/docs/XBL">XBL</a> bindings chargĂ©s pour Ă©tendre le comportement des Ă©lĂ©ments d'un document.</dd> - <dt><code>xml_dtd</code></dt> - <dd><a href="/fr/docs/Glossaire/DTD">DTDs</a> chargĂ©es pour un document XML.</dd> - <dt><code>xmlhttprequest</code></dt> - <dd>RequĂȘtes envoyĂ©es par un objet {{domxref("XMLHttpRequest")}} ou par l'<a href="/fr/docs/Web/API/Fetch_API">API Fetch</a>.</dd> - <dt><code>xslt</code></dt> - <dd>Feuilles de style <a href="/fr/docs/Web/XSLT">XSLT</a> chargĂ©es pour transformer un document XML</dd> - <dt><code>other</code></dt> - <dd>Ressources qui ne sont couvertes par aucun autre type disponible.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.ResourceType")}}</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/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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()}} + +Ce type est une chaĂźne de caractĂšres, qui reprĂ©sente le contexte dans lequel une ressource a Ă©tĂ© rĂ©cupĂ©rĂ©e dans une requĂȘte web. + +Il est utilisĂ© pour [filtrer](/fr/Add-ons/WebExtensions/API/WebRequest/RequestFilter) les requĂȘtes que vous Ă©coutez en utilisant l'API webRequest. Par exemple : vous pouvez Ă©couter les requĂȘtes uniquement pour les images, ou uniquement pour les scripts. + +## Type + +Les valeurs de ce type sont des chaĂźnes de caractĂšres. Les valeurs possibles sont : + +- `beacon` + - : Demandes envoyĂ©es par le biais de l'[API Beacon](/fr/docs/Web/API/Beacon_API). +- `csp_report` + - : Demandes envoyĂ©es au {{CSP("report-uri")}} donnĂ© dans l'en-tĂȘte {{HTTPHeader("Content-Security-Policy")}}, lorsqu'une tentative de violation de la politique est dĂ©tectĂ©e. +- `font` + - : Polices Web chargĂ©es pour un {{cssxref("@font-face")}} rĂšgle CSS. +- `image` + - : Les ressources chargĂ©es pour ĂȘtre rendues sous forme d'image, Ă l'exception de `imageset` sur les navigateurs qui prennent en charge ce type (voir la compatibilitĂ© des navigateurs ci-dessous). +- `imageset` + - : Images chargĂ©es par un Ă©lĂ©ment {{HTMLElement("picture")}} ou donnĂ©es dans un attribut {{htmlattrxref("srcset", "img")}} d'un Ă©lement `<img>`. + +<!----> + +- `main_frame` + - : Documents de niveau chargĂ©s dans un objet. +- `media` + - : Ressources chargĂ©es par un Ă©lĂ©ment {{HTMLElement("video")}} ou {{HTMLElement("audio")}}. +- `object` + + - : Ressources chargĂ©es par un Ă©lĂ©ment {{HTMLElement("object")}} ou {{HTMLElement("embed")}}. + + Les navigateurs qui n'ont pas de type `object_subrequest` dĂ©diĂ© (voir compatibilitĂ© des navigateurs ci-dessous), Ă©tiquettent Ă©galement les requĂȘtes ultĂ©rieures envoyĂ©es par le plugin en tant `object`. + +- `object_subrequest` + - : RequĂȘtes envoyĂ©es par plugins. +- `ping` + + - : Demandes envoyĂ©es Ă l'URL donnĂ©e dans l'attribut {{htmlattrxref("ping", "a")}} d'un hyperlien, lorsque l'hyperlien est suivi. + + Les navigateurs qui n'ont pas de type de `balise` dĂ©diĂ© (voir la compatibilitĂ© des navigateurs ci-dessous), Ă©tiquettent Ă©galement les requĂȘtes envoyĂ©es par l'API Beacon en tant que `ping`. + +- `script` + - : Code chargĂ© pour ĂȘtre exĂ©cutĂ© par un Ă©lĂ©ment {{HTMLElement("script")}} ou exĂ©cutĂ© dans un [Worker](/fr/docs/Web/API/Web_Workers_API). +- `speculative` + - : Dans une connexion spĂ©culative, le navigateur a dĂ©terminĂ© qu'une demande d'URI pourrait bientĂŽt arriver, donc il lance immĂ©diatement un handshake TCP et/ou TLS, de sorte qu'il est prĂȘt plus rapidement lorsque la ressource est effectivement demandĂ©e. +- `stylesheet` + - : Feuilles de style [CSS](/fr/docs/Web/CSS) chargĂ©es pour dĂ©crire la reprĂ©sentation d'un document. +- `sub_frame` + - : Documents chargĂ©s dans un Ă©lĂ©ment {{HTMLElement("iframe")}} ou {{HTMLElement("frame")}}. +- `web_manifest` + - : [Manifests Web App](/fr/docs/Web/Manifest) chargĂ©s pour les sites Web qui peuvent ĂȘtre installĂ©s sur l'Ă©cran d'accueil. +- `websocket` + - : RequĂȘtes initiant une connexion Ă un serveur via l'[API WebSocket](/fr/docs/WebSockets). +- `xbl` + - : [XBL](/fr/docs/XBL) bindings chargĂ©s pour Ă©tendre le comportement des Ă©lĂ©ments d'un document. +- `xml_dtd` + - : [DTDs](/fr/docs/Glossaire/DTD) chargĂ©es pour un document XML. +- `xmlhttprequest` + - : RequĂȘtes envoyĂ©es par un objet {{domxref("XMLHttpRequest")}} ou par l'[API Fetch](/fr/docs/Web/API/Fetch_API). +- `xslt` + - : Feuilles de style [XSLT](/fr/docs/Web/XSLT) chargĂ©es pour transformer un document XML +- `other` + - : Ressources qui ne sont couvertes par aucun autre type disponible. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.ResourceType")}} + +{{WebExtExamples}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. + +<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 @@ -114,5 +116,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/ResourceType // 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/webrequest/securityinfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/securityinfo/index.md index 2c6ae1321c..3898a1d33f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/securityinfo/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/securityinfo/index.md @@ -11,86 +11,81 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/SecurityInfo --- -<div>{{AddonSidebar()}}</div> - -<p>Objet dĂ©crivant les propriĂ©tĂ©s de sĂ©curitĂ© d'une requĂȘte Web particuliĂšre. Un objet de ce type est retournĂ© depuis l'API {{WebExtAPIRef("webRequest.getSecurityInfo()")}}.</p> - -<p>Si la requĂȘte n'est pas sĂ©curisĂ©e par <a href="/fr/docs/Glossaire/TLS">TLS</a>, alors cet objet ne contiendra que l'Ă©tat de la propriĂ©tĂ© <code>state</code>, dont la valeur sera <code>"insecure"</code>.</p> - -<h2 id="Type">Type</h2> - -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> - -<dl> - <dt><code>certificates</code></dt> - <dd><p><code>Array</code> de {{WebExtAPIRef("webRequest.CertificateInfo", "CertificateInfo")}}. Si {{WebExtAPIRef("webRequest.getSecurityInfo()")}} a Ă©tĂ© appelĂ© avec l'option <code>certificateChain</code> prĂ©sente et dĂ©finie sur <code>true</code>, cela contiendra un objet <code>CertificateInfo</code> pour chaque certificat de la chaĂźne, depuis le certificat du serveur jusqu'Ă et y compris la racine de confiance.</p> - <p>Sinon, il contiendra un seul objet <code>CertificateInfo</code>, pour le certificat du serveur.</p></dd> - <dt><code>certificateTransparencyStatus</code> {{optional_inline}}</dt> - <dd> - <p><code>String</code>. Indique l'Ă©tat de la <a href="https://www.certificate-transparency.org/">transparence des certificats</a> pour la connexion. Ceci peut prendre l'une des valeurs suivantes :</p> - - <ul> - <li>"not_applicable"</li> - <li>"policy_compliant"</li> - <li>"policy_not_enough_scts"</li> - <li>"policy_not_diverse_scts"</li> - </ul> - </dd> - <dt><code>cipherSuite</code> {{optional_inline}}</dt> - <dd><code>String</code>. Suite de chiffrement utilisĂ©e pour la connexion, formatĂ©e selon la <a href="https://tools.ietf.org/html/rfc5246#appendix-A.5">specification TLS </a>: par exemple, "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256".</dd> - <dt><code>errorMessage</code> {{optional_inline}}</dt> - <dd> - <p><code>String</code>. S'il y a eu un problĂšme avec le protocole TLS (for example, the certificate had expired, or a trusted root could not be found, or a certificate was revoked) then <code>status</code> will be "broken" and the <code>errorMessage</code> property will contain a string describing the error, taken from Firefox's internal list of error codes.</p> - - <p>Note though that at present you can only call <code>getSecurityInfo()</code> in the <code>onHeaderReceived</code> listener, and the <code>onHeaderReceived</code> event is not fired when the handshake fails. So in practice this will never be set. </p> - </dd> - <dt><code>hpkp</code> {{optional_inline}}</dt> - <dd><code>Boolean</code>. <code>true</code> si l'hĂŽte utilise <a href="/fr/docs/Web/Security/Public_Key_Pinning">Public Key Pinning</a>, sinon <code>false</code>.</dd> - <dt><code>hsts</code> {{optional_inline}}</dt> - <dd><code>Boolean</code>. <code>true</code> si l'hĂŽte utilise <a href="/fr/docs/SĂ©curitĂ©/HTTP_Strict_Transport_Security">Strict Transport Security</a>, sinon <code>false</code>.</dd> - <dt><code>isDomainMismatch</code> {{optional_inline}}</dt> - <dd><code>Boolean</code>. <code>true</code> si le nom de domaine du serveur ne correspond pas au nom de domaine dans son certificat, sinon <code>false</code>.</dd> - <dt><code>isExtendedValidation</code> {{optional_inline}}</dt> - <dd><code>Boolean</code>. <code>true</code> si le serveur possĂšde un <a href="https://en.wikipedia.org/wiki/Extended_Validation_Certificate">Extended Validation Certificate</a>, sinon <code>false</code>.</dd> - <dt><code>isNotValidAtThisTime</code> {{optional_inline}}</dt> - <dd><code>Boolean</code>. <code>true</code> si l'heure actuelle tombe en dehors de la pĂ©riode de validitĂ© du certificat de serveur (c'est-Ă -dire que le certificat a expirĂ© ou n'est pas encore valide), sinon <code>false</code>.</dd> - <dt><code>isUntrusted</code> {{optional_inline}}</dt> - <dd><code>Boolean</code>. <code>true</code> si une chaĂźne de retour Ă un certificat racine de confiance n'a pas pu ĂȘtre construite, sinon <code>false</code>.</dd> - <dt><code>keaGroupName</code> {{optional_inline}}</dt> - <dd><code>String</code>. Si <code>state</code> est "sĂ©curisĂ©" cela dĂ©crit l'algorithme d'Ă©change de clĂ© utilisĂ© dans cette requĂȘte.</dd> - <dt><code>protocolVersion</code> {{optional_inline}}</dt> - <dd> - <p><code>String</code>. Version du protocole TLS utilisĂ©. L'un des :</p> - - <ul> - <li>"TLSv1"</li> - <li>"TLSv1.1"</li> - <li>"TLSv1.2"</li> - <li>"TLSv1.3"</li> - <li>"inconnu" (si la version n'est pas valide)</li> - </ul> - </dd> - <dt><code>signatureSchemeName</code> {{optional_inline}}</dt> - <dd><code>String</code>. Si <code>state</code> est "sĂ©curisĂ©", cela dĂ©crit le schĂ©ma de signature utilisĂ© dans cette requĂȘte.t.</dd> - <dt><code>state</code></dt> - <dd> - <p><code>String</code>. Ătat de la connexion. L'un des :</p> - - <ul> - <li>"broken": la poignĂ©e de main TLS a Ă©chouĂ© (par exemple, le certificat a expirĂ©)</li> - <li>"insecure": la connexion n'est pas une connexion TLS</li> - <li>"secure": la connexion est une connexion TLS sĂ©curisĂ©e</li> - <li>"weak": la connexion est une connexion TLS mais est considĂ©rĂ©e comme faible. Vous pouvez examiner les <code>weaknessReasons</code> pour dĂ©couvrir le problĂšme.</li> - </ul> - - <p>Notez cependant qu'actuellement, vous ne pouvez appele <code>getSecurityInfo()</code> que dans l'Ă©couteur <code>onHeaderReceived</code>, et l'Ă©vĂ©nement <code>onHeaderReceived</code> n'est pas dĂ©clenchĂ© lorsque la poignĂ©e de main Ă©choue. Ainsi, dans la pratique, il ne sera jamais rĂ©glĂ© sur "cassĂ©".</p> - </dd> - <dt><code>weaknessReasons</code> {{optional_inline}}</dt> - <dd><code>String</code>. Si l'<code>Ă©tat</code> est "faible", cela indique la raison. Actuellement, il ne peut contenir qu'une seule valeur "chiffre", ce qui indique que la suite de chiffres nĂ©gociĂ©e est considĂ©rĂ©e comme faible.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.SecurityInfo", 10)}}</p> - -<p>{{WebExtExamples}}</p> +{{AddonSidebar()}} + +Objet dĂ©crivant les propriĂ©tĂ©s de sĂ©curitĂ© d'une requĂȘte Web particuliĂšre. Un objet de ce type est retournĂ© depuis l'API {{WebExtAPIRef("webRequest.getSecurityInfo()")}}. + +Si la requĂȘte n'est pas sĂ©curisĂ©e par [TLS](/fr/docs/Glossaire/TLS), alors cet objet ne contiendra que l'Ă©tat de la propriĂ©tĂ© `state`, dont la valeur sera `"insecure"`. + +## Type + +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : + +- `certificates` + + - : `Array` de {{WebExtAPIRef("webRequest.CertificateInfo", "CertificateInfo")}}. Si {{WebExtAPIRef("webRequest.getSecurityInfo()")}} a Ă©tĂ© appelĂ© avec l'option `certificateChain` prĂ©sente et dĂ©finie sur `true`, cela contiendra un objet `CertificateInfo` pour chaque certificat de la chaĂźne, depuis le certificat du serveur jusqu'Ă et y compris la racine de confiance. + + Sinon, il contiendra un seul objet `CertificateInfo`, pour le certificat du serveur. + +- `certificateTransparencyStatus` {{optional_inline}} + + - : `String`. Indique l'Ă©tat de la [transparence des certificats](https://www.certificate-transparency.org/) pour la connexion. Ceci peut prendre l'une des valeurs suivantes : + + - "not_applicable" + - "policy_compliant" + - "policy_not_enough_scts" + - "policy_not_diverse_scts" + +- `cipherSuite` {{optional_inline}} + - : `String`. Suite de chiffrement utilisĂ©e pour la connexion, formatĂ©e selon la [specification TLS ](https://tools.ietf.org/html/rfc5246#appendix-A.5): par exemple, "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256". +- `errorMessage` {{optional_inline}} + + - : `String`. S'il y a eu un problĂšme avec le protocole TLS (for example, the certificate had expired, or a trusted root could not be found, or a certificate was revoked) then `status` will be "broken" and the `errorMessage` property will contain a string describing the error, taken from Firefox's internal list of error codes. + + Note though that at present you can only call `getSecurityInfo()` in the `onHeaderReceived` listener, and the `onHeaderReceived` event is not fired when the handshake fails. So in practice this will never be set. + +- `hpkp` {{optional_inline}} + - : `Boolean`. `true` si l'hĂŽte utilise [Public Key Pinning](/fr/docs/Web/Security/Public_Key_Pinning), sinon `false`. +- `hsts` {{optional_inline}} + - : `Boolean`. `true` si l'hĂŽte utilise [Strict Transport Security](/fr/docs/SĂ©curitĂ©/HTTP_Strict_Transport_Security), sinon `false`. +- `isDomainMismatch` {{optional_inline}} + - : `Boolean`. `true` si le nom de domaine du serveur ne correspond pas au nom de domaine dans son certificat, sinon `false`. +- `isExtendedValidation` {{optional_inline}} + - : `Boolean`. `true` si le serveur possĂšde un [Extended Validation Certificate](https://en.wikipedia.org/wiki/Extended_Validation_Certificate), sinon `false`. +- `isNotValidAtThisTime` {{optional_inline}} + - : `Boolean`. `true` si l'heure actuelle tombe en dehors de la pĂ©riode de validitĂ© du certificat de serveur (c'est-Ă -dire que le certificat a expirĂ© ou n'est pas encore valide), sinon `false`. +- `isUntrusted` {{optional_inline}} + - : `Boolean`. `true` si une chaĂźne de retour Ă un certificat racine de confiance n'a pas pu ĂȘtre construite, sinon `false`. +- `keaGroupName` {{optional_inline}} + - : `String`. Si `state` est "sĂ©curisĂ©" cela dĂ©crit l'algorithme d'Ă©change de clĂ© utilisĂ© dans cette requĂȘte. +- `protocolVersion` {{optional_inline}} + + - : `String`. Version du protocole TLS utilisĂ©. L'un des : + + - "TLSv1" + - "TLSv1.1" + - "TLSv1.2" + - "TLSv1.3" + - "inconnu" (si la version n'est pas valide) + +- `signatureSchemeName` {{optional_inline}} + - : `String`. Si `state` est "sĂ©curisĂ©", cela dĂ©crit le schĂ©ma de signature utilisĂ© dans cette requĂȘte.t. +- `state` + + - : `String`. Ătat de la connexion. L'un des : + + - "broken": la poignĂ©e de main TLS a Ă©chouĂ© (par exemple, le certificat a expirĂ©) + - "insecure": la connexion n'est pas une connexion TLS + - "secure": la connexion est une connexion TLS sĂ©curisĂ©e + - "weak": la connexion est une connexion TLS mais est considĂ©rĂ©e comme faible. Vous pouvez examiner les `weaknessReasons` pour dĂ©couvrir le problĂšme. + + Notez cependant qu'actuellement, vous ne pouvez appele `getSecurityInfo()` que dans l'Ă©couteur `onHeaderReceived`, et l'Ă©vĂ©nement `onHeaderReceived` n'est pas dĂ©clenchĂ© lorsque la poignĂ©e de main Ă©choue. Ainsi, dans la pratique, il ne sera jamais rĂ©glĂ© sur "cassĂ©". + +- `weaknessReasons` {{optional_inline}} + - : `String`. Si l'`Ă©tat` est "faible", cela indique la raison. Actuellement, il ne peut contenir qu'une seule valeur "chiffre", ce qui indique que la suite de chiffres nĂ©gociĂ©e est considĂ©rĂ©e comme faible. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.webRequest.SecurityInfo", 10)}} + +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/close/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/close/index.md index a96fd5ef96..af87463a5f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/close/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/close/index.md @@ -10,41 +10,43 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/close --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ferme la demande. AprĂšs cet appel, aucune autre donnĂ©e de rĂ©ponse ne sera transmise au moteur de rendu du navigateur et aucun autre Ă©vĂ©nement de filtrage ne sera donnĂ© Ă l'extension.</p> +Ferme la demande. AprĂšs cet appel, aucune autre donnĂ©e de rĂ©ponse ne sera transmise au moteur de rendu du navigateur et aucun autre Ă©vĂ©nement de filtrage ne sera donnĂ© Ă l'extension. -<p>Notez la diffĂ©rence entre cette fonction et {{WebExtAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}}. Avec <code>disconnect()</code>, le navigateur continuera Ă traiter d'autres donnĂ©es de rĂ©ponse, mais il ne sera pas accessible par le filtre. Avec <code>close()</code>, le navigateur ignorera toutes les donnĂ©es de rĂ©ponse qui n'ont pas dĂ©jĂ Ă©tĂ© transmises au moteur de rendu.</p> +Notez la diffĂ©rence entre cette fonction et {{WebExtAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}}. Avec `disconnect()`, le navigateur continuera Ă traiter d'autres donnĂ©es de rĂ©ponse, mais il ne sera pas accessible par le filtre. Avec `close()`, le navigateur ignorera toutes les donnĂ©es de rĂ©ponse qui n'ont pas dĂ©jĂ Ă©tĂ© transmises au moteur de rendu. -<p>Vous devriez toujours appeler <code>close()</code> ou <code>disconnect()</code> une fois que vous n'avez plus besoin d'interagir avec la rĂ©ponse.</p> +Vous devriez toujours appeler `close()` ou `disconnect()` une fois que vous n'avez plus besoin d'interagir avec la rĂ©ponse. -<p>Vous ne pouvez pas appeler cette fonction avant que l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onstart", "onstart")}} ne soit dĂ©clenchĂ©.</p> +Vous ne pouvez pas appeler cette fonction avant que l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onstart", "onstart")}} ne soit dĂ©clenchĂ©. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">filter.close() -</pre> +```js +filter.close() +``` -<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>None.</p> +None. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.StreamFilter.close", 10)}}</p> +{{Compat("webextensions.api.webRequest.StreamFilter.close", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple remplacera le contenu de la page par "texte de remplacement" :</p> +Cet exemple remplacera le contenu de la page par "texte de remplacement" : -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); - filter.onstart = event => { + filter.onstart = event => { console.log("started"); let encoder = new TextEncoder(); filter.write(encoder.encode("replacement content")); @@ -56,6 +58,7 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.org/"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/disconnect/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/disconnect/index.md index e2547a136d..57c741709a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/disconnect/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/disconnect/index.md @@ -10,45 +10,39 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/disconnect --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}DĂ©connecte le filtre de la requĂȘte. AprĂšs cela, le navigateur continuera Ă traiter la rĂ©ponse, mais plus aucun Ă©vĂ©nement de filtrage ne se dĂ©clenchera, et plus aucun appel de fonction de filtrage n'aura d'effet.Notez la diffĂ©rence entre cette fonction et {{WebExtAPIRef("webRequest.StreamFilter.close()", "close()")}}. Avec `disconnect()`, le navigateur continuera Ă traiter d'autres donnĂ©es de rĂ©ponse, mais il ne sera pas accessible par le filtre. Avec `close()`, le navigateur ignorera toutes les donnĂ©es de rĂ©ponse qui n'ont pas dĂ©jĂ Ă©tĂ© transmises au moteur de rendu. -<div>DĂ©connecte le filtre de la requĂȘte. AprĂšs cela, le navigateur continuera Ă traiter la rĂ©ponse, mais plus aucun Ă©vĂ©nement de filtrage ne se dĂ©clenchera, et plus aucun appel de fonction de filtrage n'aura d'effet.</div> +Vous devriez toujours appeler `disconnect()` ou `close()` une fois que vous n'avez plus besoin d'interagir avec la rĂ©ponse. -<div></div> +Vous ne pouvez pas appeler cette fonction avant que l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onstart", "onstart")}} ne soit dĂ©clenchĂ©. -<div>Notez la diffĂ©rence entre cette fonction et {{WebExtAPIRef("webRequest.StreamFilter.close()", "close()")}}. Avec <code>disconnect()</code>, le navigateur continuera Ă traiter d'autres donnĂ©es de rĂ©ponse, mais il ne sera pas accessible par le filtre. Avec <code>close()</code>, le navigateur ignorera toutes les donnĂ©es de rĂ©ponse qui n'ont pas dĂ©jĂ Ă©tĂ© transmises au moteur de rendu.</div> +## Syntaxe -<div></div> +```js +filter.disconnect() +``` -<p>Vous devriez toujours appeler <code>disconnect()</code> ou <code>close()</code> une fois que vous n'avez plus besoin d'interagir avec la rĂ©ponse.</p> +### ParamĂštres -<p>Vous ne pouvez pas appeler cette fonction avant que l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onstart", "onstart")}} ne soit dĂ©clenchĂ©.</p> +None. -<h2 id="Syntaxe">Syntaxe</h2> +### Valeur retournĂ©e -<pre class="brush: js">filter.disconnect() -</pre> +None. -<h3 id="ParamĂštres">ParamĂštres</h3> +## CompatibilitĂ© du navigateur -<p>None.</p> +{{Compat("webextensions.api.webRequest.StreamFilter.disconnect", 10)}} -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +## Exemples -<p>None.</p> +Cet exemple prĂ©cĂšdera "preface text" au corps de la rĂ©ponse. Il se dĂ©connecte ensuite, de sorte que le corps de rĂ©ponse d'origine se charge normalement : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.webRequest.StreamFilter.disconnect", 10)}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Cet exemple prĂ©cĂšdera "preface text" au corps de la rĂ©ponse. Il se dĂ©connecte ensuite, de sorte que le corps de rĂ©ponse d'origine se charge normalement :</p> - -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); - filter.onstart = event => { + filter.onstart = event => { console.log("started"); let encoder = new TextEncoder(); filter.write(encoder.encode("preface text")); @@ -60,6 +54,7 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.org/"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/error/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/error/index.md index 231af486e9..ea9754e290 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/error/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/error/index.md @@ -11,24 +11,23 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/error --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div> -<p>Une chaĂźne de caractĂšres qui contiendra un message d'erreur aprĂšs le dĂ©clenchement de l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onerror", "onerror")}}.</p> -</div> +Une chaĂźne de caractĂšres qui contiendra un message d'erreur aprĂšs le dĂ©clenchement de l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onerror", "onerror")}}. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.StreamFilter.error", 10)}}</p> +{{Compat("webextensions.api.webRequest.StreamFilter.error", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple ajoute un Ă©couteur {{WebExtAPIRef("webRequest.StreamFilter.onerror", "onerror")}} qui enregistre la valeur de <code>error</code>.</p> +Cet exemple ajoute un Ă©couteur {{WebExtAPIRef("webRequest.StreamFilter.onerror", "onerror")}} qui enregistre la valeur de `error`. -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData("12345"); - filter.onerror = event => { + filter.onerror = event => { console.log(`Error: ${filter.error}`); } @@ -37,8 +36,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/error browser.webRequest.onBeforeRequest.addListener( listener, - {urls: ["<all_urls>"], types: ["main_frame"]}, + {urls: ["<all_urls>"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/index.md index 5e80064be0..a15d8903f4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/index.md @@ -14,100 +14,95 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un <code>StreamFilter</code> est un objet que vous pouvez utiliser pour surveiller et modifier les rĂ©ponses HTTP.</p> +Un `StreamFilter` est un objet que vous pouvez utiliser pour surveiller et modifier les rĂ©ponses HTTP. -<p>Pour crĂ©er un <code>StreamFilter</code>, appelez {{WebExtAPIRef("webRequest.filterResponseData()")}}, en lui passant l'ID de la requĂȘte web que vous voulez filtrer.</p> +Pour crĂ©er un `StreamFilter`, appelez {{WebExtAPIRef("webRequest.filterResponseData()")}}, en lui passant l'ID de la requĂȘte web que vous voulez filtrer. -<p>Vous pouvez imaginer le filtre de flux entre la pile rĂ©seau et le moteur de rendu du navigateur. Le filtre passe les donnĂ©es de rĂ©ponse HTTP au fur et Ă mesure qu'il est reçu du rĂ©seau, et peut examiner et modifier les donnĂ©es avant de les transmettre au moteur de rendu, oĂč elles seront analysĂ©es et rendues.</p> +Vous pouvez imaginer le filtre de flux entre la pile rĂ©seau et le moteur de rendu du navigateur. Le filtre passe les donnĂ©es de rĂ©ponse HTTP au fur et Ă mesure qu'il est reçu du rĂ©seau, et peut examiner et modifier les donnĂ©es avant de les transmettre au moteur de rendu, oĂč elles seront analysĂ©es et rendues. -<p>Le filtre gĂ©nĂšre quatre Ă©vĂ©nements diffĂ©rents :</p> +Le filtre gĂ©nĂšre quatre Ă©vĂ©nements diffĂ©rents : -<ul> - <li>{{WebEXTAPIRef("webRequest.StreamFilter.onstart", "onstart")}} lorsque le filtre est sur le point de commencer Ă recevoir les donnĂ©es de rĂ©ponse.</li> - <li>{{WebEXTAPIRef("webRequest.StreamFilter.ondata", "ondata")}} lorsque des donnĂ©es de rĂ©ponse ont Ă©tĂ© reçues par le filtre et sont disponibles pour ĂȘtre examinĂ©es ou modifiĂ©es.</li> - <li>{{WebEXTAPIRef("webRequest.StreamFilter.onstop", "onstop")}} lorsque le filtre a fini de recevoir les donnĂ©es de rĂ©ponse.</li> - <li>{{WebEXTAPIRef("webRequest.StreamFilter.onerror", "onerror")}} si une erreur s'est produite lors de l'initialisation et de l'utilisation du filtre.</li> -</ul> +- {{WebEXTAPIRef("webRequest.StreamFilter.onstart", "onstart")}} lorsque le filtre est sur le point de commencer Ă recevoir les donnĂ©es de rĂ©ponse. +- {{WebEXTAPIRef("webRequest.StreamFilter.ondata", "ondata")}} lorsque des donnĂ©es de rĂ©ponse ont Ă©tĂ© reçues par le filtre et sont disponibles pour ĂȘtre examinĂ©es ou modifiĂ©es. +- {{WebEXTAPIRef("webRequest.StreamFilter.onstop", "onstop")}} lorsque le filtre a fini de recevoir les donnĂ©es de rĂ©ponse. +- {{WebEXTAPIRef("webRequest.StreamFilter.onerror", "onerror")}} si une erreur s'est produite lors de l'initialisation et de l'utilisation du filtre. -<p>Vous pouvez Ă©couter chaque Ă©vĂ©nement en assignant une fonction d'Ă©coute Ă son attribut :</p> +Vous pouvez Ă©couter chaque Ă©vĂ©nement en assignant une fonction d'Ă©coute Ă son attribut : -<pre class="brush: js">filter.onstart = event => { +```js +filter.onstart = event => { console.log("started"); -}</pre> +} +``` + +Notez que la demande est bloquĂ©e pendant l'exĂ©cution de n'importe quel auditeur d'Ă©vĂ©nement. -<p>Notez que la demande est bloquĂ©e pendant l'exĂ©cution de n'importe quel auditeur d'Ă©vĂ©nement.</p> +Le filtre fournit une fonction {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}. A tout moment Ă partir de l'Ă©vĂ©nement `onstart`, vous pouvez utiliser cette fonction pour Ă©crire des donnĂ©es dans le flux de sortie. -<p>Le filtre fournit une fonction {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}. A tout moment Ă partir de l'Ă©vĂ©nement <code>onstart</code>, vous pouvez utiliser cette fonction pour Ă©crire des donnĂ©es dans le flux de sortie.</p> +Si vous assignez des auditeurs Ă l'un des Ă©vĂ©nements du filtre, alors toutes les donnĂ©es de rĂ©ponse transmises au moteur de rendu seront fournies par les appels que vous faites pour `write()`: donc si vous ajoutez un auditeur mais n'appelez pas `write()`, alors la page rendue sera vide. -<p>Si vous assignez des auditeurs Ă l'un des Ă©vĂ©nements du filtre, alors toutes les donnĂ©es de rĂ©ponse transmises au moteur de rendu seront fournies par les appels que vous faites pour <code>write()</code>: donc si vous ajoutez un auditeur mais n'appelez pas <code>write()</code>, alors la page rendue sera vide.</p> +Une fois que vous avez terminĂ© d'interagir avec la rĂ©ponse, vous appelez l'un ou l'autre des Ă©lĂ©ments suivants : -<p>Une fois que vous avez terminĂ© d'interagir avec la rĂ©ponse, vous appelez l'un ou l'autre des Ă©lĂ©ments suivants :</p> +- {{WebEXTAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}} : Cela dĂ©connecte le filtre de la requĂȘte, de sorte que le reste de la rĂ©ponse est traitĂ© normalement. +- {{WebEXTAPIRef("webRequest.StreamFilter.close()", "close()")}}: Cela met fin Ă la demande, de sorte qu'aucune donnĂ©e de rĂ©ponse supplĂ©mentaire ne sera traitĂ©e. -<ul> - <li>{{WebEXTAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}} : Cela dĂ©connecte le filtre de la requĂȘte, de sorte que le reste de la rĂ©ponse est traitĂ© normalement.</li> - <li>{{WebEXTAPIRef("webRequest.StreamFilter.close()", "close()")}}: Cela met fin Ă la demande, de sorte qu'aucune donnĂ©e de rĂ©ponse supplĂ©mentaire ne sera traitĂ©e.</li> -</ul> +Le filtre fournit Ă©galement des fonctions Ă {{WebEXTAPIRef("webRequest.StreamFilter.suspend()", "suspend()")}} et {{WebEXTAPIRef("webRequest.StreamFilter.resume()", "resume()")}} la requĂȘte. -<p>Le filtre fournit Ă©galement des fonctions Ă {{WebEXTAPIRef("webRequest.StreamFilter.suspend()", "suspend()")}} et {{WebEXTAPIRef("webRequest.StreamFilter.resume()", "resume()")}} la requĂȘte.</p> +## MĂ©thodes -<h2 id="MĂ©thodes">MĂ©thodes</h2> +- {{WebExtAPIRef("webRequest.StreamFilter.close()")}} + - : Ferme la demande. +- {{WebExtAPIRef("webRequest.StreamFilter.disconnect()")}} + - : DĂ©connecte le filtre de la requĂȘte. +- {{WebExtAPIRef("webRequest.StreamFilter.resume()")}} + - : Reprend le traitement de la demande. -<dl> - <dt>{{WebExtAPIRef("webRequest.StreamFilter.close()")}}</dt> - <dd>Ferme la demande.</dd> - <dt>{{WebExtAPIRef("webRequest.StreamFilter.disconnect()")}}</dt> - <dd>DĂ©connecte le filtre de la requĂȘte.</dd> - <dt>{{WebExtAPIRef("webRequest.StreamFilter.resume()")}}</dt> - <dd>Reprend le traitement de la demande.</dd> -</dl> +<!----> -<dl> - <dt>{{WebExtAPIRef("webRequest.StreamFilter.suspend()")}}</dt> - <dd>Suspend le traitement de la demande.</dd> - <dt>{{WebExtAPIRef("webRequest.StreamFilter.write()")}}</dt> - <dd>Ăcrit quelques donnĂ©es dans le flux de sortie.</dd> -</dl> +- {{WebExtAPIRef("webRequest.StreamFilter.suspend()")}} + - : Suspend le traitement de la demande. +- {{WebExtAPIRef("webRequest.StreamFilter.write()")}} + - : Ăcrit quelques donnĂ©es dans le flux de sortie. -<h2 id="PropriĂ©tĂ©s">PropriĂ©tĂ©s</h2> +## PropriĂ©tĂ©s -<dl> - <dt>{{WebExtAPIRef("webRequest.StreamFilter.ondata")}}</dt> - <dd>Gestionnaire d'Ă©vĂ©nements qui est appelĂ© lorsque les donnĂ©es entrantes sont disponibles.</dd> - <dt>{{WebExtAPIRef("webRequest.StreamFilter.onerror")}}</dt> - <dd>Gestionnaire d'Ă©vĂ©nements qui est appelĂ© lorsqu'une erreur s'est produite.</dd> - <dt>{{WebExtAPIRef("webRequest.StreamFilter.onstart")}}</dt> - <dd>Gestionnaire d'Ă©vĂ©nements qui est appelĂ© lorsque le flux est sur le point de commencer Ă recevoir des donnĂ©es.</dd> - <dt>{{WebExtAPIRef("webRequest.StreamFilter.onstop")}}</dt> - <dd>Gestionnaire d'Ă©vĂ©nements qui est appelĂ© lorsque le flux n'a plus de donnĂ©es Ă livrer et qu'il s'est fermĂ©.</dd> - <dt>{{WebExtAPIRef("webRequest.StreamFilter.error")}}</dt> - <dd>Quand {{WebExtAPIRef("webRequest.StreamFilter.onerror")}} est appelĂ©, cela dĂ©crira l'erreur.</dd> - <dt>{{WebExtAPIRef("webRequest.StreamFilter.status")}}</dt> - <dd>DĂ©crit l'Ă©tat actuel du flux.</dd> -</dl> +- {{WebExtAPIRef("webRequest.StreamFilter.ondata")}} + - : Gestionnaire d'Ă©vĂ©nements qui est appelĂ© lorsque les donnĂ©es entrantes sont disponibles. +- {{WebExtAPIRef("webRequest.StreamFilter.onerror")}} + - : Gestionnaire d'Ă©vĂ©nements qui est appelĂ© lorsqu'une erreur s'est produite. +- {{WebExtAPIRef("webRequest.StreamFilter.onstart")}} + - : Gestionnaire d'Ă©vĂ©nements qui est appelĂ© lorsque le flux est sur le point de commencer Ă recevoir des donnĂ©es. +- {{WebExtAPIRef("webRequest.StreamFilter.onstop")}} + - : Gestionnaire d'Ă©vĂ©nements qui est appelĂ© lorsque le flux n'a plus de donnĂ©es Ă livrer et qu'il s'est fermĂ©. +- {{WebExtAPIRef("webRequest.StreamFilter.error")}} + - : Quand {{WebExtAPIRef("webRequest.StreamFilter.onerror")}} est appelĂ©, cela dĂ©crira l'erreur. +- {{WebExtAPIRef("webRequest.StreamFilter.status")}} + - : DĂ©crit l'Ă©tat actuel du flux. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.StreamFilter", 10)}}</p> +{{Compat("webextensions.api.webRequest.StreamFilter", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Ce code Ă©coute pour <code>onstart</code>, <code>ondata</code> et <code>onstop</code>. Il enregistre simplement ces Ă©vĂ©nements et les donnĂ©es de rĂ©ponse elles-mĂȘmes :</p> +Ce code Ă©coute pour `onstart`, `ondata` et `onstop`. Il enregistre simplement ces Ă©vĂ©nements et les donnĂ©es de rĂ©ponse elles-mĂȘmes : -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); - filter.onstart = event => { + filter.onstart = event => { console.log("started"); } - filter.ondata = event => { + filter.ondata = event => { console.log(event.data); filter.write(event.data); } - filter.onstop = event => { + filter.onstop = event => { console.log("finished"); filter.disconnect(); } @@ -119,6 +114,7 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.org/"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/ondata/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/ondata/index.md index 46483be6e3..0dd7fd0354 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/ondata/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/ondata/index.md @@ -13,22 +13,23 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/ondata --- -<div>{{AddonSidebar()}} -<p>Un gestionnaire d'Ă©vĂ©nements qui sera appelĂ© Ă plusieurs reprises lorsque les donnĂ©es de rĂ©ponse sont disponibles. Le gestionnaire est passĂ© un objet <code>event</code> qui contient une propriĂ©tĂ© de <code>data</code>, qui contient un morceau des donnĂ©es de rĂ©ponse sous la forme d'un {{domxref("ArrayBuffer")}}.</p> -</div> +{{AddonSidebar()}} -<h2 id="Exemples">Exemples</h2> +Un gestionnaire d'Ă©vĂ©nements qui sera appelĂ© Ă plusieurs reprises lorsque les donnĂ©es de rĂ©ponse sont disponibles. Le gestionnaire est passĂ© un objet `event` qui contient une propriĂ©tĂ© de `data`, qui contient un morceau des donnĂ©es de rĂ©ponse sous la forme d'un {{domxref("ArrayBuffer")}}. -<p>Cet exemple ajoute un Ă©couteur <code>ondata</code> qui remplace "Example" dans la rĂ©ponse par "WebExtension Example".</p> +## Exemples -<p>Notez que cet exemple ne fonctionne que pour les occurrences de "Example" qui sont entiĂšrement contenues dans un bloc de donnĂ©es, et non celles qui chevauchent deux morceaux (ce qui peut arriver ~0.1% du temps pour les gros documents). De plus, il ne traite que les documents codĂ©s UTF-8. Une vĂ©ritable mise en Ćuvre de ce projet devrait ĂȘtre plus complexe.</p> +Cet exemple ajoute un Ă©couteur `ondata` qui remplace "Example" dans la rĂ©ponse par "WebExtension Example". -<pre class="brush: js">function listener(details) { +Notez que cet exemple ne fonctionne que pour les occurrences de "Example" qui sont entiĂšrement contenues dans un bloc de donnĂ©es, et non celles qui chevauchent deux morceaux (ce qui peut arriver \~0.1% du temps pour les gros documents). De plus, il ne traite que les documents codĂ©s UTF-8. Une vĂ©ritable mise en Ćuvre de ce projet devrait ĂȘtre plus complexe. + +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); let decoder = new TextDecoder("utf-8"); let encoder = new TextEncoder(); - filter.ondata = event => { + filter.ondata = event => { let str = decoder.decode(event.data, {stream: true}); // Just change any instance of Example in the HTTP response // to WebExtension Example. @@ -40,7 +41,7 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/ondata // the chunk boundary! } - filter.onstop = event => { + filter.onstop = event => { filter.close(); } @@ -51,34 +52,36 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.com/*"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>Un autre exemple pour le traitement de documents volumineux :</p> +Un autre exemple pour le traitement de documents volumineux : -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); let decoder = new TextDecoder("utf-8"); let encoder = new TextEncoder(); let data = []; - filter.ondata = event => { + filter.ondata = event => { data.push(event.data); }; - filter.onstop = event => { + filter.onstop = event => { let str = ""; if (data.length == 1) { str = decoder.decode(data[0]); } else { - for (let i = 0; i < data.length; i++) { + for (let i = 0; i < data.length; i++) { let stream = (i == data.length - 1) ? false : true; str += decoder.decode(data[i], {stream}); } } // Just change any instance of Example in the HTTP response // to WebExtension Example. - str = str.replace(/Example/g, 'WebExtension $&'); + str = str.replace(/Example/g, 'WebExtension $&'); filter.write(encoder.encode(str)); filter.close(); }; @@ -88,27 +91,29 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.com/"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>L'exemple ci-dessus peut aussi s'Ă©crire ainsi :</p> +L'exemple ci-dessus peut aussi s'Ă©crire ainsi : -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); let decoder = new TextDecoder("utf-8"); let encoder = new TextEncoder(); let data = []; - filter.ondata = event => { + filter.ondata = event => { data.push(decoder.decode(event.data, {stream: true})); }; - filter.onstop = event => { + filter.onstop = event => { data.push(decoder.decode()); let str = data.join(""); // Just change any instance of Example in the HTTP response // to WebExtension Example. - str = str.replace(/Example/g, 'WebExtension $&'); + str = str.replace(/Example/g, 'WebExtension $&'); filter.write(encoder.encode(str)); filter.close(); }; @@ -118,26 +123,28 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.com/"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>Cet exemple utilise un {{domxref("Blob")}}:</p> +Cet exemple utilise un {{domxref("Blob")}}: -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); let encoder = new TextEncoder(); let data = []; - filter.ondata = event => { + filter.ondata = event => { data.push(event.data); }; - filter.onstop = async event => { + filter.onstop = async event => { let blob = new Blob(data, {type: 'text/html'}); let str = await blob.text(); // Just change any instance of Example in the HTTP response // to WebExtension Example. - str = str.replace(/Example/g, 'WebExtension $&'); + str = str.replace(/Example/g, 'WebExtension $&'); filter.write(encoder.encode(str)); filter.close(); }; @@ -147,28 +154,30 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.com/"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>Cet exemple combine tous les tampons en un simple tampon :</p> +Cet exemple combine tous les tampons en un simple tampon : -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); let decoder = new TextDecoder("utf-8"); let encoder = new TextEncoder(); let data = []; - filter.ondata = event => { + filter.ondata = event => { data.push(new Uint8Array(event.data)); }; - filter.onstop = event => { + filter.onstop = event => { let combinedLength = 0; for (let buffer of data) { combinedLength += buffer.length; } let combinedArray = new Uint8Array(combinedLength); let writeOffset = 0; - while (writeOffset < combinedLength) { + while (writeOffset < combinedLength) { let buffer = data.shift(); combinedArray.set(buffer, writeOffset); writeOffset += buffer.length; @@ -176,7 +185,7 @@ browser.webRequest.onBeforeRequest.addListener( let str = decoder.decode(combinedArray); // Just change any instance of Example in the HTTP response // to WebExtension Example. - str = str.replace(/Example/g, 'WebExtension $&'); + str = str.replace(/Example/g, 'WebExtension $&'); filter.write(encoder.encode(str)); filter.close(); }; @@ -186,10 +195,11 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.com/"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.StreamFilter.ondata", 10)}}</p> +{{Compat("webextensions.api.webRequest.StreamFilter.ondata", 10)}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onerror/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onerror/index.md index d8f398ffa9..1c4ee505b1 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onerror/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onerror/index.md @@ -11,28 +11,27 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/onerror --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div> -<p>Un gestionnaire d'Ă©vĂ©nements qui sera appelĂ© lorsqu'une erreur se produit. C'est le plus souvent parce qu'un ID de requĂȘte invalide a Ă©tĂ© passĂ© dans {{WebExtAPIRef("webRequest.filterResponseData()")}}.</p> +Un gestionnaire d'Ă©vĂ©nements qui sera appelĂ© lorsqu'une erreur se produit. C'est le plus souvent parce qu'un ID de requĂȘte invalide a Ă©tĂ© passĂ© dans {{WebExtAPIRef("webRequest.filterResponseData()")}}. -<p>AprĂšs le dĂ©clenchement de cet Ă©vĂ©nement, la propriĂ©tĂ© {{WebExtAPIRef("webRequest.StreamFilter.error")}} contiendra un message donnant plus d'informations sur l'erreur.</p> +AprĂšs le dĂ©clenchement de cet Ă©vĂ©nement, la propriĂ©tĂ© {{WebExtAPIRef("webRequest.StreamFilter.error")}} contiendra un message donnant plus d'informations sur l'erreur. -<p>Notez que cet Ă©vĂ©nement n'est <em>pas</em> dĂ©clenchĂ© pour les erreurs rĂ©seau.</p> -</div> +Notez que cet Ă©vĂ©nement n'est _pas_ dĂ©clenchĂ© pour les erreurs rĂ©seau. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.StreamFilter.onerror", 10)}}</p> +{{Compat("webextensions.api.webRequest.StreamFilter.onerror", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple ajoute un Ă©couteur <code>onerror</code> qui enregistre la valeur de {{WebExtAPIRef("webRequest.StreamFilter.error")}}.</p> +Cet exemple ajoute un Ă©couteur `onerror` qui enregistre la valeur de {{WebExtAPIRef("webRequest.StreamFilter.error")}}. -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData("12345"); - filter.onerror = event => { + filter.onerror = event => { console.log(`Error: ${filter.error}`); } @@ -41,9 +40,9 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/onerro browser.webRequest.onBeforeRequest.addListener( listener, - {urls: ["<all_urls>"], types: ["main_frame"]}, + {urls: ["<all_urls>"], types: ["main_frame"]}, ["blocking"] ); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onstart/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onstart/index.md index 8d698238f0..ba704ac5b7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onstart/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onstart/index.md @@ -11,24 +11,23 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/onstart --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div> -<p>Un gestionnaire d'Ă©vĂ©nements qui sera appelĂ© lorsque le flux est ouvert et est sur le point de commencer Ă livrer les donnĂ©es. A partir de ce point, l'extension peut utiliser des fonctions de filtrage telles que {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}, {{WebExtAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}}, ou {{WebExtAPIRef("webRequest.StreamFilter.close()", "close()")}}.</p> -</div> +Un gestionnaire d'Ă©vĂ©nements qui sera appelĂ© lorsque le flux est ouvert et est sur le point de commencer Ă livrer les donnĂ©es. A partir de ce point, l'extension peut utiliser des fonctions de filtrage telles que {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}, {{WebExtAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}}, ou {{WebExtAPIRef("webRequest.StreamFilter.close()", "close()")}}. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.StreamFilter.onstart", 10)}}</p> +{{Compat("webextensions.api.webRequest.StreamFilter.onstart", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple remplacera le contenu de la page par "texte de remplacement" :</p> +Cet exemple remplacera le contenu de la page par "texte de remplacement" : -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); - filter.onstart = event => { + filter.onstart = event => { console.log("started"); let encoder = new TextEncoder(); filter.write(encoder.encode("replacement content")); @@ -40,6 +39,7 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.org/"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onstop/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onstop/index.md index 1ae77d7ce5..af5fa88166 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onstop/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/onstop/index.md @@ -11,30 +11,29 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/onstop --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div> -<p>Un gestionnaire d'Ă©vĂ©nements qui sera appelĂ© lorsque le flux n'a plus de donnĂ©es Ă livrer. IDans le gestionnaire d'Ă©vĂ©nements, vous pouvez toujours appeler des fonctions de filtrage telles que {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}, {{WebExtAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}}, ou {{WebExtAPIRef("webRequest.StreamFilter.close()", "close()")}}.</p> -</div> +Un gestionnaire d'Ă©vĂ©nements qui sera appelĂ© lorsque le flux n'a plus de donnĂ©es Ă livrer. IDans le gestionnaire d'Ă©vĂ©nements, vous pouvez toujours appeler des fonctions de filtrage telles que {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}, {{WebExtAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}}, ou {{WebExtAPIRef("webRequest.StreamFilter.close()", "close()")}}. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.StreamFilter.onstop", 10)}}</p> +{{Compat("webextensions.api.webRequest.StreamFilter.onstop", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple ajoutera des "extra stuff" Ă la rĂ©ponse :</p> +Cet exemple ajoutera des "extra stuff" Ă la rĂ©ponse : -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); let encoder = new TextEncoder(); - filter.ondata = event => { + filter.ondata = event => { // pass through all the response data filter.write(event.data); } - filter.onstop = event => { + filter.onstop = event => { filter.write(encoder.encode("extra stuff")); filter.disconnect(); } @@ -44,6 +43,7 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.com/*"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/resume/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/resume/index.md index 53fbef7737..9028cb0696 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/resume/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/resume/index.md @@ -11,40 +11,42 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/resume --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Reprend une requĂȘte qui a Ă©tĂ© prĂ©cĂ©demment suspendue par un appel Ă {{WebExtAPIRef("webRequest.StreamFilter.suspend()", "suspend()")}}.</p> +Reprend une requĂȘte qui a Ă©tĂ© prĂ©cĂ©demment suspendue par un appel Ă {{WebExtAPIRef("webRequest.StreamFilter.suspend()", "suspend()")}}. -<p>Vous ne pouvez pas appeler cette fonction avant que l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onstart", "onstart")}} ne soit dĂ©clenchĂ©.</p> +Vous ne pouvez pas appeler cette fonction avant que l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onstart", "onstart")}} ne soit dĂ©clenchĂ©. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">filter.suspend() -</pre> +```js +filter.suspend() +``` -<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>None.</p> +None. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.StreamFilter.suspend", 10)}}</p> +{{Compat("webextensions.api.webRequest.StreamFilter.suspend", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple utilise la <em>suspend/resume</em> pour retarder une requĂȘte web</p> +Cet exemple utilise la _suspend/resume_ pour retarder une requĂȘte web -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); - filter.onstart = event => { + filter.onstart = event => { filter.suspend(); - setTimeout(() => { + setTimeout(() => { filter.resume(); filter.disconnect(); }, 1000); @@ -56,6 +58,7 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.org/"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/status/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/status/index.md index a235d323c2..e4c4fce7d2 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/status/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/status/index.md @@ -11,50 +11,47 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/status --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<div> -<p>Une chaĂźne de caractĂšres qui dĂ©crit l'Ă©tat actuel de la demande. Ce sera l'une des valeurs suivantes :</p> +Une chaĂźne de caractĂšres qui dĂ©crit l'Ă©tat actuel de la demande. Ce sera l'une des valeurs suivantes : -<dl> - <dt><code>"uninitialized"</code></dt> - <dd>Le filtre n'est pas entiĂšrement initialisĂ©. Aucune fonction de filtrage ne peut ĂȘtre appelĂ©e.</dd> - <dt><code>"transferringdata"</code></dt> - <dd>Le canal sous-jacent transfĂšre actuellement des donnĂ©es qui seront acheminĂ©es vers l'extension dans un ou plusieurs Ă©vĂ©nements {{WebExtAPIRef("webRequest.StreamFilter.ondata", "ondata")}}. L'extension peut appeler des fonctions de filtrage telles que {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}, {{WebExtAPIRef("webRequest.StreamFilter.close()", "close()")}}, ou {{WebExtAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}}.</dd> - <dt><code>"finishedtransferringdata"</code></dt> - <dd>Le canal sous-jacent a terminĂ© le transfert des donnĂ©es. Dans cet Ă©tat, l'extension peut toujours Ă©crire des donnĂ©es de rĂ©ponse en utilisant la fonction {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}  du filtre.</dd> - <dt><code>"suspended"</code></dt> - <dd> Le transfert de donnĂ©es est actuellement suspendu. Dans cet Ă©tat, l'extension peut reprendre la requĂȘte en appelant la fonction {{WebExtAPIRef("webRequest.StreamFilter.resume()", "resume()")}} et peut Ă©crire les donnĂ©es de rĂ©ponse en utilisant la fonction {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}  du filtre.</dd> - <dt><code>"closed"</code></dt> - <dd>L'extension a fermĂ© la requĂȘte en appelant la fonction {{WebExtAPIRef("webRequest.StreamFilter.close()", "close()")}} du filtre. Le filtre ne dĂ©clenchera plus d'Ă©vĂ©nements, et l'extension ne peut pas appeler de fonctions de filtrage.</dd> - <dt><code>"disconnected"</code></dt> - <dd> L'extension a dĂ©connectĂ© le filtre de la requĂȘte en appelant la fonction {{WebExtAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}} du filtre. Toutes les autres donnĂ©es seront livrĂ©es directement, sans passer par le filtre. Le filtre ne dĂ©clenchera plus d'Ă©vĂ©nements, et l'extension ne peut pas appeler de fonctions de filtrage.</dd> - <dt><code>"failed"</code></dt> - <dd>Une erreur s'est produite et le filtre a Ă©tĂ© dĂ©connectĂ© de la requĂȘte. L'extension peut trouver un message d'erreur dans {{WebExtAPIRef("webRequest.StreamFilter.error", "error")}}, et ne peut appeler aucune fonction de filtrage.</dd> -</dl> -</div> +- `"uninitialized"` + - : Le filtre n'est pas entiĂšrement initialisĂ©. Aucune fonction de filtrage ne peut ĂȘtre appelĂ©e. +- `"transferringdata"` + - : Le canal sous-jacent transfĂšre actuellement des donnĂ©es qui seront acheminĂ©es vers l'extension dans un ou plusieurs Ă©vĂ©nements {{WebExtAPIRef("webRequest.StreamFilter.ondata", "ondata")}}. L'extension peut appeler des fonctions de filtrage telles que {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}, {{WebExtAPIRef("webRequest.StreamFilter.close()", "close()")}}, ou {{WebExtAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}}. +- `"finishedtransferringdata"` + - : Le canal sous-jacent a terminĂ© le transfert des donnĂ©es. Dans cet Ă©tat, l'extension peut toujours Ă©crire des donnĂ©es de rĂ©ponse en utilisant la fonction {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}  du filtre. +- `"suspended"` + - :  Le transfert de donnĂ©es est actuellement suspendu. Dans cet Ă©tat, l'extension peut reprendre la requĂȘte en appelant la fonction {{WebExtAPIRef("webRequest.StreamFilter.resume()", "resume()")}} et peut Ă©crire les donnĂ©es de rĂ©ponse en utilisant la fonction {{WebExtAPIRef("webRequest.StreamFilter.write()", "write()")}}  du filtre. +- `"closed"` + - : L'extension a fermĂ© la requĂȘte en appelant la fonction {{WebExtAPIRef("webRequest.StreamFilter.close()", "close()")}} du filtre. Le filtre ne dĂ©clenchera plus d'Ă©vĂ©nements, et l'extension ne peut pas appeler de fonctions de filtrage. +- `"disconnected"` + - :  L'extension a dĂ©connectĂ© le filtre de la requĂȘte en appelant la fonction {{WebExtAPIRef("webRequest.StreamFilter.disconnect()", "disconnect()")}} du filtre. Toutes les autres donnĂ©es seront livrĂ©es directement, sans passer par le filtre. Le filtre ne dĂ©clenchera plus d'Ă©vĂ©nements, et l'extension ne peut pas appeler de fonctions de filtrage. +- `"failed"` + - : Une erreur s'est produite et le filtre a Ă©tĂ© dĂ©connectĂ© de la requĂȘte. L'extension peut trouver un message d'erreur dans {{WebExtAPIRef("webRequest.StreamFilter.error", "error")}}, et ne peut appeler aucune fonction de filtrage. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.StreamFilter.status", 10)}}</p> +{{Compat("webextensions.api.webRequest.StreamFilter.status", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); console.log(filter.status); // uninitialized - filter.onstart = event => { + filter.onstart = event => { console.log(filter.status); // transferringdata } - filter.ondata = event => { + filter.ondata = event => { console.log(filter.status); // transferringdata // pass through the response data filter.write(event.data); } - filter.onstop = event => { + filter.onstop = event => { console.log(filter.status); // finishedtransferringdata filter.disconnect(); console.log(filter.status); // disconnected @@ -65,6 +62,7 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.com/*"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/suspend/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/suspend/index.md index 3ea6f9e509..4568f8ad93 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/suspend/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/suspend/index.md @@ -11,40 +11,42 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/suspend --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Suspend une demande. AprĂšs cet appel, plus aucune donnĂ©e ne sera livrĂ©e jusqu'Ă ce que la requĂȘte soit reprise avec un appel Ă {{WebExtAPIRef("webRequest.StreamFilter.resume()", "resume()")}}.</p> +Suspend une demande. AprĂšs cet appel, plus aucune donnĂ©e ne sera livrĂ©e jusqu'Ă ce que la requĂȘte soit reprise avec un appel Ă {{WebExtAPIRef("webRequest.StreamFilter.resume()", "resume()")}}. -<p>Vous ne pouvez pas appeler cette fonction avant que l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onstart", "onstart")}} ne soit dĂ©clenchĂ©.</p> +Vous ne pouvez pas appeler cette fonction avant que l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onstart", "onstart")}} ne soit dĂ©clenchĂ©. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">filter.suspend() -</pre> +```js +filter.suspend() +``` -<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>None.</p> +None. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.StreamFilter.suspend", 10)}}</p> +{{Compat("webextensions.api.webRequest.StreamFilter.suspend", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple utilise la <em>suspend/resume</em> pour retarder une requĂȘte web.</p> +Cet exemple utilise la _suspend/resume_ pour retarder une requĂȘte web. -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); - filter.onstart = event => { + filter.onstart = event => { filter.suspend(); - setTimeout(() => { + setTimeout(() => { filter.resume(); filter.disconnect(); }, 1000); @@ -56,6 +58,7 @@ browser.webRequest.onBeforeRequest.addListener( listener, {urls: ["https://example.org/"], types: ["main_frame"]}, ["blocking"] -);</pre> +); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/write/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/write/index.md index 92146d4f82..d27b9dec5d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/write/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/streamfilter/write/index.md @@ -11,48 +11,40 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/StreamFilter/write --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Ăcrit quelques donnĂ©es de rĂ©ponse dans le flux de sortie..Vous ne pouvez appeler cette fonction qu'aprĂšs le dĂ©clenchement de l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onstart", "onstart")}}. -<div>Ăcrit quelques donnĂ©es de rĂ©ponse dans le flux de sortie..</div> +## Syntaxe -<div></div> - -<div>Vous ne pouvez appeler cette fonction qu'aprĂšs le dĂ©clenchement de l'Ă©vĂ©nement {{WebExtAPIRef("webRequest.StreamFilter.onstart", "onstart")}}.</div> - -<div></div> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">filter.write( +```js +filter.write( data // ArrayBuffer or Uint8Array ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>data</code></dt> - <dd><code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Uint8Array">Uint8Array</a></code> ou <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer">ArrayBuffer</a></code>: tableau d'octets contenant les donnĂ©es Ă transmettre au moteur de rendu du navigateur.</dd> -</dl> +- `data` + - : [`Uint8Array`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Uint8Array) ou [`ArrayBuffer`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer): tableau d'octets contenant les donnĂ©es Ă transmettre au moteur de rendu du navigateur. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +### Valeur retournĂ©e -<p>None.</p> +None. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.StreamFilter.write", 10)}}</p> +{{Compat("webextensions.api.webRequest.StreamFilter.write", 10)}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Cet exemple utilise <code>write()</code> pour remplacer "Example" dans la rĂ©ponse par "WebExtension Example".</p> +Cet exemple utilise `write()` pour remplacer "Example" dans la rĂ©ponse par "WebExtension Example". -<pre class="brush: js">function listener(details) { +```js +function listener(details) { let filter = browser.webRequest.filterResponseData(details.requestId); let decoder = new TextDecoder("utf-8"); let encoder = new TextEncoder(); - filter.ondata = event => { + filter.ondata = event => { let str = decoder.decode(event.data, {stream: true}); // Just change any instance of Example in the HTTP response // to WebExtension Example. @@ -69,6 +61,6 @@ browser.webRequest.onBeforeRequest.addListener( {urls: ["https://example.com/*"], types: ["main_frame"]}, ["blocking"] ); -</pre> +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} diff --git a/files/fr/mozilla/add-ons/webextensions/api/webrequest/uploaddata/index.md b/files/fr/mozilla/add-ons/webextensions/api/webrequest/uploaddata/index.md index eee74f7c58..f68fd0e70c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/webrequest/uploaddata/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/webrequest/uploaddata/index.md @@ -13,36 +13,32 @@ tags: - webRequest translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/UploadData --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Contient les donnĂ©es tĂ©lĂ©chargĂ©es dans une requĂȘte URL..</p> +Contient les donnĂ©es tĂ©lĂ©chargĂ©es dans une requĂȘte URL.. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>bytes</code>{{optional_inline}}</dt> - <dd><code>any</code>. Un ArrayBuffer avec une copie des donnĂ©es.</dd> - <dt><code>file</code>{{optional_inline}}</dt> - <dd><code>string</code>. Une chaĂźne de caractĂšres avec le chemin et le nom du fichier.</dd> -</dl> +- `bytes`{{optional_inline}} + - : `any`. Un ArrayBuffer avec une copie des donnĂ©es. +- `file`{{optional_inline}} + - : `string`. Une chaĂźne de caractĂšres avec le chemin et le nom du fichier. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.webRequest.UploadData")}}</p> +{{Compat("webextensions.api.webRequest.UploadData")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API Chromium [`chrome.webRequest`](https://developer.chrome.com/extensions/webRequest). Cette documentation est dĂ©rivĂ©e de [`web_request.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json) dans le code Chromium. +> +> Les donnĂ©es de compatibilitĂ© relatives Ă Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les Ătats-Unis. -<p>Cette API est basĂ©e sur l'API Chromium <a href="https://developer.chrome.com/extensions/webRequest"><code>chrome.webRequest</code></a>. Cette documentation est dĂ©rivĂ©e de <a href="https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/web_request.json"><code>web_request.json</code></a> dans le code Chromium.</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 @@ -69,5 +65,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/UploadData // 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/windows/create/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/create/index.md index 5d2719df58..1444e97e20 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/create/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/create/index.md @@ -13,81 +13,76 @@ tags: - Windows translation_of: Mozilla/Add-ons/WebExtensions/API/windows/create --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>CrĂ©e une nouvelle fenĂȘtre.</p> +CrĂ©e une nouvelle fenĂȘtre. -<p>Lorsque vous crĂ©ez la fenĂȘtre, vous pouvez :</p> +Lorsque vous crĂ©ez la fenĂȘtre, vous pouvez : -<ul> - <li>Chargez un ou plusieurs nouveaux onglets dans la fenĂȘtre.</li> - <li>DĂ©placez un onglet d'une fenĂȘtre existante dans la nouvelle fenĂȘtre.</li> - <li>RĂ©glez la taille et la position de la fenĂȘtre.</li> - <li>CrĂ©ez une fenĂȘtre de style "panneau" qui, dans ce contexte, dĂ©signe une fenĂȘtre sans l'interface utilisateur UI (barre d'adresse, barre d'outils, etc.).</li> - <li>DĂ©finissez diffĂ©rentes propriĂ©tĂ©s de la fenĂȘtre, par exemple, qu'elle soit concentrĂ©e ou privĂ©e.</li> -</ul> +- Chargez un ou plusieurs nouveaux onglets dans la fenĂȘtre. +- DĂ©placez un onglet d'une fenĂȘtre existante dans la nouvelle fenĂȘtre. +- RĂ©glez la taille et la position de la fenĂȘtre. +- CrĂ©ez une fenĂȘtre de style "panneau" qui, dans ce contexte, dĂ©signe une fenĂȘtre sans l'interface utilisateur UI (barre d'adresse, barre d'outils, etc.). +- DĂ©finissez diffĂ©rentes propriĂ©tĂ©s de la fenĂȘtre, par exemple, qu'elle soit concentrĂ©e ou privĂ©e. -<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 creating = browser.windows.create( +```js +var creating = browser.windows.create( createData // optional object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>createData</code>{{optional_inline}}</dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>allowScriptsToClose</code> {{optional_inline}}</dt> - <dd> - <p><code>boolean</code>. Lorsque la fenĂȘtre est ouverte, elle contiendra un seul onglet, ou plus d'un onglet si <code>url</code> est donnĂ©e et comprendra un tableau contenant plus d'une URL. Par dĂ©faut, les scripts s'exĂ©cutant dans ces pages ne sont pas autorisĂ©s Ă fermer leur onglet en utilisant <code><a href="/fr/docs/Web/API/Window/close">window.close()</a></code>. Si vous incluez <code>allowScriptsToClose</code> et le mettez Ă <code>true</code> ,  alors ce comportement par dĂ©faut est modifiĂ©, de sorte que les scripts peuvent fermer leurs onglets. Notez cela :</p> - - <ul> - <li>Ceci ne s'applique qu'aux onglets qui ont Ă©tĂ© ouverts lors de la crĂ©ation de la fenĂȘtre. Si l'utilisateur ouvre plus d'onglets dans cette fenĂȘtre, les scripts ne pourront pas fermer ces nouveaux onglets.</li> - <li>Si la ou les url(s) donnĂ©e(s) dans <code>url</code> pointent vers les <a href="/fr/Add-ons/WebExtensions/user_interface/Bundled_web_pages">pages d'extension</a> (c'est-Ă -dire qu'il s'agit de pages incluses avec cette extension et chargĂ©es avec le protocole "moz-extension:") alors les scripts <em>sont</em> par dĂ©faut autorisĂ©s Ă fermer ces onglets.</li> - </ul> - </dd> - <dt><code>cookieStoreId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. S'il est prĂ©sent, spĂ©cifie le <code>CookieStoreId</code> pour tous les onglets qui seront crĂ©Ă©s lorsque la fenĂȘtre sera ouverte.</dd> - <dt><code>focused</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si c'est vrai, la nouvelle fenĂȘtre sera concentrĂ©e. Si c'est <code>false</code>, la nouvelle fenĂȘtre sera ouverte en arriĂšre-plan et la fenĂȘtre actuellement concentrĂ©e restera concentrĂ©e. Le paramĂštre par dĂ©faut est <code>true</code>.</dd> - <dt><code>height</code> {{optional_inline}}</dt> - <dd><code>integer</code>. Hauteur en pixels de la nouvelle fenĂȘtre, y compris dans une frame. Si elle n'est pas spĂ©cifiĂ©e, par dĂ©faut une hauteur naturel.</dd> - <dt><code>incognito</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Que la nouvelle fenĂȘtre soit une fenĂȘtre privĂ©e. Notez que si vous spĂ©cifiez <code>incognito</code> et <code>tabId</code>, c'est-Ă -dire, vous ne pouvez pas dĂ©placer un onglet privĂ© dans une fenĂȘtre privĂ©e.</dd> - <dt><code>left</code> {{optional_inline}}</dt> - <dd><code>integer</code>. Nombre de pixels pour positionner la nouvelle fenĂȘtre Ă partir du bord gauche de l'Ă©cran. Si elle n'est pas spĂ©cifiĂ©e, la nouvelle fenĂȘtre est dĂ©calĂ©e naturellement Ă partir de la derniĂšre fenĂȘtre ciblĂ©e. Cette valeur est ignorĂ©e pour les panneaux. (Dans Firefox, cette valeur est actuellement ignorĂ©e pour les popups (bug 1271047) mais peut ĂȘtre dĂ©finie en utilisant browser.windows.update().)</dd> - <dt><code>state</code> {{optional_inline}}</dt> - <dd>Une valeur {{WebExtAPIRef('windows.WindowState')}}. L'Ă©tat initial de la fenĂȘtre. Les Ă©tats minimisĂ©s, maximisĂ©s et plein Ă©cran ne peuvent pas ĂȘtre combinĂ©s avec la gauche, le haut, la largeur ou la hauteur.</dd> - <dt><code>tabId</code> {{optional_inline}}</dt> - <dd><code>integer</code>. Si inclus, dĂ©place un onglet de l'ID spĂ©cifiĂ© d'une fenĂȘtre existante dans la nouvelle fenĂȘtre.</dd> - <dt><code>titlePreface</code> {{optional_inline}}</dt> - <dd><code>string</code>. Utilisez ceci pour ajouter une chaĂźne au dĂ©but du titre de la fenĂȘtre du navigateur. Selon le systĂšme d'exploitation sous-jacent, cela pourrait ne pas fonctionner sur les fenĂȘtres du navigateur qui n'ont pas de titre (comme about:blank dans Firefox).</dd> - <dt><code>top</code> {{optional_inline}}</dt> - <dd><code>integer</code>. Le nombre de pixels pour positionner la nouvelle fenĂȘtre Ă partir du bord supĂ©rieur de l'Ă©cran. Si elle n'est pas spĂ©cifiĂ©e, la nouvelle fenĂȘtre est naturellement dĂ©calĂ©e Ă partir de la derniĂšre fenĂȘtre ciblĂ©e. Cette valeur est ignorĂ©e pour les panneaux. (Dans Firefox, cette valeur est actuellement ignorĂ©e pour les popups (bug 1271047) mais peut ĂȘtre dĂ©finie en utilisant browser.windows.update().)</dd> - <dt><code>type</code> {{optional_inline}}</dt> - <dd>Une valeur {{WebExtAPIRef('windows.CreateType')}} spĂ©cifie le type de fenĂȘtre du navigateur Ă crĂ©er. SpĂ©cifiĂ© le <code>panneau</code> ou la <code>fenĂȘtre contextuelle</code> ici pour ouvrir une fenĂȘtre sans l'interface utilisateur (barre d'adresse, barre d'outils, etc).</dd> - <dt><code>url</code> {{optional_inline}}</dt> - <dd><code><code>string</code></code> ou <code><code>array</code></code> of <code><code><code>string</code></code></code>s. Une URL ou un tableau d'URL Ă ouvrir comme onglets dans une fenĂȘtre. Les URL hautement qualifiĂ©es doivent inclure un schĂ©ma (c'est Ă dire <code>http://www.google.com</code>, et non <code>www.google.com</code>). Les URL relatives seront relatives Ă la page actuelle dans l'extension. Par dĂ©faut, la nouvelle page d'onglet.</dd> - <dt><code>width</code> {{optional_inline}}</dt> - <dd><code>integer</code>. La largeur en pixels de la nouvelle fenĂȘtre, y compris le cadre. Si elle n'est pas spĂ©cifiĂ©e par dĂ©faut, vous avez une largeur naturelle.</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet {{WebExtAPIRef('windows.Window')}} contenant les dĂ©tails de la nouvelle fenĂȘtre. Cet objet de fenĂȘtre aura toujours son ensemble de propriĂ©tĂ©s d'onglets, contrairement aux objets de fenĂȘtre retournĂ©s Ă partir de {{WebExtAPIRef("windows.get()")}} et d'API similaires, qui contiennent uniquement des onglets si l'option de remplissage est passĂ©e. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Ouvrir une fenĂȘtre contenant deux onglets :</p> - -<pre class="brush: js">function onCreated(windowInfo) { +``` + +### ParamĂštres + +- `createData`{{optional_inline}} + + - : `object`. + + - `allowScriptsToClose` {{optional_inline}} + + - : `boolean`. Lorsque la fenĂȘtre est ouverte, elle contiendra un seul onglet, ou plus d'un onglet si `url` est donnĂ©e et comprendra un tableau contenant plus d'une URL. Par dĂ©faut, les scripts s'exĂ©cutant dans ces pages ne sont pas autorisĂ©s Ă fermer leur onglet en utilisant [`window.close()`](/fr/docs/Web/API/Window/close). Si vous incluez `allowScriptsToClose` et le mettez Ă `true` ,  alors ce comportement par dĂ©faut est modifiĂ©, de sorte que les scripts peuvent fermer leurs onglets. Notez cela : + + - Ceci ne s'applique qu'aux onglets qui ont Ă©tĂ© ouverts lors de la crĂ©ation de la fenĂȘtre. Si l'utilisateur ouvre plus d'onglets dans cette fenĂȘtre, les scripts ne pourront pas fermer ces nouveaux onglets. + - Si la ou les url(s) donnĂ©e(s) dans `url` pointent vers les [pages d'extension](/fr/Add-ons/WebExtensions/user_interface/Bundled_web_pages) (c'est-Ă -dire qu'il s'agit de pages incluses avec cette extension et chargĂ©es avec le protocole "moz-extension:") alors les scripts _sont_ par dĂ©faut autorisĂ©s Ă fermer ces onglets. + + - `cookieStoreId` {{optional_inline}} + - : `integer`. S'il est prĂ©sent, spĂ©cifie le `CookieStoreId` pour tous les onglets qui seront crĂ©Ă©s lorsque la fenĂȘtre sera ouverte. + - `focused` {{optional_inline}} + - : `boolean`. Si c'est vrai, la nouvelle fenĂȘtre sera concentrĂ©e. Si c'est `false`, la nouvelle fenĂȘtre sera ouverte en arriĂšre-plan et la fenĂȘtre actuellement concentrĂ©e restera concentrĂ©e. Le paramĂštre par dĂ©faut est `true`. + - `height` {{optional_inline}} + - : `integer`. Hauteur en pixels de la nouvelle fenĂȘtre, y compris dans une frame. Si elle n'est pas spĂ©cifiĂ©e, par dĂ©faut une hauteur naturel. + - `incognito` {{optional_inline}} + - : `boolean`. Que la nouvelle fenĂȘtre soit une fenĂȘtre privĂ©e. Notez que si vous spĂ©cifiez `incognito` et `tabId`, c'est-Ă -dire, vous ne pouvez pas dĂ©placer un onglet privĂ© dans une fenĂȘtre privĂ©e. + - `left` {{optional_inline}} + - : `integer`. Nombre de pixels pour positionner la nouvelle fenĂȘtre Ă partir du bord gauche de l'Ă©cran. Si elle n'est pas spĂ©cifiĂ©e, la nouvelle fenĂȘtre est dĂ©calĂ©e naturellement Ă partir de la derniĂšre fenĂȘtre ciblĂ©e. Cette valeur est ignorĂ©e pour les panneaux. (Dans Firefox, cette valeur est actuellement ignorĂ©e pour les popups (bug 1271047) mais peut ĂȘtre dĂ©finie en utilisant browser.windows.update().) + - `state` {{optional_inline}} + - : Une valeur {{WebExtAPIRef('windows.WindowState')}}. L'Ă©tat initial de la fenĂȘtre. Les Ă©tats minimisĂ©s, maximisĂ©s et plein Ă©cran ne peuvent pas ĂȘtre combinĂ©s avec la gauche, le haut, la largeur ou la hauteur. + - `tabId` {{optional_inline}} + - : `integer`. Si inclus, dĂ©place un onglet de l'ID spĂ©cifiĂ© d'une fenĂȘtre existante dans la nouvelle fenĂȘtre. + - `titlePreface` {{optional_inline}} + - : `string`. Utilisez ceci pour ajouter une chaĂźne au dĂ©but du titre de la fenĂȘtre du navigateur. Selon le systĂšme d'exploitation sous-jacent, cela pourrait ne pas fonctionner sur les fenĂȘtres du navigateur qui n'ont pas de titre (comme about:blank dans Firefox). + - `top` {{optional_inline}} + - : `integer`. Le nombre de pixels pour positionner la nouvelle fenĂȘtre Ă partir du bord supĂ©rieur de l'Ă©cran. Si elle n'est pas spĂ©cifiĂ©e, la nouvelle fenĂȘtre est naturellement dĂ©calĂ©e Ă partir de la derniĂšre fenĂȘtre ciblĂ©e. Cette valeur est ignorĂ©e pour les panneaux. (Dans Firefox, cette valeur est actuellement ignorĂ©e pour les popups (bug 1271047) mais peut ĂȘtre dĂ©finie en utilisant browser.windows.update().) + - `type` {{optional_inline}} + - : Une valeur {{WebExtAPIRef('windows.CreateType')}} spĂ©cifie le type de fenĂȘtre du navigateur Ă crĂ©er. SpĂ©cifiĂ© le `panneau` ou la `fenĂȘtre contextuelle` ici pour ouvrir une fenĂȘtre sans l'interface utilisateur (barre d'adresse, barre d'outils, etc). + - `url` {{optional_inline}} + - : `string` ou `array` of `string`s. Une URL ou un tableau d'URL Ă ouvrir comme onglets dans une fenĂȘtre. Les URL hautement qualifiĂ©es doivent inclure un schĂ©ma (c'est Ă dire `http://www.google.com`, et non `www.google.com`). Les URL relatives seront relatives Ă la page actuelle dans l'extension. Par dĂ©faut, la nouvelle page d'onglet. + - `width` {{optional_inline}} + - : `integer`. La largeur en pixels de la nouvelle fenĂȘtre, y compris le cadre. Si elle n'est pas spĂ©cifiĂ©e par dĂ©faut, vous avez une largeur naturelle. + +### Valeur retournĂ©e + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef('windows.Window')}} contenant les dĂ©tails de la nouvelle fenĂȘtre. Cet objet de fenĂȘtre aura toujours son ensemble de propriĂ©tĂ©s d'onglets, contrairement aux objets de fenĂȘtre retournĂ©s Ă partir de {{WebExtAPIRef("windows.get()")}} et d'API similaires, qui contiennent uniquement des onglets si l'option de remplissage est passĂ©e. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur. + +## Exemples + +Ouvrir une fenĂȘtre contenant deux onglets : + +```js +function onCreated(windowInfo) { console.log(`Created window: ${windowInfo.id}`); } @@ -95,17 +90,19 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.browserAction.onClicked.addListener((tab) => { +browser.browserAction.onClicked.addListener((tab) => { var creating = browser.windows.create({ url: ["https://developer.mozilla.org", "https://addons.mozilla.org"] }); creating.then(onCreated, onError); -});</pre> +}); +``` -<p>Ouvrez une fenĂȘtre lorsque l'utilisateur clique sur une action du navigateur et dĂ©placez l'onglet actif actuellement :</p> +Ouvrez une fenĂȘtre lorsque l'utilisateur clique sur une action du navigateur et dĂ©placez l'onglet actif actuellement : -<pre class="brush: js">function onCreated(windowInfo) { +```js +function onCreated(windowInfo) { console.log(`Created window: ${windowInfo.id}`); } @@ -113,16 +110,18 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.browserAction.onClicked.addListener((tab) => { +browser.browserAction.onClicked.addListener((tab) => { var creating = browser.windows.create({ tabId: tab.id }); creating.then(onCreated, onError); -});</pre> +}); +``` -<p>Ouvrez une petite fenĂȘtre de style panneau et chargez-en un fichier local:</p> +Ouvrez une petite fenĂȘtre de style panneau et chargez-en un fichier local: -<pre class="brush: js">function onCreated(windowInfo) { +```js +function onCreated(windowInfo) { console.log(`Created window: ${windowInfo.id}`); } @@ -130,7 +129,7 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.browserAction.onClicked.addListener((tab) => { +browser.browserAction.onClicked.addListener((tab) => { var popupURL = browser.extension.getURL("popup/popup.html"); @@ -142,23 +141,22 @@ browser.browserAction.onClicked.addListener((tab) => { }); creating.then(onCreated, onError); -});</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +}); +``` -<p>{{Compat("webextensions.api.windows.create", 10)}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## CompatibilitĂ© du navigateur -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> +{{Compat("webextensions.api.windows.create", 10)}} -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<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 @@ -185,5 +183,4 @@ browser.browserAction.onClicked.addListener((tab) => { // 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/windows/createtype/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/createtype/index.md index 30f4261aed..5f63cb2d30 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/createtype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/createtype/index.md @@ -13,36 +13,32 @@ tags: - Windows translation_of: Mozilla/Add-ons/WebExtensions/API/windows/CreateType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>SpĂ©cifie le type de fenĂȘtre du navigateur Ă crĂ©er.</p> +SpĂ©cifie le type de fenĂȘtre du navigateur Ă crĂ©er. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets <code>strings</code>. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des objets `strings`. Les valeurs possibles sont : -<ul> - <li><code>"normal"</code></li> - <li><code>"popup"</code></li> - <li><code>"panel"</code></li> - <li><code>"detached_panel"</code></li> -</ul> +- `"normal"` +- `"popup"` +- `"panel"` +- `"detached_panel"` -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.windows.CreateType")}}</p> +{{Compat("webextensions.api.windows.CreateType")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</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 @@ -69,5 +65,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/windows/CreateType // 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/windows/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/get/index.md index 6c81c0fd06..7a956473c0 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/get/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/get/index.md @@ -13,58 +13,54 @@ tags: - get translation_of: Mozilla/Add-ons/WebExtensions/API/windows/get --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient les dĂ©tails sur une fenĂȘtre, compte tenu de son identifiant. Les dĂ©tails sont transmis Ă un rappel.</p> +Obtient les dĂ©tails sur une fenĂȘtre, compte tenu de son identifiant. Les dĂ©tails sont transmis Ă un rappel. -<p>Il s'agit d'une fonction asynchrone qui renvoit une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +Il s'agit d'une fonction asynchrone qui renvoit une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var getting = browser.windows.get( +```js +var getting = browser.windows.get( windowId, // integer getInfo // optional object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. L'ID de l'objet de fenĂȘtre souhaitĂ© est retournĂ©.</dd> - <dt><code>getInfo</code>{{optional_inline}}</dt> - <dd><p><code>object</code>. Contient des options pour filtrer le type de fenĂȘtre.</p> - <dl> - <dt><code>populate</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si c'est vrai, l'objet {{WebExtAPIRef('windows.Window')}} aura une propriĂ©tĂ© de tabulation qui contient une liste d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les onglets ouverts dans la fenĂȘtre. Les objets Tab ne contiennent que les propriĂ©tĂ©s <code>url</code>, <code>title</code> et <code>favIconUrl</code> i le fichier manifeste de l'extension comprend la permission <code>"tabs"</code>.</dd> - <dt><code>windowTypes</code>{{optional_inline}}</dt> - <dd><code>Ensemble d'objets</code> {{WebExtAPIRef('windows.WindowType')}}. Si dĂ©fini, le retour de {{WebExtAPIRef('windows.Window')}} sera filtrĂ© en fonction de son type. Si dĂ©sactivĂ©, le filtre par dĂ©faut est rĂ©glĂ© sur <code>['normal', 'panel', 'popup']</code>, avec des types de fenĂȘtres <code>'panel'</code> qui sont limitĂ©s aux propres fenĂȘtres de l'extension.</dd> - </dl> - </dd> -</dl> +- `windowId` + - : `integer`. L'ID de l'objet de fenĂȘtre souhaitĂ© est retournĂ©. +- `getInfo`{{optional_inline}} -<div class="note"><p><strong>Note :</strong></p> + - : `object`. Contient des options pour filtrer le type de fenĂȘtre. -<p>Si fourni, le composant <code>windowTypes</code> de <code>getInfo</code> est ignorĂ©. L'utilisation de <code>windowTypes</code> a Ă©tĂ© dĂ©prĂ©ciĂ©e Ă partir de Firefox 62.</p> -</div> + - `populate`{{optional_inline}} + - : `boolean`. Si c'est vrai, l'objet {{WebExtAPIRef('windows.Window')}} aura une propriĂ©tĂ© de tabulation qui contient une liste d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les onglets ouverts dans la fenĂȘtre. Les objets Tab ne contiennent que les propriĂ©tĂ©s `url`, `title` et `favIconUrl` i le fichier manifeste de l'extension comprend la permission `"tabs"`. + - `windowTypes`{{optional_inline}} + - : `Ensemble d'objets` {{WebExtAPIRef('windows.WindowType')}}. Si dĂ©fini, le retour de {{WebExtAPIRef('windows.Window')}} sera filtrĂ© en fonction de son type. Si dĂ©sactivĂ©, le filtre par dĂ©faut est rĂ©glĂ© sur `['normal', 'panel', 'popup']`, avec des types de fenĂȘtres `'panel'` qui sont limitĂ©s aux propres fenĂȘtres de l'extension. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +> **Note :** +> +> Si fourni, le composant `windowTypes` de `getInfo` est ignorĂ©. L'utilisation de `windowTypes` a Ă©tĂ© dĂ©prĂ©ciĂ©e Ă partir de Firefox 62. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet {{WebExtAPIRef('windows.Window')}} contenant les dĂ©tails de la fenĂȘtre. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur.</p> +### Valeur de retour -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef('windows.Window')}} contenant les dĂ©tails de la fenĂȘtre. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur. -<p>{{Compat("webextensions.api.windows.get",2)}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.windows.get",2)}} -<p>Cet exemple obtient la fenĂȘtre actuelle et enregistre les URL des onglets qu'il contient. Notez que vous aurez besoin des <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "onglets" pour accĂ©der aux URL des onglets.</p> +## Exemples -<div class="note"> -<p><strong>Note :</strong> Cet exemple est un peu irrĂ©aliste: dans cette situation, vous utiliserez probablement {{WebExtAPIRef("windows.getCurrent()")}}.</p> -</div> +Cet exemple obtient la fenĂȘtre actuelle et enregistre les URL des onglets qu'il contient. Notez que vous aurez besoin des [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) "onglets" pour accĂ©der aux URL des onglets. -<pre class="brush: js">function logTabs(windowInfo) { +> **Note :** Cet exemple est un peu irrĂ©aliste: dans cette situation, vous utiliserez probablement {{WebExtAPIRef("windows.getCurrent()")}}. + +```js +function logTabs(windowInfo) { for (tabInfo of windowInfo.tabs) { console.log(tabInfo.url); } @@ -74,23 +70,21 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.browserAction.onClicked.addListener((tab) => { +browser.browserAction.onClicked.addListener((tab) => { var getting = browser.windows.get(tab.windowId, {populate: true}); getting.then(logTabs, onError); }); -</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +``` -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<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 @@ -117,5 +111,4 @@ browser.browserAction.onClicked.addListener((tab) => { // 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/windows/getall/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/getall/index.md index c5499749c5..df513536f9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/getall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/getall/index.md @@ -13,49 +13,48 @@ tags: - getAll translation_of: Mozilla/Add-ons/WebExtensions/API/windows/getAll --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient des informations sur toutes les fenĂȘtres ouvertes, en les passant dans un rappel.</p> +Obtient des informations sur toutes les fenĂȘtres ouvertes, en les passant dans un rappel. -<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.windows.getAll( +```js +var gettingAll = browser.windows.getAll( getInfo // optional object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>getInfo</code>{{optional_inline}}</dt> - <dd><p><code>object</code>. Cela contrĂŽle ce que les objets {{WebExtAPIRef('windows.Window')}} sont rĂ©cupĂ©rĂ©s.</p> - <dl> - <dt><code>populate</code>{{optional_inline}}</dt> - <dd><code>boolean</code> Par dĂ©faut Ă <code>false</code>.  S'il est dĂ©fini sur <code>true</code>, chaque objet {{WebExtAPIRef('windows.Window')}} aura une propriĂ©tĂ© <code>tabs</code> qui contient une liste d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les tabs de cette fenĂȘtre. Les objets <code>Tab</code> contiendront les propriĂ©tĂ©s <code>url</code>, <code>title</code> et <code>favIconUrl</code> uniquement si le fichier manifest de l'extension contient les permissions <code>"tabs"</code>.</dd> - <dt><code>windowTypes</code>{{optional_inline}}</dt> - <dd><code>Un ensemble d'objets</code> {{WebExtAPIRef('windows.WindowType')}}. Si cette option est dĂ©finie, les objets {{WebExtAPIRef('windows.Window')}} renvoyĂ©s seront filtrĂ©s en fonction de leur type. Si dĂ©sactivĂ©, le filtre par dĂ©faut est rĂ©glĂ© sur <code>['normal', 'panel', 'popup']</code>, avec des types de fenĂȘtres <code>'panel'</code> qui sont limitĂ©s aux propres fenĂȘtres de l'extension.</dd> - </dl> - </dd> -</dl> +- `getInfo`{{optional_inline}} -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> + - : `object`. Cela contrĂŽle ce que les objets {{WebExtAPIRef('windows.Window')}} sont rĂ©cupĂ©rĂ©s. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un ensemble d'objets {{WebExtAPIRef('windows.Window')}}, reprĂ©sentant toutes les fenĂȘtres qui correspondent aux critĂšres donnĂ©s. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur.</p> + - `populate`{{optional_inline}} + - : `boolean` Par dĂ©faut Ă `false`.  S'il est dĂ©fini sur `true`, chaque objet {{WebExtAPIRef('windows.Window')}} aura une propriĂ©tĂ© `tabs` qui contient une liste d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les tabs de cette fenĂȘtre. Les objets `Tab` contiendront les propriĂ©tĂ©s `url`, `title` et `favIconUrl` uniquement si le fichier manifest de l'extension contient les permissions `"tabs"`. + - `windowTypes`{{optional_inline}} + - : `Un ensemble d'objets` {{WebExtAPIRef('windows.WindowType')}}. Si cette option est dĂ©finie, les objets {{WebExtAPIRef('windows.Window')}} renvoyĂ©s seront filtrĂ©s en fonction de leur type. Si dĂ©sactivĂ©, le filtre par dĂ©faut est rĂ©glĂ© sur `['normal', 'panel', 'popup']`, avec des types de fenĂȘtres `'panel'` qui sont limitĂ©s aux propres fenĂȘtres de l'extension. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +### Valeur retournĂ©e -<p>{{Compat("webextensions.api.windows.getAll")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un ensemble d'objets {{WebExtAPIRef('windows.Window')}}, reprĂ©sentant toutes les fenĂȘtres qui correspondent aux critĂšres donnĂ©s. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="Exemples">Exemples</h2> +## CompatibilitĂ© du navigateur -<p>Enregistrez les URL pour les onglets sur toutes les fenĂȘtres de navigateur "normales". Notez que vous aurez besoin de <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "onglets" pour accĂ©der aux URLs des onglets.</p> +{{Compat("webextensions.api.windows.getAll")}} -<pre class="brush: js">function logTabsForWindows(windowInfoArray) { +## Exemples + +Enregistrez les URL pour les onglets sur toutes les fenĂȘtres de navigateur "normales". Notez que vous aurez besoin de [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) "onglets" pour accĂ©der aux URLs des onglets. + +```js +function logTabsForWindows(windowInfoArray) { for (windowInfo of windowInfoArray) { console.log(`Window: ${windowInfo.id}`); - console.log(windowInfo.tabs.map((tab) => {return tab.url})); + console.log(windowInfo.tabs.map((tab) => {return tab.url})); } } @@ -63,26 +62,24 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.browserAction.onClicked.addListener((tab) => { +browser.browserAction.onClicked.addListener((tab) => { var getting = browser.windows.getAll({ populate: true, windowTypes: ["normal"] }); getting.then(logTabsForWindows, onError); }); -</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +``` -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<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 @@ -109,5 +106,4 @@ browser.browserAction.onClicked.addListener((tab) => { // 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/windows/getcurrent/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/getcurrent/index.md index 79c8928f0c..e119f9cb9f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/getcurrent/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/getcurrent/index.md @@ -13,53 +13,51 @@ tags: - getCurrent translation_of: Mozilla/Add-ons/WebExtensions/API/windows/getCurrent --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient la fenĂȘtre actuelle du navigateur, en passant ses dĂ©tails dans un rappel.</p> +Obtient la fenĂȘtre actuelle du navigateur, en passant ses dĂ©tails dans un rappel. -<p>La fenĂȘtre "actuelle" n'est pas nĂ©cessairement la mĂȘme que la fenĂȘtre ayant actuellement le focus. Si cette fonction est appelĂ©e Ă partir d'un script en arriĂšre-plan, elle renvoie la fenĂȘtre ayant actuellement le focus. Mais s'il est appelĂ© Ă partir d'un script dont le document est associĂ© Ă une fenĂȘtre de navigateur particuliĂšre, il retourne la fenĂȘtre de ce navigateur. Par exemple, si le navigateur affiche une barre latĂ©rale, chaque fenĂȘtre de navigateur possĂšde sa propre instance du document de la barre latĂ©rale. Si un script exĂ©cutĂ© dans le document de la barre latĂ©rale appelle <code>getCurrent()</code>, il renverra la fenĂȘtre de ce document de la barre latĂ©rale.</p> +La fenĂȘtre "actuelle" n'est pas nĂ©cessairement la mĂȘme que la fenĂȘtre ayant actuellement le focus. Si cette fonction est appelĂ©e Ă partir d'un script en arriĂšre-plan, elle renvoie la fenĂȘtre ayant actuellement le focus. Mais s'il est appelĂ© Ă partir d'un script dont le document est associĂ© Ă une fenĂȘtre de navigateur particuliĂšre, il retourne la fenĂȘtre de ce navigateur. Par exemple, si le navigateur affiche une barre latĂ©rale, chaque fenĂȘtre de navigateur possĂšde sa propre instance du document de la barre latĂ©rale. Si un script exĂ©cutĂ© dans le document de la barre latĂ©rale appelle `getCurrent()`, il renverra la fenĂȘtre de ce document de la barre latĂ©rale. -<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 gettingCurrent = browser.windows.getCurrent( +```js +var gettingCurrent = browser.windows.getCurrent( getInfo // optional object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>getInfo</code>{{optional_inline}}</dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>populate</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si c'est vrai, l'objet {{WebExtAPIRef('windows.Window')}} aura une propriĂ©tĂ© de tabulation contenant une liste d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les onglets de la fenĂȘtre. Les objets Tab ne contiennent que les propriĂ©tĂ©s <code>url</code>, <code>title</code> et <code>favIconUrl</code> si le fichier manifest de l'extension comprend la permission <code>"tabs"</code>.</dd> - <dt><code>windowTypes</code>{{optional_inline}}</dt> - <dd>Un ensemble d'objets <code>{{WebExtAPIRef('windows.WindowType')}}</code>. Si dĂ©fini, le {{WebExtAPIRef('windows.Window')}} retournĂ© sera filtrĂ© en fonction de son type. Si dĂ©sactivĂ©, le filtre par dĂ©faut est rĂ©glĂ© sur <code>['normal', 'panel', 'popup']</code>, avec des types de fenĂȘtres <code>'panneau'</code> qui sont limitĂ©s aux propres fenĂȘtres de l'extension.</dd> - </dl> - </dd> -</dl> +- `getInfo`{{optional_inline}} -<div class="note"><p><strong>Note :</strong></p> + - : `object`. -<p>Si fourni, le composant <code>windowTypes</code> de <code>getInfo</code> est ignorĂ©. L'utilisation de <code>windowTypes</code> a Ă©tĂ© dĂ©prĂ©ciĂ©e Ă partir de Firefox 62.</p> -</div> + - `populate`{{optional_inline}} + - : `boolean`. Si c'est vrai, l'objet {{WebExtAPIRef('windows.Window')}} aura une propriĂ©tĂ© de tabulation contenant une liste d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les onglets de la fenĂȘtre. Les objets Tab ne contiennent que les propriĂ©tĂ©s `url`, `title` et `favIconUrl` si le fichier manifest de l'extension comprend la permission `"tabs"`. + - `windowTypes`{{optional_inline}} + - : Un ensemble d'objets `{{WebExtAPIRef('windows.WindowType')}}`. Si dĂ©fini, le {{WebExtAPIRef('windows.Window')}} retournĂ© sera filtrĂ© en fonction de son type. Si dĂ©sactivĂ©, le filtre par dĂ©faut est rĂ©glĂ© sur `['normal', 'panel', 'popup']`, avec des types de fenĂȘtres `'panneau'` qui sont limitĂ©s aux propres fenĂȘtres de l'extension. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +> **Note :** +> +> Si fourni, le composant `windowTypes` de `getInfo` est ignorĂ©. L'utilisation de `windowTypes` a Ă©tĂ© dĂ©prĂ©ciĂ©e Ă partir de Firefox 62. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/API/windows/Window"><code>windows.Window</code></a> object contenant les dĂ©tails de la fenĂȘtre. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur.</p> +### Valeur retournĂ©e -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet [`windows.Window`](/fr/docs/Mozilla/Add-ons/WebExtensions/API/windows/Window) object contenant les dĂ©tails de la fenĂȘtre. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur. -<p>{{Compat("webextensions.api.windows.getCurrent",2)}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.windows.getCurrent",2)}} -<p>Lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur, cet exemple obtient la fenĂȘtre actuelle et enregistre les URL des onglets qu'elle contient. Notez que vous aurez besoin de la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "tabs" pour accĂ©der aux URL des onglets.</p> +## Exemples -<pre class="brush: js">function logTabs(windowInfo) { +Lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur, cet exemple obtient la fenĂȘtre actuelle et enregistre les URL des onglets qu'elle contient. Notez que vous aurez besoin de la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) "tabs" pour accĂ©der aux URL des onglets. + +```js +function logTabs(windowInfo) { for (let tabInfo of windowInfo.tabs) { console.log(tabInfo.url); } @@ -69,23 +67,21 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.browserAction.onClicked.addListener((tab) => { +browser.browserAction.onClicked.addListener((tab) => { var getting = browser.windows.getCurrent({populate: true}); getting.then(logTabs, onError); }); -</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +``` -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<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 @@ -112,5 +108,4 @@ browser.browserAction.onClicked.addListener((tab) => { // 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/windows/getlastfocused/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/getlastfocused/index.md index bfc7c81366..802ba48514 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/getlastfocused/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/getlastfocused/index.md @@ -13,52 +13,49 @@ tags: - getLastFocused translation_of: Mozilla/Add-ons/WebExtensions/API/windows/getLastFocused --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Obtient la fenĂȘtre qui a Ă©tĂ© recentrĂ©e rĂ©cemment â gĂ©nĂ©ralement la fenĂȘtre 'en haut'.</p> +Obtient la fenĂȘtre qui a Ă©tĂ© recentrĂ©e rĂ©cemment â gĂ©nĂ©ralement la fenĂȘtre 'en haut'. -<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 gettingWindow = browser.windows.getLastFocused( +```js +var gettingWindow = browser.windows.getLastFocused( getInfo // optional object ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>getInfo</code>{{optional_inline}}</dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>populate</code>{{optional_inline}}</dt> - <dd><code>boolean</code>. Si c'est vrai, l'objet {{WebExtAPIRef('windows.Window')}} aura une propriĂ©tĂ© de tabulation contenant une liste d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les onglets de la fenĂȘtre. Les objets d'onglets ne contiennent que les propriĂ©tĂ©s <code>url</code>, <code>title</code> et <code>favIconUrl</code> si le fichier manifest de l'extension comprend la permission <code>"tabs"</code>.</dd> - <dt><code>windowTypes</code>{{optional_inline}}</dt> - <dd>Un ensemble d'objets {{WebExtAPIRef('windows.WindowType')}}. Si dĂ©fini, le {{WebExtAPIRef('windows.Window')}} retournĂ© sera filtrĂ© en fonction de son type. Si dĂ©sactivĂ©, le filtre par dĂ©faut est rĂ©glĂ© sur <code>['normal', 'panel', 'popup']</code>, avec le type de fenĂȘtre <code>'panel'</code> qui sont limitĂ©s aux propres fenĂȘtres de l'extension.</dd> - </dl> - </dd> -</dl> +- `getInfo`{{optional_inline}} -<div class="note"> - <p><strong>Note :</strong></p> + - : `object`. -<p>Si fourni, le composant <code>windowTypes</code> de <code>getInfo</code> est ignorĂ©. L'utilisation de <code>windowTypes</code> a Ă©tĂ© dĂ©prĂ©ciĂ©e Ă partir de Firefox 62.</p> -</div> + - `populate`{{optional_inline}} + - : `boolean`. Si c'est vrai, l'objet {{WebExtAPIRef('windows.Window')}} aura une propriĂ©tĂ© de tabulation contenant une liste d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les onglets de la fenĂȘtre. Les objets d'onglets ne contiennent que les propriĂ©tĂ©s `url`, `title` et `favIconUrl` si le fichier manifest de l'extension comprend la permission `"tabs"`. + - `windowTypes`{{optional_inline}} + - : Un ensemble d'objets {{WebExtAPIRef('windows.WindowType')}}. Si dĂ©fini, le {{WebExtAPIRef('windows.Window')}} retournĂ© sera filtrĂ© en fonction de son type. Si dĂ©sactivĂ©, le filtre par dĂ©faut est rĂ©glĂ© sur `['normal', 'panel', 'popup']`, avec le type de fenĂȘtre `'panel'` qui sont limitĂ©s aux propres fenĂȘtres de l'extension. -<h3 id="Valeur_retournĂ©e">Valeur retournĂ©e</h3> +> **Note :** +> +> Si fourni, le composant `windowTypes` de `getInfo` est ignorĂ©. L'utilisation de `windowTypes` a Ă©tĂ© dĂ©prĂ©ciĂ©e Ă partir de Firefox 62. -<p><code>Une <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet {{WebExtAPIRef('windows.Window')}} contenant les dĂ©tails de la derniĂšre fenĂȘtre ciblĂ©e. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur.</p> +### Valeur retournĂ©e -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +`Une Promise` qui sera remplie avec un objet {{WebExtAPIRef('windows.Window')}} contenant les dĂ©tails de la derniĂšre fenĂȘtre ciblĂ©e. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur. -<p>{{Compat("webextensions.api.windows.getLastFocused",2)}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.windows.getLastFocused",2)}} -<p>Obtenez la derniĂšre fenĂȘtre ciblĂ©e et enregistrez les onglets qu'elle contient. Notez que vous aurez besoin de la <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "tabs" pour accĂ©der aux URL des onglets.</p> +## Exemples -<pre class="brush: js">function logTabs(windowInfo) { +Obtenez la derniĂšre fenĂȘtre ciblĂ©e et enregistrez les onglets qu'elle contient. Notez que vous aurez besoin de la [permission](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) "tabs" pour accĂ©der aux URL des onglets. + +```js +function logTabs(windowInfo) { for (tabInfo of windowInfo.tabs) { console.log(tabInfo.url); } @@ -68,23 +65,21 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.browserAction.onClicked.addListener((tab) => { +browser.browserAction.onClicked.addListener((tab) => { var getting = browser.windows.getLastFocused({populate: true}); getting.then(logTabs, onError); }); -</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +``` -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<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 @@ -111,5 +106,4 @@ browser.browserAction.onClicked.addListener((tab) => { // 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/windows/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/index.md index 63f560cfcf..f1140e5c8a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/index.md @@ -12,79 +12,67 @@ tags: - Windows translation_of: Mozilla/Add-ons/WebExtensions/API/windows --- -<div>{{AddonSidebar}}</div> - -<p>IntĂ©ragissez avec les fenĂȘtres du navigateur. Vous pouvez utiliser cette API pour obtenir des informations sur les fenĂȘtres ouvertes et Ă ouvrir, modifiĂ©e et fermĂ©e les fenĂȘtres. Vous pouvez Ă©galement Ă©couter la fenĂȘtre ouverte, fermĂ©e, et activĂ©e les Ă©vĂ©nements.</p> - -<h2 id="Types">Types</h2> - -<dl> - <dt>{{WebExtAPIRef("windows.WindowType")}}</dt> - <dd>Le type de fenĂȘtre du navigateur ici.</dd> - <dt>{{WebExtAPIRef("windows.WindowState")}}</dt> - <dd>L'Ă©tat de cette fenĂȘtre du navigateur.</dd> - <dt>{{WebExtAPIRef("windows.Window")}}</dt> - <dd>Contient des informations sur une fenĂȘtre de navigateur.</dd> - <dt>{{WebExtAPIRef("windows.CreateType")}}</dt> - <dd>SpĂ©cifie le type de fenĂȘtre du navigateur Ă crĂ©er.</dd> -</dl> - -<h2 id="Constantes">Constantes</h2> - -<dl> - <dt>{{WebExtAPIRef("windows.WINDOW_ID_NONE")}}</dt> - <dd>La valeur <code>windowId</code> qui reprĂ©sente l'absence d'une fenĂȘtre de navigateur.</dd> - <dt>{{WebExtAPIRef("windows.WINDOW_ID_CURRENT")}}</dt> - <dd>Une valeur qui peut ĂȘtre utilisĂ©e Ă la place d'un <code>windowId</code> dans certaines APIs pour reprĂ©senter la fenĂȘtre courante.</dd> -</dl> - -<h2 id="MĂ©thodes">MĂ©thodes</h2> - -<dl> - <dt>{{WebExtAPIRef("windows.get()")}}</dt> - <dd>Obtient les dĂ©tails sur une fenĂȘtre, compte tenu de son identifiant.</dd> - <dt>{{WebExtAPIRef("windows.getCurrent()")}}</dt> - <dd>Obtient les informations de la fenĂȘtre courante.</dd> - <dt>{{WebExtAPIRef("windows.getLastFocused()")}}</dt> - <dd>Obtient la fenĂȘtre qui a Ă©tĂ© recentrĂ©e plus rĂ©cemment â gĂ©nĂ©ralement la fenĂȘtre « en haut ».</dd> - <dt>{{WebExtAPIRef("windows.getAll()")}}</dt> - <dd>Obtient les informations de toutes les fenĂȘtres</dd> - <dt>{{WebExtAPIRef("windows.create()")}}</dt> - <dd> - <p>CrĂ©e une nouvelle fenĂȘtre.</p> - </dd> - <dt>{{WebExtAPIRef("windows.update()")}}</dt> - <dd>Mises Ă jour des propriĂ©tĂ©s d'une fenĂȘtre. Utilisez ceci pour dĂ©placer, redimensionner, et (un) se concentrer sur une fenĂȘtre, etc.</dd> - <dt>{{WebExtAPIRef("windows.remove()")}}</dt> - <dd>Ferme une fenĂȘtre et tous ses onglets.</dd> -</dl> - -<h2 id="EvĂ©nements">EvĂ©nements</h2> - -<dl> - <dt>{{WebExtAPIRef("windows.onCreated")}}</dt> - <dd>LancĂ© quand une fenĂȘtre est crĂ©Ă©e.</dd> - <dt>{{WebExtAPIRef("windows.onRemoved")}}</dt> - <dd>LancĂ© quand une fenĂȘtre est fermĂ©e.</dd> - <dt>{{WebExtAPIRef("windows.onFocusChanged")}}</dt> - <dd>LancĂ© quand la fenĂȘtre courante change.</dd> -</dl> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.windows")}}</p> - -<p>{{WebExtExamples("h2")}}</p> - -<div class="note"><p><strong>Note :</strong></p> - -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +{{AddonSidebar}} + +IntĂ©ragissez avec les fenĂȘtres du navigateur. Vous pouvez utiliser cette API pour obtenir des informations sur les fenĂȘtres ouvertes et Ă ouvrir, modifiĂ©e et fermĂ©e les fenĂȘtres. Vous pouvez Ă©galement Ă©couter la fenĂȘtre ouverte, fermĂ©e, et activĂ©e les Ă©vĂ©nements. + +## Types + +- {{WebExtAPIRef("windows.WindowType")}} + - : Le type de fenĂȘtre du navigateur ici. +- {{WebExtAPIRef("windows.WindowState")}} + - : L'Ă©tat de cette fenĂȘtre du navigateur. +- {{WebExtAPIRef("windows.Window")}} + - : Contient des informations sur une fenĂȘtre de navigateur. +- {{WebExtAPIRef("windows.CreateType")}} + - : SpĂ©cifie le type de fenĂȘtre du navigateur Ă crĂ©er. + +## Constantes + +- {{WebExtAPIRef("windows.WINDOW_ID_NONE")}} + - : La valeur `windowId` qui reprĂ©sente l'absence d'une fenĂȘtre de navigateur. +- {{WebExtAPIRef("windows.WINDOW_ID_CURRENT")}} + - : Une valeur qui peut ĂȘtre utilisĂ©e Ă la place d'un `windowId` dans certaines APIs pour reprĂ©senter la fenĂȘtre courante. + +## MĂ©thodes + +- {{WebExtAPIRef("windows.get()")}} + - : Obtient les dĂ©tails sur une fenĂȘtre, compte tenu de son identifiant. +- {{WebExtAPIRef("windows.getCurrent()")}} + - : Obtient les informations de la fenĂȘtre courante. +- {{WebExtAPIRef("windows.getLastFocused()")}} + - : Obtient la fenĂȘtre qui a Ă©tĂ© recentrĂ©e plus rĂ©cemment â gĂ©nĂ©ralement la fenĂȘtre « en haut ». +- {{WebExtAPIRef("windows.getAll()")}} + - : Obtient les informations de toutes les fenĂȘtres +- {{WebExtAPIRef("windows.create()")}} + - : CrĂ©e une nouvelle fenĂȘtre. +- {{WebExtAPIRef("windows.update()")}} + - : Mises Ă jour des propriĂ©tĂ©s d'une fenĂȘtre. Utilisez ceci pour dĂ©placer, redimensionner, et (un) se concentrer sur une fenĂȘtre, etc. +- {{WebExtAPIRef("windows.remove()")}} + - : Ferme une fenĂȘtre et tous ses onglets. + +## EvĂ©nements + +- {{WebExtAPIRef("windows.onCreated")}} + - : LancĂ© quand une fenĂȘtre est crĂ©Ă©e. +- {{WebExtAPIRef("windows.onRemoved")}} + - : LancĂ© quand une fenĂȘtre est fermĂ©e. +- {{WebExtAPIRef("windows.onFocusChanged")}} + - : LancĂ© quand la fenĂȘtre courante change. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.windows")}} + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. + +<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 @@ -111,5 +99,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/windows // 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/windows/oncreated/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/oncreated/index.md index 8d73d4227c..51beb3799f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/oncreated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/oncreated/index.md @@ -13,67 +13,61 @@ tags: - onCreated translation_of: Mozilla/Add-ons/WebExtensions/API/windows/onCreated --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Lancer quand la fenĂȘtre est crĂ©Ă©e</p> +Lancer quand la fenĂȘtre est crĂ©Ă©e -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.windows.onCreated.addListener(listener) +```js +browser.windows.onCreated.addListener(listener) browser.windows.onCreated.removeListener(listener) browser.windows.onCreated.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>Ajoute un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘter d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si un auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie vrai si elle rĂ©pond, Faux sinon.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘter d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si un auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie vrai si elle rĂ©pond, Faux sinon. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction passera les arguments suivants :</p> +- `callback` - <dl> - <dt><code>window</code></dt> - <dd>Un objet {{WebExtAPIRef('windows.Window')}} contenant les dĂ©tails de la fenĂȘtre qui a Ă©tĂ© crĂ©Ă©e.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction passera les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `window` + - : Un objet {{WebExtAPIRef('windows.Window')}} contenant les dĂ©tails de la fenĂȘtre qui a Ă©tĂ© crĂ©Ă©e. -<p>{{Compat("webextensions.api.windows.onCreated")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.windows.onCreated")}} -<p>Enregistrez les ID des nouvelles fenĂȘtres lorsqu'elles sont crĂ©Ă©es</p> +## Exemples -<pre class="brush: js">browser.windows.onCreated.addListener((window) => { - console.log("New window: " + window.id); -});</pre> - -<p>{{WebExtExamples}}</p> +Enregistrez les ID des nouvelles fenĂȘtres lorsqu'elles sont crĂ©Ă©es -<div class="note"><p><strong>Note :</strong></p> +```js +browser.windows.onCreated.addListener((window) => { + console.log("New window: " + window.id); +}); +``` -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<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.windows.onCreated.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/windows/onfocuschanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/onfocuschanged/index.md index 8ffbdf54a1..b162d131da 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/onfocuschanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/onfocuschanged/index.md @@ -13,71 +13,63 @@ tags: - onFocusChanged translation_of: Mozilla/Add-ons/WebExtensions/API/windows/onFocusChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>AttirĂ© lorsque la fenĂȘtre actuellement change. Sera {{WebExtAPIRef('windows.WINDOW_ID_NONE')}} si toutes les fenĂȘtres du navigateur ont perdu le focus.</p> +AttirĂ© lorsque la fenĂȘtre actuellement change. Sera {{WebExtAPIRef('windows.WINDOW_ID_NONE')}} si toutes les fenĂȘtres du navigateur ont perdu le focus. -<div class="note"> -<p><strong>Note :</strong> Sur certains gestionnaires de fenĂȘtres Linux, WINDOW_ID_NONE sera toujours envoyĂ© immĂ©diatement avant un passage d'une fenĂȘtre de navigateur Ă l'autre.</p> -</div> +> **Note :** Sur certains gestionnaires de fenĂȘtres Linux, WINDOW_ID_NONE sera toujours envoyĂ© immĂ©diatement avant un passage d'une fenĂȘtre de navigateur Ă l'autre. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.windows.onFocusChanged.addListener(listener) +```js +browser.windows.onFocusChanged.addListener(listener) browser.windows.onFocusChanged.removeListener(listener) browser.windows.onFocusChanged.hasListener(listener) -</pre> +``` -<p>Les Ă©vĂ©nements ont trois Ă©vĂ©nements :</p> +Les Ă©vĂ©nements ont trois Ă©vĂ©nements : -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un auditeur Ă cet Ă©vĂ©nement</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur Ă supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifiez si un auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie <strong>vrai</strong> si elle Ă©coute, <strong>faux</strong> sinon..</dd> -</dl> +- `addListener(callback)` + - : Ajoute un auditeur Ă cet Ă©vĂ©nement +- `removeListener(listener)` + - : ArrĂȘtez d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur Ă supprimer. +- `hasListener(listener)` + - : VĂ©rifiez si un auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie **vrai** si elle Ă©coute, **faux** sinon.. -<h2 id="syntaxe_addListener">syntaxe addListener</h2> +## syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction passera les arguments suivants :</p> +- `callback` - <dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. ID de la fenĂȘtre nouvellement localisĂ©e.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction passera les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `windowId` + - : `integer`. ID de la fenĂȘtre nouvellement localisĂ©e. -<p>{{Compat("webextensions.api.windows.onFocusChanged")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.windows.onFocusChanged")}} -<p>Changements de mise au point du journal :</p> +## Exemples -<pre class="brush: js">browser.windows.onFocusChanged.addListener((windowId) => { - console.log("Newly focused window: " + windowId); -});</pre> - -<p>{{WebExtExamples}}</p> +Changements de mise au point du journal : -<div class="note"><p><strong>Note :</strong></p> +```js +browser.windows.onFocusChanged.addListener((windowId) => { + console.log("Newly focused window: " + windowId); +}); +``` -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<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 @@ -104,5 +96,4 @@ browser.windows.onFocusChanged.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/windows/onremoved/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/onremoved/index.md index bf38ec83b0..6ef816ed11 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/onremoved/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/onremoved/index.md @@ -13,68 +13,61 @@ tags: - onRemoved translation_of: Mozilla/Add-ons/WebExtensions/API/windows/onRemoved --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Lancer quand une fenĂȘtre est fermĂ©e.</p> +Lancer quand une fenĂȘtre est fermĂ©e. -<h2 id="Syntax">Syntax</h2> +## Syntax -<pre class="brush: js">browser.windows.onRemoved.addListener(listener) +```js +browser.windows.onRemoved.addListener(listener) browser.windows.onRemoved.removeListener(listener) browser.windows.onRemoved.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>Ajoute un auditeur Ă cet Ă©vĂ©nement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>ArrĂȘter d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>VĂ©rifie si un auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie vrai si elle Ă©coute, faux sinon.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un auditeur Ă cet Ă©vĂ©nement. +- `removeListener(listener)` + - : ArrĂȘter d'Ă©couter cet Ă©vĂ©nement. L'argument de l'auditeur est l'auditeur supprimer. +- `hasListener(listener)` + - : VĂ©rifie si un auditeur est enregistrĂ© pour cet Ă©vĂ©nement. Renvoie vrai si elle Ă©coute, faux sinon. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction passera les arguments suivants :</p> +- `callback` - <dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. ID de la fenĂȘtre fermĂ©e.</dd> - </dl> - </dd> -</dl> + - : Fonction qui sera appelĂ©e lors de l'Ă©vĂ©nement. La fonction passera les arguments suivants : -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> + - `windowId` + - : `integer`. ID de la fenĂȘtre fermĂ©e. -<p>{{Compat("webextensions.api.windows.onRemoved")}}</p> +## CompatibilitĂ© du navigateur -<h2 id="Exemples">Exemples</h2> +{{Compat("webextensions.api.windows.onRemoved")}} -<p>Enregistrer les identifiants de la fenĂȘtre lorsqu'ils sont supprimĂ©s</p> +## Exemples -<pre class="brush: js">browser.windows.onRemoved.addListener((windowId) => { +Enregistrer les identifiants de la fenĂȘtre lorsqu'ils sont supprimĂ©s + +```js +browser.windows.onRemoved.addListener((windowId) => { console.log("Closed window: " + windowId); }); -</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +``` -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<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 +94,4 @@ browser.windows.onRemoved.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/windows/remove/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/remove/index.md index 29c0525f03..d9eeda97a6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/remove/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/remove/index.md @@ -13,39 +13,39 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/windows/remove --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ferme une fenĂȘtre et tous les onglets Ă l'intĂ©rieur, compte tenu de l'ID de la fenĂȘtre.</p> +Ferme une fenĂȘtre et tous les onglets Ă l'intĂ©rieur, compte tenu de l'ID de la fenĂȘtre. -<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 removing = browser.windows.remove( +```js +var removing = browser.windows.remove( windowId // integer ) -</pre> +``` -<h3 id="ParamĂštres">ParamĂštres</h3> +### ParamĂštres -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. ID of the window to close.</dd> -</dl> +- `windowId` + - : `integer`. ID of the window to close. -<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">Promesse</a></code> qui sera remplie sans arguments lorsque la fenĂȘtre a Ă©tĂ© fermĂ©e. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur.</p> +Une [`Promesse`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie sans arguments lorsque la fenĂȘtre a Ă©tĂ© fermĂ©e. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.windows.remove")}}</p> +{{Compat("webextensions.api.windows.remove")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur, fermez la fenĂȘtre dans laquelle l'icĂŽne a Ă©tĂ© cliquĂ©e:</p> +Lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur, fermez la fenĂȘtre dans laquelle l'icĂŽne a Ă©tĂ© cliquĂ©e: -<pre class="brush: js">function onRemoved() { +```js +function onRemoved() { console.log(`Removed window`); } @@ -53,37 +53,37 @@ function onError(error) { console.error(`Error:`, error); } -browser.browserAction.onClicked.addListener((tab) => { +browser.browserAction.onClicked.addListener((tab) => { var removing = browser.windows.remove(tab.windowId); removing.then(onRemoved, onError); -});</pre> +}); +``` -<p><br> - Fermez la fenĂȘtre en cours, par exemple une fenĂȘtre contextuelle, lorsque l'utilisateur clique sur un bouton de la page :</p> +Fermez la fenĂȘtre en cours, par exemple une fenĂȘtre contextuelle, lorsque l'utilisateur clique sur un bouton de la page : -<pre class="brush: js">// in a script loaded by the page in the window -document.querySelector('#close').addEventListener(async ({ button, }) => { try { +```js +// in a script loaded by the page in the window +document.querySelector('#close').addEventListener(async ({ button, }) => { try { if (button) return; // not a left click const windowId = (await browser.windows.getCurrent()).id; await browser.windows.remove(windowId); // this point will never be reached, since the window is gone -} catch (error) { console.error('Closing failed:', error); } });</pre> +} catch (error) { console.error('Closing failed:', error); } }); +``` -<p>Dans Firefox, la mĂȘme chose pourrait ĂȘtre rĂ©alisĂ©e avec la propriĂ©tĂ© de crĂ©ation de fenĂȘtre <code>.allowScriptsToClose</code> et <code>window.close()</code>.</p> +Dans Firefox, la mĂȘme chose pourrait ĂȘtre rĂ©alisĂ©e avec la propriĂ©tĂ© de crĂ©ation de fenĂȘtre `.allowScriptsToClose` et `window.close()`. -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</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 @@ -110,5 +110,4 @@ document.querySelector('#close').addEventListener(async ({ button, }) => { tr // 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/windows/update/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/update/index.md index f702c18b9a..b5098be23c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/update/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/update/index.md @@ -13,61 +13,60 @@ tags: - Windows translation_of: Mozilla/Add-ons/WebExtensions/API/windows/update --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Mises Ă jour des propriĂ©tĂ©s d'une fenĂȘtre. Utilisez ceci pour dĂ©placer, redimensionner, et (un) se concentrer sur une fenĂȘtre, etc.</p> +Mises Ă jour des propriĂ©tĂ©s d'une fenĂȘtre. Utilisez ceci pour dĂ©placer, redimensionner, et (un) se concentrer sur une fenĂȘtre, etc. -<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 updating = browser.windows.update( +```js +var updating = browser.windows.update( windowId, // integer updateInfo // object ) -</pre> - -<h3 id="ParamĂštres">ParamĂštres</h3> - -<dl> - <dt><code>windowId</code></dt> - <dd><code>integer</code>. ID de la fenĂȘtre Ă mettre Ă jour.</dd> - <dt><code>updateInfo</code></dt> - <dd><p><code>object</code>. Objet contenant les propriĂ©tĂ©s de mise Ă jour.</p> - <dl> - <dt><code>drawAttention</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. si cela est vrai, la fenĂȘtre doit ĂȘtre affichĂ©e de maniĂšre Ă attirer l'attention de l'utilisateur sur la fenĂȘtre, sans changer la fenĂȘtre ciblĂ©e. L'effet dure jusqu'Ă ce que l'utilisateur change de focus sur la fenĂȘtre. Cette option n'a aucun effet si la fenĂȘtre a dĂ©jĂ un focus. Si cela est faux pour annuler la requĂȘte prĂ©cĂ©ndete <code>drawAttention</code>.</dd> - <dt><code>focused</code> {{optional_inline}}</dt> - <dd><code>boolean</code>. Si c'est vrai, apporte la fenĂȘtre Ă l'avant. Si c'est faux, apporte la fenĂȘtre suivante dans le z-order de l'avant.</dd> - <dt><code>height</code> {{optional_inline}}</dt> - <dd><code>integer</code>. Hauteur pour redimensionner la fenĂȘtre en pixels. Cette valeur est ignorĂ©e pour les panneaux.</dd> - <dt><code>left</code> {{optional_inline}}</dt> - <dd><code>integer</code>. Le dĂ©calage du bord gauche de l'Ă©cran pour dĂ©placer la fenĂȘtre en pixels. Cette valeur est ignorĂ©e pour les panneaux.</dd> - <dt><code>state</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef('windows.WindowState')}}. Le nouvel Ă©tat de la fenĂȘtre. Les Ă©tats minimisĂ©s, maximisĂ©s et en plein Ă©cran ne peuvent pas ĂȘtre combinĂ©s avec gauche, haut, largeur ou hauteur.</dd> - <dt><code>titlePreface</code> {{optional_inline}}</dt> - <dd><code>string</code>. Utilisez ceci pour ajouter une chaĂźne au dĂ©but du titre de la fenĂȘtre du navigateur. Selon le systĂšme d'exploitation sous-jacent, cela pourrait ne pas fonctionner sur les fenĂȘtres du navigateur qui n'ont pas de titre (comme about:blank dans Firefox).</dd> - <dt><code>top</code> {{optional_inline}}</dt> - <dd><code>integer</code>. Le dĂ©callage du bord supĂ©rieur de l'Ă©cran pour dĂ©placer la fenĂȘtre en pixels. Cette valeur est ignorĂ©e pour les panneaux.</dd> - <dt><code>width</code> {{optional_inline}}</dt> - <dd><code>integer</code>. La largeur pour redimensionner la fenĂȘtre en pixels. Cette valeur est ignorĂ©e pour les panneaux.</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_de_retour">Valeur de retour</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec un objet {{WebExtAPIRef('windows.Window')}} contenant les dĂ©tails de la fenĂȘtre mise Ă jour. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur.</p> - -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> - -<p>{{Compat("webextensions.api.windows.update")}}</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur, dĂ©placez la fenĂȘtre vers le coin supĂ©rieur gauche:</p> - -<pre class="brush: js">function onUpdated(windowInfo) { +``` + +### ParamĂštres + +- `windowId` + - : `integer`. ID de la fenĂȘtre Ă mettre Ă jour. +- `updateInfo` + + - : `object`. Objet contenant les propriĂ©tĂ©s de mise Ă jour. + + - `drawAttention` {{optional_inline}} + - : `boolean`. si cela est vrai, la fenĂȘtre doit ĂȘtre affichĂ©e de maniĂšre Ă attirer l'attention de l'utilisateur sur la fenĂȘtre, sans changer la fenĂȘtre ciblĂ©e. L'effet dure jusqu'Ă ce que l'utilisateur change de focus sur la fenĂȘtre. Cette option n'a aucun effet si la fenĂȘtre a dĂ©jĂ un focus. Si cela est faux pour annuler la requĂȘte prĂ©cĂ©ndete `drawAttention`. + - `focused` {{optional_inline}} + - : `boolean`. Si c'est vrai, apporte la fenĂȘtre Ă l'avant. Si c'est faux, apporte la fenĂȘtre suivante dans le z-order de l'avant. + - `height` {{optional_inline}} + - : `integer`. Hauteur pour redimensionner la fenĂȘtre en pixels. Cette valeur est ignorĂ©e pour les panneaux. + - `left` {{optional_inline}} + - : `integer`. Le dĂ©calage du bord gauche de l'Ă©cran pour dĂ©placer la fenĂȘtre en pixels. Cette valeur est ignorĂ©e pour les panneaux. + - `state`{{optional_inline}} + - : {{WebExtAPIRef('windows.WindowState')}}. Le nouvel Ă©tat de la fenĂȘtre. Les Ă©tats minimisĂ©s, maximisĂ©s et en plein Ă©cran ne peuvent pas ĂȘtre combinĂ©s avec gauche, haut, largeur ou hauteur. + - `titlePreface` {{optional_inline}} + - : `string`. Utilisez ceci pour ajouter une chaĂźne au dĂ©but du titre de la fenĂȘtre du navigateur. Selon le systĂšme d'exploitation sous-jacent, cela pourrait ne pas fonctionner sur les fenĂȘtres du navigateur qui n'ont pas de titre (comme about:blank dans Firefox). + - `top` {{optional_inline}} + - : `integer`. Le dĂ©callage du bord supĂ©rieur de l'Ă©cran pour dĂ©placer la fenĂȘtre en pixels. Cette valeur est ignorĂ©e pour les panneaux. + - `width` {{optional_inline}} + - : `integer`. La largeur pour redimensionner la fenĂȘtre en pixels. Cette valeur est ignorĂ©e pour les panneaux. + +### Valeur de retour + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) qui sera remplie avec un objet {{WebExtAPIRef('windows.Window')}} contenant les dĂ©tails de la fenĂȘtre mise Ă jour. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur. + +## CompatibilitĂ© du navigateur + +{{Compat("webextensions.api.windows.update")}} + +## Exemples + +Lorsque l'utilisateur clique sur l'icĂŽne d'une action du navigateur, dĂ©placez la fenĂȘtre vers le coin supĂ©rieur gauche: + +```js +function onUpdated(windowInfo) { console.log(`Updated window: ${windowInfo.id}`); } @@ -75,7 +74,7 @@ function onError(error) { console.log(`Error: ${error}`); } -browser.browserAction.onClicked.addListener((tab) => { +browser.browserAction.onClicked.addListener((tab) => { var updating = browser.windows.update(tab.windowId, { left: 0, @@ -84,19 +83,17 @@ browser.browserAction.onClicked.addListener((tab) => { updating.then(onUpdated, onError); }); -</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +``` -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</p> -</div> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<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 @@ -123,5 +120,4 @@ browser.browserAction.onClicked.addListener((tab) => { // 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/windows/window/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/window/index.md index 1bed33bf28..8ddf92f11f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/window/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/window/index.md @@ -5,61 +5,57 @@ tags: - FenĂȘtre translation_of: Mozilla/Add-ons/WebExtensions/API/windows/Window --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Informations sur une fenĂȘtre du navigateur.</p> +Informations sur une fenĂȘtre du navigateur. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriĂ©tĂ©s suivantes : -<dl> - <dt><code>alwaysOnTop</code></dt> - <dd><code>boolean</code>. Que la fenĂȘtre soit configurĂ©e pour toujours ĂȘtre sur le dessus.</dd> - <dt><code>focused</code></dt> - <dd><code>boolean</code>.  Que la fenĂȘtre soit actuellement la fenĂȘtre ciblĂ©e.</dd> - <dt><code>height</code>{{optional_inline}}</dt> - <dd><code>integer</code>. La hauteur de la fenĂȘtre, y compris le cadre, en pixels.</dd> -</dl> +- `alwaysOnTop` + - : `boolean`. Que la fenĂȘtre soit configurĂ©e pour toujours ĂȘtre sur le dessus. +- `focused` + - : `boolean`.  Que la fenĂȘtre soit actuellement la fenĂȘtre ciblĂ©e. +- `height`{{optional_inline}} + - : `integer`. La hauteur de la fenĂȘtre, y compris le cadre, en pixels. -<dl> - <dt><code>id</code>{{optional_inline}}</dt> - <dd><code>integer</code>. L'ID de la fenĂȘtre. Les identifiants de fenĂȘtre sont uniques dans une session de navigateur.</dd> - <dt><code>incognito</code></dt> - <dd><code>boolean</code>. Que la fenĂȘtre soit incognito (privĂ©).</dd> - <dt><code>left</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Le dĂ©calage de la fenĂȘtre du bord gauche de l'Ă©cran en pixels.</dd> - <dt><code>sessionId</code>{{optional_inline}}</dt> - <dd><code>string</code>. L'ID de session utilisĂ© pour identifier de maniĂšre unique une fenĂȘtre obtenue Ă partir de l'API {{WebExtAPIRef ('sessions')}}.</dd> - <dt><code>state</code>{{optional_inline}}</dt> - <dd>Une valeur {{WebExtAPIRef('windows.WindowState')}} reprĂ©sentant l'Ă©tat de cette fenĂȘtre du navigateur - maximisĂ©, minimisĂ©, etc.</dd> - <dt><code>tabs</code>{{optional_inline}}</dt> - <dd>Tableau d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les onglets courants dans la fenĂȘtre.</dd> - <dt><code>title</code> {{optional_inline}}</dt> - <dd>Le titre de la fenĂȘtre du navigateur. NĂ©cessite la permission "tabs". Lecture seulement.</dd> - <dt><code>top</code>{{optional_inline}}</dt> - <dd><code>integer</code>. Le dĂ©calage de la fenĂȘtre du bord supĂ©rieur de l'Ă©cran en pixels.</dd> - <dt><code>type</code>{{optional_inline}}</dt> - <dd>Une valeur {{WebExtAPIRef('windows.WindowType')}} reprĂ©sentant le type de fenĂȘtre du navigateur, c'est-Ă -dire â fenĂȘtre normale du navigateur, fenĂȘtre contextuelle, etc.</dd> - <dt><code>width</code>{{optional_inline}}</dt> - <dd><code>integer</code>. La largeur de la fenĂȘtre, y compris le cadre, en pixels.</dd> -</dl> +<!----> -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +- `id`{{optional_inline}} + - : `integer`. L'ID de la fenĂȘtre. Les identifiants de fenĂȘtre sont uniques dans une session de navigateur. +- `incognito` + - : `boolean`. Que la fenĂȘtre soit incognito (privĂ©). +- `left`{{optional_inline}} + - : `integer`. Le dĂ©calage de la fenĂȘtre du bord gauche de l'Ă©cran en pixels. +- `sessionId`{{optional_inline}} + - : `string`. L'ID de session utilisĂ© pour identifier de maniĂšre unique une fenĂȘtre obtenue Ă partir de l'API {{WebExtAPIRef ('sessions')}}. +- `state`{{optional_inline}} + - : Une valeur {{WebExtAPIRef('windows.WindowState')}} reprĂ©sentant l'Ă©tat de cette fenĂȘtre du navigateur - maximisĂ©, minimisĂ©, etc. +- `tabs`{{optional_inline}} + - : Tableau d'objets {{WebExtAPIRef('tabs.Tab')}} reprĂ©sentant les onglets courants dans la fenĂȘtre. +- `title` {{optional_inline}} + - : Le titre de la fenĂȘtre du navigateur. NĂ©cessite la permission "tabs". Lecture seulement. +- `top`{{optional_inline}} + - : `integer`. Le dĂ©calage de la fenĂȘtre du bord supĂ©rieur de l'Ă©cran en pixels. +- `type`{{optional_inline}} + - : Une valeur {{WebExtAPIRef('windows.WindowType')}} reprĂ©sentant le type de fenĂȘtre du navigateur, c'est-Ă -dire â fenĂȘtre normale du navigateur, fenĂȘtre contextuelle, etc. +- `width`{{optional_inline}} + - : `integer`. La largeur de la fenĂȘtre, y compris le cadre, en pixels. -<p>{{Compat("webextensions.api.windows.Window")}}</p> +## CompatibilitĂ© du navigateur -<p>{{WebExtExamples}}</p> +{{Compat("webextensions.api.windows.Window")}} -<div class="note"><p><strong>Note :</strong></p> +{{WebExtExamples}} -<p>Cette API est basĂ©e sur l'API de Chromium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</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 @@ -86,5 +82,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/windows/Window // 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/windows/window_id_current/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/window_id_current/index.md index 831dcf35ee..8e804f207b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/window_id_current/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/window_id_current/index.md @@ -12,25 +12,23 @@ tags: - Windows translation_of: Mozilla/Add-ons/WebExtensions/API/windows/WINDOW_ID_CURRENT --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p><code>browser.windows.WINDOW_ID_CURRENT</code> est une valeur qui peut ĂȘtre utilisĂ©e comme paramĂštre <code>windowId</code> dans certaines APIs pour reprĂ©senter la fenĂȘtre courante.</p> +`browser.windows.WINDOW_ID_CURRENT` est une valeur qui peut ĂȘtre utilisĂ©e comme paramĂštre `windowId` dans certaines APIs pour reprĂ©senter la fenĂȘtre courante. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.windows.WINDOW_ID_CURRENT")}}</p> +{{Compat("webextensions.api.windows.WINDOW_ID_CURRENT")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</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 @@ -57,5 +55,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/windows/WINDOW_ID_CURRENT // 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/windows/window_id_none/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/window_id_none/index.md index 6938bdf934..10390d1104 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/window_id_none/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/window_id_none/index.md @@ -13,25 +13,23 @@ tags: - Windows translation_of: Mozilla/Add-ons/WebExtensions/API/windows/WINDOW_ID_NONE --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>La valeur <code>windowId</code> que reprĂ©sente l'absence d'une fenĂȘtre du navigateur.</p> +La valeur `windowId` que reprĂ©sente l'absence d'une fenĂȘtre du navigateur. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.windows.WINDOW_ID_NONE")}}</p> +{{Compat("webextensions.api.windows.WINDOW_ID_NONE")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</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 @@ -58,5 +56,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/windows/WINDOW_ID_NONE // 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/windows/windowstate/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/windowstate/index.md index ab630300db..ea2431c66a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/windowstate/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/windowstate/index.md @@ -13,44 +13,40 @@ tags: - Windows translation_of: Mozilla/Add-ons/WebExtensions/API/windows/WindowState --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>L'Ă©tat de cette fenĂȘtre du navigateur.</p> +L'Ă©tat de cette fenĂȘtre du navigateur. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont:</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont: -<dl> - <dt><code>"normal"</code></dt> - <dd>La fenĂȘtre est Ă la taille par dĂ©faut ou Ă la taille sĂ©lectionnĂ©e par l'utilisateur.</dd> - <dt><code>"minimized"</code></dt> - <dd>La fenĂȘtre n'est visible que sous la forme d'une icĂŽne dans la barre des tĂąches ou .</dd> - <dt><code>"maximized"</code></dt> - <dd>La fenĂȘtre remplit l'Ă©cran sur lequel elle est affichĂ©e sans inclure les zones d'Ă©cran rĂ©servĂ©es par le systĂšme d'exploitation.</dd> - <dt><code>"fullscreen"</code></dt> - <dd>La fenĂȘtre s'exĂ©cute en plein Ă©cran ou le contenu d'un onglet utilise l'<a href="/fr/docs/Web/API/Fullscreen_API">API Fullscreen</a></dd> - <dt><code>"docked"</code></dt> - <dd>Une fenĂȘtre ancrĂ©e occupe une position fixe par rapport aux autres fenĂȘtres appartenant Ă la mĂȘme application.</dd> -</dl> +- `"normal"` + - : La fenĂȘtre est Ă la taille par dĂ©faut ou Ă la taille sĂ©lectionnĂ©e par l'utilisateur. +- `"minimized"` + - : La fenĂȘtre n'est visible que sous la forme d'une icĂŽne dans la barre des tĂąches ou . +- `"maximized"` + - : La fenĂȘtre remplit l'Ă©cran sur lequel elle est affichĂ©e sans inclure les zones d'Ă©cran rĂ©servĂ©es par le systĂšme d'exploitation. +- `"fullscreen"` + - : La fenĂȘtre s'exĂ©cute en plein Ă©cran ou le contenu d'un onglet utilise l'[API Fullscreen](/fr/docs/Web/API/Fullscreen_API) +- `"docked"` + - : Une fenĂȘtre ancrĂ©e occupe une position fixe par rapport aux autres fenĂȘtres appartenant Ă la mĂȘme application. -<p>CompatibilitĂ© macOS : A partir de macOS 10.10, le comportement de maximisation par dĂ©faut pour les fenĂȘtres a Ă©tĂ© modifiĂ© pour exĂ©cuter les applications en plein Ă©cran au lieu des fenĂȘtres "zoomĂ©es". <code>fullscreen</code> fait rĂ©fĂ©rence Ă la fois au navigateur fonctionnant en plein Ă©cran et lorsque le contenu dans un onglet utilise l'API Fullscreen.</p> +CompatibilitĂ© macOS : A partir de macOS 10.10, le comportement de maximisation par dĂ©faut pour les fenĂȘtres a Ă©tĂ© modifiĂ© pour exĂ©cuter les applications en plein Ă©cran au lieu des fenĂȘtres "zoomĂ©es". `fullscreen` fait rĂ©fĂ©rence Ă la fois au navigateur fonctionnant en plein Ă©cran et lorsque le contenu dans un onglet utilise l'API Fullscreen. -<h2 id="CompatibilitĂ©_du_navigateur">CompatibilitĂ© du navigateur</h2> +## CompatibilitĂ© du navigateur -<p>{{Compat("webextensions.api.windows.WindowState")}}</p> +{{Compat("webextensions.api.windows.WindowState")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</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 @@ -77,5 +73,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/windows/WindowState // 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/windows/windowtype/index.md b/files/fr/mozilla/add-ons/webextensions/api/windows/windowtype/index.md index 51c5c72e59..c23cca6a6f 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/windows/windowtype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/windows/windowtype/index.md @@ -13,36 +13,32 @@ tags: - Windows translation_of: Mozilla/Add-ons/WebExtensions/API/windows/WindowType --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Le type de la fenĂȘtre du navigateur est comme çà .</p> +Le type de la fenĂȘtre du navigateur est comme çà . -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaĂźnes. Les valeurs possibles sont : -<ul> - <li><code>"normal"</code></li> - <li><code>"popup"</code></li> - <li><code>"panel"</code></li> - <li><code>"devtools"</code></li> -</ul> +- `"normal"` +- `"popup"` +- `"panel"` +- `"devtools"` -<h2 id="Browser_compatibility">Browser compatibility</h2> +## Browser compatibility -<p>{{Compat("webextensions.api.windows.WindowType")}}</p> +{{Compat("webextensions.api.windows.WindowType")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basĂ©e sur l'API de Chromnium [`chrome.windows`](https://developer.chrome.com/extensions/windows). Cette documentation provient de [`windows.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json) dans le code de Chromium. +> +> Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States. -<p>Cette API est basĂ©e sur l'API de Chromnium <a href="https://developer.chrome.com/extensions/windows"><code>chrome.windows</code></a>. Cette documentation provient de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/windows.json"><code>windows.json</code></a> dans le code de Chromium.</p> - -<p>Les donnĂ©es de compatibilitĂ© Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.</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 @@ -69,5 +65,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/windows/WindowType // 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> |