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

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.