Aller au contenu principal

Classe : IncomingMessage

Classe : IncomingMessage

Gère les réponses aux requêtes HTTP/HTTPS.

Processus : Principal
Cette classe n'est pas exportée depuis le module 'electron'. Il n'est disponible qu'en tant que valeur de retour des autres méthodes dans l'API Electron.

IncomingMessage Implémente l'interface Readable Stream et est donc un EventEmitter.

Événements d’instance

Événement : 'data'

Retourne :

  • chunk Buffer - Un segment de données du corps de réponse.

L'événement data est la méthode habituelle de transfert des données de réponse dans le code applicatif.

Événement : 'end'

Indique que le corps de réponse est terminée. Must be placed before 'data' event.

Événement : 'aborted'

Émis lorsqu’une requête a été annulée lors d’une transaction HTTP en cours.

Événement : 'error'

Retourne :

error Error - Retourne généralement une chaîne de caractères d’erreur identifiant les causes d’échec.

Émis lorsqu’une erreur s’est produite pendant le transfert d’événements de données de réponse. Par exemple, si le serveur ferme la connexion alors que la réponse est toujours en transfert, un événement error retentit sur l’objet de réponse et un événement close suivra par la suite sur l’objet de la demande.

Propriétés d'instance

Une instance IncomingMessage possède les propriétés suivantes :

response.statusCode

Un Integer indiquant le code d'état de la réponse HTTP.

response.statusMessage

Un string représentant le message d'état HTTP.

response.headers

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

  • Tous les noms d’en-têtes sont en minuscules.
  • 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

Un string indiquant le numéro de version du protocole HTTP. Les valeurs habituelles sont '1.0' ou '1.1'. De plus, httpVersionMajor et httpVersionMinor sont deux propriétés entières lisibles qui retournent respectivement les numéros de version principale et secondaire de HTTP.

response.httpVersionMajor

Un Integerindiquant le numéro de version majeur du protocol HTTP.

response.httpVersionMinor

Un Integer indiquant le numéro de version mineur du protocol 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)