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/sessions | |
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/sessions')
15 files changed, 400 insertions, 464 deletions
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}} |