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.
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.