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. 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(request.rawHeaders)