CC 4.0 许可证

本节内容源自以下链接的内容,并受 CC BY 4.0 许可证的约束。

除非另有说明,以下内容可以被认为是基于原始内容进行修改和删除的结果。

观察

Rspack 可以观察文件并在它们发生更改时重新编译。

观察

  • 类型: boolean
  • 默认值: false

打开观察模式。这意味着在初始构建之后,Rspack 将继续观察所有已解析文件的更改。

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

@rspack/dev-server 中,观察模式默认启用。

watchOptions

  • 类型: object

一组用于自定义观察模式的选项。

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

watchOptions.aggregateTimeout

  • 类型: number
  • 默认值: 5

在第一个文件发生更改后添加重建延迟。这允许 Rspack 将在此期间内进行的任何其他更改汇总到一次重建中。以毫秒为单位传递一个值。

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,
  },
};