Apa perbedaan antara runtimes Edge dan Node.js?

Question

Accepted Answer

Next.js dapat menjalankan kode server di dua runtime. **Runtime Node.js** (default) adalah lingkungan Node lengkap; **runtime Edge** adalah lingkungan ringan berbasis V8 yang berjalan di lokasi edge yang didistribusikan secara global dekat dengan 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)
```

## Kapan 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 **logika ringan yang mendapat manfaat dari berada dekat dengan pengguna** dan dari cold start instan.

## Kapan 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 batasan nyata

```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 populer (termasuk ORM yang membuka soket DB mentah) tidak berfungsi pada Edge tanpa adaptor berbasis HTTP — jebakan yang umum.

## Mengapa ini penting

Memilih runtime adalah keputusan arsitektur yang sebenarnya: **Edge** untuk logika cepat, global, ringan (terutama middleware) dengan cold start minimal, **Node.js** untuk akses API penuh, koneksi DB langsung, dan pekerjaan berat.

Mengetahui keterbatasan Edge (hanya Web API, tidak ada TCP mentah, eksekusi singkat) mencegah kesalahan umum menempatkan kode yang berat database atau bergantung pada Node pada runtime yang tidak dapat mendukungnya.