Trasy asynchroniczne

Część sekcji Podstawy Express ścieżki Node.js w Coddy. Lekcja 21 z 23.

Tablica znika po ponownym uruchomieniu serwera. Plik zachowuje dane.

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

Trasa może być funkcją async, która czeka za pomocą await, w tym przypadku na readFile z node:fs/promises. Express 5 obserwuje obietnicę zwracaną przez trasę: jeśli zostanie odrzucona, ponieważ brakuje pliku albo jego JSON jest nieprawidłowy, błąd trafia do procedury obsługi błędów, tak jak przy rzuceniu wyjątku.

Bez await masz obietnicę zamiast danych, a res.json(promise) wysyła {}. Nowy plik data/recipes.json zawiera cztery przepisy.

Wyzwanie

Łatwy

Tablica przechowywana w pamięci znika za każdym razem, gdy serwer zostaje ponownie uruchomiony. Zamiast tego przechowuj przepisy w pliku data/recipes.json, w którym znajdują się już cztery przepisy.

W pliku routes/recipes.js zaimportuj readFile i writeFile z node:fs/promises i przestań importować recipes z ../data.js.
Napisz jedną funkcję pomocniczą, loadRecipes() — funkcję asynchroniczną, która odczytuje data/recipes.json i zwraca sparsowaną listę. W kolejnych lekcjach będzie używana pod tą nazwą.
Spraw, by każda trasa w pliku była async, i zacznij każdą z nich od wywołania loadRecipes() z await: /tags, listę, pojedynczy przepis, trasę POST oraz trasę skalowania.
W trasie POST, po dodaniu nowego przepisu do listy, zapisz całą listę z powrotem do data/recipes.json za pomocą writeFile, jako tekst JSON.
Trasa skalowania nadal zgłasza błąd dla przepisu bez liczby porcji, teraz z wnętrza funkcji asynchronicznej. Express 5, tak jak wcześniej, przekazuje ten błąd do procedury obsługi błędów, więc nadal zwraca odpowiedź ze statusem 500 i treścią {"error": "Something went wrong"}. Nie przechwytuj tego błędu w trasie.

Wypróbuj: Naciśnij „Uruchom” i wyślij żądanie do /api/recipes: te same cztery przepisy, teraz odczytane z pliku. Wybierz POST i wyślij {"title": "Gazpacho", "tags": ["vegan", "soup"]} do /api/recipes: status 201 i przepis z "id": 5. Wyślij żądanie do /api/recipes/5: Gazpacho. Wyślij żądanie do /api/recipes/99: status 404. Następnie wyślij POST {"title": "Toast"}; ten przepis nie ma liczby porcji i zostaje przepisem 6. Wyślij żądanie do /api/recipes/6/scale?by=2: status 500 i treść {"error":"Something went wrong"}. Jeśli zamiast danych widzisz {}, brakuje await.

Spróbuj swoich sił

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

const router = express.Router();

// Każdy tag, tylko raz, w kolejności alfabetycznej.
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;