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**, **redirects** (locale/geo-आधारित, 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` config महत्वपूर्ण है: middleware को केवल उन routes तक सीमित करें जिन्हें इसकी आवश्यकता है, इसलिए यह static assets पर नहीं चलता और सब कुछ धीमा नहीं करता।

## यह क्यों महत्वपूर्ण है

Middleware cross-cutting request logic के लिए एकल choke point है — auth redirects, locale routing, rewrites, और headers — कई routes पर लागू होता है बिना प्रत्येक page में कोड दोहराए।

इसकी Edge बाधाओं (तेज़, कोई Node APIs नहीं, केवल हल्के checks) और `matcher` scoping को जानना वही है जो आपको gatekeeping और routing चिंताओं के लिए इसे सही तरीके से उपयोग करने देता है।