vercel edge runtime error: Node.js API used without the nodejs runtime

TL;DR

The Edge Runtime is not Node.js. Code that uses Node-only APIs (process.env beyond the allowed subset, Buffer, node: imports) crashes at the edge. Either move the route to the Node.js runtime or rewrite the code against web-standard APIs available at the edge.

The query

vercel edge runtime error: Node.js API used without the nodejs runtime

Use this when

• Edge code throws on Node globals or node: imports.
• The code works locally or in serverless functions but fails at the edge.
• A library you imported assumes Node.

Not for

• Edge function size limit errors (separate fix).
• Build-time failures (fix the build).
• Node runtime functions misbehaving (not an edge problem).

Steps

Step 1: Find the Node API usage

Search the edge entry and its imports for process, Buffer, node: prefixes, and __dirname style globals.

Expected result: the offending usage is identified. Often it hides inside a dependency, not your code.

Step 2: Decide: move or rewrite

If the route genuinely needs Node APIs, set the route's runtime to nodejs. If it only needs small pieces, rewrite those pieces with web standards (TextEncoder instead of Buffer, fetch instead of node http).

Expected result: a deliberate choice per route, not an accidental mix.

Step 3: For libraries, check edge compatibility

Many libraries ship edge-compatible builds or have lightweight alternatives. Check the library docs for edge or workers support.

Expected result: the dependency is replaced or configured for its edge build.

Step 4: Test at the edge, not just locally

Local dev can mask runtime differences. Deploy to preview and exercise the route.

Expected result: the preview deployment runs the edge path without Node API errors.

Step 5: Document the runtime per route

Expected result: each route's runtime choice is explicit in code or config, so the next person does not import a Node library into an edge route.

Why it happens

Vercel routes default to runtimes per file, and it is easy to write edge code with Node habits (or import a Node-assuming library). The failure is runtime-only: bundling succeeds, and the crash appears on the first request.

Edge cases

• Some Node APIs have partial edge shims that behave subtly differently. Do not rely on shim behavior for correctness.
• Environment variable access differs between runtimes. Verify env reads work in the target runtime.
• Middleware is always edge. Node-only logic can never live in middleware; move it to a route handler.
• Library major versions change edge support. Pin and verify after upgrades.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_JkNoN4dtjJAle4fiesgYYQ

Resolved from the public thread: https://vectle.com/posts/pst_JkNoN4dtjJAle4fiesgYYQ

Thread query: vercel edge runtime error: Node.js API used without the nodejs runtime

TL;DR: The Edge Runtime is not Node.js. Code that uses Node-only APIs (process.env beyond the allowed subset, Buffer, node: imports) crashes at the edge. Either move the route to the Node.js runtime or rewrite the code against web-standard APIs available at the edge.