Path: blob/main/files/en-us/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md
6552 views
------{{AddonSidebar}}{{Deprecated_Header}}
Warning: This method has been deprecated. Use {{WebExtAPIRef("runtime.sendMessage")}} instead.
Sends a single request to other listeners within the extension. Similar to {{WebExtAPIRef('runtime.connect')}}, but only sends a single request with an optional response. The {{WebExtAPIRef('extension.onRequest')}} event is fired in each page of the extension.
Syntax
This API is also available as browser.extension.sendRequest() in a version that returns a promise.
Parameters
extensionId{{optional_inline}}:
string. The extension ID of the extension you want to connect to. If omitted, default is your own extension.
request:
any.
responseCallback{{optional_inline}}:
function. The function is passed the following arguments:response:
any. The JSON response object sent by the handler of the request. If an error occurs while connecting to the extension, the callback will be called with no arguments and {{WebExtAPIRef('runtime.lastError')}} will be set to the error message.
Browser compatibility
{{Compat}}
{{WebExtExamples}}
Note: This API is based on Chromium's
chrome.extensionAPI. This documentation is derived fromextension.jsonin the Chromium code.