next.js
5c589abd - docs: document cacheLife expire omission behavior and fix default preset value (#89913)

Commit
78 days ago
docs: document cacheLife expire omission behavior and fix default preset value (#89913) ## Summary - Add note that omitting `expire` in `cacheLife` results in cache never expiring - Fix `default` preset table: `expire` was documented as "1 year" but actual code uses `INFINITE_CACHE` (never) - Add mention of expire omission behavior in custom profiles section ## Why The `expire` property is optional (`expire?: number`), but the documentation didn't explain what happens when it's omitted. The source code shows it defaults to `INFINITE_CACHE` (0xfffffffe), meaning the cache never expires. Additionally, the preset profile table incorrectly listed the `default` profile's expire as "1 year" when the actual value is `INFINITE_CACHE`. ### Source code references - `packages/next/src/lib/constants.ts:45` — `INFINITE_CACHE = 0xfffffffe` - `packages/next/src/server/config-shared.ts:1580` — `default.expire: INFINITE_CACHE` - `packages/next/src/server/use-cache/cache-life.ts:156` — only sets `explicitExpire` when `expire !== undefined` - `packages/next/src/server/use-cache/use-cache-wrapper.ts:477-479` — falls back to `defaultCacheLife.expire` (INFINITE_CACHE) --------- Co-authored-by: Joseph <joseph.chamochumbi@vercel.com>
Author
Parents
Loading