初めてのミドルウェア

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

ログに1行書き込むなど、すべてのリクエストで行う処理があります。それを各ルートに書き写していては、きりがありません。すべてのリクエストには、req.method にメソッドがあります。何かを取得するには GET、何かを送信するには POST を使います。

let visits = 0;

app.use((req, res, next) => {
    visits++;
    next();
});

app.use に渡す関数はミドルウェアです。Express は、追加された順に、下にあるルートより前に、すべてのリクエストに対して実行します。ミドルウェアは3つ目の引数 next を受け取ります。next() を呼び出すと、リクエストは次の処理に渡されます。応答もせず、next() も呼び出さないミドルウェアがあると、リクエストは永遠に待ち続けます。

前の章で使った express.static もミドルウェアです。ファイルが見つかると応答し、見つからない場合は next() を呼び出します。

チャレンジ

簡単

サーバーが受け取るすべてのリクエストについてログ行を記録し、訪問者が何を要求しているか確認できるようにします。

server.jsで、const app = express();のすぐ後に、app.useを使ってミドルウェアを追加します。ここに配置すると、すべてのルートより前に実行されます。
リクエストごとに、Consoleに1行出力します。内容は、リクエストのメソッド、スペース、続いてパスです。/recipes/2へのリクエストでは、GET /recipes/2と出力されます。メソッドはreq.method（GET、POSTなど）に、パスはreq.urlに格納されています。
出力した後、next()を呼び出すことで、リクエストはルートへ進みます。

試してみましょう：「実行」を押して、/recipes/2を送信します。Pancakesが表示され、ConsoleにはGET /recipes/2と表示されます。/api/recipesを送信すると、通常どおり一覧が表示され、ConsoleにはGET /api/recipesと表示されます。/nopeを送信すると404が返されますが、ConsoleにはGET /nopeと表示されます。これは、Expressがルートを探す前にミドルウェアが実行されるためです。

自分で試してみよう

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

const app = express();

app.use(express.static('public'));

app.get('/', (req, res) => {
    const items = recipes.map((r) => `<li><a href="/recipes/${r.id}">${escapeHtml(r.title)}</a></li>`);
    res.send(`<link rel="stylesheet" href="/style.css"><h1>Recipe Box</h1><ul>${items.join('')}</ul>`);
});

// 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('/api/recipes', (req, res) => {
    res.json(recipes);
});

app.get('/api/recipes/: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);
});

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

app.get('/menu', (req, res) => {
    res.redirect(301, '/recipes');
});

app.get('/menu/:id', (req, res) => {
    res.redirect(301, `/recipes/${req.params.id}`);
});

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