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é du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Filter Oui Non52 Non Oui
MAX_SESSION_RESULTS Oui Non52 Non Oui
Session Oui Non52 * Non Oui
forgetClosedTab Non Non55 Non Non
forgetClosedWindow Non Non55 Non Non
getRecentlyClosed Oui Non52 Non Oui
getTabValue Non Non57 Non Non
getWindowValue Non Non57 Non Non
onChanged Oui Non53 Non Oui
removeTabValue Non Non57 Non Non
removeWindowValue Non Non57 Non Non
restore Oui Non52 Non Oui
setTabValue Non Non57 Non Non
setWindowValue Non Non57 Non Non

Example extensions

Remerciements

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.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,