action.setBadgeText()

語法

browser.action.setBadgeText(
  details // object
)

此 API 也可作為 chrome.action.setBadgeText() 使用。

引數

details

具有以下屬性的物件：

文字

string 或 null。可以傳入任意數量的字元，但只有大約四個字元能裝入空間。

如果您不希望顯示任何徽章，請使用空字串 ""。

如果指定了 tabId，null 會移除標籤頁特定的徽章文字，使該標籤頁繼承全域性徽章文字。否則，它會將全域性徽章文字重置為 ""。

如果指定了 windowId，null 會移除視窗特定的徽章文字，使標籤頁繼承全域性徽章文字。否則，它會將全域性徽章文字重置為 ""。

tabId 可選

integer。僅為給定的標籤頁設定徽章文字。當用戶將此標籤頁導航到新頁面時，文字將被重置。

windowId 可選

integer。為給定的視窗設定徽章文字。

• 如果同時提供了 windowId 和 tabId，則函式將失敗。
• 如果同時省略 windowId 和 tabId，則設定全域性徽章。

示例

新增一個徽章，指示使用者點選按鈕的次數

let clicks = 0;

function increment() {
  browser.action.setBadgeText({ text: (++clicks).toString() });
}

browser.action.onClicked.addListener(increment);

瀏覽器相容性