Sitzungen

Verwenden Sie die Sitzungen-API, um Tabs und Fenster aufzulisten und wiederherzustellen, die geschlossen wurden, während der Browser ausgeführt wurde.

Die Funktion sessions.getRecentlyClosed() gibt ein Array von tabs.Tab- und windows.Window-Objekten zurück, die Tabs und Fenster repräsentieren, die seit dem Start des Browsers geschlossen wurden, bis zur maximal in sessions.MAX_SESSION_RESULTS definierten Anzahl.

Sie können dann ein Fenster oder einen Tab mit der Funktion sessions.restore() wiederherstellen. Beim Wiederherstellen wird nicht nur der Tab erneut geöffnet, sondern auch die Navigationserläufe des Tabs wiederhergestellt, sodass die Zurück-/Vorwärts-Schaltflächen funktionieren.

Diese API bietet auch eine Gruppe von Funktionen, die es einer Erweiterung ermöglicht, zusätzlichen Status mit einem Tab oder einem Fenster zu speichern. Wenn der Tab oder das Fenster geschlossen und anschließend wiederhergestellt wird, kann die Erweiterung den Status abrufen. Beispielsweise könnte eine Tab-Gruppierungserweiterung dies verwenden, um sich zu merken, in welcher Gruppe sich ein Tab befindet, um ihn in der richtigen Gruppe wiederherzustellen, falls der Benutzer den Tab wiederherstellt.

Um die Sitzungen-API verwenden zu können, müssen Sie die "sessions" API-Berechtigung haben.

Typen

sessions.Filter: Ermöglicht es Ihnen, die Anzahl der von einem Aufruf an sessions.getRecentlyClosed() zurückgegebenen Session-Objekte einzuschränken.
sessions.Session: Repräsentiert einen Tab oder ein Fenster, das der Benutzer in der aktuellen Browsing-Sitzung geschlossen hat.

Eigenschaften

sessions.MAX_SESSION_RESULTS: Die maximale Anzahl von Sitzungen, die durch einen Aufruf von sessions.getRecentlyClosed() zurückgegeben werden.

Funktionen

sessions.forgetClosedTab(): Entfernt einen geschlossenen Tab aus der Liste der kürzlich geschlossenen Tabs des Browsers.
sessions.forgetClosedWindow(): Entfernt ein geschlossenes Fenster aus der Liste der kürzlich geschlossenen Fenster des Browsers.
sessions.getRecentlyClosed(): Gibt ein Array von Session-Objekten zurück, die Fenster und Tabs repräsentieren, die in der aktuellen Browsing-Sitzung geschlossen wurden (d.h. seit dem Start des Browsers).
sessions.restore(): Stellt einen geschlossenen Tab oder Fenster wieder her.
sessions.setTabValue(): Speichert ein Schlüssel/Wert-Paar, das mit einem bestimmten Tab verbunden ist.
sessions.getTabValue(): Ruft einen zuvor gespeicherten Wert für einen bestimmten Tab anhand seines Schlüssels ab.
sessions.removeTabValue(): Entfernt ein Schlüssel/Wert-Paar aus einem bestimmten Tab.
sessions.setWindowValue(): Speichert ein Schlüssel/Wert-Paar, das mit einem bestimmten Fenster verbunden ist.
sessions.getWindowValue(): Ruft einen zuvor gespeicherten Wert für ein bestimmtes Fenster anhand seines Schlüssels ab.
sessions.removeWindowValue(): Entfernt ein Schlüssel/Wert-Paar aus einem bestimmten Fenster.

Ereignisse

sessions.onChanged: Wird ausgelöst, wenn ein Tab oder Fenster geschlossen wird.

Beispielerweiterungen

session-state

Browser-Kompatibilität

Hinweis: Diese API basiert auf der API chrome.sessions von Chromium.