ハンドラ関数とレスポンス — hello world のどの行が socket に触っているか

Node 標準の http で最小のサーバを書くと、こうなります。

const http = require("http");
const server = http.createServer((req, res) => { res.end("hello"); });
server.listen(3999, () => { console.log("listening", JSON.stringify(server.address())); });

この3行が、接続を受ける一連の呼び出しのどこに相当するか並べます。

コードの部分              相当する呼び出し        何が起きるか
http.createServer(fn)     ——                    fn を覚えるだけ
server.listen(3999)       socket / bind / listen  端点を作り、ポートを割り当て、受動にする
(接続が来る)              accept                新しい fd が返る
(リクエストが届く)         read                  バイト列が読まれ、fn が呼ばれる
res.end("hello")          write                 ステータス行・ヘッダ・本文が書き出される
(keep-alive が切れる)     close                 接続が閉じられる

この表は strace や dtruss で採取した出力ではありません(手元の macOS では採取していません)。実際にはもっと多くの呼び出しが挟まります。

注目すべきは最後から2行目です。res.end("hello") という1行だけが、書き出しに対応しています。 createServer に渡した関数は、呼ばれるだけでは何も書き出しません。

Node のドキュメントは response.end() をこう説明しています。

This method signals to the server that all of the response headers and body have been sent; that server should consider this message complete. The method, response.end(), MUST be called on each response.

すべての応答で呼ばれなければならない(MUST)。返ってくるバイト列はこうです。

HTTP/1.1 200 OK
Date: Wed, 16 Sep 2026 04:11:10 GMT
Connection: keep-alive
Keep-Alive: timeout=5
Content-Length: 5
 
hello

ヘッダは4つだけで、Content-Type は付きません。付けと言っていないものは付かないのです。

res に書く形が唯一の作法ではありません。同じことを関数の戻り値で表す設計もあります。PEP 3333 の最小のアプリです。

HELLO_WORLD = b"Hello world!\n"
 
def simple_app(environ, start_response):
  """Simplest possible application object"""
  status = '200 OK'
  response_headers = [('Content-type', 'text/plain')]
  start_response(status, response_headers)
  return [HELLO_WORLD]

start_response でステータスとヘッダを渡し、本文は return [HELLO_WORLD] で返します。仕様はこう規定しています。

When called by the server, the application object must return an iterable yielding zero or more bytestrings.

本文は「0個以上のバイト列を yield するイテラブル」。Rack はより短くまとめます。

A Rack application is a Ruby object that responds to +call+. It takes exactly one argument, the +environment+ (representing an HTTP request) and returns a non-frozen +Array+ of exactly three elements: the +status+, the +headers+, and the +body+ (representing an HTTP response).

戻り値は [status, headers, body] の3要素配列。先の材料3つが、そのまま3要素になっています。

どちらの設計でも、書き出しているのはアプリではありません。 材料を RFC 9112 の形に組み上げて接続へ書き出すのはサーバ側です。

この違いが、応答を取りこぼす経路の違いになります。戻り値で返す設計では、関数が値を返せば材料は渡ります。res に書く設計では、書く呼び出しを実行しないまま抜けられてしまう。上の実機がその状態です。