MDN self-hosted library · e01.org

browserAction.disable()

Disables the browser action for a tab, meaning that it cannot be clicked when that tab is active.

Open notebook · 2 cells webextension-api-function upstream source

Disables the browser action for a tab, meaning that it cannot be clicked when that tab is active.

Syntax

browser.browserAction.disable(
  tabId // optional integer
)

Parameters

  • tabId
  • : integer. The id of the tab for which you want to disable the browser action.

Examples

Disable the browser action when clicked, and re-enable it every time a new tab is opened:

browser.tabs.onCreated.addListener(() => {
  browser.browserAction.enable();
});

browser.browserAction.onClicked.addListener(() => {
  browser.browserAction.disable();
});

Disable the browser action only for the active tab:

browser.browserAction.onClicked.addListener((tab) => {
  browser.browserAction.disable(tab.id);
});

Browser compatibility

[!NOTE] This API is based on Chromium's chrome.browserAction API. This documentation is derived from browser_action.json in the Chromium code.