action.getBadgeTextColor()

獲取瀏覽器操作徽章的文字顏色。

注意:此 API 在 Manifest V3 或更高版本中可用。

在 Firefox 中,除非使用 action.setBadgeTextColor() 顯式設定了徽章文字顏色,否則徽章文字顏色會自動設定為黑色或白色,以最大化與指定的徽章背景色的對比度。例如,如果將徽章背景色設定為白色,則預設的徽章文字顏色將設定為黑色,反之亦然。

其他瀏覽器始終使用白色文字顏色。

這是一個非同步函式,返回一個 Promise

語法

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

引數

details

object.

tabId 可選

integer。指定要從中獲取徽章文字顏色的標籤頁。

windowId 可選

integer。指定要從中獲取徽章文字顏色的視窗。

  • 如果同時提供了 windowIdtabId,則函式將失敗。
  • 如果同時省略 windowIdtabId,則返回全域性徽章文字顏色。

返回值

一個 Promise,它將以檢索到的顏色(作為 action.ColorArray)解析。

示例

記錄徽章的文字顏色

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

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

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

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.action API。本文件源自 Chromium 程式碼中的 browser_action.json