Wat is het verschil tussen de Edge en Node.js runtimes?

Question

Accepted Answer

Next.js kan servercode in twee runtimes uitvoeren. De **Node.js runtime** (standaard) is de volledige Node-omgeving; de **Edge runtime** is een lichtgewicht, V8-gebaseerde omgeving die wordt uitgevoerd op wereldwijd verspreide edge-locaties dicht bij gebruikers.

## Waarom het belangrijk is

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

## De afwegingen

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

## Wanneer Edge gebruiken

```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 blinkt uit voor **lichtgewicht logica die voordeel heeft van dicht bij de gebruiker** en van instant cold starts.

## Wanneer Node.js gebruiken

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

## Een echt beperking voorbeeld

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

Veel populaire bibliotheken (inclusief ORMs die raw DB-sockets openen) werken niet op Edge zonder een HTTP-gebaseerde adapter — een veel voorkomende valkuil.

## Waarom het belangrijk is

Het kiezen van de runtime is een echte architecturale beslissing: **Edge** voor snelle, mondiale, lichtgewicht logica (vooral middleware) met minimale cold starts, **Node.js** voor volledige API-toegang, directe DB-verbindingen en zware werkzaamheden.

Het kennen van Edge's beperkingen (alleen Web APIs, geen raw TCP, korte uitvoering) voorkomt de veel voorkomende fout van het plaatsen van database-zware of Node-afhankelijke code op een runtime die dit niet kan ondersteunen.