Manejo de errores

Parte de la sección Conceptos básicos de Express del Journey de Node.js de Coddy. Lección 15 de 20.

Cuando una ruta genera un error, Express responde con su propia página de error, que no es JSON y muestra detalles destinados a ti.

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

Un middleware con cuatro argumentos, (err, req, res, next), es un manejador de errores. Express cuenta los argumentos: con tres es middleware ordinario, y los errores lo omiten. Cuando una ruta genera un error, Express omite el middleware ordinario y llama al manejador de errores con el error. Añádelo al final, después del manejador 404. Registra los detalles para ti; envía al cliente un mensaje breve.

Un ?by= incorrecto es un error del visitante, así que sigue recibiendo un 400. Un error corresponde a algo que el visitante no puede arreglar, como una receta guardada sin la cantidad de porciones.

Desafío

Fácil

GET /api/recipes/:id/scale?by=2 responde { "title", "servings" }, con las porciones multiplicadas.
Un factor que no es un número positivo: 400 con { "error": "Scale by a positive number" }.
Una receta sin servings lanza Recipe <id> has no servings.
Un controlador de errores registra el error y responde 500 con { "error": "Something went wrong" }.

Envía ?by=2 y ?by=lots. Después, envía { "title": "Toast" } a /api/recipes y escala la receta 5.

Pruébalo tú mismo

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') envía texto sin formato, por lo que cada título aparece en una línea aparte.
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');
});