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
HttpRequestest 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 avecreq.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 à
HttpClients'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éthodeintercept(req, next)), enregistrée via le jetonHTTP_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 viaHTTP_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.
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.