action.getBadgeTextColor()

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

备注：该 API 在 Manifest V3 或更高版本中可用。

在 Firefox 中，除非使用 action.setBadgeTextColor() 明确设置了徽章文本颜色，否则徽章文本颜色会自动设置为黑色或白色，以最大程度与指定的徽章背景颜色形成对比。例如，如果将徽章背景颜色设置为白色，则默认的徽章文本颜色将设置为黑色，反之亦然。

其他的浏览器总是使用白色作为文本颜色。

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

语法

js
browser.action.getBadgeTextColor(
  details // 对象
)

参数

details

object。

tabId 可选

integer，指定要获取徽标文本颜色的标签页。

windowId 可选

integer，指定要获取徽标文本颜色的窗口。

  • 若同时指定了 windowId 和 tabId，则函数出错。
  • 若同时未指定 windowId 和 tabId，则返回全局徽标的文本颜色。

返回值

以 action.ColorArray 形式兑现获取到的颜色的 Promise。

示例

输出徽标的文本颜色：

js
function onGot(color) {
  console.log(color);
}

function onFailure(error) {
  console.log(error);
}

browser.action.getBadgeTextColor({}).then(onGot, onFailure);

浏览器兼容性

BCD tables only load in the browser

备注：该 API 基于 Chromium 的 chrome.action API。该文档衍生于 Chromium 代码中的 browser_action.json。