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 nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
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 nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
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 nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
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