Gets the background color of the browser action's badge.
This is an asynchronous function that returns a Promise
.
Gets the background color of the browser action's badge.
This is an asynchronous function that returns a Promise
.
browser.browserAction.getBadgeBackgroundColor( details // object )
details
An object with the following properties:
tabId
Optional
integer
. Specifies the tab to get the badge background color from.
windowId
Optional
integer
. Specifies the window from which to get the badge background color.
windowId
and tabId
are both supplied, the function fails.windowId
and tabId
are both omitted, the global badge background color is returned.A Promise
that will be fulfilled with the retrieved color as a browserAction.ColorArray
.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
getBadgeBackgroundColor |
Yes
|
14
|
45
|
?
|
Yes
|
14
Always returns a red
ColorArray .
|
?
|
?
|
79
|
?
|
15
Always returns a red
ColorArray .
|
?
|
details_windowId_parameter |
No
|
No
|
62
|
?
|
No
|
No
|
?
|
?
|
No
|
?
|
No
|
?
|
Log the badge's background color:
function onGot(color) { console.log(color); } function onFailure(error) { console.log(error); } browser.browserAction.getBadgeBackgroundColor({}).then(onGot, onFailure);
Note: This API is based on Chromium's chrome.browserAction
API. This documentation is derived from browser_action.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
© 2005–2022 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/getBadgeBackgroundColor