chrome.sessions

refresh date: 2026-09-25 robots: noindex

Beschrijving

Gebruik de chrome.sessions API om tabbladen en vensters uit een browsesessie op te vragen en te herstellen.

Rechten

sessions

Typen

Device

Eigenschappen

• deviceName

  tekenreeks

  De naam van het buitenlandse apparaat.

• sessies

  Sessie[]

  Een lijst met open venstersessies voor het externe apparaat, gesorteerd van de meest recent gewijzigde sessie naar de minst recent gewijzigde sessie.

Filter

Eigenschappen

• maxResults

  number optioneel

  Het maximum aantal vermeldingen dat moet worden opgehaald in de gevraagde lijst. Laat deze parameter weg om het maximale aantal items (sessions.MAX_SESSION_RESULTS) op te halen.

Session

Eigenschappen

• lastModified

  getal

  De tijd waarop het venster of tabblad is gesloten of aangepast, weergegeven in seconden sinds de epoch.

• tab

  Tab optioneel

  De tabs.Tab, als dit item een tabblad beschrijft. Deze of sessions.Session.window wordt ingesteld.

• venster

  Window optioneel

  De windows.Window, als dit item een venster beschrijft. Deze of sessions.Session.tab wordt ingesteld.

Eigenschappen

MAX_SESSION_RESULTS

Het maximum aantal sessions.Session dat wordt opgenomen in een aangevraagde lijst.

Waarde

25

Methoden

getDevices()

Promise

chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
): Promise<Device[]>

Haalt alle apparaten met gesynchroniseerde sessies op.

Parameters

• filter

  Filter optioneel

• callback

  functie optioneel

  De parameter callback ziet er zo uit:

  (devices: Device[]) => void

  • apparaten

    Apparaat[]

    De lijst met sessions.Device-objecten voor elke gesynchroniseerde sessie, gesorteerd op volgorde van het apparaat met de meest recent gewijzigde sessie tot het apparaat met de minst recent gewijzigde sessie. tabs.Tab-objecten worden gesorteerd op recentheid in de windows.Window van de sessions.Session-objecten.

Retourzendingen

• Promise<Device[]>

  Chrome 96+

  Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getRecentlyClosed()

Promise

chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
): Promise<Session[]>

Haalt de lijst met recent gesloten tabbladen en/of vensters op.

Parameters

• filter

  Filter optioneel

• callback

  functie optioneel

  De parameter callback ziet er zo uit:

  (sessions: Session[]) => void

  • sessies

    Sessie[]

    De lijst met gesloten items in omgekeerde volgorde van sluiting (het meest recent gesloten tabblad of venster staat op index 0). De items kunnen tabbladen of vensters bevatten.

Retourzendingen

• Promise<Session[]>

  Chrome 96+

  Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

restore()

Promise

chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
): Promise<Session>

Hiermee wordt een windows.Window of tabs.Tab opnieuw geopend, met een optionele callback die wordt uitgevoerd als de invoer is hersteld.

Parameters

• sessionId

  tekenreeks optioneel

  De windows.Window.sessionId of tabs.Tab.sessionId die je wilt herstellen. Als deze parameter niet is opgegeven, wordt de meest recent gesloten sessie hersteld.

• callback

  functie optioneel

  De parameter callback ziet er zo uit:

  (restoredSession: Session) => void

  • restoredSession

    Sessie

    Een sessions.Session met het herstelde windows.Window- of tabs.Tab-object.

Retourzendingen

• Promise<Session>

  Chrome 96+

  Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Evenementen

onChanged

chrome.sessions.onChanged.addListener(
  callback: function,
)

Wordt geactiveerd als recent gesloten tabbladen en/of vensters worden gewijzigd. Deze gebeurtenis houdt geen wijzigingen in gesynchroniseerde sessies bij.

Parameters

• callback

  functie

  De parameter callback ziet er zo uit:

  () => void