chrome.sessions

Beschreibung

Mit der chrome.sessions API können Sie Tabs und Fenster aus einer Browser-Sitzung abfragen und wiederherstellen.

Berechtigungen

sessions

Typen

Device

Attribute

• deviceName

  String

  Der Name des fremden Geräts.

• Sitzungen

  Sitzung[]

  Eine Liste der geöffneten Fenstersitzungen für das fremde Gerät, sortiert nach der zuletzt geänderten Sitzung.

Filter

Attribute

• maxResults

  number optional

  Die maximale Anzahl von Einträgen, die in der angeforderten Liste abgerufen werden sollen. Lassen Sie diesen Parameter weg, um die maximale Anzahl von Einträgen abzurufen (sessions.MAX_SESSION_RESULTS).

Session

Attribute

• lastModified

  Zahl

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

• Tabulatortaste

  Tab optional

  Die tabs.Tab, wenn dieser Eintrag einen Tab beschreibt. Entweder wird dieser Wert oder sessions.Session.window festgelegt.

• Fenster

  Fenster optional

  Die windows.Window, wenn dieser Eintrag ein Fenster beschreibt. Entweder wird dieser Wert oder sessions.Session.tab festgelegt.

Attribute

MAX_SESSION_RESULTS

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

Wert

25

Methoden

getDevices()

Promise

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

Ruft alle Geräte mit synchronisierten Sitzungen ab.

Parameter

• Filter

  Filter optional

• callback

  function 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 zuletzt geänderten Sitzung. tabs.Tab-Objekte werden im windows.Window der sessions.Session-Objekte nach Aktualität sortiert.

Ausgabe

• Promise<Device[]>

  Chrome 96 und höher

  Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können nicht beide für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

getRecentlyClosed()

Promise

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

Liste der kürzlich geschlossenen Tabs und/oder Fenster abrufen

Parameter

• Filter

  Filter optional

• callback

  function 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 hat den Index 0). Die Einträge können Tabs oder Fenster enthalten.

Ausgabe

• Promise<Session[]>

  Chrome 96 und höher

  Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können nicht beide für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

restore()

Promise

chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

Öffnet eine windows.Window oder tabs.Tab wieder mit einem optionalen Callback, der ausgeführt wird, wenn der Eintrag wiederhergestellt wurde.

Parameter

• sessionId

  String optional

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

• callback

  function optional

  Der Parameter callback sieht so aus:

  (restoredSession: Session) => void

  • restoredSession

    Sitzung

    Ein sessions.Session mit dem wiederhergestellten windows.Window- oder tabs.Tab-Objekt.

Ausgabe

• Promise<Session>

  Chrome 96 und höher

  Versprechen werden in Manifest V3 und höher unterstützt, aber Callbacks sind für die Abwärtskompatibilität verfügbar. Sie können nicht beide für denselben Funktionsaufruf verwenden. Das Versprechen wird mit demselben Typ aufgelöst, der an den Rückruf übergeben wird.

Ereignisse

onChanged

chrome.sessions.onChanged.addListener(
  callback: function,
)

Wird ausgelöst, wenn kürzlich geschlossene Tabs und/oder Fenster geändert werden. Mit diesem Ereignis werden keine Änderungen an synchronisierten Sitzungen überwacht.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  () => void