Rute Asinkron

Termasuk bagian Dasar-Dasar Express dalam perjalanan Node.js di Coddy. Pelajaran 21 dari 23.

array akan hilang saat server dimulai ulang. file menyimpan datanya.

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

Rute dapat berupa fungsi async yang menunggu dengan await, dalam contoh ini menunggu readFile dari node:fs/promises. Express 5 memantau promise yang dikembalikan rute: jika promise itu ditolak karena file tidak ditemukan atau JSON-nya rusak, error akan diteruskan ke penangan error-mu, seperti saat terjadi throw.

Tanpa await, kamu memegang promise alih-alih datanya, dan res.json(promise) mengirim {}. data/recipes.json yang baru menyimpan keempat resep tersebut.

Tantangan

Mudah

array di dalam memori hilang setiap kali server dimulai ulang. Simpan resep dalam file sebagai gantinya: data/recipes.json, yang sudah berisi empat resep.

Di routes/recipes.js, impor readFile dan writeFile dari node:fs/promises, lalu berhenti mengimpor recipes dari ../data.js.
Tulis satu fungsi pembantu, loadRecipes(), sebuah fungsi async yang membaca data/recipes.json dan mengembalikan list yang sudah diuraikan. Pelajaran berikutnya menggunakannya dengan nama itu.
Jadikan setiap rute dalam file tersebut async, lalu mulai setiap rute dengan menunggu loadRecipes(): /tags, list, satu resep, rute POST, dan rute scale.
Di rute POST, setelah menambahkan resep baru ke list, tulis seluruh list kembali ke data/recipes.json dengan writeFile, sebagai teks JSON.
Rute scale tetap melempar error untuk resep tanpa servings, sekarang dari dalam fungsi async. Express 5 meneruskan error tersebut ke penangan error seperti sebelumnya, sehingga tetap merespons dengan 500 dan {"error": "Something went wrong"}. Jangan tangkap error itu di rute.

Coba: Tekan Jalankan dan kirim /api/recipes: empat resep yang sama, sekarang dibaca dari file. Pilih POST dan kirim {"title": "Gazpacho", "tags": ["vegan", "soup"]} ke /api/recipes: status 201 dan resep dengan "id": 5. Kirim /api/recipes/5: Gazpacho. Kirim /api/recipes/99: status 404. Lalu, kirim POST {"title": "Toast"}, yang tidak memiliki servings dan menjadi resep 6, lalu kirim /api/recipes/6/scale?by=2: status 500 dan {"error":"Something went wrong"}. Jika kamu melihat {} alih-alih datamu, ada await yang belum ditambahkan.

Coba sendiri

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

const router = express.Router();

// Setiap tag, satu kali, dalam urutan alfabet.
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;