Pentru ce este folosit middleware-ul Next.js?

Question

Accepted Answer

**Middleware** este codul care se execută **înainte ca o cerere să fie finalizată** — pe Edge, înainte ca pagina sau handler-ul rutei să fie redat. Vă permite să inspectați și rescrieti/redirecționați cererile, să setați anteturi sau să verificați autenticarea pentru multe rute într-un singur loc.

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

## Ce poate face 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.
```

Utilizări comune: **autentificare**, **redirecționări** (pe bază de limbă/locație geografică, www→apex), **teste A/B** prin rescriieri, setarea **anteturilor de securitate** și steaguri bot/funcții.

## Constrângeri principale

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

Configuația `matcher` este importantă: limitați middleware la doar rutele care o necesită, pentru ca aceasta să nu se execute pe active statice și să nu încetinească totul.

## De ce este important

Middleware este singurul punct de control pentru logica de cereri transversale — redirecționări de autentificare, rutare pe bază de limbă, rescriieri și antete — aplicată pe multe rute fără a repeta codul în fiecare pagină.

Cunoașterea constrângerilor Edge (rapid, fără API-uri Node, doar verificări ușoare) și scoping-ul `matcher` este ceea ce vă permite să o utilizați corect pentru preocupări legate de gatekeeping și rutare.