Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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, die überprüft werden soll.

tabId Optional

integer. ID eines Tabs zur Überprüfung.

windowId Optional

integer. ID eines Fensters zur Überprüfung.

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

Rückgabewert

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

Beispiele

Überprüfen des globalen Status:

js
browser.action.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.action.isEnabled({
    tabId: tabs[0].id,
  });
  console.log(enabled);
}

Browser-Kompatibilität