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

Question

Accepted Answer

**Middleware** وہ کوڈ ہے جو **کسی درخواست مکمل ہونے سے پہلے چلتا ہے** — Edge پر، صفحہ یا route handler رینڈر ہونے سے پہلے۔ یہ آپ کو درخواستوں کو معائنہ اور دوبارہ لکھنے/ری ڈائریکٹ کرنے، headers سیٹ کرنے، یا ایک جگہ سے بہت سی routes کے لیے 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**، **ری ڈائریکٹس** (locale/geo-based، www→apex)، rewrites کے ذریعے **A/B testing**، **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 کو صرف انہی routes تک محدود کریں جنہیں اس کی ضرورت ہے، تاکہ یہ static assets پر نہ چلے اور سب کچھ سست نہ ہو۔

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

Middleware cross-cutting request logic کے لیے واحد choke point ہے — auth redirects، locale routing، rewrites، اور headers — بہت سی routes پر لاگو کیا جاتا ہے بغیر ہر صفحہ میں کوڈ دہرایا جائے۔

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