Обработка ошибок

Часть раздела Основы Express путешествия по Node.js на Coddy. Урок 18 из 23.

Когда в маршруте возникает ошибка, Express показывает собственную страницу ошибки, которая не является JSON и содержит подробности, предназначенные для вас.

app.get('/api/fines/:member', (req, res) => {
    throw new Error('Fines database is down');
});

app.use((err, req, res, next) => {
    console.error(err);
    res.status(500).json({ error: 'Try again later' });
});

Промежуточное ПО с четырьмя аргументами (err, req, res, next) — это обработчик ошибок. Express учитывает аргументы: если их три, это обычное промежуточное ПО, и обработка ошибок пропускает его. Когда в маршруте возникает ошибка, Express пропускает обычное промежуточное ПО и вызывает обработчик ошибок, передавая ему ошибку. Добавьте его последним, после обработчика 404. Записывайте подробности в журнал для себя, а клиенту отправляйте короткое сообщение.

throw new Error('text') останавливает маршрут и передаёт ошибку Express; вызов next(err) делает то же самое. Отправляйте ответ 400, когда посетитель отправил неверные данные и может их исправить. Выбрасывайте ошибку, когда проблема на стороне сервера.

Задание

Легко

Продолжи работу над Recipe Box. Отдельные файлы practice-errors/ можно не учитывать: теперь кнопка Run запускает файл server.js проекта.

Повара хотят масштабировать рецепт, например, удваивать количество порций для вечеринки. Рецепт, сохранённый без указания количества порций, масштабировать нельзя. Это ошибка в данных, а не то, что посетитель может исправить, поэтому она передаётся обработчику ошибок, который отправляет корректный ответ JSON со статусом 500.

В файле server.js, перед обработчиком 404, добавь маршрут для /api/recipes/:id/scale. Он считывает коэффициент из строки запроса, например, из /api/recipes/1/scale?by=2.
Если рецепта с таким идентификатором нет, ответь со статусом 404 и {"error": "No such recipe"}.
Преобразуй by в число. Если это не число, или оно равно 0 либо меньше, ответь со статусом 400 и {"error": "Scale by a positive number"}. Number('lots') — это NaN, а Number.isNaN позволяет его обнаружить.
Если у рецепта нет servings, выброси новый объект Error с сообщением Recipe 5 has no servings, подставив вместо 5 идентификатор этого рецепта.
В противном случае ответь JSON, содержащим только название и масштабированное количество порций. У рецепта 1, Tomato Soup, 4 порции, поэтому запрос /api/recipes/1/scale?by=2 отправляет {"title": "Tomato Soup", "servings": 8}. Не добавляй другие поля.
В конце списка промежуточных обработчиков файла, после обработчика 404, добавь обработчик ошибок: app.use, функция которого принимает четыре аргумента — (err, req, res, next). Он выводит ошибку с помощью console.error и отвечает со статусом 500 и {"error": "Something went wrong"}.

Проверь: Нажми Run и отправь /api/recipes/1/scale?by=2. Ты должен увидеть {"title":"Tomato Soup","servings":8}. Отправь /api/recipes/2/scale?by=lots: статус 400 и {"error":"Scale by a positive number"}. Отправь /api/recipes/99/scale?by=2: статус 404. Теперь выбери POST и отправь {"title": "Toast"} на /api/recipes. Он станет рецептом 5 без указанного количества порций. Отправь /api/recipes/5/scale?by=2: статус 500 и {"error":"Something went wrong"}, а в Console появится ошибка Recipe 5 has no servings.

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

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.json());

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.post('/api/recipes', (req, res) => {
    const { title, tags } = req.body;
    if (!title) {
        res.status(400).json({ error: 'A recipe needs a title' });
        return;
    }
    const recipe = { id: recipes.length + 1, title, tags: tags ?? [] };
    recipes.push(recipe);
    res.status(201).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.use((req, res) => {
    if (req.path.startsWith('/api/')) {
        res.status(404).json({ error: 'Not found' });
        return;
    }
    res.status(404).send('<h1>Page not found</h1><p><a href="/">Back to Recipe Box</a></p>');
});

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