メインコンテンツにスキップ

クラス: IncomingMessage

クラス: IncomingMessage

HTTP/HTTPS リクエストへのレスポンスを処理します。

プロセス: メインユーティリティ
このクラスは 'electron' モジュールからエクスポートされません。Electron API の他のメソッドの戻り値としてのみ利用可能です。

IncomingMessageReadable Stream インターフェースを実装しているため、EventEmitter です。

インスタンスイベント

イベント: 'data'

戻り値

  • chunk Buffer - レスポンスボディのデータチャンク。

data イベントは、レスポンスデータをアプリケーションコードに転送する一般的な方法です。

イベント: 'end'

レスポンスボディが終了したことを示します。「data」イベントの前に配置する必要があります。

イベント: 'aborted'

進行中の HTTP トランザクション中にリクエストがキャンセルされた場合に発生します。

イベント: 'error'

戻り値

error Error - 通常、失敗の根本原因を特定するエラー文字列を保持します。

レスポンスデータイベントのストリーミング中にエラーが発生した場合に発生します。たとえば、レスポンスがまだストリーミング中にサーバーが基盤となる接続を閉じた場合、レスポンスオブジェクトで error イベントが発生し、その後、リクエストオブジェクトで close イベントが発生します。

インスタンスプロパティ

IncomingMessage インスタンスには、次の読み取り可能なプロパティがあります。

response.statusCode

HTTP レスポンスのステータスコードを示す Integer

response.statusMessage

HTTP ステータスメッセージを表す string

response.headers

HTTP レスポンスヘッダーを表す Record<string, string | string[]>headers オブジェクトは、次のようにフォーマットされています。

  • すべてのヘッダー名は小文字です。
  • ageauthorizationcontent-lengthcontent-typeetagexpiresfromhostif-modified-sinceif-unmodified-sincelast-modifiedlocationmax-forwardsproxy-authorizationrefererretry-afterserver、または user-agent の重複は破棄されます。
  • set-cookie は常に配列です。重複は配列に追加されます。
  • 重複する cookie ヘッダーの場合、値は '; ' で結合されます。
  • 他のすべてのヘッダーでは、値は ', ' で結合されます。

response.httpVersion

HTTP プロトコルバージョン番号を示す string。一般的な値は '1.0' または '1.1' です。さらに、httpVersionMajorhttpVersionMinor は、それぞれ HTTP のメジャーバージョン番号とマイナーバージョン番号を返す 2 つの Integer 値の読み取り可能なプロパティです。

response.httpVersionMajor

HTTP プロトコルのメジャーバージョン番号を示す Integer

response.httpVersionMinor

HTTP プロトコルのマイナーバージョン番号を示す Integer

response.rawHeaders

受信したとおりの生の HTTP レスポンスヘッダーを含む string[]。キーと値は同じリスト内にあります。これはタプルのリストではありません。したがって、偶数番号のオフセットはキー値であり、奇数番号のオフセットは関連付けられた値です。ヘッダー名は小文字ではなく、重複はマージされません。

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