action.setBadgeText()

Syntax

browser.action.setBadgeText(
  details // object
)

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

Parameter

details

Ein Objekt mit den folgenden Eigenschaften:

text

string oder null. Jegliche Anzahl von Zeichen kann übergeben werden, aber nur etwa vier passen in den verfügbaren Platz.

Verwenden Sie einen leeren String - "" - wenn Sie kein Abzeichen wünschen.

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

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

tabId Optional

integer. Setzt den Abzeichentext nur für den angegebenen Tab. Der Text wird zurückgesetzt, wenn der Benutzer diesen Tab auf eine neue Seite navigiert.

windowId Optional

integer. Setzt den Abzeichentext 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 das globale Abzeichen gesetzt.

Beispiele

Fügen Sie ein Abzeichen hinzu, das anzeigt, wie oft der Benutzer auf den Knopf geklickt hat:

let clicks = 0;

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

browser.action.onClicked.addListener(increment);

Browser-Kompatibilität