Cila është ndryshimi midis Edge dhe Node.js runtime?

Question

Accepted Answer

Next.js mund të ekzekutojë kod serveri në dy runtime-a. **Node.js runtime** (parazgjedhje) është mjedisi i plotë Node; **Edge runtime** është një mjedis i lehtë, i bazuar në V8, që funksionon në vendndodhje globalisht të shpërndara të Edge-it afër përdoruesve.

## Përzgjedhja e runtime-it

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

## Kompromisët

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

## Kur të përdoret 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 nxel për **logjikën e lehtë që përfiton nga qenia afër përdoruesit** dhe nga fillimet e ftohta të menjëhershme.

## Kur të përdoret 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)
```

## Shembull i kufizimit real

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

Shumë biblioteka popullore (përfshirë ORM-të që hapin soketë DB të papërpunuara) nuk funksionojnë në Edge pa një adapter të bazuar në HTTP — një gotcha e zakonshme.

## Pse është e rëndësishme

Përzgjedhja e runtime-it është një vendim i vërtetë arkitektonik: **Edge** për logjikë të shpejtë, globale, të lehtë (veçanërisht middleware) me fillime të ftohta minimale, **Node.js** për qasje të plotë në API, lidhje direkte DB, dhe punë të rënda.

Njohuritë e kufizimeve të Edge-it (vetëm Web API-t, asnjë TCP i papërpunuar, ekzekutim i shkurtër) parandalojnë gabimin e shpeshtë të vendosjes së kodit të rëndë të bazës së të dhënave ose kodit të varur nga Node në një runtime që nuk mund ta mbështesë.