В чём заключается разница между средами выполнения Edge и Node.js?

Question

Accepted Answer

Next.js может выполнять код сервера в двух средах выполнения. **Runtime Node.js** (по умолчанию) — это полная среда Node; **runtime Edge** — это лёгкая среда на базе V8, которая работает в глобально распределённых пограничных локациях, близко к пользователям.

## Выбор среды выполнения

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

Многие популярные библиотеки (включая ORM-системы, которые открывают прямые сокеты БД) не работают на Edge без HTTP-адаптера — частая проблема.

## Почему это важно

Выбор среды выполнения — это серьёзное архитектурное решение: **Edge** для быстрой, глобальной, лёгкой логики (особенно middleware) с минимальным холодным стартом, **Node.js** для полного доступа к API, прямых подключений к БД и тяжёлых операций.

Знание ограничений Edge (только Web API, без прямого TCP, короткое время выполнения) предотвращает частую ошибку размещения кода, зависящего от БД или Node.js, в среде выполнения, которая это не поддерживает.