prefetchInlining
experimental
覆盖 App Router 将较小的预取响应打包在一起的方式。
当 App Router 预取某个路由时,它可以将较小的路由段响应打包到单个响应中,而不是分别请求每一个。这样可以减少预取请求的数量,代价是在不同路由之间重复一些共享的路由段数据。此行为默认开启,大多数应用应保持默认设置。
experimental.prefetchInlining 选项可让您覆盖此行为,或在调试导航问题、测量请求量时禁用内联。对大多数应用而言,无需更改默认行为。
小知识:内联行为是 App Router 的永久组成部分。只有
experimental.prefetchInlining配置是实验性的,因此其选项仍可能变化。
用法#
要关闭预取内联,请将 experimental.prefetchInlining 设为 false:
next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
experimental: {
prefetchInlining: false,
},
}
export default nextConfignext.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
prefetchInlining: false,
},
}
module.exports = nextConfig要覆盖阈值而不是禁用内联,请传入一个对象。您省略的任何值都将保留其默认值:
next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
experimental: {
prefetchInlining: {
maxSize: 2048,
maxBundleSize: 10240,
},
},
}
export default nextConfignext.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
prefetchInlining: {
maxSize: 2048,
maxBundleSize: 10240,
},
},
}
module.exports = nextConfig参考#
| 值 | 描述 |
|---|---|
true | 使用默认阈值内联预取响应。这是默认值。 |
false | 禁用预取内联。每个路由段都作为单独的请求预取。 |
object | 使用您设置的 maxSize 或 maxBundleSize 内联预取响应。 |
传入对象时,以下选项用于控制阈值。两者都以 gzip 压缩后的路由段响应的字节数计量:
| 选项 | 类型 | 默认值 | 描述 |
|---|---|---|---|
maxSize | number | 2048 | 单个路由段响应仍符合内联条件的最大大小。 |
maxBundleSize | number | 10240 | 沿某一路径可内联到单个打包预取响应中的最大总大小。 |
较低的阈值可保留更多按路由段进行的去重;较高的阈值会内联更多数据,并进一步减少请求数量。
版本历史#
| 版本 | 变更 |
|---|---|
| 16.3.0 | experimental.prefetchInlining 默认启用。 |
| 16.2.0 | 新增 experimental.prefetchInlining。 |