Edge ve Node.js runtime arasındaki fark nedir?

Question

Accepted Answer

Next.js sunucu kodunu iki runtime ortamında çalıştırabiliyor. **Node.js runtime** (varsayılan) tam Node ortamı; **Edge runtime** ise kullanıcıya yakın, küresel olarak dağıtılmış Edge konumlarında çalışan hafif, V8 tabanlı bir ortamdır.

## Runtime seçimi

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

## Değiş tokuşlar

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

## Edge ne zaman kullanılır

```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, **kullanıcıya yakın olmaktan faydalanan hafif mantık** ve anlık soğuk başlangıçlar için mükemmeldir.

## Node.js ne zaman kullanılır

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

## Gerçek bir kısıtlama örneği

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

Birçok popüler kütüphane (ham DB soketlerini açan ORM'ler dahil) HTTP tabanlı bir adaptör olmadan Edge üzerinde çalışmaz — yaygın bir tuzak.

## Neden önemli

Runtime seçimi gerçek bir mimari kararıdır: **Edge** hızlı, küresel, hafif mantık (özellikle middleware) için minimal soğuk başlangıçlarla, **Node.js** tam API erişimi, doğrudan DB bağlantıları ve ağır işler için.

Edge'nin sınırlamalarını bilmek (yalnızca Web API'leri, raw TCP yok, kısa yürütme zamanı) veritabanı ağırlıklı veya Node'a bağımlı kodu bunu destekleyemeyecek bir runtime üzerine yerleştirme hatasını önler.