From 6a48bd97cd6812e8f867be9819fde54d4789951c Mon Sep 17 00:00:00 2001 From: hoarfroster Date: Fri, 13 Sep 2024 21:18:00 +0800 Subject: [PATCH 1/5] feat: update translation --- .../api/extension/getbackgroundpage/index.md | 89 +++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.md new file mode 100644 index 00000000000000..9bde70052e168b --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.md @@ -0,0 +1,89 @@ +--- +title: extension.getBackgroundPage() +slug: Mozilla/Add-ons/WebExtensions/API/extension/getBackgroundPage +l10n: + sourceCommit: a16fecbf75f71fc11e03ef6cd0b0c34ad6f3d480 +--- + +{{AddonSidebar}} + +若后台脚本在运行中,返回后台页面的 [Window](/zh-CN/docs/Web/API/Window)。若脚本未运行,则返回 null。 + +这是一个同步函数。 + +> [!NOTE] +> 该方法不能在隐私浏览模式下使用——它将总是返回 null。请考虑使用 {{WebExtAPIRef("runtime.sendMessage","runtime.sendMessage()")}} 或 {{WebExtAPIRef("runtime.connect","runtime.connect()")}}。更多信息请参见 [Firefox bug 1329304](https://bugzil.la/1329304)。 + +## 语法 + +```js-nolint +let page = browser.extension.getBackgroundPage() +``` + +### 参数 + +无。 + +### 返回值 + +`object`。后台页面的 [Window](/zh-CN/docs/Web/API/Window) 或 null。 + +## 示例 + +考虑[后台脚本](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#后台脚本)定义了一个函数 `foo()`: + +```js +// background.js + +function foo() { + console.log("我是在 backgroubd.js 中被定义的"); +} +``` + +在[弹窗](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#侧边栏,弹出窗口,选项页面)中运行的脚本可以直接调用这个函数: + +```js +// popup.js + +let page = browser.extension.getBackgroundPage(); +page.foo(); // -> "我是在 backgroubd.js 中被定义的" +``` + +{{WebExtExamples}} + +## 浏览器兼容性 + +{{Compat}} + +> [!NOTE] +> 此 API 基于 Chromium 的 [`chrome.extension`](https://developer.chrome.com/docs/extensions/reference/extension/#method-getBackgroundPage) API。该文档衍生自 Chromium 代码中的 [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json)。 + + From 6a6d04b4338c531a267a2a7c7437831272fd0b8b Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Fri, 20 Sep 2024 20:26:09 +0800 Subject: [PATCH 2/5] feat: improvements --- .../api/extension/getbackgroundpage/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.md index 9bde70052e168b..221dd23bc45953 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/getbackgroundpage/index.md @@ -2,12 +2,12 @@ title: extension.getBackgroundPage() slug: Mozilla/Add-ons/WebExtensions/API/extension/getBackgroundPage l10n: - sourceCommit: a16fecbf75f71fc11e03ef6cd0b0c34ad6f3d480 + sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 --- {{AddonSidebar}} -若后台脚本在运行中,返回后台页面的 [Window](/zh-CN/docs/Web/API/Window)。若脚本未运行,则返回 null。 +若后台脚本在运行中,则将返回后台页面的 [Window](/zh-CN/docs/Web/API/Window)。若脚本不在运行,则将返回 null。 这是一个同步函数。 @@ -30,7 +30,7 @@ let page = browser.extension.getBackgroundPage() ## 示例 -考虑[后台脚本](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#后台脚本)定义了一个函数 `foo()`: +考虑定义了一个函数 `foo()` 的[后台脚本](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#后台脚本): ```js // background.js @@ -46,7 +46,7 @@ function foo() { // popup.js let page = browser.extension.getBackgroundPage(); -page.foo(); // -> "我是在 backgroubd.js 中被定义的" +page.foo(); // -> "我是在 background.js 中被定义的" ``` {{WebExtExamples}} @@ -56,7 +56,7 @@ page.foo(); // -> "我是在 backgroubd.js 中被定义的" {{Compat}} > [!NOTE] -> 此 API 基于 Chromium 的 [`chrome.extension`](https://developer.chrome.com/docs/extensions/reference/extension/#method-getBackgroundPage) 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-getBackgroundPage) API。该文档衍生自 Chromium 代码中的 [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json)。