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.
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.