| description |
|---|
Learn more about the switchable runtimes (Edge and Node.js) in Next.js. |
Next.js has two server runtimes where you can render parts of your application code: the Node.js Runtime and the Edge Runtime. Depending on your deployment infrastructure, both runtimes support streaming.
By default, Next.js uses the Node.js runtime. Middleware and Edge API Routes use the Edge runtime.
On each page, you can optionally export a runtime config set to either 'nodejs' or 'experimental-edge':
// pages/index.js
export default function Index () { ... }
export function getServerSideProps() { ... }
export const config = {
runtime: 'experimental-edge',
}| Node (Server) | Node (Serverless) | Edge | |
|---|---|---|---|
| Name | nodejs |
nodejs |
edge or experimental-edge if using Next.js Rendering |
| Cold Boot | / | ~250ms | Instant |
| HTTP Streaming | Yes | Yes | Yes |
| IO | All | All | fetch |
| Scalability | / | High | Highest |
| Security | Normal | High | High |
| Latency | Normal | Low | Lowest |
| Code Size | / | 50 MB | 4 MB |
| NPM Packages | All | All | A smaller subset |
Next.js' default runtime configuration is good for most use cases, but there are still many reasons to change to one runtime over the other one.
For example, for API routes that rely on native Node.js APIs, they need to run with the Node.js Runtime. However, if an API only uses something like cookie-based authentication, using Middleware and the Edge Runtime will be a better choice due to its lower latency as well as better scalability.
Edge API Routes enable you to build high performance APIs with Next.js using the Edge Runtime.
export const config = {
runtime: 'edge',
}
export default (req) => new Response('Hello world!')