action.getBadgeTextColor()
Ruft die Textfarbe für das Browser-Action-Badge ab.
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 wird, automatisch auf Schwarz oder Weiß gesetzt, um den Kontrast mit der angegebenen Hintergrundfarbe des Badges zu maximieren. Wenn Sie beispielsweise die Hintergrundfarbe des Badges auf Weiß setzen, wird die Standard-Textfarbe 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
browser.action.getBadgeTextColor(
details // object
)
Parameter
details-
object.tabIdOptional-
integer. Gibt den Tab an, von dem die Textfarbe des Badges abgerufen werden soll. windowIdOptional-
integer. Gibt das Fenster an, von dem die Textfarbe des Badges abgerufen werden soll.
- Wenn sowohl
windowIdals auchtabIdangegeben werden, schlägt die Funktion fehl. - Wenn sowohl
windowIdals auchtabIdweggelassen werden, wird die globale Textfarbe des Badges zurückgegeben.
Rückgabewert
Ein Promise, das mit der abgerufenen Farbe als action.ColorArray erfüllt wird.
Beispiele
Protokollieren Sie die Textfarbe des Badges:
function onGot(color) {
console.log(color);
}
function onFailure(error) {
console.log(error);
}
browser.action.getBadgeTextColor({}).then(onGot, onFailure);
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf Chromiums chrome.action API. Diese Dokumentation stammt aus browser_action.json im Chromium-Code.