Formations — 1 037 leçons en français

Accueil › Angular › Gérer les erreurs et les états de chargement

Gérer les erreurs et les états de chargement

Communiquer avec une APIdebutant

Une requête HttpClient peut échouer pour deux raisons différentes : le réseau n'a pas atteint le serveur (status === 0, CORS bloqué, pas de connexion), ou le serveur a répondu avec un statut d'erreur (404, 400, 500…). Dans les deux cas, l'Observable émet une erreur de type HttpErrorResponse, à intercepter avec catchError :

chargerProduits(): Observable<Produit[]> {
  return this.http.get<Produit[]>('/api/produits').pipe(
    catchError((erreur: HttpErrorResponse) => {
      const message = erreur.status === 0
        ? 'Impossible de joindre le serveur.'
        : `Erreur ${erreur.status} : ${erreur.error?.message ?? 'inconnue'}`;
      return throwError(() => new Error(message));
    }),
  );
}

Pour piloter l'affichage, on modélise l'état d'un chargement avec des signaux plutôt que de tout mélanger dans un seul booléen : un état chargement / succes / erreur (ou équivalent) permet d'afficher un spinner, le contenu, ou un message adapté selon le cas.

retry réessaie automatiquement une requête en échec : pertinent sur un GET (opération sans effet de bord), risqué sur un POST qui crée une ressource — la première tentative a peut-être déjà réussi côté serveur malgré une réponse perdue.

Pour annuler une requête devenue inutile (l'utilisateur tape une nouvelle recherche avant que la précédente ait répondu), switchMap abandonne l'appel précédent dès qu'une nouvelle valeur source arrive.

Les termes à connaître

HttpErrorResponse

Objet reçu quand une requête HttpClient échoue (réseau ou statut HTTP d'erreur). Expose status (0 pour une erreur réseau, sinon le code HTTP), statusText, error (le corps de la réponse d'erreur) et message.

catchError

Opérateur RxJS qui intercepte une erreur dans un flux et permet de la remplacer par une valeur de repli, ou de la relancer sous une autre forme, avec throwError(...).

Erreur réseau vs erreur serveur

Une erreur réseau (status === 0, ex. pas de connexion, CORS bloqué) n'a jamais atteint le serveur. Une erreur serveur (status 4xx ou 5xx) signifie que le serveur a répondu, mais avec un refus ou une panne. Les messages à afficher diffèrent.

retry

Opérateur RxJS qui réessaie automatiquement une requête ayant échoué, un nombre de fois donné. Pertinent pour une requête GET idempotente sur une erreur transitoire, dangereux sur une opération qui modifie des données (POST, PATCH).

État de chargement (signal)

Représentation de l'avancement d'une requête sous forme de signal (chargement, succes, erreur), pour piloter l'affichage : spinner, contenu, ou message d'erreur.

switchMap

Opérateur RxJS qui, à chaque nouvelle valeur de la source, annule l'appel HTTP précédent en cours (s'il n'est pas terminé) et n'en garde que le dernier. Utile pour une recherche au fil de la frappe.

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.