Accueil › Angular › Le rendu côté serveur : principes et mise en place
Le rendu côté serveur : principes et mise en place
SSR, hydratation et SEOavance
Le SSR (Server-Side Rendering) fait exécuter Angular une première fois sur un serveur Node, à chaque requête, pour produire du HTML déjà rempli — au lieu du HTML quasiment vide envoyé en CSR (Client-Side Rendering), qui attend le téléchargement et l'exécution du JavaScript pour afficher quoi que ce soit. Deux bénéfices concrets : un premier affichage plus rapide, surtout sur un réseau lent ou un appareil peu puissant, et un contenu directement présent dans la réponse HTML pour les robots d'indexation qui n'exécutent pas (ou mal) le JavaScript.
Le SSR se distingue du prérendu (SSG) : le SSR régénère le HTML à chaque requête (données à jour, mais un serveur Node à faire tourner), le prérendu le fait une seule fois au build (rapide et sans serveur à l'exécution, mais des données figées). Le choix se fait page par page (approfondi en leçon 4).
Mise en place : ng new --ssr pour un nouveau projet, ou ng add @angular/ssr sur un projet existant. Cela génère main.server.ts, server.ts et app.config.server.ts, et ajoute provideServerRendering() aux providers serveur.
// app.config.server.ts
import { mergeApplicationConfig, ApplicationConfig } from '@angular/core';
import { provideServerRendering, withRoutes } from '@angular/ssr';
import { appConfig } from './app.config';
import { serverRoutes } from './app.routes.server';
const serverConfig: ApplicationConfig = {
providers: [provideServerRendering(withRoutes(serverRoutes))],
};
export const config = mergeApplicationConfig(appConfig, serverConfig);
Côté serveur, window et document n'existent pas : tout code qui y accède directement doit être protégé avec isPlatformBrowser(inject(PLATFORM_ID)), ou déplacé dans afterNextRender().
Les termes à connaître
- SSR (Server-Side Rendering)
Rendu de l'application sur un serveur Node, à chaque requête : le serveur exécute Angular, produit le HTML correspondant à l'état courant, et l'envoie déjà rempli au navigateur — avant même que le JavaScript de l'application soit téléchargé.
- CSR (Client-Side Rendering)
Mode par défaut d'une application Angular sans SSR : le navigateur télécharge une page HTML quasiment vide, puis exécute le JavaScript de l'application pour générer tout le contenu. Le premier affichage attend la fin du téléchargement et de l'exécution du bundle.
- SSG (Static Site Generation) / Prérendu
Rendu effectué une seule fois, au moment du build, pour une liste de routes connues à l'avance : le résultat est un fichier HTML statique par route, servable sans serveur Node à l'exécution. Voir
RenderMode.Prerender(leçon 4).- provideServerRendering()
Fonction de
@angular/ssrà ajouter aux providers de la configuration serveur de l'application pour activer le rendu côté serveur. S'utilise typiquement avecwithRoutes(serverRoutes)pour préciser le mode de rendu de chaque route.- BootstrapContext
Type introduit en Angular 21 :
bootstrapApplication()reçoit désormais, côté serveur, un troisième argument de ce type dansmain.server.ts. Un schematic de migration automatique adapte ce fichier lors d'unng updatevers v21.- PLATFORM_ID / isPlatformBrowser()
PLATFORM_ID(jeton d'injection de@angular/core) identifie la plateforme d'exécution courante ;isPlatformBrowser(platformId)(de@angular/common) renvoietrueuniquement si le code s'exécute dans un navigateur, permettant d'éviter d'exécuter du code dépendant dewindow/documentcôté serveur.- ServerRoute / RenderMode
ServerRoute(dansapp.routes.server.ts) associe un chemin à unRenderMode(Server,ClientouPrerender), et peut fixer des en-têtes ou un code de statut HTTP (headers,status) pour cette route.
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.