sessions.getTabValue()

Ruft einen zuvor gespeicherten Wert durch einen Aufruf von sessions.setTabValue ab.

Sie können einen Wert von einem Tab abrufen, auch nach einem Schließen/Wiederherstellen-Zyklus: Das bedeutet, wenn Sie einen Wert setzen und der Benutzer dann den Tab schließt und mithilfe der Browserfunktion "Tab wiederherstellen" (zum Beispiel durch Drücken von Strg+Umschalt+T) den Tab wiederherstellt, können Sie den Wert vom wiederhergestellten Tab abrufen. Beachten Sie jedoch, dass ein wiederhergestellter Tab nicht die gleiche ID wie das Original erhält, sodass die ID, die Sie in getTabValue() übergeben, sich von der ID unterscheidet, die Sie in setTabValue() übergeben haben, obwohl sie sich auf denselben Tab beziehen.

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

Syntax

js
let retrieving = browser.sessions.getTabValue(
  tabId,    // integer
  key       // string
)

Parameter

tabId

integer. ID des Tabs, dessen Daten Sie abrufen möchten. Ein Fehler wird ausgelöst, wenn die ID ungültig ist.

key

string. Schlüssel, der den bestimmten abzurufenden Wert identifiziert. Dieser muss mit dem zuvor in sessions.setTabValue angegebenen Schlüssel übereinstimmen.

Rückgabewert

Ein Promise, das mit dem Wert aufgelöst wird, falls er existiert, oder undefined, falls er nicht existiert. Wenn der Aufruf fehlgeschlagen ist (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

Protokollieren Sie den Wert von "my-key" für alle neu erstellten Tabs (dazu gehören auch alle Tabs, die wiederhergestellt wurden):

js
function onGetResolved(r) {
  console.log(`success: ${r}`);
}

function onGetRejected(e) {
  console.log(`error: ${e}`);
}

browser.tabs.onCreated.addListener((tab) => {
  browser.sessions
    .getTabValue(tab.id, "my-key")
    .then(onGetResolved, onGetRejected);
});

Beispiel-Erweiterungen