action.isEnabled()

Gibt true zurück, wenn die Browser-Aktion aktiviert ist.

Hinweis: Diese API ist in Manifest V3 oder höher verfügbar.

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

Syntax

js
let gettingIsEnabled = browser.action.isEnabled(
  details // object
)

Parameter

details

object. Ein Objekt, das optional die tabId oder windowId enthält, um zu überprüfen.

tabId Optional

integer. ID eines Tabs, der überprüft werden soll.

windowId Optional

integer. ID eines Fensters, das überprüft werden soll.

  • Wenn sowohl windowId als auch tabId angegeben sind, schlägt die Funktion fehl.
  • Wenn sowohl windowId als auch tabId weggelassen werden, wird der globale aktivierte/deaktivierte Status zurückgegeben.

Rückgabewert

Ein Promise, das mit true erfüllt wird, wenn die Browser-Aktion der Erweiterung aktiviert ist, und sonst mit false.

Beispiele

Überprüfen des globalen Zustands:

js
browser.action.isEnabled({}).then((result) => {
  console.log(result);
});

Überprüfen des Zustands des aktuell aktiven Tabs:

js
async function enabledInActiveTab() {
  let tabs = await browser.tabs.query({
    currentWindow: true,
    active: true,
  });
  let enabled = await browser.action.isEnabled({
    tabId: tabs[0].id,
  });
  console.log(enabled);
}

Browser-Kompatibilität

BCD tables only load in the browser