¿Cuál es la diferencia entre los runtimes de Edge y Node.js?

Question

Accepted Answer

Next.js puede ejecutar código del servidor en dos runtimes. El **Node.js runtime** (predeterminado) es el entorno completo de Node; el **Edge runtime** es un entorno ligero basado en V8 que se ejecuta en ubicaciones edge distribuidas globalmente cerca de los usuarios.

## Seleccionar un runtime

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

## Los compensaciones

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

## Cuándo usar 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 brilla en **lógica ligera que se beneficia de estar cerca del usuario** y de inicios en frío instantáneos.

## Cuándo usar 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)
```

## Un ejemplo de restricción 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
```

Muchas bibliotecas populares (incluidos los ORM que abren sockets DB sin procesar) no funcionan en Edge sin un adaptador basado en HTTP - una trampa común.

## Por qué es importante

Elegir el runtime es una decisión arquitectónica real: **Edge** para lógica rápida, global y ligera (especialmente middleware) con inicios en frío mínimos, **Node.js** para acceso completo a API, conexiones directas a bases de datos y trabajo pesado.

Conocer las limitaciones de Edge (solo Web APIs, sin TCP sin procesar, ejecución corta) previene el error frecuente de poner código pesado de base de datos o código dependiente de Node en un runtime que no puede soportarlo.