Navigation

📁 JavaScript

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

📅 7月 8, 2025
👤
⏱ 1 min read

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

概要

Node.js の Express フレームワークでは、ミドルウェアを使用してリクエストとレスポンスの間で処理を追加できます。この記事では、Node.js Express でミドルウェアを自作する方法について解説します。ミドルウェアを自作することで、特定の処理を再利用可能な形で実装し、アプリケーションの機能拡張や共通処理の効率化が可能となります。

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

ミドルウェアを自作することで、アプリケーションの機能を柔軟に拡張できるため、開発効率が向上します。また、共通の処理をミドルウェアとして切り出すことで、コードの再利用性や保守性が向上します。

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

ミドルウェアを自作することで、リクエストやレスポンスに対する特定の処理を共通化し、アプリケーション全体で一貫性のある動作を実現できます。また、ミドルウェアを使用することで、処理の流れを柔軟に制御することが可能です。

前提知識や環境要件

  • Node.js の基本的な知識
  • Express フレームワークの理解
  • ES6+の構文についての理解

サンプルコード


// カスタムミドルウェアの例
const customMiddleware = (req, res, next) => {
  console.log('Custom Middleware');
  next();
};

app.use(customMiddleware);

解説

上記のサンプルコードでは、`customMiddleware` というカスタムミドルウェアを定義しています。このミドルウェアは、リクエストが来た際にコンソールに `Custom Middleware` というメッセージを出力し、次のミドルウェアに処理を委譲する仕組みです。`app.use(customMiddleware)` でミドルウェアを Express アプリケーションに適用しています。

重要なポイントや注意点

  • ミドルウェアは `(req, res, next)` の引数を持つ関数として定義されます。
  • ミドルウェア内で `next()` を呼び出すことで、次のミドルウェアに処理を渡すことができます。
  • ミドルウェアは順番に適用されるため、注意して適切な順序で登録する必要があります。

応用例・バリエーション


// ログ出力ミドルウェアの例
const loggerMiddleware = (req, res, next) => {
  console.log(`${new Date().toISOString()} - ${req.method} ${req.url}`);
  next();
};

app.use(loggerMiddleware);

上記のコードは、リクエストが来た際にリクエストの詳細をログ出力する `loggerMiddleware` の例です。このように、さまざまなミドルウェアを組み合わせることで、アプリケーションの挙動をカスタマイズすることが可能です。

ベストプラクティス

  • ミドルウェアは単一責任の原則に従い、1つの処理に特化させることが望ましいです。
  • コードの再利用を考えて、共通の処理はミドルウェアとして切り出すことで保守性を高めることができます。
  • ミドルウェア内でエラーを適切にハンドリングすることで、アプリケーション全体の安定性を向上させることができます。

関連技術・参考情報

  • [Express ドキュメント](https://expressjs.com/)
  • [Node.js Middleware Guide](https://expressjs.com/en/guide/using-middleware.html)

この記事では、Node.js Express でミドルウェアを自作する方法について紹介しました。ミドルウェアを活用することで、アプリケーションの機能拡張や共通処理の効率化を実現できます。是非、実際の開発で活用してみてください。

← Back to JavaScript