Formations — 1 037 leçons en français

Accueil › Node.js › Une hiérarchie d'erreurs métier

Une hiérarchie d'erreurs métier

Erreurs et journalisationintermediaire

Sans hiérarchie, le gestionnaire d'erreur devient une liste de tests qui grandit à chaque fonctionnalité. Avec hiérarchie, il lit trois champs.

La classe de base

export class ErreurApp extends Error {
  constructor(message, { code, statut, exposable = false, cause } = {}) {
    super(message, { cause });
    this.name = this.constructor.name;
    this.code = code;
    this.statut = statut;
    this.exposable = exposable;
    Error.captureStackTrace?.(this, this.constructor);
  }
}

Quatre champs : le code machine stable pour le programme client, le statut HTTP, le drapeau exposable qui autorise le message à sortir du serveur, et la cause qui conserve l'erreur technique d'origine.

Les classes métier

export class ErreurValidation extends ErreurApp {
  constructor(details) {
    super("Données invalides", { code: "VALIDATION", statut: 422, exposable: true });
    this.details = details;
  }
}

export class Introuvable extends ErreurApp {
  constructor(ressource, id) {
    super(`${ressource} ${id} introuvable`, {
      code: `${ressource.toUpperCase()}_INTROUVABLE`, statut: 404, exposable: true,
    });
  }
}

Chaque classe ne déclare que ce qui la distingue. Le reste est hérité.

Ce que devient la couche web

app.use((err, req, res, next) => {
  const statut = err.statut ?? 500;
  res.status(statut).json({
    code: err.exposable ? err.code : "ERREUR_INTERNE",
    message: err.exposable ? err.message : "Une erreur interne est survenue",
    details: err.details,
    requeteId: req.id,
  });
});

Aucun test sur le type. Une erreur métier nouvelle ne touche pas ce fichier, et tout ce qui n'est pas une ErreurApp tombe naturellement en 500 générique — le comportement sûr par défaut.

Les termes à connaître

Code machine

Une chaîne stable comme CLIENT_INTROUVABLE, destinée au programme client. Elle ne change jamais, contrairement au message, qui se reformule et se traduit.

Classe de base

Une classe qui étend Error et porte les champs communs : code, statut, caractère exposable. Les classes métier en héritent et ne déclarent que leur spécificité.

Champ exposable

Un drapeau qui dit si le message peut sortir du serveur. C'est lui qui remplace le if sur le type dans la couche web, et il vaut false par défaut.

Cause chaînée

super(message, { cause: e }) conserve l'erreur d'origine sous l'erreur métier. On garde le vocabulaire du domaine en haut et le détail technique en dessous.

Détails de validation

Un tableau de forme constante — champ, code, message — porté par l'erreur de validation. Les clients écrivent une seule fois l'affichage des erreurs de formulaire.

Fragilité d'`instanceof`

Deux copies d'un même paquet dans l'arbre des dépendances donnent deux classes distinctes, et instanceof échoue. Un champ marqueur est plus robuste.

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.