リクエストボディを読む

CoddyのNode.jsジャーニー「Expressの基礎」セクションの一部。レッスン 15/23。

POSTリクエストは本文でデータを送信します。Expressは、指示しない限り本文を読み取りません。

app.use(express.json());

app.post('/api/loans', (req, res) => {
    const { bookId, member } = req.body;
    res.status(201).json({ bookId, member, due: '2026-11-08' });
});

GETは何かを要求し、POSTは作成するものを送信します。express.json()は、すべてのJSON本文をreq.bodyに読み込むミドルウェアです。これがないと、req.bodyはundefinedになります。何かを作成するルートは、作成したものとともに201を返します。

保存する前に本文を確認してください。フィールドが欠けているのはクライアント側の誤りなので、400を返し、何も保存しません。

チャレンジ

簡単

訪問者は自分のレシピを追加できます。プログラムは新しいレシピをPOSTリクエストの本文にJSONとして送り、APIがそれを保存します。

server.jsで、ルートより上にある他のapp.useの行と並べてexpress.json()を追加し、JSON本文がreq.bodyに入るようにします。
/api/recipesへのPOSTリクエストを処理するルートを追加します。本文からtitleとtagsを読み取ります。たとえば、{"title": "Miso Soup", "tags": ["vegan", "soup"]}のようにします。
次の番号のIDを使って新しいレシピを作成します。4つのレシピのIDは1から4なので、最初に追加するレシピのIDは5になります。送られてきたタイトルとタグを保持します。tagsが送られてこなかった場合は、空のリスト[]を使います。
レシピをrecipes配列に追加し、GET /api/recipesで一覧に表示されるようにします。次に、ステータス201と、新しいレシピをJSONで返します。{"id": 5, "title": "Miso Soup", "tags": ["vegan", "soup"]}
本文にtitleがない場合は何も保存せず、ステータス400と次のJSONを返します。{"error": "A recipe needs a title"}

試してみましょう：「実行」を押します。メソッド選択でPOSTを選び、パスに/api/recipesと入力し、本文の入力欄に{"title": "Miso Soup", "tags": ["vegan", "soup"]}を入力します。ステータス201と、"id": 5のレシピが表示されます。GETを選んで/api/recipesを送信すると、最後にMiso Soupがある5つのレシピが表示されます。次に、{"tags": ["dinner"]}を/api/recipesにPOSTします。ステータス400と{"error":"A recipe needs a title"}が返されます。GET /api/recipesには、引き続き5つのレシピが表示されます。

自分で試してみよう

import { escapeHtml } from './html.js';
import express from 'express';
import { randomUUID } from 'node:crypto';
import { recipes } from './data.js';

const app = express();

app.use((req, res, next) => {
    console.log(`${req.method} ${req.url}`);
    next();
});

app.use((req, res, next) => {
    res.set('X-Request-Id', randomUUID());
    next();
});

app.use(express.static('public'));

app.get('/', (req, res) => {
    const items = recipes.map((r) => `<li><a href="/recipes/${r.id}">${escapeHtml(r.title)}</a></li>`);
    res.send(`<link rel="stylesheet" href="/style.css"><h1>Recipe Box</h1><ul>${items.join('')}</ul>`);
});

// type('text') はプレーンテキストを送信するため、各タイトルがそれぞれ別の行に表示されます。
app.get('/recipes', (req, res) => {
    const { tag } = req.query;
    const list = tag ? recipes.filter((recipe) => recipe.tags.includes(tag)) : recipes;
    res.type('text').send(list.map((recipe) => recipe.title).join('\n'));
});

app.get('/recipes/:id', (req, res) => {
    const recipe = recipes.find((r) => r.id === Number(req.params.id));
    if (!recipe) {
        res.status(404).send('No such recipe');
        return;
    }
    res.send(recipe.title);
});

app.get('/api/recipes', (req, res) => {
    res.json(recipes);
});

app.get('/api/recipes/:id', (req, res) => {
    const recipe = recipes.find((r) => r.id === Number(req.params.id));
    if (!recipe) {
        res.status(404).json({ error: 'No such recipe' });
        return;
    }
    res.json(recipe);
});

app.get('/about', (req, res) => {
    res.send('Recipe Box collects family recipes.');
});

app.get('/menu', (req, res) => {
    res.redirect(301, '/recipes');
});

app.get('/menu/:id', (req, res) => {
    res.redirect(301, `/recipes/${req.params.id}`);
});

app.listen(3000, () => {
    console.log('Recipe Box is running on port 3000');
});