action.isEnabled()
Gibt true zurück, wenn die Browser-Aktion aktiviert ist. Gibt den globalen Status zurück, wenn der Parameter details weggelassen oder leer ist oder alle seine Eigenschaften leer sind.
Hinweis: Diese API ist in Manifest V3 oder höher verfügbar.
Syntax
let gettingIsEnabled = browser.action.isEnabled(
details // optional object or integer
)
Parameter
detailsOptional-
integeroderobject. Alsintegerdefiniert es die ID eines zu überprüfenden Tabs. Alsobjectenthält es:tabIdOptional-
integer. ID eines zu überprüfenden Tabs. windowIdOptional-
integer. ID eines zu überprüfenden Fensters.
Wenn
windowIdundtabIdangegeben sind, schlägt die Funktion fehl.
Hinweis:
Chrome unterstützt details nur als integer, die ID eines zu überprüfenden Tabs.
Rückgabewert
Ein Promise, das mit true erfüllt wird, wenn die Browser-Aktion der Erweiterung aktiviert ist, und ansonsten mit false.
Beispiele
Überprüfen Sie den globalen Status:
browser.action.isEnabled({}).then((result) => {
console.log(result);
});
Überprüfen Sie den Status des aktiven Tabs:
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);
}