CC 4.0 协议声明

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

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

Watch

监听:该选项用于监听文件变更并在变更时触发重新编译。

watch

  • 类型: boolean
  • 默认值: false

开启监听模式,使 Rspack 在第一次构建完后不会退出,而是继续监听文件变更,并在变更时触发重新编译。

rspack.config.js
module.exports = {
  // ...
  watch: true,
};
TIP

在使用 @rspack/dev-server 时,watch 默认为 true。

watchOptions

  • 类型: object

监听模式相关的配置项。

rspack.config.js
module.exports = {
  // ...
  watchOptions: {
    ignored: /node_modules/,
    poll: true,
  },
};

watchOptions.aggregateTimeout

  • 类型: number
  • 默认值: 5

当第一个文件更改后,在触发 rebuild 前存在一个延迟时间,Rspack 会将这段时间内进行的任何其他更改都聚合到一次 rebuild 里。你可以通过这个选项来设置这个时间,以毫秒为单位:

rspack.config.js
module.exports = {
  //...
  watchOptions: {
    aggregateTimeout: 600,
  },
};

watchOptions.ignored

  • 类型: RegExp, string, string[]

监听时排除匹配到的路径。

watchOptions.poll

  • 类型: boolean, number
  • 默认值: false

是否通过轮询进行监听,true 时默认的轮询间隔为 5007 毫秒。

  • 类型: boolean

根据软链接查找文件。这通常是不需要的,因为 Rspack 已经使用 resolve.symlinks 解析了软链接。

rspack.config.js
module.exports = {
  //...
  watchOptions: {
    followSymlinks: true,
  },
};

watchOptions.stdin

  • 类型: boolean

当 stdin 流结束时停止监听。

rspack.config.js
module.exports = {
  //...
  watchOptions: {
    stdin: true,
  },
};