Códigos de status

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

Um programa lê o código de status antes do corpo, então um erro enviado com 200 parece um sucesso.

app.get('/api/loans', (req, res) => {
    if (!req.query.member) {
        res.status(400).json({ error: 'Say which member' });
        return;
    }
    res.json(loansOf(req.query.member));
});

res.status(code) define o status e retorna res, então .json(...) pode vir na mesma linha. return interrompe a função após o erro. Os códigos que você mais encontra:

200: deu certo (o padrão).
201: algo foi criado.
400: a solicitação está incorreta, como quando falta um campo.
404: não há nada nesse caminho ou id.
500: o servidor falhou.

Desafio

Fácil

Um id desconhecido em GET /api/recipes/:id responde com 404 e { "error": "No such recipe" }.

Envie GET /api/recipes/99 e GET /api/recipes/abc, depois GET /api/recipes/3 e compare os status.

Experimente você mesmo

import express from 'express';
import { recipes } from './data.js';

const app = express();

app.get('/', (req, res) => {
    res.send('Welcome to Recipe Box');
});

// type('text') envia texto simples, então cada título aparece em sua própria linha.
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).send('No such recipe');
        return;
    }
    res.json(recipe);
});

app.get('/about', (req, res) => {
    res.send('Recipe Box collects family recipes.');
});

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