Per çfarë përdoret Next.js middleware?

Question

Accepted Answer

**Middleware** është kod që ekzekutohet **përpara se të përfundojë një kërkesë** — në Edge, përpara se të renderohet faqja ose route handler. Ju lejon të inspektoni dhe rishkruani/ridirektononi kërkesa, të vendosni header, ose të kontrolloni autentifikimin për shumë rute në një vend.

## Përcaktimi i 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*"] };
```

## Çfarë mund të bëjë 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.
```

Përdorimet e zakonshme: **filtrimi i autentifikimit**, **ridirektojat** (bazuar në vendndodhje/geo, www→apex), **testimi A/B** përmes rishkrimit, vendosja e **header-ave të sigurisë** dhe bot/feature flags.

## Kufizime kyçe

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

Konfigurimi `matcher` është i rëndësishëm: kufizoni middleware vetëm në rruget që e kanë nevojë, kështu që nuk ekzekutohet në asete statike dhe nuk ngadalëson gjithçka.

## Pse është e rëndësishme

Middleware është pika e vetme përqendrimi për logjikën e kërkesave në tërë sistemin — ridirektojat e autentifikimit, rrugëzimi i gjuhës, rishkrimet dhe header — zbatuar në shumë rute pa përsëritur kodin në secilën faqe.

Dija e kufizimeve të tij në Edge (shpejtë, pa API Node, vetëm kontroll të lehta) dhe përcaktimi i fushës `matcher` është ajo që ju lejon ta përdorni atë saktësisht për filtrimin e aksesit dhe shqetësimet e rrugëzimit.