browserAction.getBadgeText()

Gets the browser action's badge text.

Syntax

chrome.browserAction.getBadgeText(
  details,               // object
  function(result) {...} // function
)

This API is also available as browser.browserAction.getBadgeText() in a version that returns a promise.

Parameters

details
object.
tabIdOptional
integer. Specifies the tab to get the badge text from. If no tab is specified, the non-tab-specific badge text is returned.
callback
function. The function is passed the following arguments:
result
string. The badge text.

Browser compatibility

Chrome Edge Firefox Firefox for Android Opera
Basic support Yes Yes 45.0 No 33

Examples

Log the badge text:

function onGotText(badgeText) {
  console.log(badgeText);
}

chrome.browserAction.getBadgeText({}, onGotText);

Acknowledgements

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.

Document Tags and Contributors

 Contributors to this page: Makyen, chrisdavidmills, wbamberg
 Last updated by: Makyen,