browserAction.setBadgeText()

Syntax

browser.browserAction.setBadgeText(
  details // object
)

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

Parameter

details

Ein Objekt mit den folgenden Eigenschaften:

text

string oder null. Es können beliebig viele Zeichen übergeben werden, aber nur etwa vier passen in den verfügbaren Raum.

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

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

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

tabId Optional

integer. Setzt den Badgetext 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 Badgetext für das angegebene Fenster.

• Wenn windowId und tabId beide angegeben sind, schlägt die Funktion fehl.
• Wenn windowId und tabId beide weggelassen werden, wird das globale Badge gesetzt.

Beispiele

Fügen Sie ein Badge hinzu, das anzeigt, wie oft der Benutzer den Button geklickt hat:

let clicks = 0;

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

browser.browserAction.onClicked.addListener(increment);

Beispielerweiterungen

• tabs-tabs-tabs

Browser-Kompatibilität