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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
FilterChrome Support complet OuiEdge Aucun support NonFirefox Support complet 52Opera Support complet OuiFirefox Android Aucun support Non
MAX_SESSION_RESULTSChrome Support complet OuiEdge Aucun support NonFirefox Support complet 52Opera Support complet OuiFirefox Android Aucun support Non
SessionChrome Support complet OuiEdge Aucun support NonFirefox Support complet 52
Notes
Support complet 52
Notes
Notes 'Tab' objects in Sessions don't contain the 'url', 'title', or 'favIconUrl' properties.
Opera Support complet OuiFirefox Android Aucun support Non
forgetClosedTabChrome Aucun support NonEdge Aucun support NonFirefox Support complet 55Opera Aucun support NonFirefox Android Aucun support Non
forgetClosedWindowChrome Aucun support NonEdge Aucun support NonFirefox Support complet 55Opera Aucun support NonFirefox Android Aucun support Non
getRecentlyClosedChrome Support complet OuiEdge Aucun support NonFirefox Support complet 52Opera Support complet OuiFirefox Android Aucun support Non
getTabValueChrome Aucun support NonEdge Aucun support NonFirefox Support complet 57Opera Aucun support NonFirefox Android Aucun support Non
getWindowValueChrome Aucun support NonEdge Aucun support NonFirefox Support complet 57Opera Aucun support NonFirefox Android Aucun support Non
onChangedChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Aucun support Non
removeTabValueChrome Aucun support NonEdge Aucun support NonFirefox Support complet 57Opera Aucun support NonFirefox Android Aucun support Non
removeWindowValueChrome Aucun support NonEdge Aucun support NonFirefox Support complet 57Opera Aucun support NonFirefox Android Aucun support Non
restoreChrome Support complet OuiEdge Aucun support NonFirefox Support complet 52Opera Support complet OuiFirefox Android Aucun support Non
setTabValueChrome Aucun support NonEdge Aucun support NonFirefox Support complet 57Opera Aucun support NonFirefox Android Aucun support Non
setWindowValueChrome Aucun support NonEdge Aucun support NonFirefox Support complet 57Opera Aucun support NonFirefox Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

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,