browserAction.getBadgeTextColor()
Erhält die Textfarbe für das Badge der Browser-Aktion.
Ab Firefox 63 wird, sofern die Badge-Textfarbe nicht ausdrücklich mit browserAction.setBadgeTextColor()
festgelegt wurde, die Badge-Textfarbe automatisch auf Schwarz oder Weiß eingestellt, um den Kontrast zur angegebenen Badge-Hintergrundfarbe zu maximieren. Beispielsweise, 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
browser.browserAction.getBadgeTextColor(
details // object
)
Parameter
details
-
object
.tabId
Optional-
integer
. Gibt den Tab an, von dem die Badge-Textfarbe abgerufen werden soll. windowId
Optional-
integer
. Gibt das Fenster an, von dem die Badge-Textfarbe 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 Badge-Textfarbe zurückgegeben.
Rückgabewert
Ein Promise
, das mit der abgerufenen Farbe als browserAction.ColorArray
erfüllt wird.
Beispiele
Protokollieren Sie die Textfarbe des Badges:
function onGot(color) {
console.log(color);
}
function onFailure(error) {
console.log(error);
}
browser.browserAction.getBadgeTextColor({}).then(onGot, onFailure);
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der API von Chromiums chrome.browserAction
. Diese Dokumentation ist abgeleitet von browser_action.json
im Chromium-Code.