Rename page runtime edge to experimental-edge

docs/advanced-features/react-18/server-components.md

@@ -22,7 +22,7 @@ module.exports = {
 }
 ```
 
-Using `runtime` also enables [Streaming SSR](/docs/advanced-features/react-18/streaming). When setting `runtime` to `'edge'`, the server will be running entirely in the [Edge Runtime](https://nextjs.org/docs/api-reference/edge-runtime).
+Using `runtime` also enables [Streaming SSR](/docs/advanced-features/react-18/streaming). When setting `runtime` to `'experimental-edge'`, the server will be running entirely in the [Edge Runtime](https://nextjs.org/docs/api-reference/edge-runtime).
 
 Now, you can start using React Server Components in Next.js. [See our example](https://github.com/vercel/next-rsc-demo) for more information.
 

docs/advanced-features/react-18/switchable-runtime.md

@@ -8,7 +8,7 @@ If you have [React 18](/docs/advanced-features/react-18/overview) installed, the
 
 ## Global Runtime Option
 
-You can set the experimental option `runtime` to either `'nodejs'` or `'edge'` in your `next.config.js` file:
+You can set the experimental option `runtime` to either `'nodejs'` or `'experimental-edge'` in your `next.config.js` file:
 
 ```jsx
 // next.config.js
@@ -23,7 +23,7 @@ This option determines which runtime should be used as the default rendering run
 
 ## Page Runtime Option
 
-On each page, you can optionally export a `runtime` config set to either `'nodejs'` or `'edge'`:
+On each page, you can optionally export a `runtime` config set to either `'nodejs'` or `'experimental-edge'`:
 
 ```jsx
 export const config = {

packages/next/build/analysis/extract-const-value.ts

@@ -16,7 +16,7 @@ import type {
 
 /**
  * Extracts the value of an exported const variable named `exportedName`
- * (e.g. "export const config = { runtime: 'edge' }") from swc's AST.
+ * (e.g. "export const config = { runtime: 'experimental-edge' }") from swc's AST.
  * The value must be one of (or throws UnsupportedValueError):
  *   - string
  *   - boolean

packages/next/build/analysis/get-page-static-info.ts

@@ -6,6 +6,7 @@ import { parseModule } from './parse-module'
 import { promises as fs } from 'fs'
 import { tryToParsePath } from '../../lib/try-to-parse-path'
 import * as Log from '../output/log'
+import { PAGE_RUNTIME } from '../../lib/constants'
 
 interface MiddlewareConfig {
   pathMatcher: RegExp
@@ -39,15 +40,15 @@ export async function getPageStaticInfo(params: {
     const { ssg, ssr } = checkExports(swcAST)
     const config = tryToExtractExportedConstValue(swcAST, 'config') || {}
 
-    let runtime = ['experimental-edge', 'edge'].includes(config?.runtime)
-      ? 'edge'
-      : ssr || ssg
-      ? config?.runtime || nextConfig.experimental?.runtime
-      : undefined
+    let runtime =
+      PAGE_RUNTIME.edge === config?.runtime
+        ? PAGE_RUNTIME.edge
+        : ssr || ssg
+        ? config?.runtime || nextConfig.experimental?.runtime
+        : undefined
 
-    if (runtime === 'experimental-edge' || runtime === 'edge') {
+    if (runtime === PAGE_RUNTIME.edge) {
       warnAboutExperimentalEdgeApiFunctions()
-      runtime = 'edge'
     }
 
     const middlewareConfig = getMiddlewareConfig(config, nextConfig)

packages/next/build/entries.ts

@@ -15,6 +15,7 @@ import {
   PAGES_DIR_ALIAS,
   ROOT_DIR_ALIAS,
   APP_DIR_ALIAS,
+  PAGE_RUNTIME,
 } from '../lib/constants'
 import {
   CLIENT_STATIC_FILES_RUNTIME_AMP,
@@ -444,7 +445,7 @@ export function runDependingOnPageType<T>(params: {
   if (isMiddlewareFile(params.page)) {
     return { edgeServer: params.onEdgeServer() }
   } else if (params.page.match(API_ROUTE)) {
-    return params.pageRuntime === 'edge'
+    return params.pageRuntime === PAGE_RUNTIME.edge
       ? { edgeServer: params.onEdgeServer() }
       : { server: params.onServer() }
   } else if (params.page === '/_document') {
@@ -457,7 +458,7 @@ export function runDependingOnPageType<T>(params: {
   ) {
     return { client: params.onClient(), server: params.onServer() }
   } else {
-    return params.pageRuntime === 'edge'
+    return params.pageRuntime === PAGE_RUNTIME.edge
       ? { client: params.onClient(), edgeServer: params.onEdgeServer() }
       : { client: params.onClient(), server: params.onServer() }
   }

packages/next/build/index.ts

@@ -18,6 +18,7 @@ import {
   PUBLIC_DIR_MIDDLEWARE_CONFLICT,
   MIDDLEWARE_FILENAME,
   PAGES_DIR_ALIAS,
+  PAGE_RUNTIME,
 } from '../lib/constants'
 import { fileExists } from '../lib/file-exists'
 import { findPagesDir } from '../lib/find-pages-dir'
@@ -1117,7 +1118,7 @@ export default async function build(
               if (
                 !isReservedPage(page) &&
                 // We currently don't support static optimization in the Edge runtime.
-                pageRuntime !== 'edge'
+                pageRuntime !== PAGE_RUNTIME.edge
               ) {
                 try {
                   let isPageStaticSpan =

packages/next/build/utils.ts

@@ -24,6 +24,7 @@ import {
   SERVER_PROPS_GET_INIT_PROPS_CONFLICT,
   SERVER_PROPS_SSG_CONFLICT,
   MIDDLEWARE_FILENAME,
+  PAGE_RUNTIME,
 } from '../lib/constants'
 import { EDGE_RUNTIME_WEBPACK } from '../shared/lib/constants'
 import prettyBytes from '../lib/pretty-bytes'
@@ -194,7 +195,7 @@ export async function printTreeView(
         ? '○'
         : pageInfo?.isSsg
         ? '●'
-        : pageInfo?.runtime === 'edge'
+        : pageInfo?.runtime === PAGE_RUNTIME.edge
         ? 'ℇ'
         : 'λ'
 
@@ -1301,7 +1302,7 @@ export async function isEdgeRuntimeCompiled(
 
   // Check the page runtime as well since we cannot detect the runtime from
   // compilation when it's for the client part of edge function
-  return staticInfo.runtime === 'edge'
+  return staticInfo.runtime === PAGE_RUNTIME.edge
 }
 
 export function getNodeBuiltinModuleNotSupportedInEdgeRuntimeMessage(

packages/next/build/webpack-config.ts

@@ -12,6 +12,7 @@ import {
   PAGES_DIR_ALIAS,
   ROOT_DIR_ALIAS,
   APP_DIR_ALIAS,
+  PAGE_RUNTIME,
 } from '../lib/constants'
 import { fileExists } from '../lib/file-exists'
 import { CustomRoutes } from '../lib/load-custom-routes.js'
@@ -385,7 +386,7 @@ export default async function getBaseWebpackConfig(
     : config.experimental.disableOptimizedLoading
 
   if (isClient) {
-    if (config.experimental.runtime === 'edge') {
+    if (config.experimental.runtime === PAGE_RUNTIME.edge) {
       Log.warn(
         'You are using the experimental Edge Runtime with `experimental.runtime`.'
       )

packages/next/build/webpack/loaders/next-edge-ssr-loader/render.ts

@@ -10,6 +10,7 @@ import {
   WebNextRequest,
   WebNextResponse,
 } from '../../../../server/base-http/web'
+import { PAGE_RUNTIME } from '../../../../lib/constants'
 
 export function getRender({
   dev,
@@ -55,7 +56,7 @@ export function getRender({
       page,
       extendRenderOpts: {
         buildId,
-        runtime: 'edge',
+        runtime: PAGE_RUNTIME.edge,
         supportsDynamicHTML: true,
         disableOptimizedLoading: true,
         serverComponentManifest,

packages/next/build/webpack/loaders/next-flight-client-entry-loader.ts

@@ -1,3 +1,5 @@
+import { PAGE_RUNTIME } from '../../../lib/constants'
+
 export default async function transformSource(this: any): Promise<string> {
   let { modules, runtime, ssr } = this.getOptions()
   if (!Array.isArray(modules)) {
@@ -18,7 +20,7 @@ export default async function transformSource(this: any): Promise<string> {
     export default function RSC() {};
     ` +
     // Currently for the Edge runtime, we treat all RSC pages as SSR pages.
-    (runtime === 'edge'
+    (runtime === PAGE_RUNTIME.edge
       ? 'export const __N_SSP = true;'
       : ssr
       ? `export const __N_SSP = true;`

packages/next/build/webpack/plugins/client-entry-plugin.ts

@@ -12,6 +12,7 @@ import {
   entries,
 } from '../../../server/dev/on-demand-entry-handler'
 import { getPageStaticInfo } from '../../analysis/get-page-static-info'
+import { PAGE_RUNTIME } from '../../../lib/constants'
 
 type Options = {
   dev: boolean
@@ -111,7 +112,7 @@ export class ClientEntryPlugin {
 
         const clientLoader = `next-flight-client-entry-loader?${stringify({
           modules: clientComponentImports,
-          runtime: this.isEdgeServer ? 'edge' : 'nodejs',
+          runtime: this.isEdgeServer ? PAGE_RUNTIME.edge : PAGE_RUNTIME.nodejs,
           ssr: pageStaticInfo.ssr,
           // Adding name here to make the entry key unique.
           name,

packages/next/lib/constants.ts

@@ -1,3 +1,4 @@
+import type { PageRuntime } from '../server/config-shared'
 import { join } from '../shared/lib/isomorphic/path'
 
 export const NEXT_PROJECT_ROOT = join(__dirname, '..', '..')
@@ -84,3 +85,8 @@ export const ESLINT_PROMPT_VALUES = [
     config: null,
   },
 ]
+
+export const PAGE_RUNTIME: Record<string, PageRuntime> = {
+  edge: 'experimental-edge',
+  nodejs: 'nodejs',
+}

packages/next/server/app-render.tsx

@@ -1,5 +1,6 @@
 import type { IncomingMessage, ServerResponse } from 'http'
 import type { LoadComponentsReturnType } from './load-components'
+import type { PageRuntime } from './config-shared'
 
 import React from 'react'
 import { ParsedUrlQuery, stringify as stringifyQuery } from 'querystring'
@@ -30,7 +31,7 @@ export type RenderOptsPartial = {
   dev?: boolean
   serverComponentManifest?: any
   supportsDynamicHTML?: boolean
-  runtime?: 'nodejs' | 'edge'
+  runtime?: PageRuntime
   serverComponents?: boolean
 }
 

packages/next/server/base-server.ts

@@ -6,7 +6,11 @@ import type { FontManifest } from './font-utils'
 import type { LoadComponentsReturnType } from './load-components'
 import type { RouteMatch } from '../shared/lib/router/utils/route-matcher'
 import type { Params } from '../shared/lib/router/utils/route-matcher'
-import type { NextConfig, NextConfigComplete } from './config-shared'
+import type {
+  NextConfig,
+  NextConfigComplete,
+  PageRuntime,
+} from './config-shared'
 import type { NextParsedUrlQuery, NextUrlWithParsedQuery } from './request-meta'
 import type { ParsedUrlQuery } from 'querystring'
 import type { RenderOpts, RenderOptsPartial } from './render'
@@ -172,7 +176,7 @@ export default abstract class Server<ServerOptions extends Options = Options> {
     defaultLocale?: string
     domainLocales?: DomainLocale[]
     distDir: string
-    runtime?: 'nodejs' | 'edge'
+    runtime?: PageRuntime
     serverComponents?: boolean
     crossOrigin?: string
     supportsDynamicHTML?: boolean

packages/next/server/config-shared.ts

@@ -8,7 +8,7 @@ import {
   RemotePattern,
 } from '../shared/lib/image-config'
 
-export type PageRuntime = 'nodejs' | 'edge' | undefined
+export type PageRuntime = 'nodejs' | 'experimental-edge' | undefined
 
 export type NextConfigComplete = Required<NextConfig> & {
   images: Required<ImageConfigComplete>

packages/next/server/render.tsx

@@ -21,6 +21,7 @@ import type { LoadComponentsReturnType, ManifestItem } from './load-components'
 import type { GetServerSideProps, GetStaticProps, PreviewData } from '../types'
 import type { UnwrapPromise } from '../lib/coalesced-function'
 import type { ReactReadableStream } from './node-web-streams-helper'
+import type { PageRuntime } from './config-shared'
 
 import React from 'react'
 import { createFromReadableStream } from 'next/dist/compiled/react-server-dom-webpack'
@@ -238,7 +239,7 @@ export type RenderOptsPartial = {
   domainLocales?: DomainLocale[]
   disableOptimizedLoading?: boolean
   supportsDynamicHTML?: boolean
-  runtime?: 'nodejs' | 'edge'
+  runtime?: PageRuntime
   serverComponents?: boolean
   customServer?: boolean
   crossOrigin?: string

packages/next/server/web-server.ts

@@ -138,7 +138,7 @@ export default class NextWebServer extends BaseServer<WebServerOptions> {
       {
         ...renderOpts,
         disableOptimizedLoading: true,
-        runtime: 'edge',
+        runtime: 'experimental-edge',
       }
     )
   }

packages/next/shared/lib/html-context.ts

@@ -1,4 +1,5 @@
 import type { BuildManifest } from '../../server/get-page-files'
+import type { PageRuntime } from '../../server/config-shared'
 import type { NEXT_DATA } from './utils'
 
 import { createContext } from 'react'
@@ -37,7 +38,7 @@ export type HtmlProps = {
   optimizeCss?: boolean
   optimizeFonts?: boolean
   nextScriptWorkers?: boolean
-  runtime?: 'edge' | 'nodejs'
+  runtime?: PageRuntime
   hasConcurrentFeatures?: boolean
   largePageDataBytes?: number
 }

test/integration/react-18-invalid-config/index.test.js

@@ -50,7 +50,7 @@ function writeNextConfig(config, reactVersion = 17) {
 describe('Invalid react 18 webpack config', () => {
   it('should install react 18 when `experimental.runtime` is enabled', async () => {
     writeNextConfig({
-      runtime: 'edge',
+      runtime: 'experimental-edge',
     })
     const { stderr } = await nextBuild(appDir, [], { stderr: true, nodeArgs })
     nextConfig.restore()

test/integration/react-18/app/next.config.js

@@ -1,7 +1,7 @@
 module.exports = {
   // reactStrictMode: true,
   experimental: {
-    // runtime: 'edge',
+    // runtime: 'experimental-edge',
   },
   images: {
     deviceSizes: [480, 1024, 1600, 2000],

test/integration/react-18/app/pages/index.js

@@ -22,5 +22,5 @@ export default function Index() {
 }
 
 export const config = {
-  // runtime: 'edge'
+  // runtime: 'experimental-edge'
 }

test/integration/react-18/test/index.test.js

@@ -67,8 +67,14 @@ function runTestsAgainstRuntime(runtime) {
         if (env === 'dev') {
           invalidPage.write(`export const value = 1`)
         }
-        nextConfig.replace("// runtime: 'edge'", `runtime: '${runtime}'`)
-        indexPage.replace("// runtime: 'edge'", `runtime: '${runtime}'`)
+        nextConfig.replace(
+          "// runtime: 'experimental-edge'",
+          `runtime: '${runtime}'`
+        )
+        indexPage.replace(
+          "// runtime: 'experimental-edge'",
+          `runtime: '${runtime}'`
+        )
       },
       afterAll: (env) => {
         if (env === 'dev') {
@@ -81,7 +87,7 @@ function runTestsAgainstRuntime(runtime) {
   )
 }
 
-runTestsAgainstRuntime('edge')
+runTestsAgainstRuntime('experimental-edge')
 runTestsAgainstRuntime('nodejs')
 
 function runTests(name, fn, opts) {

test/integration/react-streaming-and-server-components/app/next.config.js

@@ -6,6 +6,6 @@ module.exports = {
   pageExtensions: ['js', 'ts', 'jsx'], // .tsx won't be treat as page,
   experimental: {
     serverComponents: true,
-    runtime: 'edge',
+    runtime: 'experimental-edge',
   },
 }

test/integration/react-streaming-and-server-components/app/pages/err/render.js

@@ -7,5 +7,5 @@ export default function MyError() {
 }
 
 export const config = {
-  runtime: 'edge',
+  runtime: 'experimental-edge',
 }

test/integration/react-streaming-and-server-components/app/pages/err/suspense.js

@@ -20,5 +20,5 @@ export default function page() {
 }
 
 export const config = {
-  runtime: 'edge',
+  runtime: 'experimental-edge',
 }

test/integration/react-streaming-and-server-components/app/pages/escaping-rsc.server.js

@@ -32,5 +32,5 @@ export default function Page() {
 }
 
 export const config = {
-  runtime: 'edge',
+  runtime: 'experimental-edge',
 }

test/integration/react-streaming-and-server-components/app/pages/next-api/image.server.js

@@ -9,5 +9,5 @@ const Page = () => {
 export default Page
 
 export const config = {
-  runtime: 'edge',
+  runtime: 'experimental-edge',
 }