Care este diferența dintre runtime-urile Edge și Node.js?

Question

Accepted Answer

Next.js poate executa cod server în două runtime-uri. **Runtime-ul Node.js** (implicit) este mediul Node complet; **runtime-ul Edge** este un mediu ușor, bazat pe V8, care rulează în locații edge distribuite la nivel global, aproape de utilizatori.

## Selectarea unui runtime

```ts
// per route handler / page
export const runtime = "edge";   // or "nodejs" (the default)
```

## Compromisurile

```text
                  Node.js runtime         Edge runtime
────────────────────────────────────────────────────────────────
APIs              full Node (fs, crypto,  Web APIs only (fetch,
                  Buffer, native modules) Request/Response) — limited
npm packages      all                     only those without Node APIs
Cold start        slower, heavier         near-zero, lightweight
Location          regional (one region)   global (near the user)
Latency to user   higher if far away      very low (geo-distributed)
Execution limits  longer, more memory     short CPU time, less memory
Database          direct TCP connections  HTTP-based DBs only (no raw TCP)
```

## Când să folosiți Edge

```text
✓ Middleware (auth checks, redirects, geo-routing) — must be fast & global
✓ Simple, latency-sensitive endpoints (personalization, A/B, feature flags)
✓ Reading geolocation/headers to tailor responses
```

Edge strălucește pentru **logica ușoară care beneficiază de a fi aproape de utilizator** și de porniri reci instantanee.

## Când să folosiți Node.js

```text
✓ Direct database connections (Prisma over TCP, etc.)
✓ Heavy computation, large dependencies, native modules
✓ Anything using Node-specific APIs (fs, crypto.randomBytes via Node, Buffer)
```

## Un exemplu real de constrângere

```ts
export const runtime = "edge";
import fs from "fs";           // ❌ not available on Edge — build/runtime error
import { PrismaClient } from "@prisma/client"; // ⚠️ needs HTTP/data-proxy on Edge
```

Multe biblioteci populare (inclusiv ORM-uri care deschid socketi BD brute) nu funcționează pe Edge fără un adaptor bazat pe HTTP — o capcană frecventă.

## De ce este important

Alegerea runtime-ului este o decizie arhitecturală reală: **Edge** pentru logică rapidă, globală, ușoară (în special middleware) cu porniri reci minime, **Node.js** pentru acces complet la API, conexiuni directe la BD și lucru greu.

Cunoașterea limitărilor Edge-ului (doar Web API-uri, fără TCP brut, execuție scurtă) previne greșeala frecventă de a plasa cod greu în baze de date sau dependent de Node pe un runtime care nu îl poate suporta.