action.getBadgeTextColor()

Ermittelt die Textfarbe für das Badge der Browser-Aktion.

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

In Firefox wird die Textfarbe des Badges, sofern sie nicht explizit mit action.setBadgeTextColor() festgelegt ist, automatisch auf Schwarz oder Weiß gesetzt, um den Kontrast zur angegebenen Hintergrundfarbe des Badges zu maximieren. Beispielsweise wird die Standardfarbe für den Badge-Text auf Schwarz gesetzt, wenn Sie die Hintergrundfarbe des Badges auf Weiß einstellen, und umgekehrt.

Andere Browser verwenden immer eine weiße Textfarbe.

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

Syntax

js
browser.action.getBadgeTextColor(
  details // object
)

Parameter

details

object.

tabId Optional

integer. Gibt den Tab an, von dem die Textfarbe des Badges ermittelt werden soll.

windowId Optional

integer. Gibt das Fenster an, aus dem die Textfarbe des Badges ermittelt werden soll.

  • Wenn windowId und tabId beide angegeben sind, schlägt die Funktion fehl.
  • Wenn windowId und tabId beide weggelassen werden, wird die globale Textfarbe des Badges zurückgegeben.

Rückgabewert

Ein Promise, das mit der ermittelten Farbe als action.ColorArray erfüllt wird.

Beispiele

Protokollieren Sie die Textfarbe des Badges:

js
function onGot(color) {
  console.log(color);
}

function onFailure(error) {
  console.log(error);
}

browser.action.getBadgeTextColor({}).then(onGot, onFailure);

Browser-Kompatibilität

BCD tables only load in the browser

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