sessions
========

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 `sessions.getRecentlyClosed()` renvoie un tableau de `tabs.Tab` et les objets `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 `sessions.MAX_SESSION_RESULTS`.

Vous pouvez ensuite restaurer une fenêtre ou un onglet en utilisant la fonction `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
-----

`sessions.Filter`

Permet de restreindre le nombre de `Session` objets retournés par un appel à `sessions.getRecentlyClosed()`.

`sessions.Session`

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

Propriétés
----------

`sessions.MAX_SESSION_RESULTS`

Le nombre maximum de sessions qui seront retournées par un appel à `sessions.getRecentlyClosed()`.

Fonctions
---------

`sessions.forgetClosedTab()`

Supprime un onglet fermé de la liste des onglets récemment fermés du navigateur.

`sessions.forgetClosedWindow()`

Supprime une fenêtre fermée de la liste des fenêtres récemment fermées du navigateur.

`sessions.getRecentlyClosed()`

Renvoie un tableau d'objets `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).

`sessions.restore()`

Restaure un onglet ou une fenêtre fermée.

`sessions.setTabValue()`

Stocke une paire clé/valeur associée à un onglet donné.

`sessions.getTabValue()`

Récupérer une valeur précédemment enregistrée pour un onglet donné, compte tenu de sa clé.

`sessions.removeTabValue()`

Supprimer une paire clé/valeur d'un onglet donné.

`sessions.setWindowValue()`

Stocke une paire clé/valeur associée à une fenêtre donnée.

`sessions.getWindowValue()`

Récupérer une valeur précédemment enregistrée pour une fenêtre donnée, compte tenu de sa clé.

`sessions.removeWindowValue()`

Supprime une paire clé/valeur d'une fenêtre données.

Evénements
----------

`sessions.onChanged`

Mise en place lorsqu'un onglet ou une fenêtre est fermée.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Example extensions
------------------

* session-state

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