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êtres ouvertes pour l'appareil étranger, triées de la session la plus récemment modifiée à la moins récemment modifiée.
Filter
Propriétés
- maxResults
number facultatif
Nombre maximal d'entrées à récupérer dans la liste demandée. Omettez ce paramètre pour récupérer le nombre maximal d'entrées (
sessions.MAX_SESSION_RESULTS
).
Session
Propriétés
- lastModified
Total
Heure à laquelle la fenêtre ou l'onglet a été fermé ou modifié, représenté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,
): Promise<Device[]>
Récupère tous les appareils dont les sessions sont synchronisées.
Paramètres
- filtre
Filtre facultatif
Renvoie
-
Promise<Device[]>
Chrome 96 et versions ultérieures
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
): Promise<Session[]>
Obtient la liste des onglets et/ou fenêtres récemment fermés.
Paramètres
- filtre
Filtre facultatif
Renvoie
-
Promise<Session[]>
Chrome 96 et versions ultérieures
restore()
chrome.sessions.restore(
sessionId?: string,
): Promise<Session>
Rouvre un windows.Window
ou un tabs.Tab
, avec un rappel facultatif à exécuter lorsque l'entrée a été restaurée.
Paramètres
- sessionId
chaîne facultative
windows.Window.sessionId
outabs.Tab.sessionId
à restaurer. Si ce paramètre n'est pas spécifié, la session fermée le plus récemment est restaurée.
Renvoie
-
Promise<Session>
Chrome 96 et versions ultérieures
Événements
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
Événement déclenché lorsque des onglets et/ou 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