Vernieuwingsdatum: 2026-09-25 robots: noindex
Beschrijving
Gebruik de chrome.sessions API om tabbladen en vensters uit een browsersessie op te vragen en te herstellen.
Toestemmingen
sessions Soorten
Device
Eigenschappen
- apparaatnaam
snaar
De naam van het buitenlandse apparaat.
- sessies
Sessie []
Een lijst met geopende venstersessies voor het externe apparaat, gesorteerd van meest recent gewijzigde naar minst recent gewijzigde sessie.
Filter
Eigenschappen
- maxResultaten
nummer optioneel
Het maximale aantal items dat in de gevraagde lijst moet worden opgehaald. Laat deze parameter weg om het maximale aantal items op te halen (
sessions.MAX_SESSION_RESULTS).
Session
Eigenschappen
- laatst gewijzigd
nummer
Het tijdstip waarop het venster of tabblad werd gesloten of gewijzigd, weergegeven in seconden sinds het begin van het tijdperk.
- tab
Tab optioneel
De
tabs.Tabwordt gebruikt als deze vermelding een tabblad beschrijft. Ofwel deze parameter, ofwelsessions.Session.windowwordt ingesteld. - raam
Venster optioneel
De
windows.Windowwordt ingesteld als deze vermelding een venster beschrijft. Ofwel deze waarde, ofwelsessions.Session.tab.
Eigenschappen
MAX_SESSION_RESULTS
Het maximale aantal sessions.Session dat in een aangevraagde lijst wordt opgenomen.
Waarde
25
Methoden
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
): Promise<Device[]>
Haalt alle apparaten met gesynchroniseerde sessies op.
Parameters
- filter
Filter optioneel
- terugbelverzoek
functie optioneel
De
callbackparameter ziet er als volgt uit:(devices: Device[]) => void
- apparaten
Apparaat []
De lijst met
sessions.Device-objecten voor elke gesynchroniseerde sessie, gesorteerd van het apparaat met de meest recent gewijzigde sessie tot het apparaat met de minst recent gewijzigde sessie.tabs.Tabobjecten zijn gesorteerd op recentheid in dewindows.Windowvan desessions.Sessionobjecten.
Retourneert
Promise< Apparaat []>
Chrome 96+Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
): Promise<Session[]>
Geeft een lijst weer van recent gesloten tabbladen en/of vensters.
Parameters
- filter
Filter optioneel
- terugbelverzoek
functie optioneel
De
callbackparameter ziet er als volgt uit:(sessions: Session[]) => void
- sessies
Sessie []
De lijst met gesloten items in omgekeerde volgorde van sluiting (het laatst gesloten tabblad of venster staat op index
0). De items kunnen zowel tabbladen als vensters bevatten.
Retourneert
Promise< Session []>
Chrome 96+Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
): Promise<Session>
Heropent een windows.Window of tabs.Tab , met een optionele callback die wordt uitgevoerd wanneer het venster is hersteld.
Parameters
- sessie-ID
string optioneel
De
windows.Window.sessionIdoftabs.Tab.sessionIddie moet worden hersteld. Als deze parameter niet is opgegeven, wordt de laatst gesloten sessie hersteld. - terugbelverzoek
functie optioneel
De
callbackparameter ziet er als volgt uit:(restoredSession: Session) => void
- herstelde sessie
Een
sessions.Sessiondat het hersteldewindows.Windowoftabs.Tabobject bevat.
Retourneert
Belofte< Sessie >
Chrome 96+Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.
Evenementen
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
Deze gebeurtenis wordt geactiveerd wanneer recent gesloten tabbladen en/of vensters worden gewijzigd. Deze gebeurtenis houdt geen rekening met wijzigingen in gesynchroniseerde sessies.
Parameters
- terugbelverzoek
functie
De
callbackparameter ziet er als volgt uit:() => void