action.getBadgeTextColor()

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

注意：此 API 在清单 V3 或更高版本中可用。

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

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

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

语法

js
browser.action.getBadgeTextColor(
  details // object
)

参数

details

对象.

tabId 可选

integer。指定要获取徽章文本颜色的选项卡。

windowId 可选

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

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

返回值

一个 Promise，它将使用检索到的颜色作为 action.ColorArray 满足。

示例

记录徽章的文本颜色

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

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

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

注意：此 API 基于 Chromium 的 chrome.action API。本文档来自 Chromium 代码中的 browser_action.json。