Edge API Routes on Next.js

Having a switchable Next.js runtime has been in the works for a while and it's finally here to test it out! The API is simple and the performance improvements are great 🚀.

Set Edge Runtime For an API Route

To set the Edge Runtime on a per-file basis, you need to add a named export called config with the runtime: 'experimental-edge' option:

export const config = {
  runtime: 'experimental-edge',

export default function handler(req) {
  return new Response('Hi from the edge!')

Note: This feature is still experimental, that's why it's called experimental-edge. It it will probably change it's name in the future.


Workers support many of the standard APIs available in modern browsers. Node.js APIs are not supported, which means that you won't have access to Node.js classes and methods that are used to. This in turn means that some libraries don't work on workers as they are in this moment (a lot of libraries have been updated to be run on the edge).

The edge runtime support standard web APIs and doesn't support native Node.js APIs. This means that we need to be aware of the constraints of this environment. Don't worry, you'll rarely find issues writing your API routes!

The constraints mentioned above also means that some libraries may not work on the edge out of the box. This is something that library authors need to fix when possible. I won't worry that much about this since a lot of libraries are migrating to using stardard APIs to support edge environments like Vercel Edge Functions and Cloudflare Workers.

Formatting Responses

To format responses we need to use standard ways to do so. For example, to format a JSON response, we could use JSON.stringify:

export default async function handler(req) {
  const data = { name: 'Giovanni Benussi' }

  return new Response(
    JSON.stringify(data, null, 2),
      headers: {
        'content-type': 'application/json;charset=UTF-8',

Retrieve Current Runtime

You can retrieve the current runtime with the process.env.NEXT_RUNTIME environment variable:

console.log("Runtime:", process.env.NEXT_RUNTIME)


Edge computing has come here to stay. The performance benefits are noticeable and the community is working actively to improve the implementation of standarized web APIs in environments different than web browsers. Next.js offers an easy way to start using the Edge Runtime so you can get the benefits of edge computing with a few changes to your applications.