Перейти к основному содержанию

Class: IncomingMessage

Class: IncomingMessage​

Обрабатывает запросы на HTTP/HTTPS-запросы.

Process: Main, Utility
This class is not exported from the 'electron' module. Он доступен только в качестве возвращаемого значения других методов в Electron API.

IncomingMessage реализует интерфейс Readable Stream и, тем самым, также и EventEmitter.

События экземпляра​

Событие: 'data'​

Возвращает:

  • chunk Buffer - Часть данных в теле ответа.

Событие data является обычным способом передачи данных ответа в применимый код.

Событие: 'end'​

Указывает, что тело ответа закончилось. Must be placed before 'data' event.

Событие: 'aborted'​

Возникает, когда запрос был отменен во время текущей HTTP-транзакции.

Событие: 'error'​

Возвращает:

  • error Error - Содержит строку ошибки, идентифицирующую причину отказа.

Возникает при обнаружении ошибки во время потоковой передачи ответных данных. Например, если сервер закрывает базовый объект во время потоковой передачи ответа, объекту ответа будет выдано error, а событие close впоследствии будет выдано объекту запроса.

Свойства экземпляра​

IncomingMessage имеет следующие свойства для чтения:

response.statusCode​

Integer с указанием кода ответа HTTP.

response.statusMessage​

string, представляющая сообщение о состоянии HTTP.

response.headers​

A Record<string, string | string[]> representing the HTTP response headers. The headers object is formatted as follows:

  • Все имена заголовков в нижнем регистре.
  • Duplicates of age, authorization, content-length, content-type, etag, expires, from, host, if-modified-since, if-unmodified-since, last-modified, location, max-forwards, proxy-authorization, referer, retry-after, server, or user-agent are discarded.
  • set-cookie is always an array. Duplicates are added to the array.
  • For duplicate cookie headers, the values are joined together with '; '.
  • For all other headers, the values are joined together with ', '.

response.httpVersion​

string с указанием номера HTTP протокола. Типичные значения: «1.0» или «1.1». Дополнительно httpVersionMajor и httpVersionMinor являются двумя целочисленными читаемыми свойствами, которые возвращают соответственно основные и второстепенные номера версий HTTP.

response.httpVersionMajor​

Integer с указанием основной версии протокола HTTP.

response.httpVersionMinor​

Integer, указание номера младшей версии протокола HTTP.

response.rawHeaders​

A string[] containing the raw HTTP response headers exactly as they were received. The keys and values are in the same list. It is not a list of tuples. So, the even-numbered offsets are key values, and the odd-numbered offsets are the associated values. Header names are not lowercased, and duplicates are not merged.

// Prints something like:
//
// [ 'user-agent',
//   'this is invalid because there can be only one',
//   'User-Agent',
//   'curl/7.22.0',
//   'Host',
//   '127.0.0.1:8000',
//   'ACCEPT',
//   '*/*' ]
console.log(response.rawHeaders)