action.getBadgeTextColor()
Ruft die Textfarbe für das Badge der Browser-Aktion ab.
Hinweis: Diese API ist in Manifest V3 oder höher verfügbar.
In Firefox, es sei denn, die Textfarbe des Badges wird explizit mithilfe von action.setBadgeTextColor()
festgelegt, wird die Textfarbe des Badges automatisch auf Schwarz oder Weiß eingestellt, um den Kontrast zur 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
.tabId
Optional-
integer
. Spezifiziert den Tab, von dem die Textfarbe des Badges abgerufen werden soll. windowId
Optional-
integer
. Spezifiziert das Fenster, aus dem die Textfarbe des Badges abgerufen werden soll.
- Wenn sowohl
windowId
als auchtabId
angegeben sind, schlägt die Funktion fehl. - Wenn sowohl
windowId
als auchtabId
weggelassen 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 leitet sich ab von browser_action.json
im Chromium-Code.