browserAction.getBadgeText()

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

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

语法

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

参数

details

包含以下属性的对象:

tabId 可选

integer。指定从中获取徽章文本的标签页。

windowId 可选

integer。指定从中获取徽章文本的窗口。

  • 如果同时提供了 windowId 和 tabId,则函数失败。
  • 如果 windowId 和 tabId 都省略,则返回全局徽章文本。

返回值

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

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
getBadgeText
details.windowId parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

示例

记录徽章文本:

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

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

备注: 此 API 基于 Chromium 的 chrome.browserAction API。该文档衍生自 Chromium 代码中的 browser_action.json