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 auchtabId
angegeben sind, schlägt die Funktion fehl. - Wenn sowohl
windowId
als auchtabId
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
Loading…
Hinweis:
Diese API basiert auf der chrome.action
API von Chromium. Diese Dokumentation ist abgeleitet von browser_action.json
im Chromium-Code.