Edge Runtime

Next.js 提供兩種伺服器運行時 (runtime) 供您的應用程式使用：

• Node.js 運行時 (預設)：可存取所有 Node.js API，用於渲染您的應用程式
• Edge 運行時：包含較為有限的 API 集合，用於 中介軟體 (Middleware)

注意事項

• Edge 運行時不支援所有 Node.js API，某些套件可能無法正常運作
• Edge 運行時不支援增量靜態再生 (ISR)
• 兩種運行時均可支援 串流 (streaming)，具體取決於您的部署適配器

API 參考

Edge 運行時支援以下 API：

網路 API

編碼 API

串流 API

加密 API

網頁標準 API

Next.js 專用 Polyfills

• AsyncLocalStorage

環境變數

你可以使用 process.env 來存取環境變數，適用於 next dev 和 next build 兩種情境。

不支援的 API

Edge Runtime 有一些限制，包括：

• 不支援原生 Node.js API。例如，你無法讀取或寫入檔案系統。
• 可以使用 node_modules，只要它們實作了 ES 模組且未使用原生 Node.js API。
• 不允許直接呼叫 require。請改用 ES 模組。

以下 JavaScript 語言功能已被禁用，將無法運作：

在極少數情況下，你的程式碼可能包含 (或引入) 一些動態程式碼評估語句，這些語句在執行時 無法被觸及 且無法透過 tree shaking 移除。
你可以透過中介軟體配置放寬檢查，允許特定檔案：

export const config = {
  unstable_allowDynamic: [
    // 允許單一檔案
    '/lib/utilities.js',
    // 使用 glob 模式允許第三方模組 function-bind 中的所有內容
    '**/node_modules/function-bind/**',
  ],
}

unstable_allowDynamic 是一個 glob 或 glob 陣列，用於忽略特定檔案的動態程式碼評估。這些 glob 是相對於你的應用程式根目錄。

請注意，如果這些語句在 Edge 環境中執行，它們將會拋出錯誤並導致執行時錯誤。