Skip to content

docs: runtime prefetching -> optimizing prefetching - #96934

Draft
icyJoseph wants to merge 3 commits into
canaryfrom
docs/optimizing-prefetching
Draft

docs: runtime prefetching -> optimizing prefetching#96934
icyJoseph wants to merge 3 commits into
canaryfrom
docs/optimizing-prefetching

Conversation

@icyJoseph

@icyJoseph icyJoseph commented Aug 7, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

With the latest GA changes, when using Cache Components with Partial Prefetching:

prefetch={true} turns on prefetching

These changes try to align around that idea.

  • runtime prefetching guide is now about optimizing
  • various changes in prose across docs
  • even fix an error page for pages router, which had a broad title

@github-actions

github-actions Bot commented Aug 7, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Failing test suites

Commit: 60da1c3 | About building and testing Next.js

pnpm test-dev test/development/acceptance-app/rsc-build-errors-poisoned-imports.test.ts (job)

  • Error overlay - RSC build errors > should error when catchError from next/error is imported in proxy.js (DD)
Expand output

● Error overlay - RSC build errors › should error when catchError from next/error is imported in proxy.js

Expected Redbox but found no visible one.

  124 |
  125 |       const { session } = sandbox
> 126 |       await session.waitForRedbox()
      |       ^
  127 |       expect(await session.getRedboxSource()).toInclude(
  128 |         'You\'re importing a module that depends on `catchError` into a React Server Component module. This API is only available in Client Components. To fix, mark the file (or its parent) with the `"use client"` directive.'
  129 |       )

  at development/acceptance-app/rsc-build-errors-poisoned-imports.test.ts:126:7

@github-actions

github-actions Bot commented Aug 7, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Stats from current PR

✅ No significant changes detected

📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 765ms 812ms ✓ █▁▂▂▂
Cold (Ready in log) 768ms 787ms ✓ █▁▁▁▂
Cold (First Request) 1.290s 1.293s ✓ █▁▁▁▂
Warm (Listen) 813ms 812ms ✓ █▁▂▂▂
Warm (Ready in log) 786ms 783ms ✓ █▁▁▁▂
Warm (First Request) 1.294s 1.276s ✓ █▁▁▁▂
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 812ms 811ms ✓ █▁███
Cold (Ready in log) 776ms 777ms ✓ ▅▂▅█▄
Cold (First Request) 3.365s 3.354s ✓ ▅▄▆█▃
Warm (Listen) 812ms 811ms ✓ █▁███
Warm (Ready in log) 781ms 775ms ✓ ▄▁▆▅▅
Warm (First Request) 3.369s 3.302s ✓ ▃▂▆▆▂

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 5.518s 5.748s ✓ █▁▂▁▃
Cached Build 2.854s 2.925s ✓ █▁▁▁▄
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 24.014s 24.072s ✓ ▂▅▄▄▄
Cached Build 24.018s 24.094s ✓ ▁▂▅▃▄
node_modules Size 553 MB 553 MB ✓ █████
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
07jdby0ue616s.js gzip 450 B N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB ✓
0im0vz0lo815s.js gzip 8.77 kB N/A -
0mhgqgnwke2ly.js gzip 157 B N/A -
0rci1f3or1a19.js gzip 13.3 kB N/A -
0vvgkp57zpfgd.js gzip 159 B N/A -
133405p6ewydx.js gzip 10 kB N/A -
14cc00_n9zs8k.js gzip 156 B N/A -
17p50_vq5-xc5.js gzip 8.71 kB N/A -
19xzn89g-pvj8.js gzip 9.45 kB N/A -
1c1wxc9_-vy_e.js gzip 158 B N/A -
1elt1qium-r2m.css gzip 115 B 115 B ✓
1ey-k8tr3q-bs.js gzip 10.6 kB N/A -
1k4lgcmwwg4hq.js gzip 155 B N/A -
1t0gxseet6rkl.js gzip 158 B N/A -
1tf1phijqlx9j.js gzip 220 B 220 B ✓
1wd1e9uuc4euy.js gzip 8.76 kB N/A -
1yxn3i6a40rcg.js gzip 157 B N/A -
2-w5wamautz2c.js gzip 65.6 kB N/A -
203768r3plkuz.js gzip 153 B N/A -
219oe54sobbj5.js gzip 8.81 kB N/A -
22alyybqz5_09.js gzip 3.57 kB N/A -
22wf46m76ktxw.js gzip 159 B N/A -
28p1njha-2ovo.js gzip 13.6 kB N/A -
2b-nvb0ybzif_.js gzip 8.7 kB N/A -
2j5mn0ng9x-8y.js gzip 71.5 kB N/A -
2n4u-h4qpegt-.js gzip 169 B N/A -
2oks0a7s7ajem.js gzip 10.3 kB N/A -
2ufosov1toup-.js gzip 157 B N/A -
31r35oy32u7ag.js gzip 46.7 kB N/A -
38-q43pzktqhs.js gzip 1.46 kB N/A -
3fw39x1tg924h.js gzip 8.79 kB N/A -
3kfiy2dr7a5m3.js gzip 5.72 kB N/A -
3l2c-qzlafpi-.js gzip 8.78 kB N/A -
3m64-4oqpxh9f.js gzip 157 B N/A -
3mrwxzed0ylgv.js gzip 13.1 kB N/A -
3rdf0zyd2dgxs.js gzip 8.76 kB N/A -
3tfvhhy7vbzhb.js gzip 157 B N/A -
41jfc8g2x7su6.js gzip 7.54 kB N/A -
41u5s3oe2-erp.js gzip 2.29 kB N/A -
turbopack-07..49nq.js gzip 3.87 kB N/A -
turbopack-0h..mzs8.js gzip 3.86 kB N/A -
turbopack-12..4sxb.js gzip 3.86 kB N/A -
turbopack-18..a0wp.js gzip 3.86 kB N/A -
turbopack-1k..sy8-.js gzip 3.86 kB N/A -
turbopack-1l..dz4k.js gzip 3.86 kB N/A -
turbopack-1v..vk8d.js gzip 3.86 kB N/A -
turbopack-2_..1f58.js gzip 3.86 kB N/A -
turbopack-29..7o98.js gzip 3.86 kB N/A -
turbopack-2d..r8zj.js gzip 3.84 kB N/A -
turbopack-2d..xiuu.js gzip 3.86 kB N/A -
turbopack-2j..stgx.js gzip 3.86 kB N/A -
turbopack-2p..4-e8.js gzip 3.86 kB N/A -
turbopack-3r..qqhu.js gzip 3.86 kB N/A -
0b3yd3wyn3bfz.js gzip N/A 155 B -
0b87lr4cig17b.js gzip N/A 8.75 kB -
0e1qkafcsotw-.js gzip N/A 8.7 kB -
0j64ls9v56hnd.js gzip N/A 3.56 kB -
0jwho9fkrb_t3.js gzip N/A 2.29 kB -
0masaz6qt9sws.js gzip N/A 10 kB -
0n2f4y98eckf4.js gzip N/A 8.78 kB -
0r_tfwh185cwx.js gzip N/A 155 B -
1234ksg9gdne_.js gzip N/A 8.77 kB -
17oe55cu76cd7.js gzip N/A 450 B -
18ehgajg6-37l.js gzip N/A 46.7 kB -
1hi2ytaglt1ta.js gzip N/A 155 B -
1ko45a632uro6.js gzip N/A 8.79 kB -
1ovh5czvtp9dc.js gzip N/A 157 B -
1tn3m9f3j0cu6.js gzip N/A 152 B -
1u5hjpgv9qkjy.js gzip N/A 9.45 kB -
2d_wvcq8ytz-8.js gzip N/A 71.5 kB -
2dt81h56uyprs.js gzip N/A 8.75 kB -
2g2f64lmg3m7w.js gzip N/A 5.73 kB -
2lpk5_hknut8q.js gzip N/A 13.1 kB -
2ugc69z0t0ypz.js gzip N/A 1.46 kB -
2uile-vrx5c0g.js gzip N/A 8.81 kB -
2xhyauod8lfuk.js gzip N/A 8.71 kB -
2z-2x1ptpwnb3.js gzip N/A 10.3 kB -
33mvbyt1q5m2m.js gzip N/A 156 B -
36lwn7padaock.js gzip N/A 65.6 kB -
3cqsjdnv36mdd.js gzip N/A 157 B -
3i1epwuzay7-v.js gzip N/A 154 B -
3l44kpbwzy-2x.js gzip N/A 154 B -
3oqnzh8zgdxwz.js gzip N/A 168 B -
3rodp-hyqw7n0.js gzip N/A 13.6 kB -
3t7v1ffjrnh9r.js gzip N/A 7.55 kB -
3tep4rtbo0q4_.js gzip N/A 159 B -
3wo9xxs3t0k6j.js gzip N/A 153 B -
3y9tus7kb5su0.js gzip N/A 13.3 kB -
408odw3u2fa2k.js gzip N/A 151 B -
40fek9ngcsppd.js gzip N/A 10.6 kB -
turbopack-03..8ax0.js gzip N/A 3.86 kB -
turbopack-0c..kifv.js gzip N/A 3.84 kB -
turbopack-0c..ok82.js gzip N/A 3.86 kB -
turbopack-0i..7bx5.js gzip N/A 3.86 kB -
turbopack-0l..y18s.js gzip N/A 3.88 kB -
turbopack-0n..gnae.js gzip N/A 3.86 kB -
turbopack-1c..vddi.js gzip N/A 3.86 kB -
turbopack-1h..o38f.js gzip N/A 3.86 kB -
turbopack-1z..3wmx.js gzip N/A 3.86 kB -
turbopack-2r..3ggg.js gzip N/A 3.86 kB -
turbopack-2z..cfkn.js gzip N/A 3.86 kB -
turbopack-3i..ian3.js gzip N/A 3.86 kB -
turbopack-3j..toh0.js gzip N/A 3.86 kB -
turbopack-3l..yym7.js gzip N/A 3.86 kB -
Total 451 kB 451 kB ✅ -14 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 775 B 778 B ✓
Total 775 B 778 B ⚠️ +3 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 434 B 431 B ✓
Total 434 B 431 B ✅ -3 B
Build Cache
Canary PR Change
00000001.sst gzip 12.2 MB 12 MB 🟢 230 kB (-2%)
00000002.sst gzip 14.1 MB 13.5 MB 🟢 569 kB (-4%)
00000003.sst gzip 15.7 MB 13.7 MB 🟢 1.95 MB (-12%)
00000004.sst gzip 13.2 MB 15.9 MB 🔴 +2.73 MB (+21%)
00000005.sst gzip 10.2 MB 2.81 MB 🟢 7.39 MB (-72%)
00000006.sst gzip 2.81 MB 10.2 MB 🔴 +7.44 MB (+265%)
00000007.sst gzip 59 B 59 B ✓
00000008.meta gzip 89 B 89 B ✓
00000009.meta gzip 298 kB 298 kB ✓
00000010.meta gzip 298 kB 298 kB ✓
00000011.meta gzip 298 kB 298 kB ✓
00000012.sst gzip 50.9 kB 51.5 kB 🔴 +656 B (+1%)
00000013.sst gzip 1.87 MB 1.85 MB 🟢 17.5 kB (-1%)
00000014.sst gzip 59 B 59 B ✓
00000015.meta gzip 116 B 116 B ✓
00000016.meta gzip 325 kB 325 kB ✓
00000017.meta gzip 405 kB 405 kB ✓
00000018.sst gzip 51.6 kB 52.2 kB 🔴 +551 B (+1%)
00000019.sst gzip 1.37 MB 1.41 MB 🔴 +33 kB (+2%)
00000020.sst gzip 59 B 59 B ✓
00000021.meta gzip 116 B 116 B ✓
00000022.meta gzip 325 kB 325 kB ✓
00000023.meta gzip 371 kB 371 kB ✓
00000024.sst gzip 51.7 kB 52.3 kB 🔴 +639 B (+1%)
00000025.sst gzip 1.37 MB 1.4 MB 🔴 +32.8 kB (+2%)
00000026.sst gzip 59 B 59 B ✓
00000027.meta gzip 116 B 116 B ✓
00000028.meta gzip 325 kB 325 kB ✓
00000029.meta gzip 371 kB 371 kB ✓
00000030.sst gzip 50.9 kB 51.7 kB 🔴 +782 B (+2%)
00000031.sst gzip 1.37 MB 1.4 MB 🔴 +32.8 kB (+2%)
00000032.sst gzip 59 B 59 B ✓
00000033.meta gzip 116 B 116 B ✓
00000034.meta gzip 325 kB 325 kB ✓
00000035.meta gzip 371 kB 371 kB ✓
00000036.sst gzip 51.5 kB 52.1 kB 🔴 +597 B (+1%)
00000037.sst gzip 1.37 MB 1.4 MB 🔴 +32.8 kB (+2%)
00000038.sst gzip 59 B 59 B ✓
00000039.meta gzip 116 B 116 B ✓
00000040.meta gzip 325 kB 325 kB ✓
00000041.meta gzip 371 kB 371 kB ✓
CURRENT gzip 24 B 24 B ✓
LOG gzip 669 B 672 B ✓
Total 80.2 MB 80.3 MB ⚠️ +150 kB

📦 Webpack

Client

Main Bundles
Canary PR Change
3322-HASH.js gzip 65.7 kB N/A -
4191.HASH.js gzip 169 B N/A -
7920-HASH.js gzip 4.67 kB N/A -
9784-HASH.js gzip 5.63 kB N/A -
b1ad9f4c-HASH.js gzip 63.2 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB ✓
main-app-HASH.js gzip 253 B 253 B ✓
main-HASH.js gzip 40.1 kB 40.1 kB ✓
webpack-HASH.js gzip 1.68 kB 1.68 kB ✓
3577.HASH.js gzip N/A 168 B -
578-HASH.js gzip N/A 66.4 kB -
8590-HASH.js gzip N/A 5.6 kB -
9750-HASH.js gzip N/A 4.68 kB -
a8984546-HASH.js gzip N/A 63.2 kB -
Total 241 kB 242 kB ⚠️ +652 B
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB ✓
Total 39.4 kB 39.4 kB ✓
Pages
Canary PR Change
_app-HASH.js gzip 194 B 193 B ✓
_error-HASH.js gzip 181 B 182 B ✓
css-HASH.js gzip 334 B 331 B ✓
dynamic-HASH.js gzip 1.81 kB 1.81 kB ✓
edge-ssr-HASH.js gzip 255 B 253 B ✓
head-HASH.js gzip 349 B 351 B ✓
hooks-HASH.js gzip 382 B 384 B ✓
image-HASH.js gzip 581 B 582 B ✓
index-HASH.js gzip 260 B 259 B ✓
link-HASH.js gzip 2.48 kB 2.48 kB ✓
routerDirect..HASH.js gzip 317 B 318 B ✓
script-HASH.js gzip 384 B 386 B ✓
withRouter-HASH.js gzip 316 B 315 B ✓
1afbb74e6ecf..834.css gzip 106 B 106 B ✓
Total 7.95 kB 7.95 kB ⚠️ +1 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 129 kB 128 kB ✓
page.js gzip 294 kB 295 kB ✓
Total 423 kB 423 kB ⚠️ +629 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 615 B 619 B ✓
middleware-r..fest.js gzip 156 B 156 B ✓
middleware.js gzip 45.7 kB 45.5 kB ✓
edge-runtime..pack.js gzip 842 B 842 B ✓
Total 47.3 kB 47.1 kB ✅ -243 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 718 B 718 B ✓
Total 718 B 718 B ✓
Build Cache
Canary PR Change
0.pack gzip 4.8 MB 4.8 MB 🟢 5.07 kB (0%)
index.pack gzip 124 kB 122 kB 🟢 2.24 kB (-2%)
index.pack.old gzip 122 kB 123 kB ✓
Total 5.05 MB 5.04 MB ✅ -6.4 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 375 kB 375 kB ✓
app-page-exp..prod.js gzip 207 kB 207 kB ✓
app-page-tur...dev.js gzip 374 kB 374 kB ✓
app-page-tur..prod.js gzip 207 kB 207 kB ✓
app-page-tur...dev.js gzip 370 kB 370 kB ✓
app-page-tur..prod.js gzip 205 kB 205 kB ✓
app-page.run...dev.js gzip 371 kB 371 kB ✓
app-page.run..prod.js gzip 205 kB 205 kB ✓
app-route-ex...dev.js gzip 83.3 kB 83.3 kB ✓
app-route-ex..prod.js gzip 56.4 kB 56.4 kB ✓
app-route-tu...dev.js gzip 83.3 kB 83.3 kB ✓
app-route-tu..prod.js gzip 56.4 kB 56.4 kB ✓
app-route-tu...dev.js gzip 82.9 kB 82.9 kB ✓
app-route-tu..prod.js gzip 56.2 kB 56.2 kB ✓
app-route.ru...dev.js gzip 82.8 kB 82.8 kB ✓
app-route.ru..prod.js gzip 56.2 kB 56.2 kB ✓
dev-validati...dev.js gzip 133 kB 133 kB ✓
dev-validati...dev.js gzip 133 kB 133 kB ✓
dev-validati...dev.js gzip 131 kB 131 kB ✓
dev-validati...dev.js gzip 131 kB 131 kB ✓
dist_client_...dev.js gzip 324 B 324 B ✓
dist_client_...dev.js gzip 326 B 326 B ✓
dist_client_...dev.js gzip 318 B 318 B ✓
dist_client_...dev.js gzip 317 B 317 B ✓
pages-api-tu...dev.js gzip 46 kB 46 kB ✓
pages-api-tu..prod.js gzip 34.3 kB 34.3 kB ✓
pages-api.ru...dev.js gzip 46 kB 46 kB ✓
pages-api.ru..prod.js gzip 34.3 kB 34.3 kB ✓
pages-turbo....dev.js gzip 54.8 kB 54.8 kB ✓
pages-turbo...prod.js gzip 39.9 kB 39.9 kB ✓
pages.runtim...dev.js gzip 54.8 kB 54.8 kB ✓
pages.runtim..prod.js gzip 39.9 kB 39.9 kB ✓
server.runti..prod.js gzip 67 kB 67 kB ✓
use-cache-pr...dev.js gzip 72.3 kB 72.3 kB ✓
use-cache-pr...dev.js gzip 72.4 kB 72.4 kB ✓
use-cache-pr...dev.js gzip 70.6 kB 70.6 kB ✓
use-cache-pr...dev.js gzip 70.6 kB 70.6 kB ✓
Total 4.1 MB 4.1 MB ✓
📎 Tarball URL 
https://vercel-packages.vercel.app/next/commits/60da1c356d380e93b8b70e75b4f4ef0f1408c4a3/next

Commit: 60da1c3

@github-actions

github-actions Bot commented Aug 7, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

All broken links are now fixed, thank you!

vercel[bot]
vercel Bot reviewed Aug 7, 2026
View reviewed changes

@vercel vercel Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Additional Suggestion:

Three in-page links still point to the removed #runtime-prefetching anchor after the section heading was renamed to ### Prefetching, producing dead links.

Fix on Vercel

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@vercel vercel[bot] vercel[bot] left review comments

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@icyJoseph