Edge 运行时

Next.js 有两个可以在应用程序中使用的服务器运行时：

• Node.js Runtime（默认），可以访问所有 Node.js API，用于渲染你的应用程序。
• Edge Runtime，包含更有限的 API 集，用于 Proxy。

注意事项

• Edge Runtime 不支持所有 Node.js API。某些包可能无法按预期工作。
• Edge Runtime 不支持增量静态再生成（ISR）。
• 两个运行时都可以支持流式传输，具体取决于你的部署适配器。

参考

Edge Runtime 支持以下 API：

Network APIs

Encoding APIs

Stream APIs

Crypto APIs

Web Standard APIs

Next.js 特定的 Polyfills

• AsyncLocalStorage

环境变量

你可以使用 process.env 来访问 next dev 和 next build 的环境变量。

不支持的 API

Edge Runtime 有一些限制，包括：

• 不支持原生 Node.js API。例如，你无法读取或写入文件系统。
• node_modules _可以_使用，只要它们实现 ES Modules 并且不使用原生 Node.js API。
• 不允许直接调用 require。请改用 ES Modules。

以下 JavaScript 语言功能已禁用，并且将无法工作：

在极少数情况下，你的代码可能包含（或导入）一些在运行时_无法到达_且无法通过 tree-shaking 删除的动态代码评估语句。 你可以通过 Proxy 配置放宽检查以允许特定文件：

export const config = {
  unstable_allowDynamic: [
    // 允许单个文件
    '/lib/utilities.js',
    // 使用 glob 允许 function-bind 第三方模块中的任何内容
    '**/node_modules/function-bind/**',
  ],
}

unstable_allowDynamic 是一个 glob，或 glob 数组，用于忽略特定文件的动态代码评估。这些 glob 相对于你的应用程序根文件夹。

请注意，如果这些语句在 Edge 上执行，它们将抛出错误并导致运行时错误。