From f36cc6a7639a8f1adff02bc7a152bd7f54ceae6d Mon Sep 17 00:00:00 2001 From: julieng Date: Mon, 15 Nov 2021 21:45:09 +0100 Subject: move *.html to *.md --- .../webextensions/api/sessions/filter/index.html | 73 ----------- .../webextensions/api/sessions/filter/index.md | 73 +++++++++++ .../api/sessions/forgetclosedtab/index.html | 78 ------------ .../api/sessions/forgetclosedtab/index.md | 78 ++++++++++++ .../api/sessions/forgetclosedwindow/index.html | 75 ------------ .../api/sessions/forgetclosedwindow/index.md | 75 ++++++++++++ .../api/sessions/getrecentlyclosed/index.html | 113 ----------------- .../api/sessions/getrecentlyclosed/index.md | 113 +++++++++++++++++ .../api/sessions/gettabvalue/index.html | 64 ---------- .../api/sessions/gettabvalue/index.md | 64 ++++++++++ .../api/sessions/getwindowvalue/index.html | 64 ---------- .../api/sessions/getwindowvalue/index.md | 64 ++++++++++ .../add-ons/webextensions/api/sessions/index.html | 134 --------------------- .../add-ons/webextensions/api/sessions/index.md | 134 +++++++++++++++++++++ .../api/sessions/max_session_results/index.html | 60 --------- .../api/sessions/max_session_results/index.md | 60 +++++++++ .../api/sessions/onchanged/index.html | 121 ------------------- .../webextensions/api/sessions/onchanged/index.md | 121 +++++++++++++++++++ .../api/sessions/removetabvalue/index.html | 82 ------------- .../api/sessions/removetabvalue/index.md | 82 +++++++++++++ .../api/sessions/removewindowvalue/index.html | 80 ------------ .../api/sessions/removewindowvalue/index.md | 80 ++++++++++++ .../webextensions/api/sessions/restore/index.html | 110 ----------------- .../webextensions/api/sessions/restore/index.md | 110 +++++++++++++++++ .../webextensions/api/sessions/session/index.html | 84 ------------- .../webextensions/api/sessions/session/index.md | 84 +++++++++++++ .../api/sessions/settabvalue/index.html | 69 ----------- .../api/sessions/settabvalue/index.md | 69 +++++++++++ .../api/sessions/setwindowvalue/index.html | 68 ----------- .../api/sessions/setwindowvalue/index.md | 68 +++++++++++ 30 files changed, 1275 insertions(+), 1275 deletions(-) delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/filter/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/filter/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedtab/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedtab/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedwindow/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedwindow/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/getrecentlyclosed/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/getrecentlyclosed/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/gettabvalue/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/gettabvalue/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/getwindowvalue/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/getwindowvalue/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/max_session_results/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/max_session_results/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/onchanged/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/onchanged/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/removetabvalue/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/removetabvalue/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/removewindowvalue/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/removewindowvalue/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/restore/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/restore/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/session/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/session/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/settabvalue/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/settabvalue/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/setwindowvalue/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/sessions/setwindowvalue/index.md (limited to 'files/fr/mozilla/add-ons/webextensions/api/sessions') diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/filter/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/filter/index.html deleted file mode 100644 index aa88a320ee..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/filter/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: sessions.Filter -slug: Mozilla/Add-ons/WebExtensions/API/sessions/Filter -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions - - filter - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/Filter ---- -
{{AddonSidebar()}}
- -

L'objet Filter permet de restreindre le nombre d'objets {{WebExtAPIRef("sessions.Session", "Session")}} retournés par un appel à {{WebExtAPIRef("sessions.getRecentlyClosed()")}}.

- -

Type

- -

Les valeurs de ce type sont des objets. Ils contiennent les proriétés suivantes :

- -
-
maxResults{{optional_inline}}
-
number. Le nombre maximal de résultats à retourner.
-
- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.Filter")}}

- -

Exemples

- -

{{WebExtExamples}}

- -

Note :

- -

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

-
- - 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 new file mode 100644 index 0000000000..aa88a320ee --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/filter/index.md @@ -0,0 +1,73 @@ +--- +title: sessions.Filter +slug: Mozilla/Add-ons/WebExtensions/API/sessions/Filter +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - filter + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/Filter +--- +
{{AddonSidebar()}}
+ +

L'objet Filter permet de restreindre le nombre d'objets {{WebExtAPIRef("sessions.Session", "Session")}} retournés par un appel à {{WebExtAPIRef("sessions.getRecentlyClosed()")}}.

+ +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les proriétés suivantes :

+ +
+
maxResults{{optional_inline}}
+
number. Le nombre maximal de résultats à retourner.
+
+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.Filter")}}

+ +

Exemples

+ +

{{WebExtExamples}}

+ +

Note :

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedtab/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedtab/index.html deleted file mode 100644 index 5f912ed8cd..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedtab/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: sessions.forgetClosedTab() -slug: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedTab -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - forgetClosedTab - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedTab ---- -
{{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.
- -
- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var forgettingTab = browser.sessions.forgetClosedTab(
-  windowId,            // integer
-  sessionId            // string
-)
-
- -

Paramètres

- -
-
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.
-
- -

Valeur retournée

- -

Une Promise. Cela sera accompli sans arguments lorsque la session a été supprimée.

- -

Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.forgetClosedTab")}}

- -

Exemples

- -

Ce code oublie la dernière session fermée, qu'il s'agisse d'un onglet ou d'une fenêtre :

- -
function forgetMostRecent(sessionInfos) {
-  if (!sessionInfos.length) {
-    console.log("No sessions found")
-    return;
-  }
-  let sessionInfo = sessionInfos[0];
-  if (sessionInfo.tab) {
-    browser.sessions.forgetClosedTab(sessionInfo.tab.windowId, sessionInfo.tab.sessionId);
-  } else {
-    browser.sessions.forgetClosedWindow(sessionInfo.window.sessionId);
-  }
-}
-
-function onError(error) {
-  console.log(error);
-}
-
-browser.sessions.getRecentlyClosed({maxResults: 1})
-.then(forgetMostRecent, onError);
- -

{{WebExtExamples}}

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 new file mode 100644 index 0000000000..5f912ed8cd --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedtab/index.md @@ -0,0 +1,78 @@ +--- +title: sessions.forgetClosedTab() +slug: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedTab +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - forgetClosedTab + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedTab +--- +
{{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.
+ +
+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var forgettingTab = browser.sessions.forgetClosedTab(
+  windowId,            // integer
+  sessionId            // string
+)
+
+ +

Paramètres

+ +
+
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.
+
+ +

Valeur retournée

+ +

Une Promise. Cela sera accompli sans arguments lorsque la session a été supprimée.

+ +

Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.forgetClosedTab")}}

+ +

Exemples

+ +

Ce code oublie la dernière session fermée, qu'il s'agisse d'un onglet ou d'une fenêtre :

+ +
function forgetMostRecent(sessionInfos) {
+  if (!sessionInfos.length) {
+    console.log("No sessions found")
+    return;
+  }
+  let sessionInfo = sessionInfos[0];
+  if (sessionInfo.tab) {
+    browser.sessions.forgetClosedTab(sessionInfo.tab.windowId, sessionInfo.tab.sessionId);
+  } else {
+    browser.sessions.forgetClosedWindow(sessionInfo.window.sessionId);
+  }
+}
+
+function onError(error) {
+  console.log(error);
+}
+
+browser.sessions.getRecentlyClosed({maxResults: 1})
+.then(forgetMostRecent, onError);
+ +

{{WebExtExamples}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedwindow/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedwindow/index.html deleted file mode 100644 index 3f78c9303b..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedwindow/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: sessions.forgetClosedWindow() -slug: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedWindow -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - forgetClosedWindows - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedWindow ---- -
{{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.
- -
- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var forgettingWindow = browser.sessions.forgetClosedWindow(
-  sessionId            // string
-)
-
- -

Paramètres

- -
-
sessionId
-
String. L'identifiant de la session que vous voulez oublier.
-
- -

Valeur retournée

- -

Une Promise. Cela sera accompli sans arguments lorsque la session a été supprimée.

- -

Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.forgetClosedWindow")}}

- -

Exemples

- -

Ce code oublie la dernière session fermée, qu'il s'agisse d'un onglet ou d'une fenêtre :

- -
function forgetMostRecent(sessionInfos) {
-  if (!sessionInfos.length) {
-    console.log("No sessions found")
-    return;
-  }
-  let sessionInfo = sessionInfos[0];
-  if (sessionInfo.tab) {
-    browser.sessions.forgetClosedTab(sessionInfo.tab.windowId, sessionInfo.tab.sessionId);
-  } else {
-    browser.sessions.forgetClosedWindow(sessionInfo.window.sessionId);
-  }
-}
-
-function onError(error) {
-  console.log(error);
-}
-
-browser.sessions.getRecentlyClosed({maxResults: 1})
-.then(forgetMostRecent, onError);
- -

{{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 new file mode 100644 index 0000000000..3f78c9303b --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/forgetclosedwindow/index.md @@ -0,0 +1,75 @@ +--- +title: sessions.forgetClosedWindow() +slug: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedWindow +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - forgetClosedWindows + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedWindow +--- +
{{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.
+ +
+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var forgettingWindow = browser.sessions.forgetClosedWindow(
+  sessionId            // string
+)
+
+ +

Paramètres

+ +
+
sessionId
+
String. L'identifiant de la session que vous voulez oublier.
+
+ +

Valeur retournée

+ +

Une Promise. Cela sera accompli sans arguments lorsque la session a été supprimée.

+ +

Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.forgetClosedWindow")}}

+ +

Exemples

+ +

Ce code oublie la dernière session fermée, qu'il s'agisse d'un onglet ou d'une fenêtre :

+ +
function forgetMostRecent(sessionInfos) {
+  if (!sessionInfos.length) {
+    console.log("No sessions found")
+    return;
+  }
+  let sessionInfo = sessionInfos[0];
+  if (sessionInfo.tab) {
+    browser.sessions.forgetClosedTab(sessionInfo.tab.windowId, sessionInfo.tab.sessionId);
+  } else {
+    browser.sessions.forgetClosedWindow(sessionInfo.window.sessionId);
+  }
+}
+
+function onError(error) {
+  console.log(error);
+}
+
+browser.sessions.getRecentlyClosed({maxResults: 1})
+.then(forgetMostRecent, onError);
+ +

{{WebExtExamples}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/getrecentlyclosed/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/getrecentlyclosed/index.html deleted file mode 100644 index be1e181aff..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/getrecentlyclosed/index.html +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: sessions.getRecentlyClosed() -slug: Mozilla/Add-ons/WebExtensions/API/sessions/getRecentlyClosed -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - getRecentlyClosed - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/getRecentlyClosed ---- -
{{AddonSidebar()}}
- -

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).

- -

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

- -

Syntaxe

- -
var gettingSessions = browser.sessions.getRecentlyClosed(
-  filter             // optional object
-)
-
- -

Paramètres

- -
-
filter{{optional_inline}}
-
object. Un objet {{WebExtAPIRef("sessions.Filter")}} qui limite l'ensemble des sessions renvoyées.
-
- -

Valeur retournée

- -

Une 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.

- -

Si une erreur survient, la promesse sera rejetée avec un message d'erreur.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.getRecentlyClosed")}}

- -

Exemples

- -

Le code restaure la session la plus récemment fermée, qu'il s'agisse d'un onglet ou d'une fenêtre :

- -
function restoreMostRecent(sessionInfos) {
-  if (!sessionInfos.length) {
-    console.log("No sessions found")
-    return;
-  }
-  let sessionInfo = sessionInfos[0];
-  if (sessionInfo.tab) {
-    browser.sessions.restore(sessionInfo.tab.sessionId);
-  } else {
-    browser.sessions.restore(sessionInfo.window.sessionId);
-  }
-}
-
-function onError(error) {
-  console.log(error);
-}
-
-browser.browserAction.onClicked.addListener(function() {
-  var gettingSessions = browser.sessions.getRecentlyClosed({
-    maxResults: 1
-  });
-  gettingSessions.then(restoreMostRecent, onError);
-});
-
- -

{{WebExtExamples}}

- -

Note :

- -

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

-
- - 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 new file mode 100644 index 0000000000..be1e181aff --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/getrecentlyclosed/index.md @@ -0,0 +1,113 @@ +--- +title: sessions.getRecentlyClosed() +slug: Mozilla/Add-ons/WebExtensions/API/sessions/getRecentlyClosed +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getRecentlyClosed + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/getRecentlyClosed +--- +
{{AddonSidebar()}}
+ +

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).

+ +

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

+ +

Syntaxe

+ +
var gettingSessions = browser.sessions.getRecentlyClosed(
+  filter             // optional object
+)
+
+ +

Paramètres

+ +
+
filter{{optional_inline}}
+
object. Un objet {{WebExtAPIRef("sessions.Filter")}} qui limite l'ensemble des sessions renvoyées.
+
+ +

Valeur retournée

+ +

Une 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.

+ +

Si une erreur survient, la promesse sera rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.getRecentlyClosed")}}

+ +

Exemples

+ +

Le code restaure la session la plus récemment fermée, qu'il s'agisse d'un onglet ou d'une fenêtre :

+ +
function restoreMostRecent(sessionInfos) {
+  if (!sessionInfos.length) {
+    console.log("No sessions found")
+    return;
+  }
+  let sessionInfo = sessionInfos[0];
+  if (sessionInfo.tab) {
+    browser.sessions.restore(sessionInfo.tab.sessionId);
+  } else {
+    browser.sessions.restore(sessionInfo.window.sessionId);
+  }
+}
+
+function onError(error) {
+  console.log(error);
+}
+
+browser.browserAction.onClicked.addListener(function() {
+  var gettingSessions = browser.sessions.getRecentlyClosed({
+    maxResults: 1
+  });
+  gettingSessions.then(restoreMostRecent, onError);
+});
+
+ +

{{WebExtExamples}}

+ +

Note :

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/gettabvalue/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/gettabvalue/index.html deleted file mode 100644 index 2c52bac4fc..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/gettabvalue/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: sessions.getTabValue() -slug: Mozilla/Add-ons/WebExtensions/API/sessions/getTabValue -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - getTabValue - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/getTabValue ---- -
{{AddonSidebar()}}
- -

Récupère une valeur précédemment stockée par un appel à  {{WebExtAPIRef("sessions.setTabValue")}}.

- -

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.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var retrieving = browser.sessions.getTabValue(
-  tabId,    // integer
-  key       // string
-)
-
- -

Paramètres

- -
-
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")}}.
-
- -

Valeur retournée

- -

Une 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.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.getTabValue", 10)}}

- -

Exemples

- -

Consignez la valeur de "my-key" pour tous les nouveaux onglets créés (cela inclura tous les onglets qui ont été restaurés) :

- -
function onGetResolved(r) {
-  console.log(`success: ${r}`);
-}
-
-function onGetRejected(e) {
-  console.log(`error: ${e}`);
-}
-
-browser.tabs.onCreated.addListener((tab) => {
-  browser.sessions.getTabValue(tab.id, "my-key").then(onGetResolved, onGetRejected);
-});
- -

{{WebExtExamples}}

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 new file mode 100644 index 0000000000..2c52bac4fc --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/gettabvalue/index.md @@ -0,0 +1,64 @@ +--- +title: sessions.getTabValue() +slug: Mozilla/Add-ons/WebExtensions/API/sessions/getTabValue +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - getTabValue + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/getTabValue +--- +
{{AddonSidebar()}}
+ +

Récupère une valeur précédemment stockée par un appel à  {{WebExtAPIRef("sessions.setTabValue")}}.

+ +

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.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var retrieving = browser.sessions.getTabValue(
+  tabId,    // integer
+  key       // string
+)
+
+ +

Paramètres

+ +
+
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")}}.
+
+ +

Valeur retournée

+ +

Une 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.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.getTabValue", 10)}}

+ +

Exemples

+ +

Consignez la valeur de "my-key" pour tous les nouveaux onglets créés (cela inclura tous les onglets qui ont été restaurés) :

+ +
function onGetResolved(r) {
+  console.log(`success: ${r}`);
+}
+
+function onGetRejected(e) {
+  console.log(`error: ${e}`);
+}
+
+browser.tabs.onCreated.addListener((tab) => {
+  browser.sessions.getTabValue(tab.id, "my-key").then(onGetResolved, onGetRejected);
+});
+ +

{{WebExtExamples}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/getwindowvalue/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/getwindowvalue/index.html deleted file mode 100644 index 093d61dc9f..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/getwindowvalue/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: sessions.getWindowValue() -slug: Mozilla/Add-ons/WebExtensions/API/sessions/getWindowValue -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - getWindowValue - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/getWindowValue ---- -
{{AddonSidebar()}}
- -

Récupère une valeur précédemment stockée par un appel à {{WebExtAPIRef("sessions.setWindowValue")}}.

- -

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.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var retrieving = browser.sessions.getWindowValue(
-  windowId,    // integer
-  key          // string
-)
-
- -

Paramètres

- -
-
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")}}.
-
- -

Valeure retournée

- -

Une 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.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.getWindowValue", 10)}}

- -

Exemples

- -

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) :

- -
function onGetResolved(r) {
-  console.log(`success: ${r}`);
-}
-
-function onGetRejected(e) {
-  console.log(`error: ${e}`);
-}
-
-browser.windows.onCreated.addListener((window) => {
-  browser.sessions.getWindowValue(window.id, "my-key").then(onGetResolved, onGetRejected);
-});
- -

{{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 new file mode 100644 index 0000000000..093d61dc9f --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/getwindowvalue/index.md @@ -0,0 +1,64 @@ +--- +title: sessions.getWindowValue() +slug: Mozilla/Add-ons/WebExtensions/API/sessions/getWindowValue +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - getWindowValue + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/getWindowValue +--- +
{{AddonSidebar()}}
+ +

Récupère une valeur précédemment stockée par un appel à {{WebExtAPIRef("sessions.setWindowValue")}}.

+ +

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.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var retrieving = browser.sessions.getWindowValue(
+  windowId,    // integer
+  key          // string
+)
+
+ +

Paramètres

+ +
+
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")}}.
+
+ +

Valeure retournée

+ +

Une 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.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.getWindowValue", 10)}}

+ +

Exemples

+ +

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) :

+ +
function onGetResolved(r) {
+  console.log(`success: ${r}`);
+}
+
+function onGetRejected(e) {
+  console.log(`error: ${e}`);
+}
+
+browser.windows.onCreated.addListener((window) => {
+  browser.sessions.getWindowValue(window.id, "my-key").then(onGetResolved, onGetRejected);
+});
+ +

{{WebExtExamples}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/index.html deleted file mode 100644 index 8cb87b54be..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/index.html +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: sessions -slug: Mozilla/Add-ons/WebExtensions/API/sessions -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Reference - - WebExtensions - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions ---- -
{{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 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().
-
- -

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.

- -

Les données de 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/sessions/index.md b/files/fr/mozilla/add-ons/webextensions/api/sessions/index.md new file mode 100644 index 0000000000..8cb87b54be --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/index.md @@ -0,0 +1,134 @@ +--- +title: sessions +slug: Mozilla/Add-ons/WebExtensions/API/sessions +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - WebExtensions + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions +--- +
{{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 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().
+
+ +

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.

+ +

Les données de 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/sessions/max_session_results/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/max_session_results/index.html deleted file mode 100644 index 0b0e17b7f3..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/max_session_results/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: sessions.MAX_SESSION_RESULTS -slug: Mozilla/Add-ons/WebExtensions/API/sessions/MAX_SESSION_RESULTS -tags: - - API - - Add-ons - - Extensions - - MAX_SESSION_RESULTS - - Non-standard - - Propriété - - Reference - - WebExtensions - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/MAX_SESSION_RESULTS ---- -
{{AddonSidebar()}}
- -

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.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.MAX_SESSION_RESULTS")}}

- -

Note :

- -

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

-
- - 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 new file mode 100644 index 0000000000..0b0e17b7f3 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/max_session_results/index.md @@ -0,0 +1,60 @@ +--- +title: sessions.MAX_SESSION_RESULTS +slug: Mozilla/Add-ons/WebExtensions/API/sessions/MAX_SESSION_RESULTS +tags: + - API + - Add-ons + - Extensions + - MAX_SESSION_RESULTS + - Non-standard + - Propriété + - Reference + - WebExtensions + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/MAX_SESSION_RESULTS +--- +
{{AddonSidebar()}}
+ +

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.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.MAX_SESSION_RESULTS")}}

+ +

Note :

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/onchanged/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/onchanged/index.html deleted file mode 100644 index d702c852a2..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/onchanged/index.html +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: sessions.onChanged -slug: Mozilla/Add-ons/WebExtensions/API/sessions/onChanged -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onChanged - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/onChanged ---- -
{{AddonSidebar()}}
- -

Mise en place lorsque une liste d'onglets fermes ou de fenêtre changes.

- -

Syntaxe

- -
browser.sessions.onChanged.addListener(listener)
-browser.sessions.onChanged.removeListener(listener)
-browser.sessions.onChanged.hasListener(listener)
-
- -

Les événements ont trois fonctions :

- -
-
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.
-
- -

Syntaxe addListener

- -

Paramètres

- -
-
callback
-
-

Fonction qui sera appelée lors de l'événement. Il ne passe aucun paramètre.

-
-
- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.onChanged")}}

- -

Exemples

- -

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 :

- -
function restoreSession(sessionInfos) {
-  if (!sessionInfos.length) {
-    console.log("No sessions found")
-    return;
-  }
-  let sessionInfo = sessionInfos[0];
-  if (sessionInfo.tab) {
-    browser.sessions.restore(sessionInfo.tab.sessionId);
-  } else {
-    browser.sessions.restore(sessionInfo.window.sessionId);
-  }
-}
-
-function onError(error) {
-  console.log(error);
-}
-
-function restoreMostRecent() {
-  var gettingSessions = browser.sessions.getRecentlyClosed({
-    maxResults: 1
-  });
-  gettingSessions.then(restoreSession, onError);
-}
-
-browser.sessions.onChanged.addListener(restoreMostRecent);
- -

{{WebExtExamples}}

- -

Note :

- -

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

-
- - 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 new file mode 100644 index 0000000000..d702c852a2 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/onchanged/index.md @@ -0,0 +1,121 @@ +--- +title: sessions.onChanged +slug: Mozilla/Add-ons/WebExtensions/API/sessions/onChanged +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onChanged + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/onChanged +--- +
{{AddonSidebar()}}
+ +

Mise en place lorsque une liste d'onglets fermes ou de fenêtre changes.

+ +

Syntaxe

+ +
browser.sessions.onChanged.addListener(listener)
+browser.sessions.onChanged.removeListener(listener)
+browser.sessions.onChanged.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
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.
+
+ +

Syntaxe addListener

+ +

Paramètres

+ +
+
callback
+
+

Fonction qui sera appelée lors de l'événement. Il ne passe aucun paramètre.

+
+
+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.onChanged")}}

+ +

Exemples

+ +

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 :

+ +
function restoreSession(sessionInfos) {
+  if (!sessionInfos.length) {
+    console.log("No sessions found")
+    return;
+  }
+  let sessionInfo = sessionInfos[0];
+  if (sessionInfo.tab) {
+    browser.sessions.restore(sessionInfo.tab.sessionId);
+  } else {
+    browser.sessions.restore(sessionInfo.window.sessionId);
+  }
+}
+
+function onError(error) {
+  console.log(error);
+}
+
+function restoreMostRecent() {
+  var gettingSessions = browser.sessions.getRecentlyClosed({
+    maxResults: 1
+  });
+  gettingSessions.then(restoreSession, onError);
+}
+
+browser.sessions.onChanged.addListener(restoreMostRecent);
+ +

{{WebExtExamples}}

+ +

Note :

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/removetabvalue/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/removetabvalue/index.html deleted file mode 100644 index c943c5184b..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/removetabvalue/index.html +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: sessions.removeTabValue() -slug: Mozilla/Add-ons/WebExtensions/API/sessions/removeTabValue -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - removeTabValue - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/removeTabValue ---- -
{{AddonSidebar()}}
- -

Supprime une valeur précédemment stockée par un appel à {{WebExtAPIRef("sessions.setTabValue")}}.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var removing = browser.sessions.removeTabValue(
-  tabId,    // integer
-  key       // string
-)
-
- -

Paramètres

- -
-
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")}}.
-
- -

Valeur retournée

- -

Une 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.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.removeTabValue", 10)}}

- -

Exemples

- -

Ce code ajoute deux éléments de menu contextuel: l'un stocke une valeur associée à l'onglet en cours, l'autre le supprime :

- -
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");
-}
-
-async function removeFromActiveTab() {
-  let tabArray = await browser.tabs.query({currentWindow: true, active: true});
-  let tabId = tabArray[0].id;
-  await browser.sessions.removeTabValue(tabId, "my-key");
-}
-
-browser.menus.create({
-  id: "add-my-item",
-  title: "add item",
-  contexts: ["all"]
-});
-
-browser.menus.create({
-  id: "remove-my-item",
-  title: "remove item",
-  contexts: ["all"]
-});
-
-browser.menus.onClicked.addListener((info) => {
-  if (info.menuItemId === "add-my-item") {
-    setOnActiveTab();
-  } else {
-    removeFromActiveTab();
-  }
-});
- -

{{WebExtExamples}}

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 new file mode 100644 index 0000000000..c943c5184b --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/removetabvalue/index.md @@ -0,0 +1,82 @@ +--- +title: sessions.removeTabValue() +slug: Mozilla/Add-ons/WebExtensions/API/sessions/removeTabValue +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - removeTabValue + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/removeTabValue +--- +
{{AddonSidebar()}}
+ +

Supprime une valeur précédemment stockée par un appel à {{WebExtAPIRef("sessions.setTabValue")}}.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var removing = browser.sessions.removeTabValue(
+  tabId,    // integer
+  key       // string
+)
+
+ +

Paramètres

+ +
+
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")}}.
+
+ +

Valeur retournée

+ +

Une 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.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.removeTabValue", 10)}}

+ +

Exemples

+ +

Ce code ajoute deux éléments de menu contextuel: l'un stocke une valeur associée à l'onglet en cours, l'autre le supprime :

+ +
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");
+}
+
+async function removeFromActiveTab() {
+  let tabArray = await browser.tabs.query({currentWindow: true, active: true});
+  let tabId = tabArray[0].id;
+  await browser.sessions.removeTabValue(tabId, "my-key");
+}
+
+browser.menus.create({
+  id: "add-my-item",
+  title: "add item",
+  contexts: ["all"]
+});
+
+browser.menus.create({
+  id: "remove-my-item",
+  title: "remove item",
+  contexts: ["all"]
+});
+
+browser.menus.onClicked.addListener((info) => {
+  if (info.menuItemId === "add-my-item") {
+    setOnActiveTab();
+  } else {
+    removeFromActiveTab();
+  }
+});
+ +

{{WebExtExamples}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/removewindowvalue/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/removewindowvalue/index.html deleted file mode 100644 index ba590fd013..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/removewindowvalue/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: sessions.removeWindowValue() -slug: Mozilla/Add-ons/WebExtensions/API/sessions/removeWindowValue -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - removeWindowsValue - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/removeWindowValue ---- -
{{AddonSidebar()}}
- -

Supprime une valeur précédemment stockée par un appel à {{WebExtAPIRef("sessions.setWindowValue")}}.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var removing = browser.sessions.removeWindowValue(
-  windowId,    // integer
-  key          // string
-)
-
- -

Paramètres

- -
-
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")}}.
-
- -

Valeur retournée

- -

Une 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.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.removeWindowValue", 10)}}

- -

Exemples

- -

Ce code ajoute deux éléments de menu contextuel: l'un stocke une valeur associée à la fenêtre courante, l'autre la supprime :

- -
async function setOnActiveWindow() {
-  let currentWindow = await browser.windows.getLastFocused();
-  await browser.sessions.setWindowValue(currentWindow.id, "my-key", "my-value");
-}
-
-async function removeFromActiveWindow() {
-  let currentWindow = await browser.windows.getLastFocused();
-  await browser.sessions.removeWindowValue(currentWindow.id, "my-key");
-}
-
-browser.menus.create({
-  id: "add-my-item",
-  title: "add item",
-  contexts: ["all"]
-});
-
-browser.menus.create({
-  id: "remove-my-item",
-  title: "remove item",
-  contexts: ["all"]
-});
-
-browser.menus.onClicked.addListener((info) => {
-  if (info.menuItemId === "add-my-item") {
-    setOnActiveWindow();
-  } else {
-    removeFromActiveWindow();
-  }
-});
- -

{{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 new file mode 100644 index 0000000000..ba590fd013 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/removewindowvalue/index.md @@ -0,0 +1,80 @@ +--- +title: sessions.removeWindowValue() +slug: Mozilla/Add-ons/WebExtensions/API/sessions/removeWindowValue +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - removeWindowsValue + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/removeWindowValue +--- +
{{AddonSidebar()}}
+ +

Supprime une valeur précédemment stockée par un appel à {{WebExtAPIRef("sessions.setWindowValue")}}.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var removing = browser.sessions.removeWindowValue(
+  windowId,    // integer
+  key          // string
+)
+
+ +

Paramètres

+ +
+
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")}}.
+
+ +

Valeur retournée

+ +

Une 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.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.removeWindowValue", 10)}}

+ +

Exemples

+ +

Ce code ajoute deux éléments de menu contextuel: l'un stocke une valeur associée à la fenêtre courante, l'autre la supprime :

+ +
async function setOnActiveWindow() {
+  let currentWindow = await browser.windows.getLastFocused();
+  await browser.sessions.setWindowValue(currentWindow.id, "my-key", "my-value");
+}
+
+async function removeFromActiveWindow() {
+  let currentWindow = await browser.windows.getLastFocused();
+  await browser.sessions.removeWindowValue(currentWindow.id, "my-key");
+}
+
+browser.menus.create({
+  id: "add-my-item",
+  title: "add item",
+  contexts: ["all"]
+});
+
+browser.menus.create({
+  id: "remove-my-item",
+  title: "remove item",
+  contexts: ["all"]
+});
+
+browser.menus.onClicked.addListener((info) => {
+  if (info.menuItemId === "add-my-item") {
+    setOnActiveWindow();
+  } else {
+    removeFromActiveWindow();
+  }
+});
+ +

{{WebExtExamples}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/restore/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/restore/index.html deleted file mode 100644 index 98eda5f898..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/restore/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: sessions.restore() -slug: Mozilla/Add-ons/WebExtensions/API/sessions/restore -tags: - - API - - Add-ons - - Extensions - - Methode(2) - - Non-standard - - WebExtensions - - restaure - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/restore ---- -
{{AddonSidebar()}}
- -

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.

- -

Il s'agit d'une fonction asynchrone que retourne une Promise.

- -

Syntaxe

- -
var restoringSession = browser.sessions.restore(
-  sessionId             // string
-)
-
- -

Paramètres

- -
-
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()")}}.
-
- -

Valeur renvoyée

- -

Une Promise. Cela sera rempli avec un objet  {{WebExtAPIRef("sessions.Session", "Session")}} représentant la session qui a été restaurée.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.restore")}}

- -

Exemples

- -

Cela restaure la session fermée la plus récente, qu'il s'agisse d'une fenêtre ou d'un onglet :

- -
function restoreMostRecent(sessionInfos) {
-  if (!sessionInfos.length) {
-    console.log("No sessions found")
-    return;
-  }
-  let sessionInfo = sessionInfos[0];
-  if (sessionInfo.tab) {
-    browser.sessions.restore(sessionInfo.tab.sessionId);
-  } else {
-    browser.sessions.restore(sessionInfo.window.sessionId);
-  }
-}
-
-function onError(error) {
-  console.log(error);
-}
-
-browser.browserAction.onClicked.addListener(function() {
-  var gettingSessions = browser.sessions.getRecentlyClosed({
-    maxResults: 1
-  });
-  gettingSessions.then(restoreMostRecent, onError);
-});
-
- -

{{WebExtExamples}}

- -

Note :

- -

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

-
- - 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 new file mode 100644 index 0000000000..98eda5f898 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/restore/index.md @@ -0,0 +1,110 @@ +--- +title: sessions.restore() +slug: Mozilla/Add-ons/WebExtensions/API/sessions/restore +tags: + - API + - Add-ons + - Extensions + - Methode(2) + - Non-standard + - WebExtensions + - restaure + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/restore +--- +
{{AddonSidebar()}}
+ +

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.

+ +

Il s'agit d'une fonction asynchrone que retourne une Promise.

+ +

Syntaxe

+ +
var restoringSession = browser.sessions.restore(
+  sessionId             // string
+)
+
+ +

Paramètres

+ +
+
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()")}}.
+
+ +

Valeur renvoyée

+ +

Une Promise. Cela sera rempli avec un objet  {{WebExtAPIRef("sessions.Session", "Session")}} représentant la session qui a été restaurée.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.restore")}}

+ +

Exemples

+ +

Cela restaure la session fermée la plus récente, qu'il s'agisse d'une fenêtre ou d'un onglet :

+ +
function restoreMostRecent(sessionInfos) {
+  if (!sessionInfos.length) {
+    console.log("No sessions found")
+    return;
+  }
+  let sessionInfo = sessionInfos[0];
+  if (sessionInfo.tab) {
+    browser.sessions.restore(sessionInfo.tab.sessionId);
+  } else {
+    browser.sessions.restore(sessionInfo.window.sessionId);
+  }
+}
+
+function onError(error) {
+  console.log(error);
+}
+
+browser.browserAction.onClicked.addListener(function() {
+  var gettingSessions = browser.sessions.getRecentlyClosed({
+    maxResults: 1
+  });
+  gettingSessions.then(restoreMostRecent, onError);
+});
+
+ +

{{WebExtExamples}}

+ +

Note :

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/session/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/session/index.html deleted file mode 100644 index 389fca9b5f..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/session/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: sessions.Session -slug: Mozilla/Add-ons/WebExtensions/API/sessions/Session -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Reference - - Session - - Type - - WebExtensions - - sessions -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/Session ---- -
{{AddonSidebar()}}
- -

L'objet de Session représente un onglet ou une fenêtre que l'utilisateur a fermé dans la session de navigation actuelle.

- -

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.

- -

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.

- -

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 :

- - - -

Type

- -

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

- -
-
lastModified
-
number. L'heure où l'onglet ou la fenêtre a été fermé, en millisecondes depuis l'époque.
-
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 "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")}}.
-
- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.Session")}}

- -

Note :

- -

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

-
- - 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 new file mode 100644 index 0000000000..389fca9b5f --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/session/index.md @@ -0,0 +1,84 @@ +--- +title: sessions.Session +slug: Mozilla/Add-ons/WebExtensions/API/sessions/Session +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - Session + - Type + - WebExtensions + - sessions +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/Session +--- +
{{AddonSidebar()}}
+ +

L'objet de Session représente un onglet ou une fenêtre que l'utilisateur a fermé dans la session de navigation actuelle.

+ +

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.

+ +

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.

+ +

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 :

+ + + +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

+ +
+
lastModified
+
number. L'heure où l'onglet ou la fenêtre a été fermé, en millisecondes depuis l'époque.
+
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 "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")}}.
+
+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.Session")}}

+ +

Note :

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/settabvalue/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/settabvalue/index.html deleted file mode 100644 index 64da5c051c..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/settabvalue/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: sessions.setTabValue() -slug: Mozilla/Add-ons/WebExtensions/API/sessions/setTabValue -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - sessions - - setTabValue -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/setTabValue ---- -
{{AddonSidebar()}}
- -

Stocke une paire clé / valeur à associer à un onglet donné. Vous pouvez ensuite récupérer cette valeur en utilisant {{WebExtAPIRef("sessions.getTabValue")}}.

- -

Notez que ces données ne seront visibles que par l'extension qui l'a définie, et non par les autres extensions.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var storing = browser.sessions.setTabValue(
-  tabId,    // integer
-  key,      // string
-  value     // string or object
-)
-
- -

Paramètres

- -
-
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, 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.
-
- -

Valeur retournée

- -

Une 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.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.setTabValue", 10)}}

- -

Exemples

- -

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 "menus" pour exécuter cet exemple :

- -
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");
-}
-
-browser.menus.create({
-  id: "my-item",
-  title: "my item",
-  contexts: ["all"]
-});
-
-browser.menus.onClicked.addListener(setOnActiveTab);
- -

{{WebExtExamples}}

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 new file mode 100644 index 0000000000..64da5c051c --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/settabvalue/index.md @@ -0,0 +1,69 @@ +--- +title: sessions.setTabValue() +slug: Mozilla/Add-ons/WebExtensions/API/sessions/setTabValue +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - sessions + - setTabValue +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/setTabValue +--- +
{{AddonSidebar()}}
+ +

Stocke une paire clé / valeur à associer à un onglet donné. Vous pouvez ensuite récupérer cette valeur en utilisant {{WebExtAPIRef("sessions.getTabValue")}}.

+ +

Notez que ces données ne seront visibles que par l'extension qui l'a définie, et non par les autres extensions.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var storing = browser.sessions.setTabValue(
+  tabId,    // integer
+  key,      // string
+  value     // string or object
+)
+
+ +

Paramètres

+ +
+
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, 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.
+
+ +

Valeur retournée

+ +

Une 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.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.setTabValue", 10)}}

+ +

Exemples

+ +

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 "menus" pour exécuter cet exemple :

+ +
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");
+}
+
+browser.menus.create({
+  id: "my-item",
+  title: "my item",
+  contexts: ["all"]
+});
+
+browser.menus.onClicked.addListener(setOnActiveTab);
+ +

{{WebExtExamples}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/sessions/setwindowvalue/index.html b/files/fr/mozilla/add-ons/webextensions/api/sessions/setwindowvalue/index.html deleted file mode 100644 index c81dbd0ab1..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/sessions/setwindowvalue/index.html +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: sessions.setWindowValue() -slug: Mozilla/Add-ons/WebExtensions/API/sessions/setWindowValue -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - sessions - - setWindowsValue -translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/setWindowValue ---- -
{{AddonSidebar()}}
- -

Stocke une paire clé / valeur à associer à une fenêtre donnée. Vous pouvez ensuite récupérer cette valeur en utilisant {{WebExtAPIRef("sessions.getWindowValue")}}.

- -

Notez que ces données ne seront visibles que par l'extension qui l'a définie, et non par les autres extensions..

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var storing = browser.sessions.setWindowValue(
-  windowId,    // integer
-  key,         // string
-  value        // string or object
-)
-
- -

Paramètres

- -
-
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, 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.
-
- -

Valeur retournée

- -

Une 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.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.sessions.setWindowValue", 10)}}

- -

Exemples

- -

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 "menus" pour exécuter cet exemple :

- -
async function setOnActiveWindow() {
-  let currentWindow = await browser.windows.getLastFocused();
-  await browser.sessions.setWindowValue(currentWindow.id, "my-key", "my-value");
-}
-
-browser.menus.create({
-  id: "my-item",
-  title: "my item",
-  contexts: ["all"]
-});
-
-browser.menus.onClicked.addListener(setOnActiveWindow);
- -

{{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 new file mode 100644 index 0000000000..c81dbd0ab1 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/sessions/setwindowvalue/index.md @@ -0,0 +1,68 @@ +--- +title: sessions.setWindowValue() +slug: Mozilla/Add-ons/WebExtensions/API/sessions/setWindowValue +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - sessions + - setWindowsValue +translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/setWindowValue +--- +
{{AddonSidebar()}}
+ +

Stocke une paire clé / valeur à associer à une fenêtre donnée. Vous pouvez ensuite récupérer cette valeur en utilisant {{WebExtAPIRef("sessions.getWindowValue")}}.

+ +

Notez que ces données ne seront visibles que par l'extension qui l'a définie, et non par les autres extensions..

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var storing = browser.sessions.setWindowValue(
+  windowId,    // integer
+  key,         // string
+  value        // string or object
+)
+
+ +

Paramètres

+ +
+
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, 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.
+
+ +

Valeur retournée

+ +

Une 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.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.sessions.setWindowValue", 10)}}

+ +

Exemples

+ +

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 "menus" pour exécuter cet exemple :

+ +
async function setOnActiveWindow() {
+  let currentWindow = await browser.windows.getLastFocused();
+  await browser.sessions.setWindowValue(currentWindow.id, "my-key", "my-value");
+}
+
+browser.menus.create({
+  id: "my-item",
+  title: "my item",
+  contexts: ["all"]
+});
+
+browser.menus.onClicked.addListener(setOnActiveWindow);
+ +

{{WebExtExamples}}

-- cgit v1.2.3-54-g00ecf