chrome.sessions

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 oder sessions.Session.window wird festgelegt.

• Fenster

  Fenster optional

  Der windows.Window, wenn dieser Eintrag ein Fenster beschreibt. Entweder dieses oder sessions.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()

Versprechen

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 in windows.Window der sessions.Session-Objekte nach Aktualität sortiert.

Rückgaben

• Promise<Gerät[]>

  Chrome 96 oder höher

  Promise-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()

Versprechen

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öher

  Promise-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()

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.

Parameters

• sessionId

  String optional

  Das windows.Window.sessionId- oder tabs.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

    Sitzung

    Ein sessions.Session, das das wiederhergestellte windows.Window- oder tabs.Tab-Objekt enthält.

Rückgaben

• Promise<Sitzung>

  Chrome 96 oder höher

  Promise-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