browserAction.setBadgeText()

设置浏览器操作的徽章文本。徽章显示在图标顶部。

没有特定徽章文本的标签页将继承全局徽章文本,默认情况下为 ""。

语法

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

此 API 也可通过 chrome.browserAction.setBadgeText() 来使用。

参数

details

一个包含以下属性的对象:

text

string 或 null。可以传递任意数量的字符,但空间只能容纳大约四个字符。

如果不需要徽章,请使用空字符串 ""。

如果指定了 tabId,null 将移除特定标签页的徽章文本,使该标签页继承全局徽章文本。否则将全局徽章文本恢复为 ""。

如果指定了 windowId,null 将移除特定窗口的徽章文本,使标签页继承全局徽章文本。否则将全局徽章文本恢复为 ""。

tabId 可选

integer。仅为指定的标签页设置徽章文本。当用户将该标签页导航到新页面时,文本会重置。

windowId 可选

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

• 如果同时提供 windowId 和 tabId,函数将失败。
• 如果 windowId 和 tabId 都省略,则会设置全局徽章文本。

浏览器兼容性

示例

添加一个徽章,显示用户点击按钮的次数:

let clicks = 0;
function increment() {
 browser.browserAction.setBadgeText({ text: (++clicks).toString() });
}
browser.browserAction.onClicked.addListener(increment);

示例扩展

• tabs-tabs-tabs