sessions.setTabValue()

Speichert ein Schlüssel/Wert-Paar zur Verknüpfung mit einem bestimmten Tab. Sie können diesen Wert anschließend mit sessions.getTabValue abrufen.

Beachten Sie, dass diese Daten nur der Erweiterung sichtbar sind, die sie gesetzt hat, und nicht anderen 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. Ein Fehler wird ausgelöst, wenn die ID ungültig ist.
key: string. Schlüssel, mit dem Sie diesen speziellen Datenwert später abrufen können.
value: string oder object. Wenn dies ein Objekt ist, wird es stringified, 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 fehlschlug (zum Beispiel, weil die Tab-ID nicht gefunden werden konnte), wird das Promise mit einer Fehlermeldung abgelehnt.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Setzen Sie 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);

Beispiel-Erweiterungen

session-state