Formations — 1 037 leçons en français

Accueil › React › L'hydratation

L'hydratation

Rendu serveur et Next.jsavance

Le serveur a envoyé du HTML correct mais inerte : aucun bouton ne fonctionne. L'hydratation est l'étape où React y branche ses gestionnaires.

// CSR : React construit le DOM
createRoot(document.getElementById("root")).render(<App />);

// SSR : React adopte le DOM existant
hydrateRoot(document.getElementById("root"), <App />);

React ne reconstruit pas le HTML. Il le parcourt en parallèle de son propre arbre et y rattache les écouteurs.

La fenêtre d'inertie

HTML affiché ──────── JS téléchargé ── hydraté
     ↑                                    ↑
  visible                            interactif
     └──────── un clic ici est perdu ─────┘

C'est le défaut le plus concret du SSR : la page paraît prête. Plus il y a de JavaScript à hydrater, plus la fenêtre est longue.

L'écart d'hydratation

// ❌ le serveur et le client ne calculent pas la même chose
<p>{new Date().toLocaleTimeString()}</p>
<p>{Math.random()}</p>
<p>{localStorage.getItem("theme")}</p>     // 💥 pas de localStorage côté serveur

React compare, trouve l'écart, et refait le rendu de la zone concernée. On a payé le coût du SSR sans en toucher le bénéfice.

La correction

function Horloge() {
  const [heure, setHeure] = useState(null);      // identique des deux côtés

  useEffect(() => {
    setHeure(new Date().toLocaleTimeString());   // uniquement sur le client
  }, []);

  return <p>{heure ?? "—"}</p>;
}

On rend le même contenu neutre des deux côtés, puis on l'ajuste après l'hydratation.

Les termes à connaître

Hydratation

React parcourt le HTML reçu du serveur et y rattache ses gestionnaires d'événements, sans le reconstruire. La page devient interactive.

Fenêtre d'inertie

Entre l'affichage du HTML et la fin de l'hydratation, la page est visible mais ne répond pas. Un clic y est perdu.

Écart d'hydratation

Le HTML du serveur et le premier rendu du client diffèrent. React signale l'écart et refait le rendu, perdant le bénéfice du SSR sur cette partie.

suppressHydrationWarning

Dit à React qu'un écart est attendu sur cet élément. À réserver aux cas où il l'est réellement, comme une date formatée.

Hydratation sélective

React hydrate d'abord les parties avec lesquelles l'utilisateur interagit. Un clic pendant l'hydratation est pris en compte en priorité, pas perdu.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.