Edge Runtime

Next.js 有兩個可在應用程式中使用的伺服器執行時

• Node.js 執行時（預設），可訪問所有 Node.js API，用於渲染應用程式。
• Edge 執行時包含一組更有限的API，用於代理。

注意事項

• Edge 執行時不支援所有 Node.js API。某些軟體包可能無法按預期工作。
• Edge 執行時不支援增量靜態再生 (ISR)。
• 這兩個執行時都可以支援流式傳輸，具體取決於您的部署介面卡。

參考

Edge 執行時支援以下 API

網路 API

編碼 API

流 API

加密 API

Web 標準 API

Next.js 特定 Polyfill

• AsyncLocalStorage

環境變數

您可以使用 process.env 訪問 環境變數，適用於 next dev 和 next build。

不支援的 API

Edge 執行時有一些限制，包括

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

以下 JavaScript 語言特性已被停用，將無法工作：

在極少數情況下，您的程式碼可能包含（或匯入）一些動態程式碼評估語句，這些語句無法在執行時到達，並且無法透過搖樹最佳化移除。您可以透過代理配置放寬檢查以允許特定檔案

export const config = {
  unstable_allowDynamic: [
    // allows a single file
    '/lib/utilities.js',
    // use a glob to allow anything in the function-bind 3rd party module
    '**/node_modules/function-bind/**',
  ],
}

unstable_allowDynamic 是一個 glob，或 glob 陣列，它忽略特定檔案的動態程式碼評估。glob 相對於您的應用程式根資料夾。

請注意，如果這些語句在 Edge 上執行，它們將丟擲並導致執行時錯誤。