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

    Session[]

    Eine Liste der geöffneten Fenstersitzungen für das fremde Gerät, sortiert von der zuletzt bis zur am wenigsten kürzlich geänderten Sitzung.

Filter

Attribute

  • maxResults

    number optional

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

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 einer angeforderten Liste enthalten sind.

Wert

25

Methoden

getDevices()

Promise 
chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
): Promise<Device[]>

Ruft alle Geräte mit synchronisierten Sitzungen ab.

Parameter

  • filtern

    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 kürzlich 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

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

getRecentlyClosed()

Promise 
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
): Promise<Session[]>

Ruft die Liste der zuletzt geschlossenen Tabs und/oder Fenster ab.

Parameter

  • filtern

    Filter optional

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (sessions: Session[]) => void

    • Sitzungen

      Session[]

      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 am Index 0. Die Einträge können entweder Tabs oder Fenster enthalten.

Ausgabe

  • Promise<Session[]>

    Chrome 96 und höher

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

restore()

Promise 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
): Promise<Session>

Öffnet ein windows.Window oder tabs.Tab wieder. Optional kann ein Callback angegeben werden, der ausgeführt wird, wenn der Eintrag wiederhergestellt wurde.

Parameter

Ausgabe

  • Promise<Session>

    Chrome 96 und höher

    Promises 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 sich kürzlich geschlossene Tabs und/oder Fenster ändern. Bei diesem Ereignis werden keine Änderungen an synchronisierten Sitzungen erfasst.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void