Next.js middleware चा वापर कशासाठी केला जातो?

Question

Accepted Answer

**Middleware** हा कोड आहे जो **विनंतीच्या पूर्ण होण्यापूर्वी चालतो** — Edge वर, पृष्ठ किंवा मार्ग हॅन्डलर रेंडर होण्यापूर्वी. हे तुम्हाला विनंतीचे निरीक्षण करणे, पुनर्लेखन/पुनर्निर्देशित करणे, हेडर सेट करणे किंवा अनेक मार्गांसाठी एक जागेवर प्रमाणीकरण तपासणे देते.

## Defining 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*"] };
```

## What middleware can do

```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.
```

सामान्य वापर: **प्रमाणीकरण गेटिंग**, **पुनर्निर्देशन** (स्थान/भौगोलिक-आधारित, www→apex), **A/B चाचणी** rewrite द्वारे, **सुरक्षा हेडर** सेट करणे, आणि बॉट/वैशिष्ट्य ध्वज.

## Key constraints

```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 केवळ ज्या मार्गांना त्याची आवश्यकता आहे त्यांच्यापर्यंत मर्यादित करा, जेणेकरून ते स्थिर मालमत्तेवर चालू न होईल आणि सर्वकाही हळू न होईल.

## हे महत्वाचे का आहे

Middleware हा क्रॉस-कटिंग विनंती तर्कशास्त्रासाठी एकच चोक पॉईंट आहे — प्रमाणीकरण पुनर्निर्देशन, स्थान मार्गप्रेषण, पुनर्लेखन, आणि हेडर — प्रत्येक पृष्ठांमध्ये कोड पुनरावृत्ती न करता अनेक मार्गांवर लागू केले.

त्याच्या Edge मर्यादा (वेगवान, Node API नाहीत, केवळ हल्के चेक) आणि `matcher` स्कोपिंग समजणे ही गोष्ट आहे जी तुम्हाला गेटकीपिंग आणि राउटिंग चिंतांसाठी त्याचा योग्य उपयोग करू देते.