Spec-Zone.ru › Next.js

StaleTimes (экспериментальная)

Предупреждение: Настройка staleTimes — экспериментальная функция. Стратегия этой конфигурации, вероятно, изменится в будущем.

staleTimes — экспериментальная функция, позволяющая настроить период инвалидации кэша клиента маршрутизатора.

Этот параметр конфигурации доступен начиная с v14.2.0-canary.53.

Вы можете включить эту экспериментальную функцию и задать пользовательские времена перепроверки, установив экспериментальный флаг staleTimes:

/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    staleTimes: {
      dynamic: 30,
      static: 180,
    },
  },
}
 
module.exports = nextConfig

Свойства static и dynamic соответствуют временным интервалам (в секундах), основанным на различных типах предварительной загрузки ссылок.

  • Свойство dynamic используется, когда свойство prefetch в Link не указано.
    • Значение по умолчанию: 30 секунд
  • Свойство static используется, когда свойство prefetch в Link установлено в true, или при вызове router.prefetch.
    • Значение по умолчанию: 5 минут

Важно знать:

  • Границы загрузки считаются повторно используемыми в течение периода static, определённого в этой конфигурации.
  • Это не отключает поддержку частичного рендеринга, что означает, что общие макеты не будут автоматически перечитываться при каждом переходе, только новые данные сегмента.
  • Это не изменяет поведение кэширования вперёд/назад для предотвращения сдвига макета и потери позиции прокрутки браузера.
  • Разные свойства этой конфигурации относятся к различным уровням «актуальности» и не связаны с тем, выбирает ли сам сегмент статический или динамический рендеринг. Другими словами, текущее значение по умолчанию static в 5 минут предполагает, что данные кажутся статическими благодаря тому, что они перепроверяются нечасто.

Дополнительную информацию о кэше клиента маршрутизатора вы можете найти здесь.

© 2024 Vercel, Inc.
Licensed under the MIT License.
https://nextjs.org/docs/app/api-reference/next-config-js/staleTimes

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API