#废弃选项

本页面列出了 Rspack 中已被废弃的配置选项。

这些选项仅为向后兼容而保留，不应在新项目中使用。

#builtin:swc-loader 选项

#rspackExperiments.collectTypeScriptInfo

用于从 TypeScript 的 AST 中收集信息，以供 Rspack 后续过程进行消费。

{
  loader: 'builtin:swc-loader',
  options: {
-   rspackExperiments: {
-     collectTypeScriptInfo: {
-       exportedEnum: true,
-     },
-   },
+   collectTypeScriptInfo: {
+     exportedEnum: true,
+   },
  },
}

#experiments.topLevelAwait

• 类型： boolean
• 默认值： true

开启打包 Top-level await 的支持，Top-level await 仅能在 ModuleType 为 javascript/esm 的模块中使用。

默认开启，可通过该配置关闭：

export default {
  experiments: {
    topLevelAwait: false,
  },
};

#experiments.lazyCompilation

用于开启懒编译。

#experiments.layers

• 类型： boolean
• 默认值： true

控制是否启用 layer 功能，layer 可以为模块图中以一个模块作为起点的子图中的所有模块添加标识符前缀，用来与其他不同 layer 的模块进行区分，比如：

index.js 模块的 layer 为默认的 null，其 identifier 为 ./index.js，我们为其添加 layer = 'client'，其 identifier 会变成 (client)/./index.js，这时这两个不同 layer 的 index.js 会被区分为不同的模块，因为其唯一标识 identifier 不一样，最终产物中也会存在这两个模块的产物。

模块默认的 layer 为 null，模块默认会继承其父模块的 layer，你可以通过 entryOptions.layer 为一个入口模块添加 layer，也可以通过 module.rule[].layer 为匹配到的模块添加 layer，同时可以通过 module.rule[].issuerLayer 根据父模块的 layer 进行匹配。

export default {
  experiments: {
    layers: true,
  },
};

#experiments.parallelCodeSplitting

• 类型： boolean
• 默认值： false

开启后会启用新的多线程 code splitting 算法，如果你的项目中包含较多的动态引用，并且不包含循环 chunk，开启后可以显著降低 code splitting 阶段耗时。

export default {
  experiments: {
    parallelCodeSplitting: true,
  },
  optimization: {
    removeAvailableModules: true,
  },
};

#rules[].loaders

用于传递 Loader 包名与其选项的数组。

#experiments.inlineConst

• 类型： boolean
• 默认值： false

用于启用常量导出的跨模块内联优化实验性功能。

#experiments.inlineEnum

• 类型： boolean
• 默认值： false

用于启用 TypeScript 枚举的内联优化。

#experiments.lazyBarrel

• 类型： boolean
• 默认值： true

用于启用 barrel 文件的惰性编译优化，跳过无副作用的重导出模块中未使用的模块的构建。

#experiments.typeReexportsPresence

• 类型： boolean
• 默认值： false

用于启用类型重导出的错误容忍。

#module.parser.javascript.inlineConst

• 类型： boolean
• 默认值： false

用于控制是否在解析器中对常量导出执行跨模块内联优化。