browserAction.getBadgeTextColor()

Ermittelt die Textfarbe für das Badge der Browseraktion.

Ab Firefox 63 wird die Textfarbe des Badges, sofern nicht explizit mit browserAction.setBadgeTextColor() festgelegt, automatisch auf Schwarz oder Weiß gesetzt, um den Kontrast mit der angegebenen Hintergrundfarbe des Badges zu maximieren. Wenn beispielsweise die Hintergrundfarbe des Badges auf Weiß gesetzt wird, wird 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 sind, 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

BCD tables only load in the browser

Beispiele

Protokolliert 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 stammt aus browser_action.json im Chromium-Code.