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
。