chrome.browseraction.getBadgeText

简介

chrome.browseraction.getBadgeText 是 Chrome 扩展 API 之一，用于获取浏览器动作栏图标的角标文本。

用法

使用 chrome.browseraction.getBadgeText 前，需要在扩展清单文件 manifest.json 中声明 browser_action 属性，并分别设置 default_icon 和 default_popup 属性的值。

{
  "name": "My extension",
  "version": "1.0",
  "manifest_version": 2,
  "description": "This is a Chrome extension",
  "browser_action": {
    "default_icon": "icon.png",
    "default_popup": "popup.html"
  }
}

在扩展的 Chrome 浏览器动作栏图标上添加角标文本，使用 chrome.browseraction.setBadgeText 方法，通过传递文本字符串来设置角标文本的内容。

chrome.browserAction.setBadgeText({
  text: '1'
});

获取浏览器动作栏图标的角标文本，使用 chrome.browseraction.getBadgeText 方法。

chrome.browserAction.getBadgeText({}, function(result) {
  console.log(result);
});

参数

chrome.browseraction.getBadgeText 方法可以传递一个对象参数和一个回调函数。

对象参数

使用对象参数时，可以指定一个整数类型的 tabId 属性，表示获取特定标签页的角标文本。默认情况下，tabId 属性为 undefined，表示获取当前标签页的角标文本。

chrome.browserAction.getBadgeText({tabId: 123}, function(result) {
  console.log(result);
});

回调函数

回调函数接收一个字符串类型的 result 参数，表示获取到的角标文本内容。

chrome.browserAction.getBadgeText({}, function(result) {
  console.log(result);
});

返回值

chrome.browseraction.getBadgeText 方法会异步返回获取到的角标文本内容，通过传递给回调函数。

示例

chrome.browserAction.getBadgeText({}, function(result) {
  console.log(result);
});

参考文献

• chrome.browserAction.getBadgeText - Chrome Developers