Mi a különbség az Edge és Node.js runtimeok között?

Question

Accepted Answer

A Next.js szerver kódot két futtatókörnyezetben futtathat. A **Node.js runtime** (alapértelmezett) a teljes Node-környezet; az **Edge runtime** egy könnyű, V8-alapú környezet, amely globálisan elosztott peremhelyek között fut, a felhasználók közelében.

## Runtime kiválasztása

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

## Az átváltások

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

## Mikor használjunk Edge-et

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

Az Edge kiválóan alkalmas **könnyű logikához, amely a felhasználóhoz való közelségből profitál** és az azonnali hideg indításból.

## Mikor használjunk Node.js-t

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

## Egy valós korlátozási példa

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

Sok népszerű könyvtár (beleértve az ORM-eket, amelyek nyitott nyerstől adatbázis-szoftvereket nyitnak meg) nem működik az Edge-en HTTP-alapú adapter nélkül — egy gyakori csapda.

## Miért fontos ez

A futtatókörnyezet kiválasztása valós építészeti döntés: **Edge** a gyors, globális, könnyű logikához (különösen middleware) minimális hideg indítással, **Node.js** a teljes API-hozzáféréshez, közvetlen adatbázis-kapcsolatokhoz és nehéz munkához.

Az Edge-korlátozások ismerete (csak Web API-k, nincs nyers TCP, rövid végrehajtás) megelőzi az adatbázis-nehéz vagy Node-függő kód olyan futtatókörnyezetbe helyezésének gyakori hibáját, amely nem támogatja azt.