action.disable()
Disables the browser action for a tab, meaning that it cannot be clicked when that tab is active.
Note: This API is available in Manifest V3 or higher.
Syntax
js
browser.action.disable(
tabId // optional integer
)
Parameters
tabIdOptional-
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:
js
browser.tabs.onCreated.addListener(() => {
browser.action.enable();
});
browser.action.onClicked.addListener(() => {
browser.action.disable();
});
Disable the browser action only for the active tab:
js
browser.action.onClicked.addListener((tab) => {
browser.action.disable(tab.id);
});
Browser compatibility
| desktop | mobile | ||||||
|---|---|---|---|---|---|---|---|
disable
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
Note:
This API is based on Chromium's chrome.action API. This documentation is derived from browser_action.json in the Chromium code.