SuperAPI AI 工具集

next-partial-prefetching-adoption

通用与其它

查看项目

更新于 10-16 07:21

技能介绍

本技能用于在 Next.js 应用中启用 Partial Prefetching,并逐步让每个链接复用共享 App Shell。启用后,指向某路由的链接会预取一个共享 App Shell,而 prefetch={true} 还能解析缓存的 URL 专属内容。采用过程分为多步:先审计 <Link prefetch={true}> 导航(保持全局标志关闭),再捕获旧行为基线,然后为已审计路由逐个采用 prefetch = 'partial' 并恢复目标 UI,接着在 next.config 中开启 partialPrefetching: true,并用 codemod 移除冗余的 prefetch = 'partial' 导出,最后进行 URL 数据洞察扫描。

前提条件:需先采用 Cache Components(cacheComponents: true)且构建通过,否则先使用 next-cache-components-adoption;需要 Next.js 16.3 或更高版本;需要一个可驱动的浏览器(测试保留使用生产模式的 Playwright 套件,手动保留和最终演示使用运行中的生产应用);需要一个可运行的应用,因为自动预取只在生产中运行。

主要能力与使用方式:将工作拆分为保留门禁、基线捕获、目的地采用、标志启用和洞察扫描。测试保留默认使用 @next/playwright 的 instant() 套件,先在关闭 partialPrefetching 的情况下让套件通过,再迁移。开发洞察只在 next dev 的 dev overlay 的 Insights 标签中显示,是非阻塞的琥珀色信号;记录在开发日志中,可用 next-dev-loop 驱动导航并读取 overlay。overlay 渲染在 shadow root(nextjs-portal)中,程序化读取需 evaluate 进 shadowRoot。

限制:当缓存调用树中存在 cookies()/headers()/session 读取时,next build 会通过但请求时会抛错,因此添加 use cache 后需在 next start 下验证。若应用被 webpack 固定,需直接用浏览器驱动。缺少适用生产套件时需按 rig-template.md 建立生产模式测试架;仅当存在仓库无法解决的具体阻塞时,才退回手动保留并记录阻塞与延后的测试覆盖。具体收费、价格等信息资料未提供。