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
。