action.setBadgeText()

browser.action.setBadgeText(
  details // 对象
)

该 API 同样以 chrome.action.setBadgeText() 的形式可用。

details

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

text

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);