Accueil › Node.js › Erreurs attendues et erreurs de programmation
Erreurs attendues et erreurs de programmation
Erreurs et journalisationintermediaire
Deux familles d'erreurs, et une seule question pour les séparer : quelqu'un avait-il prévu ce cas ?
L'erreur attendue
if (!client) throw new NotFoundError("client", id);
Validation échouée, ressource absente, conflit de version, droits
insuffisants. Ces cas sont documentés : ils font partie du contrat de
l'API. Ils se renvoient au client avec un statut 4xx, se comptent dans une
métrique, et ne réveillent personne.
Le système fonctionne normalement. Il dit non, ce qui est son travail.
L'erreur de programmation
function total(panier) {
return panier.lignes.reduce((s, l) => s + l.prix, 0);
}
total({}); // TypeError: Cannot read properties of undefined
Personne n'a prévu ce cas. Le code s'est arrêté au milieu d'une fonction, et plus rien ne garantit l'état des objets qu'il manipulait : une transaction peut être ouverte, un verrou tenu, un total à moitié calculé.
La réponse se joue en trois temps : 500 avec un message générique,
journal critique avec la trace, redémarrage.
Ce que coûte la confusion
| Erreur | Traitée comme | Conséquence |
|---|---|---|
| validation échouée | erreur système | l'alerte sonne mille fois par jour, puis on la coupe |
| bogue | erreur attendue | un 500 masqué en 400, et le bogue vit des mois |
Le second cas est le plus grave : renvoyer 400 pour un TypeError fait
croire au client qu'il a tort, et retire au bogue la seule chose qui l'aurait
fait corriger — sa visibilité.
Une troisième famille, à ne pas confondre
La base refuse la connexion, le service de paiement expire. Ni le client ni le
code n'ont tort : l'environnement a changé. C'est une erreur
d'exploitation — 503, une reprise, et une alerte sur le volume, pas sur
l'occurrence.
Les termes à connaître
- Erreur attendue
Un cas prévu par le contrat de l'API : validation échouée, ressource absente, conflit, droits insuffisants. Elle se renvoie au client et ne réveille personne.
- Erreur de programmation
Un bogue : une propriété lue sur
undefined, un invariant violé. Personne ne l'a prévue, donc personne ne sait dans quel état le processus se trouve après.- Erreur d'exploitation
La base refuse la connexion, le service appelé expire. Ni le client ni le code n'ont tort : l'environnement a changé. Elle se réessaie, et son volume s'alerte.
- État inconnu
Après un bogue, une transaction peut être ouverte, un verrou tenu, un objet à moitié modifié. Continuer, c'est servir des réponses fausses sans le savoir.
- Invariant
Une propriété que le code tient pour acquise — « cette liste n'est jamais vide ici ». Sa violation est toujours une erreur de programmation, jamais une erreur du client.
- Fatigue d'alerte
Le résultat mécanique d'une alerte qui sonne pour des cas attendus : au bout de deux semaines, plus personne ne la regarde, y compris le jour où elle a raison.
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.