connection

La función connection() permite indicar que el renderizado debe esperar una solicitud de usuario entrante antes de continuar.

Es útil cuando un componente no utiliza APIs dinámicas, pero se desea que se renderice dinámicamente en tiempo de ejecución y no de forma estática durante el tiempo de construcción. Esto suele ocurrir cuando se accede a información externa que intencionalmente debe cambiar el resultado del renderizado, como Math.random() o new Date().

import { connection } from 'next/server'

export default async function Page() {
  await connection()
  // Todo lo siguiente será excluido del prerenderizado
  const rand = Math.random()
  return <span>{rand}</span>
}

Referencia

Tipo

function connection(): Promise<void>

Parámetros

• La función no acepta ningún parámetro.

Retorna

• La función retorna una Promesa void. No está destinada a ser consumida.

Bueno saber

• connection reemplaza a unstable_noStore para alinearse mejor con el futuro de Next.js.
• La función solo es necesaria cuando se requiere renderizado dinámico y no se utilizan APIs dinámicas comunes.

Historial de versiones