はじめに

Expressを学び始めて、エラーハンドラの扱い方にいくつかのパターンがあるため、実装方法を整理。
本記事では、第2弾としてExpressにおける、エラーハンドラを利用したミドルウェアのバリデーションをまとめる。

Expressのエラー処理まとめ　【第1弾】Expressのエラーハンミドラの定義
Expressのエラー処理まとめ　【第2弾】バリデーションのミドルウェア（本記事）
Expressのエラー処理まとめ　【第3弾】非同期関数のエラーハンドラ

1.ルートハンドラでバリデーションの定義

ルートハンドラでミドルウェアを複数列挙することで、リクエストを受けてからレスポンスまでに行いたいバリデーションを複数定義することができる。
その列挙されたミドルウェアの中で、バリデーションエラーが発覚した場合、エラーを発生させてバリーデーションエラーを実装することができる。

// ルートハンドラ
app.get('/login', verifyLoginid, verifyPassword, (req, res) => {
    res.send('ログインしました。')
});

上記の場合、「/login」にリクエストがあった場合に、レスポンスを返すまでにの以下の流れで処理される。

verifyLoginid：ログインIDのバリデーションを実施
verifyPassword：ログインパスワードのバリデーションを実施
レスポンスのコールバック関数

バリーデションミドルウェア関数の中身

バリデーションのミドルウェアでは正常の場合はnext()で次の関数へ進み、入力エラーが発見された場合は、エラーハンドラーを利用してレスポンスを返す形が基本形。
「verifyLoginid」と「verifyPassword」中身を確認する。

// Idのバリデーション
const verifyLoginid = (req, res, next) => {
    const { id } = req.query;
    if (id === 'hoge') {
        return next(); //次のミドルウェアへ
    } else {
        // エラーハンドラへ
        throw new AppError('ログインIDが誤っています', 401);
    }
}

// Passwordのバリデーション
const verifyPassword = (req, res, next) => {
    const { password } = req.query;
    if (password === 'moge') {
        return next(); //次のミドウェア（コールバック関数）へ
    } else {
        // エラーハンドラへ
        throw new AppError('パワードが誤っています', 401);
    }
}

// ルートハンドラ
app.get('/login', verifyLoginid, verifyPassword, (req, res) => {
    res.send('ログインしました。')
});

処理の結果として、idもしくは、パスワードが誤っている場合はエラーになり、エラーハンドラーにキャッチされていることがことが分かる。

idとパスワードの両方とも正しい場合に、ルートハンドラのレスポンスコールバック関数が処理され、ログインができていることが分かる。

まとめ

ルートハンドラでバリデーションミドルウェアを実装すると、ＯＫの時は次の処理（ミドルウェアもしくはレスポンスのコールバック関数）へ移り、NGの場合はエラーハンドラへエラーを飛ばすことで入力チェックを実装することができる。app.useのミドルウェア関数と使い方は異なるが、ルートハンドラに組み込まれる関数とエラーハンドラを利用することでバリデーションを実装できることが分かった。
エラー処理のまとめ第3弾へ続く。