From 6a4bf1f5bc2616d9f382c19a04c4eaf806358f16 Mon Sep 17 00:00:00 2001 From: hoarfroster Date: Fri, 13 Sep 2024 21:21:18 +0800 Subject: [PATCH 1/5] feat: update translation --- .../api/extension/sendrequest/index.md | 77 +++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md new file mode 100644 index 00000000000000..1882ebb2bef0a0 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md @@ -0,0 +1,77 @@ +--- +title: extension.sendRequest() +slug: Mozilla/Add-ons/WebExtensions/API/extension/sendRequest +l10n: + sourceCommit: a16fecbf75f71fc11e03ef6cd0b0c34ad6f3d480 +--- + +{{AddonSidebar}}{{Deprecated_Header}} + +> [!WARNING] +> 该方法已被弃用。请改用 {{WebExtAPIRef("runtime.sendMessage")}}。 + +向插件中其他的监听器发送请求。类似于 {{WebExtAPIRef('runtime.connect')}}，但只发送单一请求并可选地带有响应。在扩展的每个页面中，{{WebExtAPIRef('extension.onRequest')}} 事件都会触发。 + +## 语法 + +```js-nolint +chrome.extension.sendRequest( + extensionId, // 可选的字符串 + request, // 任意类型 + (response) => {/* … */} // 可选的函数 +) +``` + +该函数也可以通过[将会返回一个 Promise](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/API#callbacks_and_promises) 的 `browser.extension.sendRequest()` 方法来使用。 + +### 参数 + +- `extensionId` {{optional_inline}} + - : `string`，你的插件希望连接到的插件的扩展 ID。如果省略，则默认为你自己的插件。 +- `request` + - : `any`。 +- `responseCallback` {{optional_inline}} + + - : `function`，将传递如下参数： + + - `response` + - : `any`，由请求处理程序发送的 JSON 响应对象。如果在连接到插件时发生错误，回调函数将不带参数调用，且 {{WebExtAPIRef('runtime.lastError')}} 将被设置为错误消息。 + +## 浏览器兼容性 + +{{Compat}} + +{{WebExtExamples}} + +> [!NOTE] +> 此 API 基于 Chromium 的 [`chrome.extension`](https://developer.chrome.com/docs/extensions/reference/extension/#method-sendRequest) API。该文档衍生自 Chromium 代码中的 [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json)。 + + From 79c62f311d13def04ea9aa4c83efc024b7faf212 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Fri, 20 Sep 2024 20:15:24 +0800 Subject: [PATCH 2/5] feat: improvements --- .../webextensions/api/extension/sendrequest/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md index 1882ebb2bef0a0..abe8ce7ef8ecf3 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md @@ -2,7 +2,7 @@ title: extension.sendRequest() slug: Mozilla/Add-ons/WebExtensions/API/extension/sendRequest l10n: - sourceCommit: a16fecbf75f71fc11e03ef6cd0b0c34ad6f3d480 + sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 --- {{AddonSidebar}}{{Deprecated_Header}} @@ -10,7 +10,7 @@ l10n: > [!WARNING] > 该方法已被弃用。请改用 {{WebExtAPIRef("runtime.sendMessage")}}。 -向插件中其他的监听器发送请求。类似于 {{WebExtAPIRef('runtime.connect')}}，但只发送单一请求并可选地带有响应。在扩展的每个页面中，{{WebExtAPIRef('extension.onRequest')}} 事件都会触发。 +向插件中其他的监听器发送请求。该方法类似于 {{WebExtAPIRef('runtime.connect')}}，但它只能发送可选地带有响应的单一请求。发送请求后在扩展的每个页面中，{{WebExtAPIRef('extension.onRequest')}} 事件都会触发。 ## 语法 @@ -32,10 +32,10 @@ chrome.extension.sendRequest( - : `any`。 - `responseCallback` {{optional_inline}} - - : `function`，将传递如下参数： + - : `function`，将传递如下参数的函数： - `response` - - : `any`，由请求处理程序发送的 JSON 响应对象。如果在连接到插件时发生错误，回调函数将不带参数调用，且 {{WebExtAPIRef('runtime.lastError')}} 将被设置为错误消息。 + - : `any`，由请求处理程序发送的 JSON 响应对象。如果在连接到插件时发生错误，回调函数将不带参数地被调用，且 {{WebExtAPIRef('runtime.lastError')}} 将被设置为错误消息。 ## 浏览器兼容性 @@ -44,7 +44,7 @@ chrome.extension.sendRequest( {{WebExtExamples}} > [!NOTE] -> 此 API 基于 Chromium 的 [`chrome.extension`](https://developer.chrome.com/docs/extensions/reference/extension/#method-sendRequest) 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-sendRequest) API。该文档衍生自 Chromium 代码中的 [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json)。