browserAction.setBadgeText()

語法

browser.browserAction.setBadgeText(
  details // object
)

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

引數

details

具有以下屬性的物件：

文字

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

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

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

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

tabId 可選

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

windowId 可選

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

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

示例

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

let clicks = 0;

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

browser.browserAction.onClicked.addListener(increment);

擴充套件程式示例

• tabs-tabs-tabs

瀏覽器相容性