Códigos de estado

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

Un programa lee el código de estado antes que el cuerpo, así que un error enviado con 200 parece un éxito.

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) establece el estado y devuelve res, así que .json(...) puede ir a continuación en la misma línea. return detiene la función después del error. Los códigos que verás con más frecuencia:

200: funcionó (el valor predeterminado).
201: se creó algo.
400: la solicitud es incorrecta, por ejemplo, porque falta un campo.
404: no hay nada en esa ruta o id.
500: el servidor falló.

Desafío

Fácil

Un programa que lee tu API comprueba primero el código de estado y después el cuerpo. Deja claro el caso de elemento no encontrado en ambos.

En server.js, en la ruta /api/recipes/:id, cambia lo que ocurre cuando no hay ninguna receta con ese id. Mantén el estado 404, pero envía este JSON en lugar del texto: {"error": "No such recipe"}
Un id que no es un número, como abc, tampoco coincide con ninguna receta. Recibe el mismo 404 y el mismo JSON.

Pruébalo: Pulsa Ejecutar y envía /api/recipes/99. Deberías ver el estado 404 y {"error":"No such recipe"}. Envía /api/recipes/abc: el mismo 404 y JSON. Envía /api/recipes/3: estado 200 y la receta Lentil Curry.

Pruébalo tú mismo

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

const app = express();

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

// type('text') envía texto sin formato, por lo que cada título aparece en su propia línea.
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');
});