Edge اور Node.js runtimes کے درمیان کیا فرق ہے؟

Question

Accepted Answer

Next.js سرور کوڈ کو دو runtimes میں چلا سکتا ہے۔ **Node.js runtime** (ڈیفالٹ) مکمل Node ماحول ہے؛ **Edge runtime** ایک سبک وزن، V8-پر مبنی ماحول ہے جو صارفین کے قریب عالمی سطح پر تقسیم شدہ edge مقامات پر چلتا ہے۔

## Runtime کو منتخب کرنا

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

## ٹریڈ آفس

```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 کب استعمال کریں

```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 **ہلکے منطق کے لیے بہترین ہے جو صارف کے قریب ہونے سے فائدہ اٹھاتا ہے** اور فوری سرد شروعات سے۔

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

## ایک حقیقی رکاوٹ کی مثال

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

بہت سی مشہور لائبریریں (بشمول ORMs جو خام ڈیٹا بیس sockets کھولتے ہیں) Edge پر HTTP-پر مبنی adapter کے بغیر کام نہیں کرتیں — ایک عام نقصان۔

## یہ اہم کیوں ہے

Runtime کا انتخاب ایک حقیقی معماری فیصلہ ہے: تیز، عالمی، ہلکے منطق کے لیے **Edge** (خاص طور پر middleware) کم سرد شروعات کے ساتھ، مکمل API رسائی، براہ راست ڈیٹا بیس کنکشن، اور بھاری کام کے لیے **Node.js**۔

Edge کی حدود (صرف Web APIs، خام TCP نہیں، مختصر عمل) کو جاننا ڈیٹا بیس سے بھرپور یا Node-منحصر کوڈ کو ایک runtime پر ڈالنے کی بار بار غلطی سے بچاتا ہے جو اس کی حمایت نہیں کر سکتا۔