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

js
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 auch tabId angegeben sind, schlägt die Funktion fehl.
  • Wenn sowohl windowId als auch tabId 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:

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