cacheLife
此功能目前在 canary 通道中可用,并可能发生变化。您可以通过升级 Next.js 来试用它,并在 GitHub 上分享您的反馈。
当在组件或函数内部,以及在 use cache 指令范围内使用 cacheLife 函数时,cacheLife 选项允许您定义自定义缓存配置文件。
用法
要定义配置文件,请启用 cacheComponents 标志,并在 next.config.js 文件中的 cacheLife 对象中添加缓存配置文件。例如,一个 blog 配置文件
next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
cacheComponents: true,
cacheLife: {
blog: {
stale: 3600, // 1 hour
revalidate: 900, // 15 minutes
expire: 86400, // 1 day
},
},
}
export default nextConfig您现在可以在组件或函数中使用此自定义 blog 配置,如下所示
app/actions.ts
import { cacheLife } from 'next/cache'
export async function getCachedData() {
'use cache'
cacheLife('blog')
const data = await fetch('/api/data')
return data
}参考
配置对象具有以下格式的键值
| 属性 | 值 | 描述 | 要求 |
|---|---|---|---|
stale | 数字 | 客户端缓存值而不检查服务器的持续时间。 | 可选 |
`revalidate` | 数字 | 缓存应在服务器上刷新的频率;在重新验证时可能会提供过期值。 | 可选 |
expire | 数字 | 在切换到动态之前,值可以保持过期的最大持续时间。 | 可选 - 必须长于 revalidate |
这有帮助吗?