performance.prefetch
- 类型：
undefined | true | PrefetchOptions
- 默认值：
undefined
为 Rsbuild 构建生成的静态资源注入 <link rel="prefetch"> 标签。
什么是 prefetch
<link> 元素的 rel 属性中的 prefetch 关键字是为了提示浏览器，用户未来的浏览有可能需要加载目标资源，所以浏览器有可能通过事先获取和缓存对应资源，优化用户体验。
启用 prefetch
当设置 performance.prefetch 为 true 时，Rsbuild 将使用以下默认选项，对资源进行预获取，这表示 prefetch 当前页面的所有异步资源，包含异步 JS 及其关联的 CSS、image、font 等资源。
在 Rsbuild 配置中启用 prefetch：
rsbuild.config.ts
比如，在入口文件中动态引入了其他模块：
index.js
在 HTML 中注入的标签为：
手动注入
performance.prefetch 只能为 Rsbuild 构建生成的静态资源注入 prefetch 标签，如果你需要 prefetch 其他资源，可以通过 html.tags 手动添加标签：
rsbuild.config.ts
注入的 HTML 标签如下：
选项
performance.prefetch 可以设置为一个对象来指定选项。
prefetch.type
- 类型：
'async-chunks' | 'initial' | 'all-assets' | 'all-chunks' - 默认值：
'async-chunks'
指定哪些类型的资源会被包含，目前支持的值如下：
async-chunks: 包含当前页面的所有异步资源，比如异步的 JS chunks，以及它关联的 CSS、image、font 等静态资源。initial: 包含当前页面的所有非异步资源。all-chunks: 包含当前页面的所有异步和非异步资源。all-assets: 包含所有页面的所有资源。
例如，为了包含当前页面中所有 png 图片，可以配置为：
rsbuild.config.ts
TIP
如果一个脚本已通过 HTML <script> 标签直接引入，则不会对其进行 prefetch。
prefetch.include
- 类型：
- 默认值：
undefined
一个额外的过滤器，用于指定哪些资源会被包含。
- 当
include为一个正则表达式时，它会被直接用于匹配文件名：
rsbuild.config.ts
- 当
include为一个字符串时，它会被转换为正则表达式来匹配文件名：
rsbuild.config.ts
- 当
include为函数时，它会被调用并传入文件名作为参数：
rsbuild.config.ts
- 当
include为一个数组时，它可以包含多个过滤器，文件名只要匹配任何一个过滤器都会被包含：
rsbuild.config.ts
prefetch.exclude
- 类型：
- 默认值：
undefined
一个额外的过滤器，用于指定哪些资源会被排除，用法与 include 类似。