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**, **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` कन्फिगरेसन महत्त्वपूर्ण छ: middleware लाई केवल त्यन सञ्चालनहरूमा सीमित गर्नुहोस् जसलाई यसको आवश्यकता छ, ताकि यो static assets मा चल्न र सबै कुरा सुस्त पारन।

## यो किन महत्त्वपूर्ण छ

Middleware क्रस-कटिङ अनुरोध तर्कको लागि एकल choke point हो — auth redirects, locale routing, rewrites, र headers — धेरै मार्गहरूमा लागू गरिएको, प्रत्येक पृष्ठमा कोड दोहोर्याउन बिना।

यसको Edge बाधाहरू (छिटो, कुनै Node APIs छैनन्, केवल हल्का जाँचहरू) र `matcher` scoping को ज्ञान यो हो जसले तपाईंलाई गेटकीपिङ र रुटिङ चिन्ताहरूका लागि यो सही तरिकाले प्रयोग गर्न दिन्छ।