Accueil › React › Frontières d'erreur
Frontières d'erreur
Patterns de compositionavance
La forme minimale
class Frontiere extends React.Component {
state = { erreur: null };
static getDerivedStateFromError(erreur) {
return { erreur }; // pure : on change l'état, rien d'autre
}
componentDidCatch(erreur, infos) {
journaliser(erreur, infos.componentStack); // effets de bord ici
}
render() {
if (this.state.erreur) {
return this.props.repli(this.state.erreur, () =>
this.setState({ erreur: null })
);
}
return this.props.children;
}
}
React 19 n'offre pas d'équivalent en composant fonction : une frontière est encore une classe, ou une bibliothèque qui en encapsule une.
Les deux méthodes ont des rôles distincts. getDerivedStateFromError
s'exécute pendant le rendu et doit rester pure. componentDidCatch
s'exécute après, reçoit la pile des composants, et c'est là qu'on journalise.
Sans frontière, l'écran disparaît
Une exception non attrapée pendant le rendu fait démonter tout l'arbre par React : l'utilisateur voit une page blanche, sans message et sans recours. La frontière limite la perte à son sous-arbre.
Ce qu'elle n'attrape pas
// ❌ invisible pour toute frontière
<button onClick={() => { throw new Error("boum"); }}>Valider</button>
// ✅ attrapé et rendu normalement
<button onClick={() => {
try { valider(); } catch (e) { setErreur(e); }
}}>Valider</button>
Gestionnaires d'événements, minuteurs, promesses, rendu serveur : hors du cadre que React exécute pour la frontière. L'erreur part dans la console et rien ne s'affiche — c'est la question d'entretien la plus fréquente sur le sujet.
La granularité est une décision
Une frontière par zone indépendante, et une à la racine comme dernier filet. Un graphique en panne doit laisser le reste du tableau de bord debout ; une erreur dans le formulaire de paiement, non.
Les termes à connaître
- Frontière d'erreur
Un composant de classe qui attrape une exception levée pendant le rendu d'un sous-arbre et affiche un repli à sa place, au lieu de laisser l'arbre entier se démonter.
- getDerivedStateFromError
La méthode statique appelée pendant le rendu pour passer la frontière en état d'erreur. Elle doit être pure : aucun appel réseau, aucune journalisation.
- componentDidCatch
La méthode appelée après l'erreur, avec l'erreur et la pile des composants. C'est là qu'on journalise vers un outil de suivi.
- Repli
Ce qui s'affiche à la place du sous-arbre tombé. Sa portée doit correspondre à celle de la frontière : un bloc pour un bloc, une page pour une page.
- Réinitialisation
Remettre la frontière en état normal pour retenter le rendu. Sans elle, le repli reste affiché jusqu'au rechargement complet.
- Erreur hors rendu
Une erreur levée dans un gestionnaire d'événement, un
setTimeoutou une promesse. Aucune frontière ne l'attrape : elle se gère partry/catchou par un état d'erreur.- onUncaughtError
Option de
createRootajoutée par React 19, appelée pour une erreur qu'aucune frontière n'a attrapée. Utile pour journaliser au niveau racine.
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.