できない.dev

Hydration

別名: ハイドレーション / hydrate

サーバ側で生成した静的 HTML に対し、クライアント側で React などのフレームワークがイベントハンドラや状態を「後付け」して動的にする仕組み。

公開: 更新:

定義

Hydration(ハイドレーション) は、サーバが返した静的 HTML に対し、ブラウザ側で JavaScript フレームワークが状態やイベントハンドラを再構築して、ページをインタラクティブにする処理である。
直訳は「水を与える」で、乾いた HTML に動きを与えることをたとえている。

詳細

Next.js などの SSR / SSG では、ページの初回表示を高速にするため HTML をあらかじめ生成して送る。
ブラウザは何もしなくても文字や画像が見えるが、ボタンを押しても動かない。

そこに React の JS バンドルが届いて hydrateRoot() が走ると、サーバが生成した DOM ツリーをスキャンしながら、各ノードに onClick などのリスナーや state を結びつける。
この処理を Hydration と呼ぶ。

よくある誤解

  • クライアント側で再描画しているわけではない。
    サーバが作った DOM を「そのまま使う」ことが前提で、ノードを作り直すと逆に遅くなる。
  • 完全に透明な処理でもない。
    サーバとクライアントの出力が一致していないと Hydration mismatch が発生する。
    new Date() / Math.random() / typeof window 分岐などが典型的な原因になる。

関連

React Server Components や Streaming SSR では、Hydration の単位やタイミングが従来とは異なる(Selective Hydration、Progressive Hydration)。