action.getBadgeBackgroundColor()
Ermittelt die Hintergrundfarbe des Browser-Action-Abzeichens.
Hinweis: Diese API ist in Manifest V3 oder höher verfügbar.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
browser.action.getBadgeBackgroundColor(
details // object
)
Parameter
details
-
Ein Objekt mit den folgenden Eigenschaften:
tabId
Optional-
integer
. Gibt den Tab an, von dem die Hintergrundfarbe des Abzeichens abgerufen werden soll. windowId
Optional-
integer
. Gibt das Fenster an, von dem die Hintergrundfarbe des Abzeichens abgerufen werden soll.
- Wenn sowohl
windowId
als auchtabId
angegeben sind, schlägt die Funktion fehl. - Wenn sowohl
windowId
als auchtabId
weggelassen werden, wird die globale Hintergrundfarbe des Abzeichens zurückgegeben.
Rückgabewert
Ein Promise
, das mit der abgerufenen Farbe als action.ColorArray
erfüllt wird.
Beispiele
Protokollieren der Hintergrundfarbe des Abzeichens:
function onGot(color) {
console.log(color);
}
function onFailure(error) {
console.log(error);
}
browser.action.getBadgeBackgroundColor({}).then(onGot, onFailure);
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.action
API von Chromium. Diese Dokumentation ist aus browser_action.json
im Chromium-Code abgeleitet.