Kuo skiriasi Edge ir Node.js runtime?

Question

Accepted Answer

Next.js gali paleisti serverio kodą dviem runtime aplinkose. **Node.js runtime** (numatytoji) yra pilna Node aplinka; **Edge runtime** yra lengva, V8 paremta aplinka, kuri veikia globaliai paskirstytose šalyje prie vartotojų.

## Runtime pasirinkimas

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

## Kompromisai

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

## Kada naudoti 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 puikiai tinka **lengviems logikams, kurie gauna naudą iš artumo prie vartotojo** ir iš momentinio šaltojo startu.

## Kada naudoti 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)
```

## Realinis apribojimo pavyzdys

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

Daug populiarių bibliotekų (įskaitant ORM, kurie atidaro žiupsnius DB lizdus) negali veikti Edge be HTTP paremto adapteryje — tai bendra klaidą.

## Kodėl tai svarbu

Runtime pasirinkimas yra tikra architektūrinė sprendimas: **Edge** greito, globalaus, lengvo logiko (ypač middleware) su minimaliomis šaltom startais, **Node.js** pilnom API prieigom, tiesioginėm DB jungtimis ir sunkiomis užduotimis.

Supratimas apie Edge apribojimų (tik Web API, nėra žiupsno TCP, trumpi vykdymai) nuo daž paskutinis šešėlis padėti įdėti duomenų bazės apkrovas arba Node-priklausomus kodų į runtime, kuris negali to palaikyti.