CC 4.0 授權

本節內容衍生自以下連結的內容,並受 CC BY 4.0 授權條款約束。

除非另有說明,否則以下內容可假定為基於原始內容進行修改和刪除後的結果。

監看

Rspack 可以監看檔案,並在檔案變更時重新編譯。

watch

  • 類型: 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

  • 類型: RegExpstringstring[]

在監看時排除符合的路徑。

watchOptions.poll

  • 類型: booleannumber
  • 預設值: 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,
  },
};