action.getBadgeBackgroundColor()

獲取瀏覽器操作徽章的背景顏色。

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

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

語法

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

引數

details

具有以下屬性的物件:

tabId 可選

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

windowId 可選

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

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

返回值

一個 Promise,它將以 action.ColorArray 格式的檢索到的顏色進行 fulfilled。

示例

記錄徽章的背景顏色

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

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

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

瀏覽器相容性

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