Formations — 1 037 leçons en français

Accueil › Angular › Les intercepteurs

Les intercepteurs

Communiquer avec une APIdebutant

Un intercepteur s'insère entre le code qui appelle HttpClient et l'envoi réel de la requête : il peut la lire, la modifier, ou intercepter la réponse (et les erreurs). Cas d'usage typiques : ajouter un jeton d'authentification, journaliser les appels, afficher un indicateur de chargement global.

La forme recommandée est fonctionnelle, typée HttpInterceptorFn :

export const authInterceptor: HttpInterceptorFn = (req, next) => {
  const token = inject(AuthService).jeton();
  const reqAvecJeton = req.clone({
    headers: req.headers.set('Authorization', `Bearer ${token}`),
  });
  return next(reqAvecJeton);
};

On l'enregistre avec withInterceptors([...]) dans app.config.ts :

provideHttpClient(withInterceptors([authInterceptor, loggingInterceptor]));

Point essentiel : une HttpRequest est immuable. Impossible de modifier req.headers ou req.url directement : il faut passer par req.clone({ ... }), qui retourne une copie avec les propriétés changées.

Les intercepteurs s'enchaînent dans l'ordre du tableau : le premier voit la requête en premier, et la réponse en dernier. C'est le même principe qu'une chaîne de middlewares.

L'ancienne forme, à base de classes implémentant HttpInterceptor, reste supportée (via withInterceptorsFromDi()) mais n'est plus mise en avant par la documentation officielle pour du code neuf.

Les termes à connaître

HttpInterceptorFn

Type d'un intercepteur fonctionnel : une fonction (req, next) => Observable<HttpEvent<unknown>>. C'est la forme recommandée depuis Angular 15, à privilégier pour tout nouveau code.

withInterceptors([...])

Option de provideHttpClient() qui enregistre une liste d'intercepteurs fonctionnels. Ils s'exécutent dans l'ordre du tableau, chacun avant de passer la main au suivant.

req.clone()

Une HttpRequest est immuable : on ne peut pas modifier ses propriétés directement. Pour changer une en-tête, une URL ou un corps, on crée une copie modifiée avec req.clone({ ... }).

next

Fonction reçue en second paramètre par un intercepteur fonctionnel : l'appeler avec la requête (éventuellement clonée) transmet la main au prochain intercepteur, ou à HttpClient s'il n'y en a plus. Ne pas l'appeler bloque la requête.

HTTP_INTERCEPTORS (classe, legacy)

Ancienne forme d'intercepteur : une classe implémentant HttpInterceptor (méthode intercept(req, next)), enregistrée via le jeton HTTP_INTERCEPTORS. Toujours supportée, mais la doc met désormais en avant la forme fonctionnelle.

withInterceptorsFromDi()

Option de provideHttpClient() qui inclut dans la chaîne les intercepteurs de classe déclarés via HTTP_INTERCEPTORS. Utile pour faire cohabiter d'anciens intercepteurs de classe avec de nouveaux intercepteurs fonctionnels.

Ordre d'exécution

Les intercepteurs s'enchaînent comme des maillons : le premier de withInterceptors([...]) voit la requête en premier (à l'aller) et la réponse en dernier (au retour). L'ordre du tableau a donc un effet réel sur le comportement.

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.