Sets the text color for the browser action's badge. Tabs without a specific badge text color will inherit the global badge text color.
On this page
browserAction.setBadgeTextColor()
Syntax
browser.browserAction.setBadgeTextColor(
details // object
)
Parameters
-
details
-
An object with the following properties:
-
color
-
The color, specified as one of:
- a string: any CSS <color> value, for example
"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. - a
object.browserAction.ColorArray
null
. If atabId
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.
- a string: any CSS <color> value, for example
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.
-
- If
windowId
andtabId
are both supplied, the function fails and the color is not set. - If
windowId
andtabId
are both omitted, the global badge text color is set instead.
Browser compatibility
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 | ? | No | ? |
Examples
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–2023 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