sessions.setTabValue()

Speichert ein Schlüssel/Wert-Paar, das mit einem bestimmten Tab assoziiert wird. Sie können diesen Wert anschließend mit sessions.getTabValue abrufen.

Beachten Sie, dass diese Daten nur für die Erweiterung sichtbar sind, die sie gesetzt hat, und nicht für andere Erweiterungen.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

let storing = browser.sessions.setTabValue(
  tabId,    // integer
  key,      // string
  value     // string or object
)

Parameter

tabId: integer. ID des Tabs, mit dem Sie die Daten verknüpfen möchten. Es wird ein Fehler ausgegeben, wenn die ID ungültig ist.
key: string. Schlüssel, den Sie später verwenden können, um diesen speziellen Datenwert abzurufen.
value: string oder object. Wenn dies ein Objekt ist, wird es stringifiziert, sodass zum Beispiel Objektmethoden weggelassen werden. Wenn hier eine Funktion angegeben wird, wird sie als Wert null gespeichert.

Ein Promise, das ohne Argumente aufgelöst wird, wenn der Aufruf erfolgreich war. Wenn der Aufruf fehlgeschlagen ist (zum Beispiel, weil die Tab-ID nicht gefunden werden konnte), wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Setzt einen Wert auf dem aktiven Tab, wenn der Benutzer ein Menüelement auswählt. Beachten Sie, dass Sie die "menus"-Berechtigung benötigen, um dieses Beispiel auszuführen:

async function setOnActiveTab() {
  let tabArray = await browser.tabs.query({
    currentWindow: true,
    active: true,
  });
  let tabId = tabArray[0].id;
  await browser.sessions.setTabValue(tabId, "my-key", "my-value");
}

browser.menus.create({
  id: "my-item",
  title: "my item",
  contexts: ["all"],
});

browser.menus.onClicked.addListener(setOnActiveTab);

Beispielerweiterungen

session-state