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

Class: IncomingMessage

Class: IncomingMessage

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

Process: Main
This class is not exported from the 'electron' module. It is only available as a return value of other methods in the 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(request.rawHeaders)