Navigation

📁 JavaScript

Node.js Express でミドルウェアを自作する方法

📅 7月 8, 2025
👤
⏱ 1 min read

Node.js Express でミドルウェアを自作する方法

概要

Node.jsのExpressフレームワークでは、ミドルウェアが非常に重要な役割を果たします。ミドルウェアを自作することで、リクエストやレスポンスに対するカスタム処理を追加したり、特定のルートに対する認証やセキュリティの強化を行うことができます。この記事では、Node.js Expressでミドルウェアを自作する方法について解説します。

なぜこの技術/手法が重要なのか

ミドルウェアを自作することで、Expressアプリケーションの機能性や柔軟性を向上させることができます。特定の機能を再利用可能な形で実装し、コードの重複を避けることができます。

どんな問題を解決するのか

ミドルウェアを自作することで、アプリケーション全体で共通の処理を実装したり、特定のルートに対する処理を追加することができます。また、ミドルウェアを利用することで、コードの可読性や保守性を向上させることができます。

前提知識や環境要件

  • Node.jsおよびExpressの基本的な知識
  • JavaScript/TypeScriptの理解

サンプルコード


// ログを出力するカスタムミドルウェアの例
const loggerMiddleware = (req, res, next) => {
  console.log(`[${new Date()}] ${req.method} ${req.url}`);
  next();
};

app.use(loggerMiddleware);

解説

上記のサンプルコードでは、リクエストが来た時にログを出力する簡単なカスタムミドルウェアを定義しています。ミドルウェアは、引数としてリクエストオブジェクト(req)、レスポンスオブジェクト(res)、次のミドルウェアを呼び出す関数(next)を受け取ります。ミドルウェア関数内で処理を行った後は必ずnext()を呼び出すことで、次のミドルウェアやルートハンドラに処理を渡します。

重要なポイントや注意点

  • ミドルウェアは順番に適用されるため、定義した順番に注意する必要があります。
  • ミドルウェア内での処理が非同期である場合は、適切にコールバックやPromiseを扱う必要があります。

応用例・バリエーション


// 認証を行うミドルウェアの例
const authMiddleware = (req, res, next) => {
  if (req.headers.authorization === 'secret') {
    next();
  } else {
    res.status(401).send('Unauthorized');
  }
};

app.get('/secure', authMiddleware, (req, res) => {
  res.send('This is a secure route');
});

ベストプラクティス

  • ミドルウェアは1つの機能を持つようにシンプルに保つことで再利用性を高めることが重要です。
  • テストコードを書くことで、ミドルウェアの動作を確認しやすくしましょう。
  • エラーハンドリングを適切に行うことで、アプリケーションの安定性を向上させることができます。

関連技術・参考情報

  • Express ドキュメント: https://expressjs.com/
  • Middleware パターンについて理解する: https://expressjs.com/en/guide/using-middleware.html

—

この記事では、Node.js Expressでミドルウェアを自作する方法について紹介しました。ミドルウェアを活用することで、Expressアプリケーションの柔軟性や機能性を向上させることができます。是非実際に試してみて、自身のアプリケーションに活かしてみてください。

← Back to JavaScript