Formations — 1 037 leçons en français

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 avec provideHttpClient(withInterceptors([...])). Elle voit passer toutes les requêtes et toutes les réponses de HttpClient, dans l'ordre de déclaration.

HttpErrorResponse

Objet reçu quand une requête échoue. status vaut 0 pour une erreur réseau ou un blocage CORS, sinon le code HTTP. error contient le corps de la réponse d'erreur — donc votre ProblemDetail dé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.

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.