كيف يعمل middleware في Express؟

Question

Accepted Answer

**Middleware** هي دوال تعمل **بالتتابع** خلال دورة request-response في Express. كل منها تستقبل `(req, res, next)` ويمكنها فحص/تعديل الطلب والاستجابة، أو إنهاء الاستجابة، أو استدعاء `next()` لتمرير التحكم إلى middleware التالية. وهي تشكل الأساس في كيفية بناء تطبيقات 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 (والأطر المشابهة) — المصادقة، وتسجيل السجلات، وتحليل النص، و CORS، والتحقق من الصحة، ومعالجة الأخطاء كلها middleware.

فهم العقد `(req, res, next)` (خاصة أنه يجب عليك استدعاء `next()` أو إرسال استجابة)، كيف يمكن لـ middleware أن تقطع السلسلة أو تثري الطلبات، ومعالج الأخطاء ذو الأربعة معاملات، وأن **الترتيب مهم**، ضروري لبناء وهيكلة وتصحيح أي تطبيق Express.