HMR (Hot Module Replacement)
別名: Hot Module Replacement / ホットモジュールリプレースメント
アプリを動かしたまま、変更のあったモジュールだけを差し替える開発サーバーの仕組み。
ページ全体を再読み込みしないので状態が残る。
公開:
定義
HMR (Hot Module Replacement) は、アプリケーションを実行したまま、変更のあったモジュールだけを追加・置換・削除する開発時の仕組みである。
ページ全体をリロードしないため、入力途中のフォームや開いているモーダルといった実行中の状態が保たれたまま、変更が画面に反映される。
詳細
開発サーバーはファイルの変更を監視し、差分を WebSocket などでブラウザへ送る。
ブラウザ側のランタイムは受け取ったモジュールを差し替え、そのモジュールが用意した更新ハンドラを呼ぶ。
Vite では import.meta.hot、webpack では module.hot がその API にあたる。
CSS はローダー側が HMR に対応しているため、ほとんど設定なしで差し替わる。
一方 JavaScript では、更新を受け入れる側のコードが必要になる。
React や Vue では各フレームワークのプラグインがこれを肩代わりするので、利用者が直接書く機会は多くない。
よくある誤解
- HMR はホットリロードと同じものではない。
ページ全体を再読み込みするライブリロードでは状態が消えるが、HMR は差し替えなので状態が残る。 - HMR が効いていても、常に最新の設定が反映されるわけではない。
vite.config.tsや.envのように読み込みが起動時に限られるファイルは対象外で、開発サーバーの再起動が必要になる。
関連
反映されないときの原因は Vite で HMR (Hot Module Replacement) が反映されない、モジュール形式の前提は ESM の項で説明している。