Quelle est la différence entre les runtimes Edge et Node.js ?

Question

Accepted Answer

Next.js peut exécuter du code serveur dans deux runtimes. Le **runtime Node.js** (par défaut) est l'environnement Node complet ; le **runtime Edge** est un environnement léger basé sur V8 qui s'exécute dans des emplacements edge distribués mondialement, proches des utilisateurs.

## Sélection d'un runtime

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

## Les compromis

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

## Quand utiliser 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 excelle pour une **logique légère qui bénéficie de la proximité avec l'utilisateur** et des démarrages à froid instantanés.

## Quand utiliser 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 exemple de contrainte réelle

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

De nombreuses bibliothèques populaires (y compris les ORMs qui ouvrent des sockets DB brutes) ne fonctionnent pas sur Edge sans un adaptateur basé sur HTTP — un piège courant.

## Pourquoi c'est important

Choisir le runtime est une véritable décision architecturale : **Edge** pour une logique rapide, mondiale et légère (en particulier les middlewares) avec des démarrages à froid minimaux, **Node.js** pour un accès API complet, des connexions DB directes et des tâches lourdes.

Connaître les limitations d'Edge (Web APIs uniquement, pas de TCP brut, exécution courte) prévient l'erreur fréquente de placer du code lourd en base de données ou dépendant de Node sur un runtime qui ne peut pas le supporter.