diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md new file mode 100644 index 00000000000000..b206d59d427d7f --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/action/getbadgetext/index.md @@ -0,0 +1,95 @@ +--- +title: action.getBadgeText() +slug: Mozilla/Add-ons/WebExtensions/API/action/getBadgeText +l10n: + sourceCommit: b30a10c08b986ebabd44733fb62f67667350403e +--- + +{{AddonSidebar}} + +获取浏览器操作的徽章文本。 + +> [!NOTE] +> 该 API 在 Manifest V3 或更高版本中可用。 + +这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。 + +## 语法 + +```js-nolint +let gettingText = browser.action.getBadgeText( + details // 对象 +) +``` + +### 参数 + +- `details` + + - : 一个含有下列属性的对象: + + - `tabId` {{optional_inline}} + - : `integer`,指定要获取徽章文本的标签页。 + - `windowId` {{optional_inline}} + - : `integer`,指定要获取徽章文本的窗口。 + + + +- 若同时指定了 `windowId` 和 `tabId`,则函数出错。 +- 若同时未指定 `windowId` 和 `tabId`,则返回全局的徽章文本。 + +### 返回值 + +一个 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise),会兑现包含徽章文本的字符串。 + +## 示例 + +输出徽章文本: + +```js +function gotBadgeText(text) { + console.log(text); +} + +let gettingBadgeText = browser.action.getBadgeText({}); +gettingBadgeText.then(gotBadgeText); +``` + +{{WebExtExamples}} + +## 浏览器兼容性 + +{{Compat}} + +> [!NOTE] +> 该 API 基于 Chromium 的 [`chrome.action`](https://developer.chrome.com/docs/extensions/reference/action/#method-getBadgeText) API。本文衍生自 Chromium 代码中的 [`browser_action.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/browser_action.json)。 + +