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，它不應被使用。

實用資訊

• 為了更好地與 Next.js 的未來發展方向保持一致，connection 取代了 unstable_noStore。
• 僅在需要動態渲染且未使用常見的動態 API 時才需要使用此函式。

版本歷史記錄