できない.dev

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 の項で説明している。