action.setBadgeText()

Legt den Badge-Text für die Browseraktion fest. Der Badge wird über dem Symbol angezeigt.

Hinweis: Diese API ist in Manifest V3 oder höher verfügbar.

Tabs ohne spezifischen Badge-Text erben den globalen Badge-Text, der standardmäßig "" ist.

Syntax

js
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. 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.

Beispiele

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

js
let clicks = 0;

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

browser.action.onClicked.addListener(increment);

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
setBadgeText
details.windowId parameter
The text property of the details parameter can be set to null.

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Hinweis: Diese API basiert auf der chrome.action API von Chromium. Diese Dokumentation ist abgeleitet von browser_action.json im Chromium-Code.