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 ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
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 ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
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 ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
É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