connection

Theconnection() function allows you to indicate rendering should wait for an incoming user request before continuing.

It's useful when a component doesn't useDynamic APIs, but you want it to be dynamically rendered at runtime and not statically rendered at build time. This usually occurs when you access external information that you intentionally want to change the result of a render, such asMath.random() ornew Date().

import { connection }from'next/server'exportdefaultasyncfunctionPage() {awaitconnection()// Everything below will be excluded from prerenderingconstrand=Math.random()return <span>{rand}</span>}

Reference

Type

functionconnection():Promise<void>

Parameters

• The function does not accept any parameters.

Returns

• The function returns avoid Promise. It is not meant to be consumed.

Good to know

• connection replacesunstable_noStore to better align with the future of Next.js.
• The function is only necessary when dynamic rendering is required and common Dynamic APIs are not used.

Version History