エッジランタイム

Next.js には、アプリケーションで使用できる 2 つのサーバーランタイムがあります。

• Node.js Runtime（デフォルト）。すべての Node.js API にアクセスでき、アプリケーションのレンダリングに使用されます。
• Edge Runtime。より限定されたAPI セットを含み、Proxyで使用されます。

注意事項

• Edge Runtime はすべての Node.js API をサポートしていません。一部のパッケージは期待通りに動作しない可能性があります。
• Edge Runtime は Incremental Static Regeneration（ISR）をサポートしていません。
• 両方のランタイムはデプロイアダプタに応じてストリーミングをサポートできます。

リファレンス

Edge Runtime は以下の API をサポートしています。

ネットワーク API

エンコーディング API

ストリーム API

Crypto API

Web 標準 API

Next.js 固有のポリフィル

• AsyncLocalStorage

環境変数

process.env を使用して、next dev と next build の両方で環境変数にアクセスできます。

サポートされていない API

Edge Runtime にはいくつかの制限があります。

• ネイティブの Node.js API はサポートされていません。たとえば、ファイルシステムの読み取りや書き込みはできません。
• node_modules は、ES Modules を実装し、ネイティブの Node.js API を使用しない限り、使用できます。
• require を直接呼び出すことは許可されていません。代わりに ES Modules を使用してください。

次の JavaScript 言語機能は無効化されており、動作しません。

稀なケースでは、コードが動的コード評価ステートメント（実行時に到達できず、ツリーシェーキングで削除できないもの）を含む、またはインポートする可能性があります。 Proxy 設定で特定のファイルのチェックを緩和できます。

export const config = {
  unstable_allowDynamic: [
    // 単一のファイルを許可します
    '/lib/utilities.js',
    // グロブを使用して function-bind サードパーティモジュール内のすべてを許可します
    '**/node_modules/function-bind/**',
  ],
}

unstable_allowDynamic はグロブ、またはグロブの配列で、特定のファイルの動的コード評価を無視します。グロブはアプリケーションルートフォルダを基準に相対的です。

Edge で実行されるこれらのステートメントは、_エラーをスローしてランタイムエラーが発生する_可能性があることに注意してください。