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 dietabId
oderwindowId
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