クラス: IncomingMessage
クラス: IncomingMessage
HTTP/HTTPS リクエストへのレスポンスを処理します。
プロセス: メイン、ユーティリティ
このクラスは 'electron'
モジュールからエクスポートされません。Electron API の他のメソッドの戻り値としてのみ利用可能です。
IncomingMessage
は Readable 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
オブジェクトは、次のようにフォーマットされています。
- すべてのヘッダー名は小文字です。
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
、またはuser-agent
の重複は破棄されます。set-cookie
は常に配列です。重複は配列に追加されます。- 重複する
cookie
ヘッダーの場合、値は '; ' で結合されます。 - 他のすべてのヘッダーでは、値は ', ' で結合されます。
response.httpVersion
HTTP プロトコルバージョン番号を示す string
。一般的な値は '1.0' または '1.1' です。さらに、httpVersionMajor
と httpVersionMinor
は、それぞれ 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)