其他配置#

这里展示了 Rspack 支持的其余配置项。

amd#

• 类型： false | object
• 默认值：false

开启此选项可以支持 AMD 模块的依赖分析，这对于兼容一些按照 AMD 规范编写的老旧库很有帮助。

export default {
  amd: {}, // 开启 AMD 模块的依赖分析
};

另外可以通过该配置设置 require.amd 或 define.amd 的值：

export default {
  amd: {
    jQuery: true, // require.amd 和 define.amd 被设置为 { jQuery: true }
  },
};

bail#

• 类型： boolean
• 默认值：false

遇到第一个错误时退出。Rspack 在默认情况下会在命令行以及在 HMR 时的浏览器 console 中打印这些错误，并且继续编译。

export default {
  bail: true,
};

这会强制 Rspack 终止编译流程。

dependencies#

• 类型： string[]
• 默认值：undefined

定义当前配置依赖的所有相邻配置的 name。依赖的配置需要先编译完成。

在 watch 模式下，当以下情况发生时，依赖关系将使编译器无效：

1. 依赖的配置已更改。
2. 依赖的配置正在编译中或无效。

请记住，当前配置在其依赖项完成之前不会编译。

export default [
  {
    name: 'client',
    target: 'web',
    // …
  },
  {
    name: 'server',
    target: 'node',
    dependencies: ['client'],
  },
];

ignoreWarnings#

• 类型： (RegExp | ((warning: Error, Compilation: Compilation) => boolean))[]
• 默认值：undefined

告知 Rspack 忽略特定的警告。

export default {
  //...
  ignoreWarnings: [/warning from compiler/, warning => true],
};

name#

• 类型： string
• 默认值：undefined

配置的名称。当加载多个配置时被使用。

export default {
  //...
  name: 'admin-app',
};

loader#

• 类型： Record<string, any>
• 默认值：undefined

将自定义值添加到 Loader 上下文。

如下示例在 Loader 上下问中定义了一个新变量 answer：

export default {
  // ...
  loader: {
    answer: 42,
  },
};

通过 this.answer 在 Loader 中获取该变量：

module.exports = function (source) {
  // ...
  console.log(this.answer); // 打印 `42`
  return source;
};

profile#

• 类型： boolean
• 默认值：undefined

捕获构建的分析和提示数据，供分析工具消费。它会尽可能详细的打印模块的耗时信息。