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 は グロブ、またはグロブの配列で、特定のファイルに対する動的コード評価を無視します。グロブはアプリケーションのルートフォルダからの相対パスです。

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