Express.jsのres.sendとres.jsonの違いを徹底解説

ExpressアプリケーションサーバーがHTTPリクエストを受け取ると、開発者に対してオブジェクトが提供されます。このオブジェクトは一般的に「res」と呼ばれています。

resオブジェクトとは

まず、基本的なコード例を見てみましょう。

app.get('/test', (req, res) => {
    // ここでreqとresを使用する
})

上記の例では、resオブジェクトは、このAPI呼び出しの一部としてクライアントへ送信されるレスポンス(応答)を表しています。開発者はこのresオブジェクトのメソッドを使って、クライアントに返すデータやヘッダー情報を制御します。

res.sendの特徴

res.send()関数は、Content-Typeをtext/htmlに設定します。つまり、クライアント側は受け取ったレスポンスをテキストとして扱うことになります。その後、レスポンスがクライアントに返されます。

文字列、HTML、Buffer、オブジェクトなど、さまざまな型のデータを送信できる柔軟性があるのが特徴です。ただし、送信する内容によって自動的にContent-Typeが判定されるため、意図しない形式で送信される可能性もあります。

res.jsonの特徴

一方、res.json()関数は、Content-Typeヘッダーをapplication/jsonに設定します。これにより、クライアントはレスポンスとして受け取った文字列を有効なJSONオブジェクトとして認識・処理できます。こちらも同様に、レスポンスはクライアントに返されます。

JSON形式のAPIレスポンスを返す場合には、res.json()を使用することで、クライアント側でのデータ解析がスムーズになり、より明確な意図を伝えることができます。

使い分けのポイント

• res.send():HTMLやプレーンテキストなど、JSON以外のデータを返したい場合に適しています。
• res.json():REST APIなどでJSONデータを返すことが明確な場合に使用すると、Content-Typeが正しく設定され、クライアント側の扱いも一貫します。

どちらのメソッドも最終的にはレスポンスをクライアントに返すという同じ役割を果たしますが、Content-Typeの設定が異なる点が最大の違いです。API設計においては、返却するデータの形式に合わせて適切なメソッドを選択することが重要です。