browserAction.isEnabled()

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

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

Syntax

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

Parameter

details

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

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 werden, schlägt die Funktion fehl.
  • Wenn windowId und tabId beide weggelassen werden, wird der globale Aktiviert-/Deaktiviert-Status zurückgegeben.

Rückgabewert

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

Browser-Kompatibilität

Beispiele

Überprüfen des globalen Status:

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

Überprüfen des Status des aktuell aktiven Tabs:

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