action.getBadgeTextColor()

Ruft die Textfarbe des Browser-Action-Badges ab.

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

In Firefox wird die Badge-Textfarbe, sofern sie nicht explizit mit action.setBadgeTextColor() festgelegt wird, automatisch auf Schwarz oder Weiß gesetzt, um den Kontrast zur angegebenen Badge-Hintergrundfarbe zu maximieren. Zum Beispiel, wenn Sie die Badge-Hintergrundfarbe auf Weiß setzen, wird die Standard-Badge-Textfarbe auf Schwarz gesetzt 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 die Registerkarte an, von der die Badge-Textfarbe abgerufen werden soll.

windowId Optional

integer. Gibt das Fenster an, aus dem die Badge-Textfarbe abgerufen werden soll.

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

Rückgabewert

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

Beispiele

Protokollieren der 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

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