נתיבים אסינכרוניים

חלק מהיחידה יסודות Express במסלול ה-Node.js של Coddy. שיעור 21 מתוך 23.

מערך נעלם כשהשרת מופעל מחדש. קובץ שומר את הנתונים.

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

נתיב יכול להיות פונקציית async שממתינה בעזרת await, במקרה הזה ל־readFile מתוך node:fs/promises. Express 5 עוקב אחר ההבטחה שהנתיב מחזיר: אם היא נדחית, משום שהקובץ חסר או שה־JSON שלו פגום, השגיאה מועברת למטפל השגיאות שלך, כמו במקרה של זריקת שגיאה.

בלי await נשארת בידיך הבטחה במקום הנתונים, ו־res.json(promise) שולח {}. הקובץ החדש data/recipes.json מכיל את ארבעת המתכונים.

אתגר

קל

מערך שנמצא בזיכרון אובד בכל פעם שהשרת מופעל מחדש. שמרו את המתכונים בקובץ במקום זאת: data/recipes.json, שכבר מכיל את ארבעת המתכונים.

ב־routes/recipes.js, ייבאו את readFile ואת writeFile מתוך node:fs/promises, והפסיקו לייבא את recipes מתוך ../data.js.
כתבו פונקציית עזר אחת, loadRecipes(), פונקציה אסינכרונית שקוראת את data/recipes.json ומחזירה את הרשימה שפוענחה. השיעורים הבאים משתמשים בה בשם הזה.
הפכו כל נתיב בקובץ ל־async, והתחילו כל אחד מהם בהמתנה ל־loadRecipes(): /tags, הרשימה, מתכון יחיד, נתיב ה־POST ונתיב שינוי הכמויות.
בנתיב ה־POST, לאחר הוספת המתכון החדש לרשימה, כתבו את הרשימה כולה בחזרה אל data/recipes.json בעזרת writeFile, כטקסט JSON.
נתיב שינוי הכמויות עדיין זורק שגיאה עבור מתכון ללא מנות, עכשיו מתוך פונקציה אסינכרונית. Express 5 מעביר את השגיאה הזאת למטפל השגיאות שלכם כבעבר, כך שהוא עדיין מחזיר 500 ואת {"error": "Something went wrong"}. אל תתפסו את השגיאה בנתיב.

נסו זאת: לחצו על Run ושלחו /api/recipes: אותם ארבעה מתכונים, שנקראים כעת מהקובץ. בחרו POST ושלחו {"title": "Gazpacho", "tags": ["vegan", "soup"]} אל /api/recipes: סטטוס 201 והמתכון עם "id": 5. שלחו /api/recipes/5: Gazpacho. שלחו /api/recipes/99: סטטוס 404. לאחר מכן שלחו POST עם {"title": "Toast"}, שאין בו מספר מנות והוא הופך למתכון 6, ושלחו /api/recipes/6/scale?by=2: סטטוס 500 ו־{"error":"Something went wrong"}. אם אתם רואים {} במקום הנתונים שלכם, חסר await.

נסו בעצמכם

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

const router = express.Router();

// כל תג, פעם אחת, לפי סדר אלפביתי.
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;