Ni nini tofauti kati ya Edge na Node.js runtime?

Question

Accepted Answer

Next.js inaweza kueneza msimbo wa seva katika runtime mbili. **Node.js runtime** (chaguo-msingi) ni mazingira kamili ya Node; **Edge runtime** ni mazingira nyepesi, yanayotumia V8, inayotumika katika maeneo ya Edge yanayosambazwa ulimwenguni karibu na watumiaji.

## Kuchagua runtime

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

## Maamuzi ya biashara

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

## Wakati wa kutumia 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 inastahili kwa **mantiki nyepesi ambayo inanufaika kutokewa karibu na mtumiaji** na kutokana na uanzishaji baridi wa haraka.

## Wakati wa kutumia 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)
```

## Mfano wa kikomo halisi

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

Maktaba nyingi maarufu (kama vile ORM-i ambayo hufungua sockets za DB safi) hazifanyi kazi kwenye Edge bila adapter inayotumia HTTP — ayuba inayojulikana.

## Kwa nini ni muhimu

Kuchagua runtime ni uamuzi halisi wa usanifu: **Edge** kwa mantiki ya haraka, ya ulimwengu, nyepesi (haswa middleware) na uanzishaji baridi wa chini, **Node.js** kwa ufahamu kamili wa API, miunganisho ya moja kwa moja ya DB, na kazi nzito.

Kujua vikomo vya Edge (API za Wavuti tu, hakuna TCP safi, utekelezaji fupi) hukamatia hitilafu inayojulikana ya kuweka msimbo unaokamatia benki la data au msimbo unaotegemeana na Node kwenye runtime ambayo haiwezi kuuunga mkono.