electron/docs/api/structures/protocol-response.md
Cheng Zhao 0a9438dbba
docs: documentation of NetworkService-based protocol module (#18952)
* docs: NetworkService-based protocol module

* docs: separate ProtocolRequest

* docs: separate ProtocolResponse

* docs: fix lint warning

* docs: fix electron.d.ts

* fix: print deprecation warnings for protocol module

* docs: fix links

* Apply suggestions from code review

Co-Authored-By: Felix Rieseberg <felix@felixrieseberg.com>

* Apply suggestions from code review

Co-Authored-By: Samuel Attard <samuel.r.attard@gmail.com>

* Do not publish NetworkService changes draft

* Apply suggestions from code review

Co-Authored-By: Samuel Attard <samuel.r.attard@gmail.com>

* docs: filePath must be absolute
2019-06-28 16:25:30 +09:00

2.1 KiB

ProtocolResponse Object

  • error Integer (optional) - When assigned, the request will fail with the error number . For the available error numbers you can use, please see the net error list.
  • statusCode Number (optional) - The HTTP response code, default is 200.
  • charset String (optional) - The charset of response body, default is "utf-8".
  • mimeType String (optional) - The MIME type of response body, default is "text/html". Setting mimeType would implicitly set the content-type header in response, but if content-type is already set in headers, the mimeType would be ignored.
  • headers Record<string, string | string[]> (optional) - An object containing the response headers. The keys must be String, and values must be either String or Array of String.
  • data (Buffer | String | ReadableStream) (optional) - The response body. When returning stream as response, this is a Node.js readable stream representing the response body. When returning Buffer as response, this is a Buffer. When returning String as response, this is a String. This is ignored for other types of responses.
  • path String (optional) - Path to the file which would be sent as response body. This is only used for file responses.
  • url String (optional) - Download the url and pipe the result as response body. This is only used for URL responses.
  • referrer String (optional) - The referrer URL. This is only used for file and URL responses.
  • method String (optional) - The HTTP method. This is only used for file and URL responses.
  • session Session (optional) - The session used for requesting URL, by default the HTTP request will reuse the current session. Setting session to null would use a random independent session. This is only used for URL responses.
  • uploadData Object (optional) - The data used as upload data. This is only used for URL responses when method is "POST".
    • contentType String - MIME type of the content.
    • data String - Content to be sent.