Aller au contenu principal

Classe : IncomingMessage

Classe : IncomingMessage​

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

Processus : Main, Utility
Cette classe n’est pas exportée à partir du module 'electron'. Elle 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. Doit être placé avant l'événement 'data'.

É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​

Record<string, string | string[]> représentant les en-têtes de réponse HTTP. L'objet headers est formaté comme suit :

  • Tous les noms d’en-têtes sont en minuscules.
  • Les doublons 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, ou user-agent sont ignorés.
  • set-cookie est toujours un tableau. Les doublons sont ajoutés dans le tableau.
  • Pour les en-têtes cookie dupliqués, les valeurs sont jointes avec '; '.
  • Pour tous les autres en-têtes, les valeurs sont jointes avec ', '.

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​

string[] contenant les en-têtes de réponse HTTP bruts exactement tels qu'ils ont été reçus. Les clés et les valeurs sont dans la même liste. Il ne s'agit pas d'une liste de tuples. Ainsi, les index pairs correspondent aux valeurs des clés et les impairs aux valeurs associées . Les noms d'en-tête ne sont pas mis en minuscule, et les doublons ne sont pas fusionnés.

// 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)