action.disable()

禁用某个标签页的浏览器操作,这意味着在该标签页处于活动状态时无法单击它。

注意:此 API 在 Manifest V3 或更高版本中可用。

语法

js
browser.action.disable(
  tabId // optional integer
)

参数

tabId 可选

integer。您要禁用浏览器操作的选项卡的 ID。

示例

点击时禁用浏览器操作,并在每次打开新选项卡时重新启用它

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

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

仅为活动选项卡禁用浏览器操作

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

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.action API。本文档源自 Chromium 代码中的 browser_action.json