クエリ文字列

CoddyのNode.jsジャーニー「Expressの基礎」セクションの一部。レッスン 5/23。

一覧ページでは、表示するレシピなどのオプションが必要になることがよくありますが、オプションごとに新しいルートを作るのは多すぎます。

app.get('/books', (req, res) => {
    const { author } = req.query;
    res.send(author ? 'Books by ' + author : 'All books');
});

クエリ文字列はURLの?以降の部分で、Expressはこれをオブジェクトであるreq.queryに格納します。const { author } = req.queryはconst author = req.query.authorを短く書いたものです。GET /books?author=Austenの場合、req.query.author === 'Austen'になります。?がない場合はundefinedです。複数のオプションは&でつなぎます。例：/books?author=Austen&year=1813。

ルートパラメーターはパスの一部で、1つのものを指定します。クエリオプションは一覧を絞り込んだり並べ替えたりするためのもので、省略できます。

チャレンジ

簡単

訪問者は、タグごとに新しいページを作らなくても、ビーガンのレシピだけ、または夕食のレシピだけを見たいと思っています。

server.jsで、/recipesルートを変更します。クエリー文字列からtagオプションを読み取ります。data.jsの各レシピには、['vegan', 'soup']のようなtagsリストがあります。
タグが指定されている場合は、tagsにそのタグが含まれるレシピのタイトルだけを、現在のルートと同じように1行に1タイトルずつ送信します。
タグが指定されていない場合は、以前と同じようにすべてのタイトルを送信します。
そのタグを持つレシピがない場合は、ステータス200で空のレスポンスを送信します。

試してみましょう:「実行」を押して、/recipes?tag=veganを送信します。2行でTomato SoupとLentil Curryが表示されるはずです。/recipes?tag=dinnerを送信すると、Lentil CurryとFish & Chipsが表示されます。/recipes?tag=dessertを送信すると、そのタグを持つレシピがないため、空のレスポンスになります。/recipesを送信すると、4つすべてのタイトルが表示されます。

自分で試してみよう

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) => {
    res.type('text').send(recipes.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');
});