Hva er forskjellen mellom Edge- og Node.js-runtime?

Question

Accepted Answer

Next.js kan kjøre serverkode i to runtime-miljøer. **Node.js-runtime** (standard) er det fullstendige Node-miljøet; **Edge-runtime** er et lett, V8-basert miljø som kjører på globalt distribuerte edge-lokasjoner nær brukerne.

## Velge runtime

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

## Avveiningene

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

## Når du skal bruke 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 utmerker seg for **lett logikk som drar nytte av å være nær brukeren** og fra øyeblikkelige cold starts.

## Når du skal bruke 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)
```

## Et reelt eksempel på begrensninger

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

Manges populære biblioteker (inkludert ORMer som åpner råe DB-sockets) fungerer ikke på Edge uten en HTTP-basert adapter — en vanlig fallgruve.

## Hvorfor det betyr noe

Å velge runtime er en ekte arkitekturmessig beslutning: **Edge** for rask, global, lett logikk (spesielt middleware) med minimale cold starts, **Node.js** for full API-tilgang, direkte DB-tilkoblinger og tungt arbeid.

Å kjenne Edge's begrensninger (kun Web APIs, ingen råe TCP, kort kjøring) forhindrer den vanlige feilen med å plassere databasetung eller Node-avhengig kode på en runtime som ikke kan støtte det.