Express-এ middleware কীভাবে কাজ করে?

Question

Accepted Answer

**Middleware** এমন ফাংশন যা Express-এ request-response চক্রের সময় **ক্রমানুসারে** চলে। প্রতিটি `(req, res, next)` পায় এবং অনুরোধ এবং প্রতিক্রিয়া পরিদর্শন/সংশোধন করতে পারে, প্রতিক্রিয়া শেষ করতে পারে, বা পরবর্তী middleware-এ নিয়ন্ত্রণ পাস করতে `next()` কল করতে পারে। এগুলি Express অ্যাপ্লিকেশন কীভাবে কাঠামোবদ্ধ করা হয় তার মূল।

## স্বাক্ষর এবং শৃঙ্খল

```js
app.use((req, res, next) => {
  console.log(`${req.method} ${req.url}`); // do something
  next();                                   // ⬅ pass control to the next middleware
});
```

সমালোচনামূলক নিয়ম: **`next()`** কল করুন শৃঙ্খল অব্যাহত রাখতে। যদি আপনি এটি ভুলে যান (এবং প্রতিক্রিয়া পাঠান না), তাহলে অনুরোধ চিরকাল ঝুলে থাকবে।

## প্রবাহ

```text
Request → [logger] → [auth] → [body parser] → [route handler] → Response
            next()    next()     next()         res.send()
Each middleware runs in order; any can short-circuit by sending a response.
```

## সাধারণ middleware প্রকার

```js
// 1. Application-level — runs for all (or path-matched) requests
app.use(express.json());                       // built-in: parse JSON bodies
app.use(cors());                                // third-party

// 2. Custom — e.g. authentication that can SHORT-CIRCUIT
function requireAuth(req, res, next) {
  if (!req.headers.authorization) {
    return res.status(401).json({ error: "Unauthorized" }); // STOP — don't call next()
  }
  req.user = decodeToken(req.headers.authorization);  // attach data for later handlers
  next();                                              // authorized → continue
}

// 3. Route-specific
app.get("/profile", requireAuth, (req, res) => res.json(req.user));
```

Middleware **শর্ট-সার্কিট** করতে পারে (প্রতিক্রিয়া পাঠান এবং `next()` কল করবেন না, যেমন অননুমোদিত অনুরোধ ব্লক করা) অথবা অনুরোধ **সমৃদ্ধ** করতে পারে (ডাউনস্ট্রিম হ্যান্ডলারদের জন্য `req.user` সংযুক্ত করা)।

## ত্রুটি-পরিচালনা middleware (চার আর্গুমেন্ট)

```js
// special signature with 4 params → Express treats it as an error handler
app.use((err, req, res, next) => {
  console.error(err);
  res.status(500).json({ error: "Server error" });
});
// triggered by next(err) or a thrown error; place it LAST
```

ত্রুটি হ্যান্ডলারের **চার** পরামিতি রয়েছে (`err` প্রথম)। আপনি `next(err)` কল করে এটিতে পৌঁছান; এটি শেষে নিবন্ধন করা উচিত।

## অর্ডার গুরুত্বপূর্ণ

```text
Middleware runs in the ORDER you register it. Body parser before routes that
read the body; auth before protected routes; error handler last.
```

## কেন এটি গুরুত্বপূর্ণ

Middleware হল Express (এবং অনুরূপ ফ্রেমওয়ার্ক) এর স্থাপত্য মেরুদণ্ড — প্রমাণীকরণ, লগিং, body parsing, CORS, যাচাইকরণ এবং ত্রুটি পরিচালনা সবই middleware।

`(req, res, next)` চুক্তি বোঝা (বিশেষত যে আপনি অবশ্যই `next()` কল করুন অথবা প্রতিক্রিয়া পাঠান), middleware কীভাবে শর্ট-সার্কিট বা অনুরোধ সমৃদ্ধ করতে পারে, চার-আর্গুমেন্ট ত্রুটি হ্যান্ডলার, এবং যে **অর্ডার গুরুত্বপূর্ণ**, যেকোনো Express অ্যাপ্লিকেশন তৈরি, কাঠামো এবং ডিবাগিংয়ের জন্য অপরিহার্য।