Diese Seite wurde von der Cloud Translation API übersetzt.

chrome.sessions

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 Sitzungen in offenen Fenstern für das fremde Gerät, sortiert von der letzten bis zur am wenigsten geänderten Sitzung.

Filter

Attribute

maxResults

Zahl optional

Die maximale Anzahl der abzurufenden Einträge in der angeforderten Liste. Lassen Sie diesen Parameter aus, um die maximale Anzahl von Einträgen (sessions.MAX_SESSION_RESULTS) abzurufen.

Session

Attribute

lastModified

Zahl

Die Zeit in Millisekunden seit der Epoche, zu der das Fenster oder der Tab geschlossen oder geändert wurde.
Tabulatortaste

Tabulatortaste optional

Den tabs.Tab, wenn dieser Eintrag einen Tab beschreibt. Dies oder sessions.Session.window wird festgelegt.
Fenster

Fenster optional

Den windows.Window, wenn dieser Eintrag ein Fenster beschreibt. Dies oder sessions.Session.tab wird festgelegt.

Attribute

MAX_SESSION_RESULTS

Die maximale Anzahl von sessions.Session, die in eine angeforderte Liste aufgenommen werden.

Wert

Methoden

getDevices()

<ph type="x-smartling-placeholder"></ph> Versprechen

chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
)

Ruft alle Geräte mit synchronisierten Sitzungen ab.

Parameter

Filter

Filter optional
callback

Funktion optional

Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>
```
(devices: Device[]) => void
```
- Geräte
  
  Gerät[]
  
  Die Liste der sessions.Device-Objekte für jede synchronisierte Sitzung, sortiert vom Gerät mit der letzten Sitzung bis zum Gerät mit der letzten Änderung. tabs.Tab-Objekte werden nach Aktualität in den windows.Window-Objekten der sessions.Session-Objekte sortiert.

Gibt Folgendes zurück:

Promise<Gerät[]>

Chrome 96 und höher

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

getRecentlyClosed()

<ph type="x-smartling-placeholder"></ph> Versprechen

chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

Ruft die Liste der kürzlich geschlossenen Tabs und/oder Fenster ab.

Parameter

Filter

Filter optional
callback

Funktion optional

Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>
```
(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.

Gibt Folgendes zurück:

Promise<Sitzung[]>

Chrome 96 und höher

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

restore()

<ph type="x-smartling-placeholder"></ph> Versprechen

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.

Parameter

sessionId

String optional

Den windows.Window.sessionId oder den tabs.Tab.sessionId, der wiederhergestellt werden soll. Wenn dieser Parameter nicht angegeben ist, wird die zuletzt geschlossene Sitzung wiederhergestellt.
callback

Funktion optional

Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>
```
(restoredSession: Session) => void
```
- restoredSession
  
  Sitzung
  
  Ein sessions.Session mit dem wiederhergestellten windows.Window- oder tabs.Tab-Objekt.

Gibt Folgendes zurück:

Promise<Session>

Chrome 96 und höher

Promise-Objekte 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: <ph type="x-smartling-placeholder"></ph>
```
() => void
```