Skip to content

NextJS中文文档 - Connection

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

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

ts
import { connection } from 'next/server'

export default async function Page() {
  await connection()
  // 下面的所有内容将被排除在预渲染之外
  const rand = Math.random()
  return <span>{rand}</span>
}
jsx
import { connection } from 'next/server'

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

参考

类型

jsx
function connection(): Promise<void>

参数

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

返回值

  • 该函数返回一个 void Promise。它不需要被消费。

须知

  • connection 替代了 unstable_noStore,以更好地与 Next.js 的未来发展方向保持一致。
  • 只有在需要动态渲染且没有使用常见的动态 API 时,才需要使用该函数。

版本历史

版本变更
v15.0.0connection 稳定版发布。
v15.0.RC引入 connection

🎉有任何问题,欢迎联系我

WeChat QR Code
WeChat
QQ QR Code
QQ

赣ICP备2023003243号