0Pricing
TypeScript Academy · Lezione

Classi e gerarchie di errori tipizzate

Crei classi di errore personalizzate con tipi discriminati.

Classi e gerarchie di errori tipizzate è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento TypeScript Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso TypeScript Academy include 4 lezioni in totale.

Benvenuti

Le classi di errore personalizzate in TypeScript forniscono agli errori una gerarchia di tipi per una gestione sicura e strutturata.

Estensione di Error

Crei una classe AppError di base con un statusCode.
class AppError extends Error {
  constructor(public message: string, public statusCode = 500) {
    super(message);
    this.name = 'AppError';
  }
}

Gerarchia degli errori

Costruisca sottoclassi tipizzate per tipi di errore specifici.
class NotFoundError extends AppError {
  constructor(resource: string) { super(`${resource} not found`, 404); }
}
class ValidationError extends AppError {
  constructor(public fields: string[]) { super('Validation failed', 400); }
}

Utilizzo di instanceof

Utilizzi instanceof per restringere i tipi degli errori nei blocchi 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 });
}

Unione discriminata degli errori

Utilizzi un'unione discriminata per gestire gli errori con tipi sicuri.
type AppError =
  | { kind: 'not_found'; resource: string }
  | { kind: 'unauthorized' }
  | { kind: 'validation'; fields: string[] };

Funzioni factory per gli errori

Crei funzioni factory per ogni tipo di errore.
const errors = {
  notFound: (r: string) => new NotFoundError(r),
  unauthorized: () => new AppError('Unauthorized', 401),
};

Serializzazione degli errori

Serializzi gli errori per le risposte dell'API.
function serializeError(err: AppError): Record<string, unknown> {
  return { error: err.message, code: err.statusCode, name: err.name };
}

Impostazione di this.name

Imposti sempre this.name sul nome della classe di errore, per identificare correttamente l'errore nei log.
class MyError extends Error {
  readonly name = 'MyError' as const;
  constructor(msg: string) { super(msg); }
}

Errori in Express

Utilizzi errori personalizzati tipizzati nei gestori degli errori 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' });
  }
});

Pattern di logging degli errori

Registri gli errori con il relativo tipo e messaggio per garantire l'osservabilità.
function logError(err: unknown): void {
  if (err instanceof Error) console.error(`[${err.name}] ${err.message}`);
  else console.error('Unknown error:', err);
}

Test dei tipi di errore

Verifichi che le funzioni generino i tipi di errore corretti.
test('throws NotFoundError for missing user', async () => {
  await expect(getUser(999)).rejects.toThrow(NotFoundError);
});

Verifica rapida

Quale parola chiave di TypeScript verifica a runtime se un oggetto è un'istanza di una classe?

Riepilogo

Classi e gerarchie di errori tipizzate: ha appreso i concetti chiave di questo argomento e come applicarli in progetti TypeScript reali.

Domande Frequenti

La lezione «Classi e gerarchie di errori tipizzate» è gratuita?

Sì — il testo completo di «Classi e gerarchie di errori tipizzate» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso TypeScript Academy, passa a CoddyKit PRO. Il corso TypeScript Academy include 4 lezioni in totale.

Cosa imparerò in «Classi e gerarchie di errori tipizzate»?

Crei classi di errore personalizzate con tipi discriminati. Eserciti TypeScript Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare TypeScript Academy?

Non è richiesta alcuna esperienza precedente. TypeScript Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.

Quanto tempo richiede la lezione «Classi e gerarchie di errori tipizzate»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione TypeScript Academy?

Sì. Ogni lezione TypeScript Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Classi e gerarchie di errori tipizzate
  2. Il pattern Result: Ok ed Err
  3. Restringimento degli errori intercettati (unknown o Error)
  4. Gestione degli errori nel codice TypeScript asincrono
← Torna a TypeScript Academy