Saltar al contenido principal

Clase: IncomingMessage

Clase: IncomingMessage​

Maneja las respuestas a las solicitudes HTTP/HTTPS.

Process: Main, Utility
This class is not exported from the 'electron' module. Sólo está disponible como un valor de retorno de otros métodos en la API de Electron.

IncomingMessage implementa la interfaz Readable Stream y es por lo tanto un EventEmitter.

Eventos de Instancia​

Evento: "data"​

Devuelve:

  • chunk Buffer - Un fragmento de la colección de datos de respuesta.

El evento data es el método habitual de transferir datos de respuesta en código aplicativo.

Evento: "end"​

Indica que la respuesta del cuerpo ha finalizado. Debe colocarse antes del evento ' Data '.

Evento: "aborted"​

Aparece cuando una solicitud ha sido cancelada durante una transacción HTTP en curso.

Evento: "error"​

Devuelve:

error Error - Por lo general tiene tiene una cadena de error por la falla de la identificación de la causa raíz.

Aparece cuando se detecta un error mientras se transmiten los eventos de datos de respuesta. Por ejemplo, si el servidor cierra el subyacente mientras que la respuesta todavía se está transfiriendo, un evento data aparecerá como objeto de respuesta y un evento close seguirá posteriormente al objeto de la solicitud.

Propiedades de la instancia​

Una instancia IncomingMessage tiene las siguientes propiedades legibles:

response.statusCode​

Un Integer indicando el código de estatus de respuesta HTTP.

response.statusMessage​

Una string representando el mensaje de estado HTTP.

response.headers​

Un Record<string, string | string[]> que representa las cabeceras de la respuesta HTTP. El objeto headers tiene el siguiente formato:

  • Todos los nombres de los encabezados son puestos en minúsculas.
  • Duplicados de 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, o user-agent son descartados.
  • set-cookie siempre es un array. Los duplicados son agregados al array.
  • Para los encabezados cookie duplicados, los valores se unen con '; '.
  • Para todos los otros encabezados, los valores se unen con ', '.

response.httpVersion​

Una string que indica el número de versión de protocolo HTTP. Los valores típicos son "1.0" o "1.1". Adicionalmente httpVersionMajor y httpVersionMinor son dos propiedades legibles de valores enteros que devuelven los números de la versión principal y secundaria de HTTP respectivamente.

response.httpVersionMajor​

Un Integer que indica el número de la versión principal del protocolo HTTP.

response.httpVersionMinor​

Un Integer que indica el número de la versión secundaria del protocolo 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)