From 1ffcbb1b4d8d980ca4e5292414fcadfbfd65c9e1 Mon Sep 17 00:00:00 2001 From: hoarfroster Date: Fri, 13 Sep 2024 21:19:20 +0800 Subject: [PATCH 1/3] feat: update translation --- .../api/extension/getviews/index.md | 103 ++++++++++++++++++ 1 file changed, 103 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/extension/getviews/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getviews/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getviews/index.md new file mode 100644 index 00000000000000..0d5602cffb8660 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getviews/index.md @@ -0,0 +1,103 @@ +--- +title: extension.getViews() +slug: Mozilla/Add-ons/WebExtensions/API/extension/getViews +l10n: + sourceCommit: a16fecbf75f71fc11e03ef6cd0b0c34ad6f3d480 +--- + +{{AddonSidebar}} + +返回当前扩展内运行的每个页面的 [Window](/zh-CN/docs/Web/API/Window) 对象数组。这包括： + +- 背景页面（若定义了） +- 任何弹出页面（若定义并已加载） +- 任何选项页面（若定义并已加载） +- 任何托管扩展打包内容的浏览器标签页 + +在 Firefox 中，如果从隐私浏览窗口的页面调用此方法，例如从隐私窗口中的侧边栏或从隐私窗口打开的弹出窗口，则其返回值将不包括扩展的背景页面。 + +## 语法 + +```js-nolint +let windows = browser.extension.getViews( + fetchProperties // 可选的对象 +) +``` + +### 参数 + +- `fetchProperties` {{optional_inline}} + + - : 包含如下属性的对象： + + - `type` {{optional_inline}} + - : `string`，指示要获取的视图类型的 {{WebExtAPIRef('extension.ViewType')}}。如果省略，此函数将返回所有视图。 + - `windowId` {{optional_inline}} + - : `integer`，要限制搜索范围的窗口。如果省略，此函数将返回所有视图。在 Firefox 版本 92 及更早版本中，侧边栏视图并不匹配，因此将不会返回。 + +### 返回值 + +`object` 的 `array`：[Window](/zh-CN/docs/Web/API/Window) 对象数组。 + +## 浏览器兼容性 + +{{Compat}} + +## 示例 + +获取属于此扩展的所有窗口，并记录它们的 URL： + +```js +const windows = browser.extension.getViews(); + +for (const extensionWindow of windows) { + console.log(extensionWindow.location.href); +} +``` + +仅获取托管扩展打包内容的浏览器标签页中的窗口： + +```js +const windows = browser.extension.getViews({ type: "tab" }); +``` + +仅获取弹出窗口中的窗口： + +```js +const windows = browser.extension.getViews({ type: "popup" }); +``` + +{{WebExtExamples}} + +> [!NOTE] +> 此 API 基于 Chromium 的 [`chrome.extension`](https://developer.chrome.com/docs/extensions/reference/extension/#method-getViews) API。该文档衍生自 Chromium 代码中的 [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json)。 + + From c8b343e7a65a733e875d5e7eede51b13b220cb28 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Fri, 20 Sep 2024 20:24:04 +0800 Subject: [PATCH 2/3] feat: improvements --- .../add-ons/webextensions/api/extension/getviews/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getviews/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getviews/index.md index 0d5602cffb8660..b8fb4ebf8ccafd 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getviews/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getviews/index.md @@ -2,7 +2,7 @@ title: extension.getViews() slug: Mozilla/Add-ons/WebExtensions/API/extension/getViews l10n: - sourceCommit: a16fecbf75f71fc11e03ef6cd0b0c34ad6f3d480 + sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 --- {{AddonSidebar}} @@ -33,7 +33,7 @@ let windows = browser.extension.getViews( - `type` {{optional_inline}} - : `string`，指示要获取的视图类型的 {{WebExtAPIRef('extension.ViewType')}}。如果省略，此函数将返回所有视图。 - `windowId` {{optional_inline}} - - : `integer`，要限制搜索范围的窗口。如果省略，此函数将返回所有视图。在 Firefox 版本 92 及更早版本中，侧边栏视图并不匹配，因此将不会返回。 + - : `integer`，要限制搜索范围的窗口。如果省略，此函数将返回所有视图。在 Firefox 版本 92 及更早版本中，由于侧边栏视图并不匹配，因此将不会被返回。 ### 返回值 @@ -70,7 +70,7 @@ const windows = browser.extension.getViews({ type: "popup" }); {{WebExtExamples}} > [!NOTE] -> 此 API 基于 Chromium 的 [`chrome.extension`](https://developer.chrome.com/docs/extensions/reference/extension/#method-getViews) API。该文档衍生自 Chromium 代码中的 [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json)。 +> 此 API 基于 Chromium 的 [`chrome.extension`](https://developer.chrome.com/docs/extensions/reference/api/extension/#method-getViews) API。该文档衍生自 Chromium 代码中的 [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json)。