Asynchrone Routen

Teil des Abschnitts Express-Grundlagen der Node.js-Journey von Coddy. Lektion 21 von 23.

Ein Array ist nach einem Neustart des Servers nicht mehr vorhanden. Eine Datei speichert die Daten dauerhaft.

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

Eine Route kann eine async-Funktion sein, die mit await wartet, hier auf readFile aus node:fs/promises. Express 5 überwacht das Promise, das die Route zurückgibt: Wenn es abgelehnt wird, weil die Datei fehlt oder das JSON fehlerhaft ist, wird der Fehler wie bei einem Wurf an deinen Fehler-Handler weitergegeben.

Ohne await hältst du ein Promise statt der Daten, und res.json(promise) sendet {}. Die neue Datei data/recipes.json enthält die vier Rezepte.

Aufgabe

Einfach

Ein Array im Arbeitsspeicher geht bei jedem Neustart des Servers verloren. Speichere die Rezepte stattdessen in einer Datei: data/recipes.json, die bereits die vier Rezepte enthält.

Importiere in routes/recipes.js readFile und writeFile aus node:fs/promises, und importiere recipes nicht mehr aus ../data.js.
Schreibe eine Hilfsfunktion, loadRecipes(), eine asynchrone Funktion, die data/recipes.json liest und die geparste Liste zurückgibt. In den nächsten Lektionen wird sie unter diesem Namen verwendet.
Mache jede Route in der Datei zu einer async-Funktion und beginne jede mit einem Aufruf von loadRecipes() mit await: /tags, die Liste, ein einzelnes Rezept, die POST-Route und die Skalierungsroute.
Schreibe in der POST-Route, nachdem du das neue Rezept zur Liste hinzugefügt hast, die gesamte Liste mit writeFile als JSON-Text zurück in data/recipes.json.
Die Skalierungsroute wirft weiterhin einen Fehler für ein Rezept ohne Portionen, jetzt innerhalb einer asynchronen Funktion. Express 5 leitet diesen Fehler wie zuvor an deinen Fehler-Handler weiter, sodass weiterhin mit Status 500 und {"error": "Something went wrong"} geantwortet wird. Fange den Fehler nicht in der Route ab.

Probiere es aus: Drücke „Ausführen“ und sende /api/recipes: dieselben vier Rezepte, jetzt aus der Datei gelesen. Wähle POST aus und sende {"title": "Gazpacho", "tags": ["vegan", "soup"]} an /api/recipes: Status 201 und das Rezept mit "id": 5. Sende /api/recipes/5: Gazpacho. Sende /api/recipes/99: Status 404. Sende dann POST {"title": "Toast"}, das keine Portionen hat und zu Rezept 6 wird, und sende /api/recipes/6/scale?by=2: Status 500 und {"error":"Something went wrong"}. Wenn du statt deiner Daten {} siehst, fehlt ein await.

Probier es selbst

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

const router = express.Router();

// Jeder Tag genau einmal, in alphabetischer Reihenfolge.
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;