action.getBadgeText()

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

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

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

语法

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

参数

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 表仅在浏览器中加载

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