connection

Функция connection() позволяет указать, что рендеринг должен ожидать входящего пользовательского запроса перед продолжением.

Она полезна, когда компонент не использует Динамические API, но вы хотите, чтобы он рендерился динамически во время выполнения, а не статически во время сборки. Обычно это происходит при доступе к внешней информации, которая намеренно должна изменять результат рендеринга, например Math.random() или new Date().

import { connection } from 'next/server'

export default async function Page() {
  await connection()
  // Все ниже будет исключено из предварительного рендеринга
  const rand = Math.random()
  return <span>{rand}</span>
}

import { connection } from 'next/server'

export default async function Page() {
  await connection()
  // Все ниже будет исключено из предварительного рендеринга
  const rand = Math.random()
  return <span>{rand}</span>
}

Справочник

Тип

function connection(): Promise<void>

Параметры

• Функция не принимает параметров.

Возвращаемое значение

• Функция возвращает Promise void. Он не предназначен для использования.

Полезно знать

• connection заменяет unstable_noStore для лучшего соответствия будущему Next.js.
• Функция необходима только когда требуется динамический рендеринг и не используются общие Динамические API.

История версий