action.setBadgeText()

browser.action.setBadgeText(
  details // object
)

Diese API ist auch als chrome.action.setBadgeText() verfügbar.

details

Ein Objekt mit den folgenden Eigenschaften:

text

string oder null. Es können beliebige Zeichenanzahlen übergeben werden, aber es passen nur etwa vier in den verfügbaren Raum.

Verwenden Sie eine leere Zeichenfolge - "" -, wenn Sie keinen Badge wünschen.

Wenn eine tabId angegeben ist, entfernt null den tab-spezifischen Badge-Text, sodass der Tab den globalen Badge-Text erbt. Andernfalls wird der globale Badge-Text auf "" zurückgesetzt.

Wenn eine windowId angegeben ist, entfernt null den fensterspezifischen Badge-Text, sodass der Tab den globalen Badge-Text erbt. Andernfalls wird der globale Badge-Text auf "" zurückgesetzt.

tabId Optional

integer. Setzen Sie den Badge-Text nur für den angegebenen Tab. Der Text wird zurückgesetzt, wenn der Benutzer diesen Tab zu einer neuen Seite navigiert.

windowId Optional

integer. Setzen Sie den Badge-Text für das angegebene Fenster.

• Wenn sowohl windowId als auch tabId angegeben sind, schlägt die Funktion fehl.
• Wenn sowohl windowId als auch tabId weggelassen werden, wird der globale Badge gesetzt.

Fügen Sie einen Badge hinzu, der anzeigt, wie oft der Benutzer die Schaltfläche angeklickt hat:

let clicks = 0;

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

browser.action.onClicked.addListener(increment);