跳到内容

connection

connection() 函数允许你指示渲染应等待传入的用户请求,然后继续。

当组件不使用 动态 API,但你希望它在运行时动态渲染而不是在构建时静态渲染时,此函数非常有用。这通常发生在你访问有意改变渲染结果的外部信息时,例如 Math.random()new Date()

app/page.tsx
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 替代了 unstable_noStore,以更好地与 Next.js 的未来保持一致。
  • 仅当需要动态渲染且未使用常用动态 API 时,此函数才必要。

版本历史

版本更改
v15.0.0connection 稳定化。
v15.0.0-RCconnection 引入。