Асинхронные маршруты

Часть раздела Основы 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"}. Не перехватывай ошибку в маршруте.

Попробуй: Нажми «Играть» и отправь /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;