connection

La fonction connection() permet d'indiquer que le rendu doit attendre une requête utilisateur entrante avant de continuer.

Elle est utile lorsqu'un composant n'utilise pas les API dynamiques, mais que vous souhaitez qu'il soit rendu dynamiquement lors de l'exécution et non statiquement au moment de la construction. Cela se produit généralement lorsque vous accédez à des informations externes qui modifient intentionnellement le résultat d'un rendu, comme Math.random() ou new Date().

import { connection } from 'next/server'

export default async function Page() {
  await connection()
  // Tout ce qui suit sera exclu du prérendu
  const rand = Math.random()
  return <span>{rand}</span>
}

Référence

Type

function connection(): Promise<void>

Paramètres

• La fonction n'accepte aucun paramètre.

Valeur de retour

• La fonction retourne une Promise void. Elle n'est pas destinée à être consommée.

Bon à savoir

• connection remplace unstable_noStore pour mieux s'aligner avec l'avenir de Next.js.
• La fonction n'est nécessaire que lorsque le rendu dynamique est requis et que les API dynamiques courantes ne sont pas utilisées.

Historique des versions