Rotas Assíncronas

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

Um array desaparece quando o servidor reinicia. Um arquivo mantém os dados.

import { readFile } from 'node:fs/promises';

app.get('/api/forecast', async (req, res) => {
    const text = await readFile('data/forecast.json', 'utf8');
    res.json(JSON.parse(text));
});

Uma rota pode ser uma função async que espera com await, aqui por readFile de node:fs/promises. O Express 5 monitora a promessa que a rota retorna: se ela for rejeitada porque o arquivo não existe ou seu JSON está inválido, o erro vai para o seu manipulador de erros, como acontece com uma exceção.

Sem await, você fica com uma promessa em vez dos dados, e res.json(promise) envia {}. O novo data/recipes.json contém as quatro receitas.

Desafio

Fácil

Um array na memória é perdido toda vez que o servidor reinicia. Em vez disso, mantenha as receitas em um arquivo: data/recipes.json, que já contém as quatro receitas.

Em routes/recipes.js, importe readFile e writeFile de node:fs/promises e pare de importar recipes de ../data.js.
Escreva uma função auxiliar, loadRecipes(), uma função assíncrona que lê data/recipes.json e retorna a lista analisada. As próximas lições a usarão com esse nome.
Torne cada rota do arquivo async e comece cada uma aguardando loadRecipes(): /tags, a lista, uma receita, a rota POST e a rota de escala.
Na rota POST, depois de adicionar a nova receita à lista, grave a lista inteira de volta em data/recipes.json com writeFile, como texto JSON.
A rota de escala ainda lança um erro para uma receita sem porções, agora de dentro de uma função assíncrona. O Express 5 passa esse erro ao seu manipulador de erros como antes, então ainda responde com 500 e {"error": "Something went wrong"}. Não capture o erro na rota.

Experimente: Pressione Run e envie /api/recipes: as mesmas quatro receitas, agora lidas do arquivo. Escolha POST e envie {"title": "Gazpacho", "tags": ["vegan", "soup"]} para /api/recipes: status 201 e a receita com "id": 5. Envie /api/recipes/5: Gazpacho. Envie /api/recipes/99: status 404. Em seguida, faça POST de {"title": "Toast"}, que não tem porções e se torna a receita 6, e envie /api/recipes/6/scale?by=2: status 500 e {"error":"Something went wrong"}. Se você vir {} em vez dos seus dados, está faltando um await.

Experimente você mesmo

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

const router = express.Router();

// Cada tag, uma única vez, em ordem alfabética.
router.get('/tags', (req, res) => {
    const tags = new Set(recipes.flatMap((recipe) => recipe.tags));
    res.json([...tags].sort());
});

router.get('/', (req, res) => {
    res.json(recipes);
});

router.get('/: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);
});

router.post('/', (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);
});

router.get('/:id/scale', (req, res) => {
    const recipe = recipes.find((r) => r.id === Number(req.params.id));
    if (!recipe) {
        res.status(404).json({ error: 'No such recipe' });
        return;
    }
    const by = Number(req.query.by);
    if (!Number.isFinite(by) || by <= 0) {
        res.status(400).json({ error: 'Scale by a positive number' });
        return;
    }
    if (!recipe.servings) {
        throw new Error(`Recipe ${recipe.id} has no servings`);
    }
    res.json({ title: recipe.title, servings: recipe.servings * by });
});

export default router;