Files
Andrew ClarkandGitHub bc48ef76ee Unify appShells flag with Partial Prefetching (#95415)
The experimental `appShells` flag was added while the feature was being
developed. It was not meant to be a public-facing flag.

Some of the behavior that was gated behind the `appShells` flag is
purely an optimization and can be landed without any gate.

There are also some behaviors that we don't want to turn on unless
you've opted into the new prefetching model via Partial Prefetching.
Arguably these too are internal optimizations, but because they can
change the number of requests that are made to the server (e.g. one
request for the shell, another for the page data), we will gate these
behind Partial Prefetching to minimize the impact on existing
applications.

The result is that until you opt into Partial Prefetching, you should
not see any meaningfully detrimental impact to prefetching costs,
regardless of how your app is structured.
2026-07-16 16:30:57 -04:00

273 lines
6.7 KiB
TypeScript

import { DebugLinkAccordion } from '../../components/link-accordion'
export default async function Page() {
return (
<main>
<h1>Home</h1>
<h2>directly in a page</h2>
<ul>
<li>
cookies + dynamic content
<ul>
<li>
<DebugLinkAccordion href="/in-page/cookies" prefetch />
</li>
</ul>
</li>
<li>
headers + dynamic content
<ul>
<li>
<DebugLinkAccordion href="/in-page/headers" prefetch />
</li>
</ul>
</li>
<li>
search params + dynamic content
<ul>
<li>
<DebugLinkAccordion
href="/in-page/search-params?searchParam=123"
prefetch
/>
</li>
<li>
<DebugLinkAccordion
href="/in-page/search-params?searchParam=456"
prefetch
/>
</li>
</ul>
</li>
<li>
dynamic params + dynamic content
<ul>
<li>
<DebugLinkAccordion href="/in-page/dynamic-params/123" prefetch />
</li>
<li>
<DebugLinkAccordion href="/in-page/dynamic-params/456" prefetch />
</li>
</ul>
</li>
<li>
only cookies
<ul>
<li>
<DebugLinkAccordion href="/in-page/cookies-only" prefetch />
</li>
</ul>
</li>
</ul>
<h2>
<code>use cache: private</code>
</h2>
<ul>
<li>
cookies in private cache + dynamic content
<ul>
<li>
<DebugLinkAccordion href="/in-private-cache/cookies" prefetch />
</li>
</ul>
</li>
<li>
headers in private cache + dynamic content
<ul>
<li>
<DebugLinkAccordion href="/in-private-cache/headers" prefetch />
</li>
</ul>
</li>
<li>
dynamic params in private cache + dynamic content
<ul>
<li>
<DebugLinkAccordion
href="/in-private-cache/dynamic-params/123"
prefetch
/>
</li>
<li>
<DebugLinkAccordion
href="/in-private-cache/dynamic-params/456"
prefetch
/>
</li>
</ul>
</li>
<li>
search params in private cache + dynamic content
<ul>
<li>
<DebugLinkAccordion
href="/in-private-cache/search-params?searchParam=123"
prefetch
/>
</li>
<li>
<DebugLinkAccordion
href="/in-private-cache/search-params?searchParam=456"
prefetch
/>
</li>
</ul>
</li>
<li>
only cookies in private cache
<ul>
<li>
<DebugLinkAccordion
href="/in-private-cache/cookies-only"
prefetch
/>
</li>
</ul>
</li>
<li>
Date.now() in private cache
<ul>
<li>
<DebugLinkAccordion href="/in-private-cache/date-now" prefetch />
</li>
</ul>
</li>
</ul>
<h2>
<code>runtime promise passed to public cache</code>
</h2>
<ul>
<li>
cookies() promise passed to public cache + dynamic content
<ul>
<li>
<DebugLinkAccordion
href="/passed-to-public-cache/cookies"
prefetch
/>
</li>
</ul>
</li>
<li>
headers() promise passed to public cache + dynamic content
<ul>
<li>
<DebugLinkAccordion
href="/passed-to-public-cache/headers"
prefetch
/>
</li>
</ul>
</li>
<li>
dynamic params promise passed to public cache + dynamic content
<ul>
<li>
<DebugLinkAccordion
href="/passed-to-public-cache/dynamic-params/123"
prefetch
/>
</li>
<li>
<DebugLinkAccordion
href="/passed-to-public-cache/dynamic-params/456"
prefetch
/>
</li>
</ul>
</li>
<li>
search params promise passed to public cache + dynamic content
<ul>
<li>
<DebugLinkAccordion
href="/passed-to-public-cache/search-params?searchParam=123"
prefetch
/>
</li>
<li>
<DebugLinkAccordion
href="/passed-to-public-cache/search-params?searchParam=456"
prefetch
/>
</li>
</ul>
</li>
<li>
only cookies passed to public cache (no dynamic content)
<ul>
<li>
<DebugLinkAccordion
href="/passed-to-public-cache/cookies-only"
prefetch
/>
</li>
</ul>
</li>
</ul>
<h2>short-lived caches</h2>
<ul>
<li>
private, short stale
<ul>
<li>
<DebugLinkAccordion href="/caches/private-short-stale" prefetch />
</li>
</ul>
</li>
<li>
public, short expire, long enough stale
<ul>
<li>
<DebugLinkAccordion
href="/caches/public-short-expire-long-stale"
prefetch
/>
</li>
</ul>
</li>
<li>
public, short expire, short stale
<ul>
<li>
<DebugLinkAccordion
href="/caches/public-short-expire-short-stale"
prefetch
/>
</li>
</ul>
</li>
<li>
public, cacheLife("seconds")
<ul>
<li>
<DebugLinkAccordion href="/caches/public-seconds" prefetch />
</li>
</ul>
</li>
<li>
private, cacheLife("seconds")
<ul>
<li>
<DebugLinkAccordion href="/caches/private-seconds" prefetch />
</li>
</ul>
</li>
</ul>
<h2>misc</h2>
<ul>
<li>
<DebugLinkAccordion href="/fully-static" prefetch />
</li>
</ul>
</main>
)
}