Skip to main content

staleTimes

staleTimes 是一项实验性功能，可在 客户端路由缓存 中启用页面段的缓存。

¥staleTimes is an experimental feature that enables caching of page segments in the client-side router cache.

你可以通过设置实验性的 staleTimes 标志来启用此实验性功能并提供自定义重新验证时间：

¥You can enable this experimental feature and provide custom revalidation times by setting the experimental staleTimes flag:

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

module.exports = nextConfig

static 和 dynamic 属性对应于基于不同类型的 链接预取 的时间段（以秒为单位）。

¥The static and dynamic properties correspond with the time period (in seconds) based on different types of link prefetching.

  • 当页面既不是静态生成的也不是完全预取的（即，prefetch=）时，使用 dynamic 属性。

    ¥The dynamic property is used when the page is neither statically generated nor fully prefetched (i.e., with prefetch=).

    • 默认：0 秒（未缓存）

      ¥Default: 0 seconds (not cached)

  • static 属性用于静态生成的页面，或者当 Link 上的 prefetch 属性设置为 true 时，或者调用 router.prefetch 时。

    ¥The static property is used for statically generated pages, or when the prefetch prop on Link is set to true, or when calling router.prefetch.

    • 默认：5 分钟

      ¥Default: 5 minutes

很高兴知道：

¥Good to know:

  • 加载边界 被认为在此配置中定义的 static 周期内可重复使用。

    ¥Loading boundaries are considered reusable for the static period defined in this configuration.

  • 这不会影响 部分渲染，这意味着共享布局不会在每次导航时自动重新获取，只会重新获取发生变化的页面段。

    ¥This doesn't affect partial rendering, meaning shared layouts won't automatically be refetched on every navigation, only the page segment that changes.

  • 这不会改变 后退/前进缓存 行为以防止布局偏移并防止丢失浏览器滚动位置。

    ¥This doesn't change back/forward caching behavior to prevent layout shift and to prevent losing the browser scroll position.

你可以了解有关客户端路由缓存 此处 的更多信息。

¥You can learn more about the Client Router Cache here.

版本历史​

¥Version History

版本变化
v15.0.0dynamic staleTimes 默认值从 30 秒更改为 0 秒。
v14.2.0引入了实验性 staleTimes。