ما الفرق بين Edge و Node.js runtimes؟

Question

Accepted Answer

يمكن لـ Next.js تشغيل رمز الخادم في بيئتي تشغيل مختلفتين. **Node.js runtime** (الافتراضي) هو بيئة Node الكاملة؛ **Edge runtime** هي بيئة خفيفة الوزن قائمة على V8 وتعمل في مواقع edge موزعة عالميًا بالقرب من المستخدمين.

## اختيار بيئة التشغيل

```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 التي تفتح DB sockets خام) لا تعمل على Edge بدون محول قائم على HTTP - وهذا مشكل شائع.

## لماذا يهم ذلك

اختيار بيئة التشغيل قرار معماري حقيقي: **Edge** للمنطق السريع والعام والخفيف الوزن (خاصة middleware) مع بدايات باردة قليلة، **Node.js** للوصول الكامل إلى API والاتصالات المباشرة بقاعدة البيانات والعمل الثقيل.

معرفة قيود Edge (Web APIs فقط، بدون TCP خام، تنفيذ قصير) يمنع الخطأ الشائع بوضع رمز ثقيل قاعدة البيانات أو رمز يعتمد على Node على بيئة تشغيل لا يمكنها دعمه.