Sets the text color for the browser action's badge. Tabs without a specific badge text color will inherit the global badge text color.
browser.browserAction.setBadgeTextColor( details // object )
details
object
. color
"red"
, "#FF0000"
, or "rgb(255,0,0)"
. If the string is not a valid color, the returned promise will be rejected and the text color won't be altered.browserAction.ColorArray
object.null
. If a tabId
is specified, it removes the tab-specific badge text color so that the tab inherits the global badge text color. Otherwise it reverts the global badge text color to the default value.tabId
Optional
integer
. Sets the badge text color only for the given tab. The color is reset when the user navigates this tab to a new page.windowId
Optional
integer
. Sets the badge text color only for the given tab.windowId
and tabId
are both supplied, the function fails and the color is not set.windowId
and tabId
are both omitted, the global badge text color is set instead.Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
setBadgeTextColor |
No |
No |
63 |
? |
No |
No |
? |
? |
79 |
? |
? |
? |
A badge text color that starts off as red, and turns green when the browser action is clicked:
browser.browserAction.setBadgeText({text: "1234"}); browser.browserAction.setBadgeTextColor({color: "red"}); browser.browserAction.onClicked.addListener(()=> { browser.browserAction.setBadgeTextColor({color: "green"}); });
Set the badge text color only for the active tab:
browser.browserAction.setBadgeText({text: "1234"}); browser.browserAction.setBadgeTextColor({color: "red"}); browser.browserAction.onClicked.addListener((tab)=> { browser.browserAction.setBadgeTextColor({ color: "green", tabId: tab.id }); });
Note: This API is based on Chromium's chrome.browserAction
API. This documentation is derived from browser_action.json
in the Chromium code.
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browserAction/setBadgeTextColor