index.md

---

title: browserAction.getBadgeText()
slug: Mozilla/Add-ons/WebExtensions/API/browserAction/getBadgeText
page-type: webextension-api-function
tags:
  - API
  - Add-ons
  - Extensions
  - Method
  - Non-standard
  - Reference
  - WebExtensions
  - browserAction
  - getBadgeText
browser-compat: webextensions.api.browserAction.getBadgeText

---

{{AddonSidebar()}}

Gets the browser action's badge text.

This is an asynchronous function that returns a Promise.

Syntax

let gettingText = browser.browserAction.getBadgeText(
  details               // object
)

Parameters

• details

  • : An object with the following properties:

    • tabId {{optional_inline}}

      • : integer. Specifies the tab from which to get the badge text.

    • windowId {{optional_inline}}

      • : integer. Specifies the window from which to get the badge text.

• If windowId and tabId are both supplied, the function fails.

• If windowId and tabId are both omitted, the global badge text is returned.

Return value

A Promise that will be fulfilled with a string containing the badge text.

Browser compatibility

{{Compat}}

Examples

Log the badge text:

function gotBadgeText(text) {
  console.log(text);
}

let gettingBadgeText = browser.browserAction.getBadgeText({});
gettingBadgeText.then(gotBadgeText);

{{WebExtExamples}}

Note: This API is based on Chromium's chrome.browserAction API. This documentation is derived from browser_action.json in the Chromium code.