Formations — 1 037 leçons en français

Accueil › React › Afficher une erreur utilement

Afficher une erreur utilement

Charger des donnéesintermediaire

Un message par situation

function messagePour(erreur) {
  if (erreur.name === "AbortError") return null;               // rien
  if (erreur.name === "TypeError") return "Vous semblez hors connexion.";
  if (erreur.statut === 401) return "Votre session a expiré. Reconnectez-vous.";
  if (erreur.statut === 403) return "Vous n'avez pas accès à cet élément.";
  if (erreur.statut === 404) return "Cet élément n'existe plus.";
  if (erreur.statut >= 500) return "Problème de notre côté. Réessayez dans un instant.";
  return "Une erreur inattendue est survenue.";
}

Chacun suggère une action différente : se reconnecter, demander un accès, revenir en arrière, réessayer. « Une erreur est survenue » n'en suggère aucune.

Et l'ordre compte : l'annulation passe en premier, parce qu'elle peut porter un statut.

Le bouton « réessayer »

if (etat === "erreur") {
  return (
    <div className="erreur">
      <p>{messagePour(erreur)}</p>
      <button onClick={recharger}>Réessayer</button>
    </div>
  );
}

Deux lignes, et l'utilisateur reprend la main. Beaucoup moins coûteux qu'une reprise automatique — et il sait souvent mieux que le code s'il vaut la peine d'insister.

La frontière d'erreur

Une exception levée pendant le rendu démonte tout l'arbre : page blanche. Une frontière limite les dégâts à une zone.

<Frontiere repli={<p>Ce bloc est indisponible.</p>}>
  <TableauDeBord />
</Frontiere>

Elle n'attrape pas les erreurs asynchrones : un rejet de promesse dans un effet lui échappe, et se gère par un catch.

Isoler plutôt que tout faire tomber

<Frontiere repli={<BlocIndisponible nom="Ventes" />}><Ventes /></Frontiere>
<Frontiere repli={<BlocIndisponible nom="Stock" />}><Stock /></Frontiere>

Une panne sur les ventes ne doit pas effacer le stock. C'est le même raisonnement que allSettled au niveau des données, appliqué au rendu.

Les termes à connaître

Message actionnable

Un message qui dit ce qui s'est passé et quoi faire. « Une erreur est survenue » ne satisfait ni l'une ni l'autre condition.

Frontière d'erreur

Un composant qui attrape les exceptions de rendu de ses enfants et affiche une solution de repli, au lieu de laisser l'écran blanc.

Erreur isolée

Une panne limitée à une zone de l'écran. Le reste reste utilisable, parce que chaque bloc gère son sort.

Reprise manuelle

Un bouton « réessayer » à côté du message. Beaucoup moins coûteux qu'une reprise automatique, et souvent suffisant.

Identifiant d'incident

Un court code affiché à l'utilisateur et joint au rapport d'erreur. Il transforme un échange inexploitable en diagnostic immédiat.

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.