Edge Runtime

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

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

注意点

• Edge Runtime は、すべての Node.js API をサポートしているわけではありません。一部のパッケージは期待どおりに動作しない場合があります。
• Edge Runtime は、増分静的再生 (ISR) をサポートしていません。
• デプロイメントアダプターによっては、両方のランタイムでストリーミングをサポートできます。

リファレンス

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

ネットワーク API

エンコーディング API

ストリーム API

暗号 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: [
    // 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 で実行された場合、エラーが発生し、実行時エラーを引き起こすことに注意してください。