Docs: Description of client-side cache time

[AkifumiSato]

What is the improvement or update you wish to see?

I would like to see a description of when the client-side cache is reused and when it is expired.

Is there any context that might help us understand?

next.js/packages/next/src/client/components/router-reducer/get-prefetch-cache-entry-status.ts

Lines 18 to 39 in 9028a16

	// if the cache entry was prefetched or read less than 30s ago, then we want to re-use it
	if (Date.now() < (lastUsedTime ?? prefetchTime) + THIRTY_SECONDS) {
	return lastUsedTime
	? PrefetchCacheEntryStatus.reusable
	: PrefetchCacheEntryStatus.fresh
	}
	// if the cache entry was prefetched less than 5 mins ago, then we want to re-use only the loading state
	if (kind === 'auto') {
	if (Date.now() < prefetchTime + FIVE_MINUTES) {
	return PrefetchCacheEntryStatus.stale
	}
	}
	// if the cache entry was prefetched less than 5 mins ago and was a "full" prefetch, then we want to re-use it "full
	if (kind === 'full') {
	if (Date.now() < prefetchTime + FIVE_MINUTES) {
	return PrefetchCacheEntryStatus.reusable
	}
	}
	return PrefetchCacheEntryStatus.expired

Does the docs page already exist? Please link to it.

https://nextjs.org/docs/app/building-your-application/routing/linking-and-navigating#client-side-caching-of-rendered-server-components

[wscotten]

This would be extremely helpful to document explicitly. Having to dive into the code to see that it is 30 seconds is silly.

[AkifumiSato]

Close as the document has been added.
#52514

[github-actions]

This closed issue has been automatically locked because it had no new activity for 2 weeks. If you are running into a similar issue, please create a new issue with the steps to reproduce. Thank you.