action.getBadgeText()

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

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

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

語法

js
let gettingText = browser.action.getBadgeText(
  details               // object
)

引數

details

具有以下屬性的物件:

tabId 可選

integer。指定要從中獲取徽章文字的選項卡。

windowId 可選

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

  • 如果同時提供了 windowId 和 tabId,則函式會失敗。
  • 如果同時省略了 windowId 和 tabId,則返回全域性徽章文字。

返回值

一個 Promise,它將以包含徽章文字的字串來完成。

示例

記錄徽章文字

js
function gotBadgeText(text) {
  console.log(text);
}

let gettingBadgeText = browser.action.getBadgeText({});
gettingBadgeText.then(gotBadgeText);

瀏覽器相容性

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