connection

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

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

TypeScript

app/page.tsx

import { connection } from 'next/server'

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

JavaScript

app/page.js

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 时，该函数才是必要的。

版本历史

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