close

dev.liveReload

  • 类型: boolean | { html?: boolean }
  • 默认值: true

是否在源文件变更时自动刷新页面。

默认情况下,Rsbuild 会优先使用 HMR 来更新模块。当 HMR 功能被禁用,或者某些场景 HMR 无法生效时,会自动降级到 liveReload。

查看 模块热更新 来了解更多内容。

禁用 live reload

如果你需要禁用 live reload,可以将 dev.hmrdev.liveReload 同时设置为 false,此时页面不会发起 WebSocket 请求到 dev server,也不会在文件变更时自动刷新页面。

rsbuild.config.ts
export default {
  dev: {
    hmr: false,
    liveReload: false,
  },
};

选项

liveReload.html

  • 类型: boolean
  • 默认值: true

默认情况下,Rsbuild 会在 HTML 模板变更时触发整页刷新。

liveReload 为对象时,你可以将 liveReload.html 设为 false 来避免在 HTML 模板变更时触发整页刷新:

rsbuild.config.ts
export default {
  dev: {
    liveReload: {
      html: false,
    },
  },
};

版本历史

版本变更内容
v2.0.0新增 html 选项