Express middleware ทำงานอย่างไร?

Question

Accepted Answer

**Middleware** คือฟังก์ชันที่ทำงาน **เรียงตามลำดับ** ในระหว่างวงจร request-response ของ Express แต่ละตัวรับ `(req, res, next)` และสามารถตรวจสอบ/แก้ไข request และ response, จบ response, หรือเรียก `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()`** เพื่อให้สายโซ่ดำเนินต่อ ถ้าลืม (และไม่ได้ส่ง response) request จะค้างตลอดกาล

## ลำดับการทำงาน

```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 สามารถ **short-circuit** (ส่ง response และไม่เรียก `next()` เช่น บล็อก request ที่ไม่มีสิทธิ์) หรือ **เพิ่มข้อมูล** ให้ request (แนบ `req.user` ให้ handler ปลายทาง)

## Error-handling 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
```

Error handler มี **สี่** พารามิเตอร์ (`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 (และเฟรมเวิร์กที่คล้ายกัน) — การยืนยันตัวตน, การ logging, การ parse body, CORS, การ validate และการจัดการ error ล้วนเป็น middleware ทั้งหมด

การเข้าใจสัญญา `(req, res, next)` (โดยเฉพาะว่าต้องเรียก `next()` หรือส่ง response), วิธีที่ middleware สามารถ short-circuit หรือเพิ่มข้อมูลให้ request, error handler แบบสี่อาร์กิวเมนต์ และความจริงที่ว่า **ลำดับมีความสำคัญ** เป็นสิ่งจำเป็นต่อการสร้าง จัดโครงสร้าง และ debug แอป Express ใด ๆ