connection

connection() 関数を使用すると、レンダリングが続行する前に、受信したユーザーリクエストを待つ必要があることを示すことができます。

動的 API を使用していないが、ビルド時に静的にレンダリングされるのではなく、ランタイム時に動的にレンダリングしたい場合に便利です。これは通常、Math.random() や new Date() など、レンダリングの結果を意図的に変更したい外部情報にアクセスする場合に発生します。

import { connection } from 'next/server'
 
export default async function Page() {
  await connection()
  // Everything below will be excluded from prerendering
  const rand = Math.random()
  return <span>{rand}</span>
}

リファレンス

型

function connection(): Promise<void>

パラメーター

• この関数はパラメーターを受け取りません。

戻り値

• この関数は void Promise を返します。使用されることは意図されていません。

知っておくとよいこと

• connection は、Next.js の将来とよりよく整合するために、unstable_noStore に置き換わるものです。
• この関数は、動的なレンダリングが必要で、一般的な動的 API が使用されていない場合にのみ必要です。

バージョン履歴