Edge Runtime

Next.js 提供了兩種可在應用程式中使用的伺服器執行時：

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

注意事項

• Edge Runtime 不支援所有 Node.js API。某些包可能無法按預期工作。
• Edge Runtime 不支援增量靜態再生（ISR）。
• 兩種執行時都可以根據您的部署介面卡支援 流式傳輸。

參考

Edge Runtime 支援以下 API

網路 API

編碼 API

流 API

加密 API

Web 標準 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: [
    // 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 上執行，它們將丟擲錯誤並導致執行時錯誤。