StaleTimes (experimental)

Advertencia: La configuración staleTimes es una característica experimental. Esta estrategia de configuración probablemente cambiará en el futuro.

staleTimes es una característica experimental que permite configurar el período de invalidación de la caché del enrutador (Router) del cliente.

Esta opción de configuración está disponible a partir de la versión v14.2.0-canary.53.

Puede habilitar esta característica experimental y proporcionar tiempos de revalidación personalizados configurando el flag experimental staleTimes:

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

module.exports = nextConfig

Las propiedades static y dynamic corresponden al período de tiempo (en segundos) basado en diferentes tipos de precarga de enlaces (prefetching).

• La propiedad dynamic se utiliza cuando la página no se genera estáticamente ni se precarga completamente (es decir, con prefetch=).
  • Valor predeterminado: 0 segundos (no se almacena en caché)
• La propiedad static se utiliza para páginas generadas estáticamente, o cuando la propiedad prefetch en Link se establece en true, o al llamar a router.prefetch.
  • Valor predeterminado: 5 minutos

Dato importante:

• Los límites de carga (loading boundaries) se consideran reutilizables durante el período static definido en esta configuración.
• Esto no afecta el renderizado parcial (partial rendering), lo que significa que los diseños compartidos no se volverán a cargar automáticamente en cada navegación, solo el segmento de página que cambia.
• Esto no cambia el comportamiento del caché de avance/retroceso (back/forward caching) para evitar cambios en el diseño y perder la posición de desplazamiento del navegador.

Puede obtener más información sobre la caché del enrutador (Router) del cliente aquí.

Historial de versiones