NNext.js 中文网 GitHub

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 nextConfig
next.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 nextConfig
next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    prefetchInlining: {
      maxSize: 2048,
      maxBundleSize: 10240,
    },
  },
}

module.exports = nextConfig

参考#

值描述
true使用默认阈值内联预取响应。这是默认值。
false禁用预取内联。每个路由段都作为单独的请求预取。
object使用您设置的 maxSize 或 maxBundleSize 内联预取响应。

传入对象时,以下选项用于控制阈值。两者都以 gzip 压缩后的路由段响应的字节数计量:

选项类型默认值描述
maxSizenumber2048单个路由段响应仍符合内联条件的最大大小。
maxBundleSizenumber10240沿某一路径可内联到单个打包预取响应中的最大总大小。

较低的阈值可保留更多按路由段进行的去重;较高的阈值会内联更多数据,并进一步减少请求数量。

版本历史#

版本变更
16.3.0experimental.prefetchInlining 默认启用。
16.2.0新增 experimental.prefetchInlining。
Next.js 中文网