Returns true
if the browser action is enabled.
This is an asynchronous function that returns a Promise
.
Syntax
let gettingIsEnabled = browser.browserAction.isEnabled( details // object )
Parameters
details
object
. An object optionally containing thetabId
orwindowId
to check.-
tabId
Optionalinteger
. ID of a tab to check.windowId
Optionalinteger
. ID of a window to check.
- If windowId and tabId are both supplied, the function fails.
- If windowId and tabId are both omitted, the global enabled/disabled status is returned.
Return value
A Promise
that will be fulfilled with true
if the extension's browser action is enabled, and false
otherwise.
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | ||||
---|---|---|---|---|---|
isEnabled | Chrome No support No | Edge No support No | Firefox Full support 59 | Opera No support No | Firefox Android No support No |
details.windowId | Chrome No support No | Edge No support No | Firefox Full support 62 | Opera No support No | Firefox Android No support No |
Legend
- Full support
- Full support
- No support
- No support
Examples
Check the global state:
browser.browserAction.isEnabled({}).then(result => { console.log(result); });
Check the state of the currently active tab:
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); }