Edge Runtime (エッジランタイム)

Next.js ではアプリケーションで使用できる2つのサーバーランタイムを提供しています:

• Node.js ランタイム (デフォルト): すべての Node.js API にアクセス可能で、アプリケーションのレンダリングに使用されます。
• Edge ランタイム: 制限された API セット を含み、Middleware で使用されます。

注意事項

• Edge ランタイムはすべての Node.js API をサポートしていません。一部のパッケージは期待通りに動作しない可能性があります。
• Edge ランタイムは インクリメンタル静的再生成 (ISR) をサポートしていません。
• どちらのランタイムも、デプロイアダプターに応じて ストリーミング をサポートできます。

リファレンス

Edge ランタイムは以下の API をサポートしています:

ネットワーク API

エンコーディング API

ストリーム API

暗号化 API

Web 標準 API

Next.js 固有のポリフィル

• AsyncLocalStorage

環境変数

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

サポートされていない API

Edge Runtime には以下のような制限があります:

• ネイティブの Node.js API はサポートされていません。例えば、ファイルシステムの読み書きはできません。
• node_modules は使用_可能_ですが、ES モジュールを実装しており、ネイティブの Node.js API を使用していない場合に限ります。
• require の直接呼び出しは許可されていません。代わりに ES モジュールを使用してください。

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

まれなケースとして、コードに（またはインポートしたモジュールに）ランタイム時に到達できない動的コード評価文が含まれており、ツリーシェイキングで削除できない場合があります。 Middleware 設定で特定のファイルを許可するようにチェックを緩和できます:

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

unstable_allowDynamic は glob、または glob の配列で、特定のファイルに対する動的コード評価を無視します。glob はアプリケーションのルートフォルダからの相対パスです。

これらの文が Edge で実行された場合、_エラーがスローされランタイムエラーを引き起こす_ことに注意してください。