connection

Die connection()-Funktion ermöglicht es, anzugeben, dass das Rendering warten soll, bis eine eingehende Benutzeranfrage vorliegt, bevor es fortgesetzt wird.

Sie ist nützlich, wenn eine Komponente keine Dynamischen APIs verwendet, Sie aber möchten, dass sie zur Laufzeit dynamisch gerendert und nicht zur Buildzeit statisch gerendert wird. Dies tritt normalerweise auf, wenn Sie auf externe Informationen zugreifen, deren Rendering-Ergebnis Sie absichtlich ändern möchten, wie z.B. Math.random() oder new Date().

import { connection } from 'next/server'
 
export default async function Page() {
  await connection()
  // Alles unterhalb 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 dazu gedacht, konsumiert zu werden.

Hinweis

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

Versionsverlauf