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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
isEnabled
details.windowId parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support