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

25

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:

  (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 in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

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:

  (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 in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

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:

  (restoredSession: Session) => void

  • restoredSession

    Sitzung

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

Gibt Folgendes zurück:

• Promise&lt;Session&gt;

  Chrome 96 und höher

  Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

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:

  () => void