index.md

---

title: browserAction.isEnabled()
slug: Mozilla/Add-ons/WebExtensions/API/browserAction/isEnabled
page-type: webextension-api-function
tags:
  - API
  - Add-ons
  - Extensions
  - Method
  - Reference
  - WebExtensions
  - browserAction
  - isEnabled
browser-compat: webextensions.api.browserAction.isEnabled

---

{{AddonSidebar()}}

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 the tabId or windowId to check.

    • tabId {{optional_inline}}

      • : integer. ID of a tab to check.

    • windowId {{optional_inline}}

      • : integer. 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

{{Compat}}

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);
}

{{WebExtExamples}}