connection

connection() 函数允许您指定渲染应等待传入的用户请求后再继续执行。

当组件不使用 动态 API (Dynamic APIs)，但您希望它在运行时动态渲染而非构建时静态渲染时，此函数非常有用。这种情况通常发生在您访问外部信息时，这些信息会刻意改变渲染结果，例如 Math.random() 或 new Date()。

import { connection } from 'next/server'

export default async function Page() {
  await connection()
  // 以下内容将从预渲染中排除
  const rand = Math.random()
  return <span>{rand}</span>
}

参考

类型

function connection(): Promise<void>

参数

• 该函数不接受任何参数。

返回值

• 该函数返回一个 void 类型的 Promise，不应被消费。

须知

• connection 取代了 unstable_noStore，以更好地与 Next.js 的未来发展方向保持一致。
• 仅当需要动态渲染且未使用常见的动态 API 时，才需要使用此函数。

版本历史