close
指南
配置
插件
API
博客
关于
贡献
指南
配置
插件
API
博客
关于
贡献
简体中文
CC 4.0 协议声明

本节内容派生于以下链接指向的内容 ，并遵守 CC BY 4.0 许可证的规定。

以下内容如果没有特殊声明，可以认为都是基于原内容的修改和删减后的结果。

InfrastructureLogging

控制基础架构级别的日志记录。一般用于与 Compilation 无关的日志。

infrastructureLogging.appendOnly

  • 类型： boolean

将内容逐行追加到输出中，而不更新现有的输出。这对状态消息非常有用。只有在未提供自定义 console 时才会使用此选项。

rspack.config.js
module.exports = {
  //...
  infrastructureLogging: {
    appendOnly: true,
    level: 'verbose',
  },
  plugins: [
    compiler => {
      const logger = compiler.getInfrastructureLogger('MyPlugin');
      logger.status('first output'); // 当启用 `appendOnly` 时，此行不会被覆盖
      logger.status('second output');
    },
  ],
};

infrastructureLogging.colors

  • 类型： boolean

基础架构级别的输出颜色。只有在未提供自定义 console 时才会使用此选项。

rspack.config.js
module.exports = {
  //...
  infrastructureLogging: {
    colors: true,
    level: 'verbose',
  },
  plugins: [
    compiler => {
      const logger = compiler.getInfrastructureLogger('MyPlugin');
      logger.log('this output will be colorful');
    },
  ],
};

infrastructureLogging.console

  • 类型： Console
  • 默认值： Console

自定义用于基础架构级别日志记录的控制台。

rspack.config.js
module.exports = {
  //...
  infrastructureLogging: {
    console: yourCustomConsole(),
  },
};

infrastructureLogging.debug

  • 类型： boolean | RegExp | function(name) => boolean | [string, RegExp, function(name) => boolean]
  • 默认值： 'false'

指定输出（如特定的插件或 loader）的调试信息。类似 stats.loggingDebug 选项，但适用于基础架构。默认为 false。

rspack.config.js
module.exports = {
  //...
  infrastructureLogging: {
    level: 'info',
    debug: ['MyPlugin', /MyPlugin/, name => name.contains('MyPlugin')],
  },
};

infrastructureLogging.level

  • 类型： 'none' | 'error' | 'warn' | 'info' | 'log' | 'verbose'
  • 默认值： 'info'

启用基础架构日志输出。类似于 stats.logging 选项，但适用于基础架构。默认为 'info'。

可能的值：

  • 'none' - 禁用日志记录
  • 'error' - 仅记录错误
  • 'warn' - 仅记录错误和警告
  • 'info' - 记录错误、警告和信息消息
  • 'log' - 记录错误、警告、信息消息、日志消息、组和清除。折叠的组以折叠状态显示。
  • 'verbose' - 记录除调试和跟踪以外的所有内容。折叠的组以扩展状态显示。
rspack.config.js
module.exports = {
  //...
  infrastructureLogging: {
    level: 'info',
  },
};

infrastructureLogging.stream

  • 类型： NodeJS.WritableStream
  • 默认值： process.stderr

用于日志记录输出的流。默认为 process.stderr。只有在未提供自定义 console 时才会使用此选项。

rspack.config.js
module.exports = {
  //...
  infrastructureLogging: {
    stream: process.stderr,
  },
};