Apakah perbezaan antara runtime Edge dan Node.js?

Question

Accepted Answer

Next.js boleh menjalankan kod pelayan dalam dua runtime. **Runtime Node.js** (lalai) ialah persekitaran Node penuh; **runtime Edge** ialah persekitaran ringan berbasis V8 yang berjalan di lokasi edge yang diedarkan secara global berhampiran pengguna.

## Memilih runtime

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

## Pertukaran

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

## Bila menggunakan 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 bersinar untuk **logik yang ringan yang menguntungkan daripada dekat dengan pengguna** dan daripada permulaan sejuk serta-merta.

## Bila menggunakan 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)
```

## Contoh kekangan sebenar

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

Banyak perpustakaan popular (termasuk ORM yang membuka soket DB mentah) tidak berfungsi di Edge tanpa adaptor berasaskan HTTP — ini adalah perangkap biasa.

## Mengapa ia penting

Memilih runtime adalah keputusan seni bina yang sebenar: **Edge** untuk logik pantas, global, ringan (terutamanya middleware) dengan permulaan sejuk yang minimum, **Node.js** untuk akses API penuh, sambungan DB terus, dan kerja berat.

Mengetahui batasan Edge (hanya Web API, tiada TCP mentah, pelaksanaan pendek) mencegah kesilapan kerap untuk meletakkan kod berat pangkalan data atau bergantung Node pada runtime yang tidak dapat menyokongnya.