Formations — 1 037 leçons en français

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.

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.