跳至内容
API 参考函数connection

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。它不打算被消费。

须知 unstable_noStore 以更好地与 Next.js 的未来发展方向保持一致。
  • 只有在需要动态渲染并且未使用常见的动态 API 时才需要此函数。

    • 版本历史记录

    版本更改
    v15.0.0-RC引入了 connection。