diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getextensiontabs/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getextensiontabs/index.md new file mode 100644 index 00000000000000..a6547d7051a544 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getextensiontabs/index.md @@ -0,0 +1,71 @@ +--- +title: extension.getExtensionTabs() +slug: Mozilla/Add-ons/WebExtensions/API/extension/getExtensionTabs +l10n: + sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 +--- + +{{AddonSidebar}} + +> [!WARNING] +> 此方法已被弃用。请改用 {{WebExtAPIRef("extension.getViews()")}}。 + +返回表示当前扩展内运行的每个标签页的 JavaScript [Window](/zh-CN/docs/Web/API/Window) 对象的数组。如果指定了 `windowId`,则仅返回附加到指定窗口的标签页的 Window 对象。 + +## 语法 + +```js-nolint +chrome.extension.getExtensionTabs( + windowId // 可选的整型值 +) +``` + +该 API 同样以 `browser.extension.getExtensionTabs()` 的形式可用。 + +### 参数 + +- `windowId` {{optional_inline}} + - : `integer`。 + +### 返回值 + +`object` 数组(`array`):全局 window 对象的数组。 + +## 浏览器兼容性 + +{{Compat}} + +{{WebExtExamples}} + +> [!NOTE] +> 此 API 基于 Chromium 的 [`chrome.extension`](https://developer.chrome.com/docs/extensions/reference/api/extension#method-getExtensionTabs) API。该文档衍生自 Chromium 代码中的 [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json)。 + +