Чтение тела запроса

Часть раздела Основы Express путешествия по Node.js на Coddy. Урок 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 и ничего не сохраняйте.

Задание

Легко

Посетители могут добавлять собственные рецепты. Программа отправляет новый рецепт в формате JSON в теле POST-запроса, а ваш API сохраняет его.

В server.js добавьте express.json() вместе с остальными строками app.use, выше маршрутов, чтобы тело запроса в формате JSON попадало в req.body.
Добавьте маршрут для POST-запросов к /api/recipes. Он считывает из тела запроса title и tags, например {"title": "Miso Soup", "tags": ["vegan", "soup"]}.
Маршрут создаёт новый рецепт со следующим номером id: у четырёх рецептов id от 1 до 4, поэтому первый новый рецепт получит id 5. В нём сохраняются присланные title и tags. Если 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 — последним. Затем отправьте POST-запрос с телом {"tags": ["dinner"]} к /api/recipes: статус 400 и {"error":"A recipe needs a title"}. GET /api/recipes по-прежнему возвращает список из пяти рецептов.

Попробуйте сами

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');
});