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 ouvertes sur l'appareil étranger, triées de la session la plus récente à la moins récemment modifiée.
Filter
Propriétés
-
maxResults
numéro facultatif
Nombre maximal d'entrées à extraire 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
number
Heure à laquelle la fenêtre ou l'onglet a été fermé ou modifié, représentée en millisecondes écoulées depuis l'epoch.
-
tab
Tabulation facultatif
La valeur
tabs.Tab
, si cette entrée décrit un onglet. Cette valeur ousessions.Session.window
sera définie. -
fenêtre
Window (Fenêtre) facultatif
La valeur
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
à inclure 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
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(devices: Device[]) => void
-
appareils
Appareil[]
Liste d'objets
sessions.Device
pour chaque session synchronisée, triés de l'appareil avec la dernière session modifiée à l'appareil avec la session la moins récemment modifiée. Les objetstabs.Tab
sont triés par date dans lawindows.Window
des objetssessions.Session
.
-
Renvoie
-
Promesse<Appareil[]>
Chrome 96 et versions ultérieuresLes promesses sont compatibles avec Manifest V3 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 est résolue 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 fenêtres récemment fermés.
Paramètres
-
filtre
Filtre facultatif
-
rappel
fonction facultative
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 les plus récemment fermés seront associés à l'index
0
). Les entrées peuvent contenir soit des onglets, soit des fenêtres.
-
Renvoie
-
Promesse<Session[]>
Chrome 96 et versions ultérieuresLes promesses sont compatibles avec Manifest V3 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 est résolue avec le même type que celui transmis au rappel.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
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
string facultatif
Le
windows.Window.sessionId
ou letabs.Tab.sessionId
à restaurer. Si ce paramètre n'est pas spécifié, la dernière session fermée est restaurée. -
rappel
fonction facultative
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 et versions ultérieuresLes promesses sont compatibles avec Manifest V3 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 est résolue avec le même type que celui transmis au rappel.
Événements
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
Déclenché lorsque des onglets et/ou des 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
-
rappel
function
Le paramètre
callback
se présente comme suit :() => void