chrome.sessions

refresh date: 2026-09-25 robots: noindex

Beschreibung

Mit der chrome.sessions API können Sie Tabs und Fenster aus einer Browsersitzung abfragen und wiederherstellen.

Berechtigungen

sessions

Typen

Device

Attribute

  • deviceName

    String

    Der Name des fremden Geräts.

  • Sitzungen

    Sitzung[]

    Eine Liste der offenen Fenstersitzungen für das fremde Gerät, sortiert nach der zuletzt geänderten Sitzung.

Filter

Attribute

  • maxResults

    number optional

    Die maximale Anzahl von Einträgen, die in der angeforderten Liste abgerufen werden sollen. Lassen Sie diesen Parameter weg, um die maximale Anzahl von Einträgen (sessions.MAX_SESSION_RESULTS) abzurufen.

Session

Attribute

  • lastModified

    Zahl

    Die Zeit, zu der das Fenster oder der Tab geschlossen oder geändert wurde, in Sekunden seit der UNIX-Epoche.

  • Tabulatortaste

    Tab optional

    Die tabs.Tab, wenn dieser Eintrag einen Tab beschreibt. Entweder wird dieses Feld oder sessions.Session.window festgelegt.

  • Fenster

    Fenster optional

    windows.Window, wenn dieser Eintrag ein Fenster beschreibt. Entweder wird dieses Feld oder sessions.Session.tab festgelegt.

Attribute

MAX_SESSION_RESULTS

Die maximale Anzahl von sessions.Session, die in einer angeforderten Liste enthalten sein werden.

Wert

25

Methoden

getDevices()

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

Ruft alle Geräte mit synchronisierten Sitzungen ab.

Parameter

  • Filter

    Filter optional

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (devices: Device[]) => void

    • Geräte

      Gerät[]

      Die Liste der sessions.Device-Objekte für jede synchronisierte Sitzung, sortiert nach dem Gerät mit der zuletzt geänderten Sitzung bis zum Gerät mit der am längsten zurückliegenden geänderten Sitzung. tabs.Tab-Objekte werden im windows.Window der sessions.Session-Objekte nach Aktualität sortiert.

Ausgabe

  • Promise<Device[]>

    Chrome 96 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getRecentlyClosed()

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

Ruft die Liste der zuletzt geschlossenen Tabs und/oder Fenster ab.

Parameter

  • Filter

    Filter optional

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (sessions: Session[]) => void

    • Sitzungen

      Sitzung[]

      Die Liste der geschlossenen Einträge in umgekehrter Reihenfolge, in der sie geschlossen wurden. Der zuletzt geschlossene Tab oder das zuletzt geschlossene Fenster befindet sich bei Index 0. Die Einträge können entweder Tabs oder Fenster enthalten.

Ausgabe

  • Promise<Session[]>

    Chrome 96 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

restore()

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

Öffnet einen windows.Window oder tabs.Tab wieder, mit einem optionalen Callback, der ausgeführt wird, wenn der Eintrag wiederhergestellt wurde.

Parameter

Ausgabe

  • Promise<Session>

    Chrome 96 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onChanged

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

Wird ausgelöst, wenn kürzlich geschlossene Tabs und/oder Fenster geändert werden. Bei diesem Ereignis werden Änderungen an synchronisierten Sitzungen nicht überwacht.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void