Hot Module Replacement (HMR) exchanges, adds, or removes modules while an application is running, without a full reload. This can significantly speed up development in a few ways:
Rsbuild has built-in support for HMR, which is enabled by default during development.
If you do not need to use HMR, you can set dev.hmr to false
. This will disable HMR and react-refresh will, and Rsbuild will automatically fallback to dev.liveReload.
If you need to disable both HMR and liveReload, you can set both dev.hmr and dev.liveReload to false
. Then, no Web Socket requests will be made to the dev server on the page, and the page will not automatically refresh when files change.
By default, Rsbuild uses the host and port number of the current page to splice the WebSocket URL of HMR.
When the HMR connection fails, you can specify the WebSocket URL by customizing dev.client
configuration.
The default config are as follows, Rsbuild will automatically deduce the URL of the WebSocket request according to the current location:
WHen you proxy an online site for local development, WebSocket requests will fail to connect. You can try configuring dev.client
to the following values so that HMR requests can reach the local Dev Server.
Please refer to HMR FAQ.