Obsługa błędów

Część sekcji Podstawy Express ścieżki Node.js w Coddy. Lekcja 15 z 20.

Gdy trasa zgłasza wyjątek, Express wyświetla własną stronę błędu, która nie jest w formacie JSON i pokazuje szczegóły przeznaczone dla Ciebie.

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

Oprogramowanie pośredniczące z czterema argumentami, (err, req, res, next), to obsługa błędów. Express zlicza argumenty: gdy są trzy, jest to zwykłe oprogramowanie pośredniczące, a błędy je pomijają. Gdy trasa zgłasza wyjątek, Express pomija zwykłe oprogramowanie pośredniczące i wywołuje obsługę błędów, przekazując jej błąd. Dodaj ją na końcu, za obsługą błędu 404. Zapisuj szczegóły w logach dla siebie, a klientowi wysyłaj krótką wiadomość.

Nieprawidłowy parametr ?by= to pomyłka odwiedzającego, więc nadal zwracaj kod 400. Błąd dotyczy czegoś, czego odwiedzający nie może naprawić, na przykład przepisu zapisanego bez liczby porcji.

Wyzwanie

Łatwy

GET /api/recipes/:id/scale?by=2 zwraca { "title", "servings" }, z pomnożoną liczbą porcji.
Współczynnik, który nie jest liczbą dodatnią: 400 z { "error": "Scale by a positive number" }.
Przepis bez servings zgłasza wyjątek Recipe <id> has no servings.
Program obsługi błędów zapisuje błąd w logu i zwraca 500 z { "error": "Something went wrong" }.

Wyślij ?by=2 i ?by=lots. Następnie wyślij żądanie POST z { "title": "Toast" } do /api/recipes i przeskaluj przepis 5.

Spróbuj swoich sił

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

const escapeHtml = (text) =>
    text
        .replaceAll('&', '&amp;')
        .replaceAll('<', '&lt;')
        .replaceAll('>', '&gt;')
        .replaceAll('"', '&quot;');

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') wysyła zwykły tekst, więc każdy tytuł pojawia się w osobnym wierszu.
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');
});