Next.js middleware کس لیے استعمال ہوتا ہے?

Question

Accepted Answer

**Middleware** کوڈ ہے جو **درخواست مکمل ہونے سے پہلے** چلتا ہے — Edge پر، صفحہ یا روٹ ہینڈلر رینڈر ہونے سے پہلے۔ یہ آپ کو درخواستوں کو دیکھنے اور دوبارہ لکھنے/مختلف پتے پر بھیجنے، ہیڈرز سیٹ کرنے، یا بہت سی روٹس کے لیے auth کو ایک جگہ سے چیک کرنے دیتا ہے۔

## Middleware کو بیان کرنا

```ts
// middleware.ts (at the project root)
import { NextRequest, NextResponse } from "next/server";

export function middleware(req: NextRequest) {
  const token = req.cookies.get("session")?.value;

// protect /dashboard — redirect unauthenticated users to login
  if (req.nextUrl.pathname.startsWith("/dashboard") && !token) {
    return NextResponse.redirect(new URL("/login", req.url));
  }
  return NextResponse.next(); // allow the request to proceed
}

// only run on these paths (performance — don't run on every asset)
export const config = { matcher: ["/dashboard/:path*", "/account/:path*"] };
```

## Middleware کیا کر سکتا ہے

```ts
NextResponse.redirect(url);          // send the user elsewhere (auth gates)
NextResponse.rewrite(url);           // serve different content, URL unchanged (A/B, i18n)
NextResponse.next();                  // continue, optionally with modified headers
// req.geo / req.cookies / req.headers — inspect location, auth, etc.
```

عام استعمال: **authentication gating**، **مختلف پتے پر بھیجنا** (زبان/جغرافیہ پر مبنی، www→apex)، **A/B testing** rewrites کے ذریعے، **security headers** سیٹ کرنا، اور bot/feature flags۔

## اہم پابندیاں

```text
⚠️ Runs on the EDGE runtime → no Node.js APIs (no fs, limited libraries)
⚠️ Must be FAST — it runs before every matched request; heavy work adds latency
⚠️ Can't access the database directly for complex auth — do lightweight checks
   (e.g. verify a JWT/cookie exists); do full auth in the page/handler
```

`matcher` کنفیگریشن اہم ہے: middleware کو صرف ان روٹس تک محدود کریں جنہیں اس کی ضرورت ہے، تاکہ یہ static assets پر نہ چلے اور سب کچھ سست نہ ہو۔

## یہ کیوں اہم ہے

Middleware cross-cutting درخواست کی منطق کے لیے واحد کنٹرول نقطہ ہے — auth مختلف پتے پر بھیجنا، locale routing، rewrites، اور headers — بہت سی روٹس پر لاگو کیا جاتا ہے بغیر ہر صفحہ میں کوڈ کو دہرایا جائے۔

اس کی Edge پابندیوں کو جاننا (تیز، کوئی Node APIs نہیں، صرف ہلکے چیکس) اور `matcher` scoping یہ ہے جو آپ کو gatekeeping اور routing کے خیالات کے لیے اسے درست طریقے سے استعمال کرنے دیتا ہے۔