action.isEnabled()

如果浏览器操作已启用，则返回true。

注意：此 API 在清单 V3 或更高版本中可用。

这是一个异步函数，它返回一个Promise。

语法

js
let gettingIsEnabled = browser.action.isEnabled(
  details // object
)

参数

details

object。一个对象，可选地包含要检查的tabId或windowId。

tabId 可选

integer。要检查的选项卡的 ID。

windowId 可选

integer。要检查的窗口的 ID。

  • 如果同时提供了 windowId 和 tabId，则函数失败。
  • 如果同时省略了 windowId 和 tabId，则返回全局启用/禁用状态。

返回值

一个Promise，如果扩展的浏览器操作已启用，则将以true完成，否则将以false完成。

示例

检查全局状态

js
browser.action.isEnabled({}).then((result) => {
  console.log(result);
});

检查当前活动选项卡的状态

js
async function enabledInActiveTab() {
  let tabs = await browser.tabs.query({
    currentWindow: true,
    active: true,
  });
  let enabled = await browser.action.isEnabled({
    tabId: tabs[0].id,
  });
  console.log(enabled);
}

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。