Accueil › Fullstack Angular + Spring Boot › Centraliser le traitement des erreurs côté front
Centraliser le traitement des erreurs côté front
Les erreurs de bout en boutdebutant
Sans traitement centralisé, chaque appel HTTP du projet reproduit le même bloc de dix lignes, avec des variantes. Avec un intercepteur, le comportement transverse est écrit une fois.
import { HttpErrorResponse, HttpInterceptorFn } from '@angular/common/http';
import { catchError, throwError } from 'rxjs';
import { inject } from '@angular/core';
export const erreursInterceptor: HttpInterceptorFn = (requete, suivant) => {
const notifications = inject(NotificationService);
const auth = inject(AuthService);
return suivant(requete).pipe(
catchError((erreur: HttpErrorResponse) => {
if (erreur.status === 0) {
notifications.erreur('Serveur injoignable. Vérifiez votre connexion.');
} else if (erreur.status === 401) {
auth.sessionExpiree(); // redirection vers la connexion
} else if (erreur.status === 403) {
notifications.erreur('Vous n\'avez pas les droits nécessaires.');
} else if (erreur.status >= 500) {
const correlation = erreur.error?.correlationId;
notifications.erreur(
`Erreur serveur.${correlation ? ' Référence : ' + correlation : ''}`,
);
}
// 400 et 409 : non traités ici, c'est l'affaire de l'écran appelant
return throwError(() => erreur);
}),
);
};
// app.config.ts
export const appConfig: ApplicationConfig = {
providers: [
provideHttpClient(withInterceptors([authInterceptor, erreursInterceptor])),
],
};
La règle de partage : l'intercepteur traite ce qui est identique partout, le composant traite ce qui dépend de son écran. Et dans tous les cas, l'intercepteur relance l'erreur.
Les termes à connaître
- Intercepteur fonctionnel
Fonction
(requete, suivant) => Observable<HttpEvent<unknown>>enregistrée avecprovideHttpClient(withInterceptors([...])). Elle voit passer toutes les requêtes et toutes les réponses deHttpClient, dans l'ordre de déclaration.- HttpErrorResponse
Objet reçu quand une requête échoue.
statusvaut 0 pour une erreur réseau ou un blocage CORS, sinon le code HTTP.errorcontient le corps de la réponse d'erreur — donc votreProblemDetaildésérialisé.- catchError
Opérateur RxJS qui intercepte l'erreur d'un flux. Dans un intercepteur, on l'utilise pour agir (journaliser, notifier) puis relancer l'erreur avec
throwError, afin que l'appelant puisse encore la traiter.- status === 0
Signature d'une requête qui n'a jamais obtenu de réponse lisible : coupure réseau, serveur injoignable, requête bloquée par CORS, ou annulée. Le message à afficher n'est pas le même que pour une erreur serveur, et c'est le cas le plus souvent oublié.
- Erreur technique / erreur métier
L'erreur technique (500, réseau) n'apprend rien à l'utilisateur et se traite globalement : notification générique plus journalisation. L'erreur métier (400, 409) le concerne directement et se traite localement, dans l'écran qui l'a provoquée.
- Service de notification
Service applicatif unique chargé d'afficher les messages transitoires (bandeau, toast). Centraliser l'affichage évite que chaque composant invente sa propre façon de signaler une erreur, et rend le style homogène.
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.