Formations — 1 037 leçons en français

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 avec withRoutes(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 dans main.server.ts. Un schematic de migration automatique adapte ce fichier lors d'un ng update vers v21.

PLATFORM_ID / isPlatformBrowser()

PLATFORM_ID (jeton d'injection de @angular/core) identifie la plateforme d'exécution courante ; isPlatformBrowser(platformId) (de @angular/common) renvoie true uniquement si le code s'exécute dans un navigateur, permettant d'éviter d'exécuter du code dépendant de window/document côté serveur.

ServerRoute / RenderMode

ServerRoute (dans app.routes.server.ts) associe un chemin à un RenderMode (Server, Client ou Prerender), et peut fixer des en-têtes ou un code de statut HTTP (headers, status) pour cette route.

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.