browserAction.getBadgeTextColor()

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

从 Firefox 63 版本开始，除非使用 browserAction.setBadgeTextColor() 显式设置了徽章文本颜色，否则徽章文本颜色将自动设置为黑色或白色，以使其与指定的徽章背景颜色形成最大对比度。例如，如果你将徽章背景颜色设置为白色，则默认的徽章文本颜色将设置为黑色，反之亦然。

其他浏览器始终使用白色文本颜色。

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

语法

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

参数

details

object。

tabId 可选

integer。指定从中获取徽章文本颜色的标签页。

windowId 可选

integer。指定从中获取徽章文本颜色的窗口。

  • 如果同时提供了 windowId 和 tabId，则函数失败。
  • 如果 windowId 和 tabId 都省略，则返回全局徽章文本颜色。

返回值

一个 Promise，其会兑现包含检索到的颜色的 browserAction.ColorArray。

浏览器兼容性

BCD tables only load in the browser

示例

记录徽章的文本颜色：

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

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

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

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