Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

action.getBadgeText()

Ruft den Text des Browser-Action-Badges ab.

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

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let gettingText = browser.action.getBadgeText(
  details               // object
)

Parameter

details

Ein Objekt mit den folgenden Eigenschaften:

tabId Optional

integer. Gibt die Registerkarte an, von der der Badge-Text abgerufen werden soll.

windowId Optional

integer. Gibt das Fenster an, von dem der Badge-Text abgerufen werden soll.

  • 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-Text zurückgegeben.

Rückgabewert

Ein Promise, das mit einem String erfüllt wird, der den Badge-Text enthält.

Beispiele

Protokollierung des Badge-Texts:

js
function gotBadgeText(text) {
  console.log(text);
}

let gettingBadgeText = browser.action.getBadgeText({});
gettingBadgeText.then(gotBadgeText);

Browser-Kompatibilität

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