action.getBadgeText()

获取浏览器操作的徽章文本。

备注： 该 API 在 Manifest V3 或更高版本中可用。

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

语法

js
let gettingText = browser.action.getBadgeText(
  details               // 对象
)

参数

details

一个含有下列属性的对象：

tabId 可选

integer，指定要获取徽章文本的标签页。

windowId 可选

integer，指定要获取徽章文本的窗口。

  • 若同时指定了 windowId 和 tabId，则函数出错。
  • 若同时未指定 windowId 和 tabId，则返回全局的徽章文本。

返回值

一个 Promise，会兑现包含徽章文本的字符串。

示例

输出徽章文本：

js
function gotBadgeText(text) {
  console.log(text);
}

let gettingBadgeText = browser.action.getBadgeText({});
gettingBadgeText.then(gotBadgeText);

浏览器兼容性

BCD tables only load in the browser

备注： 该 API 基于 Chromium 的 chrome.action API。本文衍生自 Chromium 代码中的 browser_action.json。