TypeScript Academy · Leçon

Classes et hiérarchies d’erreurs typées

Créez des classes d’erreurs personnalisées avec des types discriminés

Leçon 1 sur 413 étapes

Classes et hiérarchies d’erreurs typées est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage TypeScript Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours TypeScript Academy comprend 4 leçons au total.

Bienvenue

Les classes d'erreurs personnalisées en TypeScript fournissent aux erreurs une hiérarchie de types pour une gestion sûre et structurée.

Étendre Error

Créez une classe AppError de base avec un statusCode.
class AppError extends Error {
  constructor(public message: string, public statusCode = 500) {
    super(message);
    this.name = 'AppError';
  }
}

Hiérarchie des erreurs

Créez des sous-classes typées pour les types d'erreurs spécifiques.
class NotFoundError extends AppError {
  constructor(resource: string) { super(`${resource} not found`, 404); }
}
class ValidationError extends AppError {
  constructor(public fields: string[]) { super('Validation failed', 400); }
}

Utiliser instanceof

Utilisez instanceof pour affiner les types d'erreurs dans les blocs catch.
try { doSomething(); }
catch (err) {
  if (err instanceof NotFoundError) res.status(404).json({ error: err.message });
  else if (err instanceof ValidationError) res.status(400).json({ fields: err.fields });
}

Union discriminée d'erreurs

Utilisez une union discriminée pour gérer les erreurs de manière typée.
type AppError =
  | { kind: 'not_found'; resource: string }
  | { kind: 'unauthorized' }
  | { kind: 'validation'; fields: string[] };

Fonctions de fabrique d'erreurs

Créez des fonctions de fabrique pour chaque type d'erreur.
const errors = {
  notFound: (r: string) => new NotFoundError(r),
  unauthorized: () => new AppError('Unauthorized', 401),
};

Sérialisation des erreurs

Sérialisez les erreurs pour les réponses de l'API.
function serializeError(err: AppError): Record<string, unknown> {
  return { error: err.message, code: err.statusCode, name: err.name };
}

Définir this.name

Définissez toujours this.name sur le nom de la classe d'erreur afin d'identifier correctement l'erreur dans les journaux.
class MyError extends Error {
  readonly name = 'MyError' as const;
  constructor(msg: string) { super(msg); }
}

Gestion des erreurs dans Express

Utilisez des erreurs personnalisées typées dans les gestionnaires d'erreurs Express.
app.use((err: unknown, req: Request, res: Response, next: NextFunction) => {
  if (err instanceof AppError) {
    res.status(err.statusCode).json({ error: err.message });
  } else {
    res.status(500).json({ error: 'Internal error' });
  }
});

Modèle de journalisation des erreurs

Journalisez les erreurs avec leur type et leur message pour assurer l'observabilité.
function logError(err: unknown): void {
  if (err instanceof Error) console.error(`[${err.name}] ${err.message}`);
  else console.error('Unknown error:', err);
}

Tester les types d'erreurs

Vérifiez que les fonctions lèvent les bons types d'erreurs.
test('throws NotFoundError for missing user', async () => {
  await expect(getUser(999)).rejects.toThrow(NotFoundError);
});

Vérification rapide

Quel mot-clé TypeScript vérifie si un objet est une instance d'une classe à l'exécution ?

Récapitulatif

Classes et hiérarchies d'erreurs typées : vous avez appris les concepts clés de ce sujet et comment les appliquer dans de vrais projets TypeScript.
Gratuit pour commencer

Apprends TypeScript avec un tuteur IA — gratuit

Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.

Cours
101
Leçons
352

Questions Fréquemment Posées

La leçon « Classes et hiérarchies d’erreurs typées » est-elle gratuite ?

Oui — le texte complet de « Classes et hiérarchies d’erreurs typées » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours TypeScript Academy, passe à CoddyKit PRO. Le cours TypeScript Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Classes et hiérarchies d’erreurs typées » ?

Créez des classes d’erreurs personnalisées avec des types discriminés Tu pratiques TypeScript Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer TypeScript Academy ?

Aucune expérience préalable n'est requise. TypeScript Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « Classes et hiérarchies d’erreurs typées » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon TypeScript Academy ?

Oui. Chaque leçon TypeScript Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Classes et hiérarchies d’erreurs typées
  2. Motif Result : Ok et Err
  3. Affiner les erreurs interceptées (unknown ou Error)
  4. Gestion des erreurs dans le code TypeScript asynchrone
← Retour à TypeScript Academy