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);
浏览器兼容性
Loading…
备注:
此 API 基于 Chromium 的 chrome.action API。该文档衍生自 Chromium 代码中的 browser_action.json。