browserAction.getBadgeTextColor()

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

Ab Firefox 63 wird, sofern die Textfarbe des Badges nicht explizit mit browserAction.setBadgeTextColor() festgelegt ist, die Textfarbe des Badges automatisch auf Schwarz oder Weiß gesetzt, um den maximalen Kontrast mit der angegebenen Hintergrundfarbe des Badges zu gewährleisten. Beispielsweise wird, wenn Sie die Hintergrundfarbe des Badges auf Weiß setzen, die Standardtextfarbe des Badges 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.browserAction.getBadgeTextColor(
  details // object
)

Parameter

details

object.

tabId Optional

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

windowId Optional

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

  • Wenn sowohl windowId als auch tabId angegeben werden, schlägt die Funktion fehl.
  • Wenn sowohl windowId als auch tabId weggelassen werden, wird die globale Textfarbe des Badges zurückgegeben.

Rückgabewert

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

Browser-Kompatibilität

Beispiele

Protokollieren Sie die Textfarbe des Badges:

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

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

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

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