action.setBadgeText()

语法

browser.action.setBadgeText(
  details // object
)

此 API 也可作为 chrome.action.setBadgeText() 使用。

参数

details

具有以下属性的对象：

文本

string 或 null。可以传入任意数量的字符，但只有大约四个字符能装入空间。

如果您不希望显示任何徽章，请使用空字符串 ""。

如果指定了 tabId，null 会移除标签页特定的徽章文本，使该标签页继承全局徽章文本。否则，它会将全局徽章文本重置为 ""。

如果指定了 windowId，null 会移除窗口特定的徽章文本，使标签页继承全局徽章文本。否则，它会将全局徽章文本重置为 ""。

tabId 可选

integer。仅为给定的标签页设置徽章文本。当用户将此标签页导航到新页面时，文本将被重置。

windowId 可选

integer。为给定的窗口设置徽章文本。

• 如果同时提供了 windowId 和 tabId，则函数将失败。
• 如果同时省略 windowId 和 tabId，则设置全局徽章。

示例

添加一个徽章，指示用户点击按钮的次数

let clicks = 0;

function increment() {
  browser.action.setBadgeText({ text: (++clicks).toString() });
}

browser.action.onClicked.addListener(increment);

浏览器兼容性