Ответы JSON

Часть раздела Основы Express путешествия по Node.js на Coddy. Урок 6 из 23.

Программе, которая обращается к вашему серверу, нужны данные, которые она может прочитать, а не предложение.

app.get('/api/weather', (req, res) => {
    res.json({ city: 'Oslo', temp: 4, rain: true });
});

JSON — это текстовый формат для объектов и массивов. res.json(value) преобразует значение в JSON и устанавливает заголовок Content-Type в значение application/json; заголовок — это именованная строка, отправляемая вместе с ответом, и этот заголовок сообщает, какой тип тела ответа следует далее. Клиент получает {"city":"Oslo","temp":4,"rain":true} и считывает temp как число.

Если передать строку в res.send, отправляется text/html, который программе пришлось бы разбирать. Маршруты для программ обычно начинаются с /api, поэтому страницы и данные никогда не используют один и тот же путь.

Задание

Легко

Программам, например приложению на телефоне, нужны данные Recipe Box в формате, который они могут читать. Добавь JSON API рядом со страницами.

В server.js добавь маршрут для /api/recipes. Он отправляет весь массив recipes в формате JSON.
Добавь маршрут для /api/recipes/:id. Он находит рецепт так же, как это делает /recipes/:id, и отправляет весь объект рецепта в формате JSON, а не только его название. Для рецепта 2 это объект с "id": 2, "title": "Pancakes", "tags": ["breakfast", "sweet"] и количеством порций.
Если рецепта с таким идентификатором нет, верни статус 404. Можно отправить текст No such recipe, как это делает страница.

Попробуй: Нажми Run и отправь /api/recipes. Ты должен увидеть список из четырёх рецептов, начиная с Tomato Soup. Отправь /api/recipes/2: объект Pancakes. Отправь /api/recipes/99: статус 404. На вкладке Headers у /api/recipes значение Content-Type — application/json. Затем отправь /about: значение Content-Type — text/html, потому что res.send со строкой отправляет страницу.

Попробуйте сами

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

const app = express();

app.get('/', (req, res) => {
    res.send('Welcome to Recipe Box');
});

// type('text') отправляет обычный текст, поэтому каждое название выводится на отдельной строке.
app.get('/recipes', (req, res) => {
    const { tag } = req.query;
    const list = tag ? recipes.filter((recipe) => recipe.tags.includes(tag)) : recipes;
    res.type('text').send(list.map((recipe) => recipe.title).join('\n'));
});

app.get('/recipes/:id', (req, res) => {
    const recipe = recipes.find((r) => r.id === Number(req.params.id));
    if (!recipe) {
        res.status(404).send('No such recipe');
        return;
    }
    res.send(recipe.title);
});

app.get('/about', (req, res) => {
    res.send('Recipe Box collects family recipes.');
});

app.listen(3000, () => {
    console.log('Recipe Box is running on port 3000');
});