TypeScript Academy · Lezione

Middleware e gestori degli errori tipizzati

Scriva funzioni middleware Express type-safe.

Middleware e gestori degli errori tipizzati è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 3 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

Middleware e gestori degli errori Express con tipi sicuri prevengono i bug comuni nelle pipeline di gestione delle richieste.

Firma del middleware

Una funzione middleware accetta req, res e next. Utilizzi il tipo RequestHandler di express.

import { RequestHandler } from 'express';
const authMiddleware: RequestHandler = (req, res, next) => {
  if (!req.headers.authorization) return res.status(401).json({});
  next();
};

NextFunction

Importi NextFunction per tipizzare esplicitamente il terzo parametro.

import { Request, Response, NextFunction } from 'express';
function logger(req: Request, res: Response, next: NextFunction): void {
  console.log(req.method, req.path);
  next();
}

Firma del gestore degli errori

I gestori degli errori richiedono quattro parametri. TypeScript lo garantisce tramite il tipo ErrorRequestHandler.

import { ErrorRequestHandler } from 'express';
const errorHandler: ErrorRequestHandler = (err, req, res, next) => {
  res.status(err.status ?? 500).json({ message: err.message });
};

Classe di errore personalizzata

Definisca una classe di errore tipizzata con un codice di stato.

class AppError extends Error {
  constructor(public message: string, public status: number = 500) {
    super(message);
  }
}

Wrapper per middleware asincroni

Avvolga i middleware asincroni per inoltrare gli errori al gestore degli errori di Express.

function asyncHandler(fn: RequestHandler): RequestHandler {
  return (req, res, next) => Promise.resolve(fn(req, res, next)).catch(next);
}

Middleware di autenticazione con associazione dell'utente

Associ l'utente autenticato alla richiesta dopo la verifica del token.

const authenticate: RequestHandler = async (req, res, next) => {
  const user = await verifyToken(req.headers.authorization);
  req.user = user; // requires module augmentation
  next();
};

Middleware di validazione con Zod

Utilizzi Zod nel middleware per analizzare i body delle richieste e restringerne i tipi.

function validate<T>(schema: ZodSchema<T>): RequestHandler {
  return (req, res, next) => {
    const result = schema.safeParse(req.body);
    if (!result.success) return res.status(400).json(result.error);
    req.body = result.data;
    next();
  };
}

Middleware a livello di Router

Applichi middleware tipizzati a route specifiche.

router.use('/admin', authenticate, authorize('admin'));
router.get('/admin/users', asyncHandler(listUsers));

Middleware di logging

Middleware tipizzato per il logging delle richieste.

const requestLogger: RequestHandler = (req, _res, next) => {
  console.log(`${req.method} ${req.path}`);
  next();
};

Registrazione del gestore globale degli errori

Registri il gestore degli errori come ultimo middleware della catena.

app.use(requestLogger);
app.use('/api', apiRouter);
app.use(errorHandler); // must be last

Verifica rapida

Quanti parametri ha un gestore degli errori Express?

Riepilogo

Utilizzi i tipi RequestHandler, ErrorRequestHandler e NextFunction per i middleware Express. Avvolga i gestori asincroni per inoltrare gli errori. Utilizzi Zod nel middleware per convalidare con tipi sicuri il body delle richieste.

Domande Frequenti

La lezione «Middleware e gestori degli errori tipizzati» è gratuita?

Sì — il testo completo di «Middleware e gestori degli errori tipizzati» è 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 «Middleware e gestori degli errori tipizzati»?

Scriva funzioni middleware Express type-safe. 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 3 di 4.

Quanto tempo richiede la lezione «Middleware e gestori degli errori tipizzati»?

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

Configurazione di TypeScript con Node.js
Tipizzazione di Request e Response di Express
Middleware e gestori degli errori tipizzati
Variabili d'ambiente e tipizzazione della configurazione

← Torna a TypeScript Academy