რა განსხვავებაა Edge და Node.js runtime-ებს შორის?

Question

Accepted Answer

Next.js შეიძლება სერვერის კოდი გაუშვას ორ runtime-ში. **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 ბრწყინვალედ მუშაობს **მსუბუქი ლოგიკისთვის, რომელიც სარგებელს იღებს მომხმარებელთან სიახლოვის და მყის cold start-დან**.

## როდის გამოიყენოთ 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
```

ბევრი პოპულარული ბიბლიოთეკა (მათ შორის ORM-ები, რომლებიც ხსნიან raw DB სოკეტებს) Edge-ზე არ მუშაობს HTTP-ზე დაფუძნებული ადაპტორის გარეშე — ეს ხშირი შეცდომაა.

## რატომ არის ეს მნიშვნელოვანი

Runtime-ის არჩევა რეალური არქიტექტურული გადაწყვეტილებაა: **Edge** სწრაფი, გლობალური, მსუბუქი ლოგიკისთვის (განსაკუთრებით middleware) მინიმალური cold start-ებით, **Node.js** სრული API წვდომისთვის, პირდაპირი DB კავშირებისთვის და მძიმე სამუშაოსთვის.

Edge-ის შეზღუდვების ცოდნა (მხოლოდ Web API, არ არის raw TCP, მოკლე შესრულება) თავს აქცევს ხშირ შეცდომას, როდესაც database-heavy ან Node-დამოკიდებული კოდი დადებულია runtime-ზე, რომელიც მას ვერ მხარს დაუჭერს.