Tratamento de erros

Parte da seção Fundamentos de Express do Journey de Node.js da Coddy. Lição 18 de 23.

Quando uma rota lança um erro, o Express responde com sua própria página de erro, que não é JSON e mostra detalhes destinados a você.

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

Um middleware com quatro argumentos, (err, req, res, next), é um manipulador de erros. O Express conta os argumentos: com três, é um middleware comum, e os erros o ignoram. Quando uma rota lança um erro, o Express ignora o middleware comum e chama o manipulador de erros passando o erro. Adicione-o por último, depois do manipulador de 404. Registre os detalhes para você; envie uma mensagem curta ao cliente.

throw new Error('text') interrompe a rota e passa o erro para o Express, e chamar next(err) faz o mesmo. Responda com 400 quando o visitante enviar algo errado que possa corrigir. Lance um erro quando a culpa for do servidor.

Desafio

Fácil

Dê continuidade ao Recipe Box. Você pode ignorar os arquivos separados em practice-errors/; agora, “Executar” inicia o server.js do projeto.

Quem cozinha quer ajustar as porções de uma receita, por exemplo, dobrar a quantidade para uma festa. Uma receita salva sem porções não pode ter as quantidades ajustadas. Isso é uma falha nos seus dados, não algo que o visitante possa corrigir, então o caso é encaminhado a um manipulador de erros que envia uma resposta JSON 500 organizada.

Em server.js, acima do manipulador 404, adicione uma rota para /api/recipes/:id/scale. Ela lê o fator da string de consulta, como em /api/recipes/1/scale?by=2.
Quando nenhuma receita tiver esse id, responda com o status 404 e {"error": "No such recipe"}.
Converta by em um número. Quando não for um número, ou for 0 ou menos, responda com o status 400 e {"error": "Scale by a positive number"}. Number('lots') é NaN, e Number.isNaN detecta esse valor.
Quando a receita não tiver servings, lance um novo Error cuja mensagem seja Recipe 5 has no servings, substituindo 5 pelo id dessa receita.
Caso contrário, responda com JSON contendo apenas o título e as porções ajustadas. A receita 1, Tomato Soup, tem 4 porções, então /api/recipes/1/scale?by=2 envia {"title": "Tomato Soup", "servings": 8}. Não adicione outros campos.
No fim do middleware do arquivo, depois do manipulador 404, adicione um manipulador de erros: um app.use cuja função recebe quatro argumentos, (err, req, res, next). Ele exibe o erro com console.error e responde com o status 500 e {"error": "Something went wrong"}.

Teste: Pressione “Executar” e envie /api/recipes/1/scale?by=2. Você deverá ver {"title":"Tomato Soup","servings":8}. Envie /api/recipes/2/scale?by=lots: status 400 e {"error":"Scale by a positive number"}. Envie /api/recipes/99/scale?by=2: status 404. Agora escolha POST e envie {"title": "Toast"} para /api/recipes. Ela se torna a receita 5, sem porções. Envie /api/recipes/5/scale?by=2: status 500 e {"error":"Something went wrong"}, e o Console mostra o erro Recipe 5 has no servings.

Experimente você mesmo

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') envia texto simples, então cada título aparece em uma linha separada.
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');
});