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
Erroret 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
ifsur le type dans la couche web, et il vautfalsepar 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.
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.