Accueil › Angular › L'hydratation
L'hydratation
SSR, hydratation et SEOavance
Le SSR (leçon précédente) produit du HTML avant même que le JavaScript ne s'exécute côté client. Sans précaution supplémentaire, Angular démarre ensuite côté client exactement comme en CSR : il détruit ce DOM serveur et le recrée entièrement — un travail dupliqué, et souvent un flash visible à l'écran.
L'hydratation évite cela : Angular réutilise le DOM déjà présent, y rattache les écouteurs d'événements et son propre état interne, sans tout reconstruire. Elle s'active avec provideClientHydration() (déjà branché automatiquement par ng add @angular/ssr) :
import { bootstrapApplication, provideClientHydration, withEventReplay } from '@angular/platform-browser';
bootstrapApplication(App, {
providers: [provideClientHydration(withEventReplay())],
});
withEventReplay() capture les interactions utilisateur (clic, frappe) survenues avant que l'hydratation ne soit terminée, et les rejoue une fois l'application prête — un clic précoce sur un bouton « Ajouter au panier » n'est donc pas perdu.
Pour que l'hydratation fonctionne, le DOM produit côté client doit correspondre exactement à celui produit côté serveur. Une divergence (manipulation DOM directe, HTML invalide, valeur non déterministe comme Math.random() dans un template) déclenche une erreur d'hydratation (NG0500). ngSkipHydration permet de désactiver l'hydratation pour un composant précis en dernier recours, au prix d'une destruction/recréation classique de son DOM.
Les termes à connaître
- Hydratation
Processus qui, après un rendu SSR, réutilise le DOM déjà présent dans la page (au lieu de le détruire et de le recréer) et y rattache les gestionnaires d'événements et l'état interne d'Angular. Stable depuis l'introduction de l'hydratation non destructive.
- provideClientHydration()
Fonction de
@angular/platform-browserà ajouter aux providers de l'application pour activer l'hydratation côté client. Générée automatiquement parng add @angular/ssr. Se combine avec des fonctionnalités optionnelles :withEventReplay(),withI18nSupport(),withIncrementalHydration().- withEventReplay()
Fonctionnalité de
provideClientHydration()qui capture les événements utilisateur (clic, frappe…) survenus entre l'affichage du HTML serveur et la fin de l'hydratation, puis les rejoue une fois l'application prête — pour qu'un clic précoce ne soit jamais silencieusement perdu.- NG0500 (Hydration Node Mismatch)
Erreur levée quand la structure du DOM produite côté serveur diverge de celle attendue côté client lors de l'hydratation. Causes typiques : manipulation directe du DOM (
appendChild,innerHTML), HTML invalide, ou contenu non déterministe dans le template.- ngSkipHydration
Attribut (ou liaison d'hôte
host: { ngSkipHydration: 'true' }) qui désactive l'hydratation pour un composant précis et ses enfants : Angular détruit alors le DOM serveur de ce sous-arbre et le recrée entièrement côté client. Solution de dernier recours, pas une correction.- Transfert d'état HTTP (TransferState)
Mécanisme qui transmet au client les réponses HTTP déjà obtenues côté serveur pendant le rendu, pour que le client les réutilise au lieu de relancer les mêmes requêtes juste après le démarrage — évite une double requête serveur puis client pour les mêmes données.
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.