【Node.js24.x】Object::IncomingMessage()メソッドの使い方

IncomingMessageメソッドは、Node.js環境において、HTTP通信で受信されるメッセージの処理に関連する操作を実行するメソッドです。このメソッドはObjectクラスに属しており、主にHTTPサーバーがクライアントからのリクエストを受信した際、またはHTTPクライアントがサーバーからのレスポンスを受信した際に、そのメッセージをプログラムで扱うための機能を提供します。具体的には、受信メッセージのヘッダー情報を解析したり、メッセージボディ（本文）のデータストリームを読み込んだりする処理が想定されます。システム開発において、WebアプリケーションやAPIサーバーを構築する際には、受信したHTTPリクエストの内容を正確に理解し、それに基づいて適切な処理を実行することが不可欠です。IncomingMessageメソッドは、そうした受信メッセージのデータにアクセスし、アプリケーションロジックに組み込むための基盤的な役割を担います。これにより、開発者は効率的にHTTP通信を扱うシステムを構築できるようになります。

Copy
1const http = require('node:http');
2
3http.createServer((req, res) => {
4  // 'req' は http.IncomingMessage のインスタンスです。
5
6  // 受信するデータストリームのエンコーディングを設定するメソッド
7  req.setEncoding('utf8');
8
9  // 'data' イベントのリスナーを設定するメソッド
10  // リクエストボディのデータチャンクが利用可能になるたびに呼び出されます。
11  req.on('data', (chunk) => {
12    // ここで受信したデータチャンクを処理します
13  });
14
15  // 'end' イベントのリスナーを設定するメソッド
16  // リクエストボディ全体の受信が完了したときに呼び出されます。
17  req.on('end', () => {
18    // ここでリクエストボディ全体の処理が完了した後の処理を行います
19    res.statusCode = 200;
20    res.end('Request processed.');
21  });
22}).listen(3000);

socket

• socket: IncomingMessageインスタンスが関連付けられるソケットオブジェクト

http.IncomingMessage

http.IncomingMessage: クライアントからのHTTPリクエストに関する情報を含むオブジェクトを返します。