Beschreibung
Verwenden Sie die chrome.sessions
API, um Tabs und Fenster aus einer Browsersitzung abzufragen und wiederherzustellen.
Berechtigungen
sessions
Typen
Device
Attribute
-
deviceName
String
Der Name des fremden Geräts.
-
Sitzungen
Sitzung[]
Eine Liste der Sitzungen im geöffneten Fenster für das fremde Gerät, sortiert von der jüngsten bis zur am wenigsten geänderten Sitzung.
Filter
Attribute
-
maxResults
Nummer optional
Die maximale Anzahl der abzurufenden Einträge in der angeforderten Liste. Lassen Sie diesen Parameter weg, um die maximale Anzahl von Einträgen abzurufen (
sessions.MAX_SESSION_RESULTS
).
Session
Attribute
-
lastModified
Zahl
Die Zeit, in der das Fenster oder der Tab geschlossen oder geändert wurde, angegeben in Millisekunden seit der Epoche.
-
Tabulatortaste optional
Der
tabs.Tab
, wenn dieser Eintrag einen Tab beschreibt. Entweder dieses odersessions.Session.window
wird festgelegt. -
Fenster
Fenster optional
Der
windows.Window
, wenn dieser Eintrag ein Fenster beschreibt. Entweder dieses odersessions.Session.tab
wird festgelegt.
Attribute
MAX_SESSION_RESULTS
Die maximale Anzahl von sessions.Session
, die in einer angeforderten Liste enthalten sein können.
Wert
25
Methoden
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
)
Ruft alle Geräte mit synchronisierten Sitzungen ab.
Parameters
-
Filter
Filter optional
-
callback
Funktion 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 wenigsten geänderten Sitzung.tabs.Tab
-Objekte werden inwindows.Window
dersessions.Session
-Objekte nach Aktualität sortiert.
-
Rückgaben
-
Promise<Gerät[]>
Chrome 96 oder höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
Ruft die Liste der zuletzt geschlossenen Tabs und/oder Fenster ab.
Parameters
-
Filter
Filter optional
-
callback
Funktion 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 im Index
0
). Die Einträge können entweder Tabs oder Fenster enthalten.
-
Rückgaben
-
Promise<Sitzung[]>
Chrome 96 oder höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
Öffnet ein windows.Window
- oder tabs.Tab
-Element mit einem optionalen Callback, der ausgeführt wird, wenn der Eintrag wiederhergestellt wurde.
Parameters
-
sessionId
String optional
Das
windows.Window.sessionId
- odertabs.Tab.sessionId
-Element, das wiederhergestellt werden soll. Wenn dieser Parameter nicht angegeben ist, wird die zuletzt geschlossene Sitzung wiederhergestellt. -
callback
Funktion optional
Der Parameter
callback
sieht so aus:(restoredSession: Session) => void
-
restoredSession
Ein
sessions.Session
, das das wiederhergestelltewindows.Window
- odertabs.Tab
-Objekt enthält.
-
Rückgaben
-
Promise<Sitzung>
Chrome 96 oder höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
Veranstaltungen
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 berücksichtigt.
Parameters
-
callback
Funktion
Der Parameter
callback
sieht so aus:() => void