connection

Die connection()-Funktion ermöglicht es anzugeben, dass das Rendering auf eine eingehende Benutzeranfrage warten soll, bevor es fortfährt.

Sie ist nützlich, wenn eine Komponente keine dynamischen APIs verwendet, Sie aber möchten, dass sie zur Laufzeit dynamisch gerendert wird und nicht statisch zur Build-Zeit. Dies tritt typischerweise auf, wenn Sie auf externe Informationen zugreifen, die absichtlich das Ergebnis eines Renderings verändern sollen, wie z.B. Math.random() oder new Date().

import { connection } from 'next/server'

export default async function Page() {
  await connection()
  // Alles darunter wird vom Prerendering ausgeschlossen
  const rand = Math.random()
  return <span>{rand}</span>
}

import { connection } from 'next/server'

export default async function Page() {
  await connection()
  // Alles darunter wird vom Prerendering ausgeschlossen
  const rand = Math.random()
  return <span>{rand}</span>
}

Referenz

Typ

function connection(): Promise<void>

Parameter

• Die Funktion akzeptiert keine Parameter.

Rückgabewert

• Die Funktion gibt ein void Promise zurück. Es ist nicht zur Verwendung gedacht.

Wissenswertes

• connection ersetzt unstable_noStore, um besser mit der Zukunft von Next.js ausgerichtet zu sein.
• Die Funktion ist nur notwendig, wenn dynamisches Rendering erforderlich ist und keine gängigen dynamischen APIs verwendet werden.

Versionsverlauf