Description
Utilisez l'API chrome.sessions
pour interroger et restaurer les onglets et les fenêtres d'une session de navigation.
Autorisations
sessions
Types
Device
Propriétés
-
deviceName
chaîne
Nom de l'appareil étranger.
-
sessions
Session[]
Liste des sessions de fenêtre ouvertes pour l'appareil externe, triées de la session la plus récente à la moins récente.
Filter
Propriétés
-
maxResults
number facultatif
Nombre maximal d'entrées à extraire dans la liste demandée. Omettez ce paramètre pour extraire le nombre maximal d'entrées (
sessions.MAX_SESSION_RESULTS
).
Session
Propriétés
-
lastModified
Total
Heure à laquelle la fenêtre ou l'onglet ont été fermés ou modifiés, exprimée en secondes depuis l'epoch.
-
tabulation
Onglet facultatif
tabs.Tab
, si cette entrée décrit un onglet. Cette valeur ousessions.Session.window
sera définie. -
fenêtre
Fenêtre facultatif
windows.Window
, si cette entrée décrit une fenêtre. Cette valeur ousessions.Session.tab
sera définie.
Propriétés
MAX_SESSION_RESULTS
Nombre maximal de sessions.Session
qui seront inclus dans une liste demandée.
Valeur
25
Méthodes
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
)
Récupère tous les appareils avec des sessions synchronisées.
Paramètres
-
filtre
Filtre facultatif
-
callback
fonction facultatif
Le paramètre
callback
se présente comme suit :(devices: Device[]) => void
-
appareils
Appareil[]
Liste des objets
sessions.Device
pour chaque session synchronisée, triée de l'appareil dont la session a été modifiée le plus récemment à celui dont la session a été modifiée le moins récemment. Les objetstabs.Tab
sont triés par ordre de récence dans lewindows.Window
des objetssessions.Session
.
-
Renvoie
-
Promise<Device[]>
Chrome 96 ou version ultérieureLes promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
Récupère la liste des onglets et/ou des fenêtres récemment fermés.
Paramètres
-
filtre
Filtre facultatif
-
callback
fonction facultatif
Le paramètre
callback
se présente comme suit :(sessions: Session[]) => void
-
sessions
Session[]
Liste des entrées fermées dans l'ordre inverse de leur fermeture (l'onglet ou la fenêtre fermée en dernier se trouve à l'index
0
). Les entrées peuvent contenir des onglets ou des fenêtres.
-
Renvoie
-
Promise<Session[]>
Chrome 96 ou version ultérieureLes promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
Réouvre un windows.Window
ou tabs.Tab
, avec un rappel facultatif à exécuter une fois l'entrée restaurée.
Paramètres
-
sessionId
chaîne facultatif
windows.Window.sessionId
outabs.Tab.sessionId
à restaurer. Si ce paramètre n'est pas spécifié, la session la plus récemment fermée est restaurée. -
callback
fonction facultatif
Le paramètre
callback
se présente comme suit :(restoredSession: Session) => void
-
restoredSession
Un
sessions.Session
contenant l'objetwindows.Window
outabs.Tab
restauré.
-
Renvoie
-
Promise<Session>
Chrome 96 ou version ultérieureLes promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.
Événements
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
Déclenché lorsque les onglets et/ou les fenêtres récemment fermés sont modifiés. Cet événement ne surveille pas les modifications apportées aux sessions synchronisées.
Paramètres
-
callback
fonction
Le paramètre
callback
se présente comme suit :() => void