sessions

Verwenden Sie die sessions API, um Tabs und Fenster aufzulisten und wiederherzustellen, die während der Ausführung des Browsers geschlossen wurden.

Die Funktion sessions.getRecentlyClosed() gibt ein Array von tabs.Tab und windows.Window Objekten zurück, die Tabs und Fenster darstellen, die seit dem Start des Browsers geschlossen wurden, bis zu dem in sessions.MAX_SESSION_RESULTS definierten Maximum.

Sie können dann ein Fenster oder einen Tab mit der Funktion sessions.restore() wiederherstellen. Das Wiederherstellen öffnet nicht nur den Tab erneut: Es stellt auch den Verlauf des Tabs wieder her, sodass die Vorwärts-/Rückwärts-Schaltflächen funktionieren.

Diese API bietet auch eine Gruppe von Funktionen, die es einer Erweiterung ermöglichen, zusätzlichen Zustand zu speichern, der mit einem Tab oder Fenster verbunden ist. Wenn der Tab oder das Fenster geschlossen und anschließend wiederhergestellt wird, kann die Erweiterung den Zustand abrufen. Ein Beispiel wäre eine Tab-Gruppenerweiterung, die damit speichert, zu welcher Gruppe ein Tab gehört, um ihn beim Wiederherstellen in die richtige Gruppe zuzuordnen.

Um die sessions API zu verwenden, müssen Sie die "sessions" API-Berechtigung besitzen.

Typen

sessions.Filter: Ermöglicht es Ihnen, die Anzahl der Session Objekte zu begrenzen, die von einem Aufruf von sessions.getRecentlyClosed() zurückgegeben werden.
sessions.Session: Stellt einen Tab oder ein Fenster dar, das der Benutzer in der aktuellen Browsersitzung 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 Browsersitzung geschlossen wurden (also: seit der Browser gestartet wurde).
sessions.restore(): Stellt einen geschlossenen Tab oder ein Fenster wieder her.
sessions.setTabValue(): Speichert ein Schlüssel/Wert-Paar, das mit einem gegebenen Tab verbunden ist.
sessions.getTabValue(): Ruft einen zuvor für einen gegebenen Tab gespeicherten Wert anhand seines Schlüssels ab.
sessions.removeTabValue(): Entfernt ein Schlüssel/Wert-Paar aus einem gegebenen Tab.
sessions.setWindowValue(): Speichert ein Schlüssel/Wert-Paar, das mit einem gegebenen Fenster verbunden ist.
sessions.getWindowValue(): Ruft einen zuvor für ein gegebenes Fenster gespeicherten Wert anhand seines Schlüssels ab.
sessions.removeWindowValue(): Entfernt ein Schlüssel/Wert-Paar aus einem gegebenen Fenster.

Ereignisse

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

Browser-Kompatibilität

BCD tables only load in the browser

Beispiel-Erweiterungen

session-state

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