TypeScript Academy · Lección

Middleware y controladores de errores tipados

Escriba funciones middleware de Express seguras respecto a los tipos.

Middleware y controladores de errores tipados es una lección gratuita de TypeScript Academy en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de TypeScript Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de TypeScript Academy incluye 4 lecciones en total.

Bienvenida

El middleware y los controladores de errores de Express con seguridad de tipos previenen errores comunes en las canalizaciones de gestión de solicitudes.

Firma del middleware

Una función de middleware recibe req, res y next. Use el tipo RequestHandler de express.

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

NextFunction

Importe NextFunction para tipificar explícitamente el tercer parámetro.

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

Firma del controlador de errores

Los controladores de errores necesitan cuatro parámetros. TypeScript lo impone mediante el tipo ErrorRequestHandler.

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

Clase de error personalizada

Defina una clase de error tipada con un código de estado.

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

Envoltorio de middleware asíncrono

Envuelva el middleware asíncrono para reenviar los errores al controlador de errores de Express.

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

Middleware de autenticación con asociación de usuario

Asocie el usuario autenticado a la solicitud después de verificar el token.

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

Middleware de validación con Zod

Use Zod en el middleware para analizar los cuerpos de las solicitudes y refinar sus tipos.

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 nivel de router

Aplique middleware tipado a rutas específicas.

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

Middleware de registro

Middleware tipado para registrar solicitudes.

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

Registro del controlador de errores global

Registre el controlador de errores como el último middleware de la cadena.

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

Comprobación rápida

¿Cuántos parámetros tiene un controlador de errores de Express?

Resumen

Use los tipos RequestHandler, ErrorRequestHandler y NextFunction para el middleware de Express. Envuelva los controladores asíncronos para reenviar los errores. Use Zod en el middleware para validar el cuerpo de las solicitudes con tipos.

Preguntas frecuentes

¿La lección «Middleware y controladores de errores tipados» es gratis?

Sí — el texto completo de «Middleware y controladores de errores tipados» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de TypeScript Academy, actualiza a CoddyKit PRO. El curso de TypeScript Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Middleware y controladores de errores tipados»?

Escriba funciones middleware de Express seguras respecto a los tipos. Practicas TypeScript Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar TypeScript Academy?

No se requiere experiencia previa. TypeScript Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.

¿Cuánto tiempo toma la lección «Middleware y controladores de errores tipados»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de TypeScript Academy?

Sí. Cada lección de TypeScript Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

Configuración de TypeScript con Node.js
Tipado de solicitudes y respuestas de Express
Middleware y controladores de errores tipados
Tipado de variables de entorno y configuración

← Volver a TypeScript Academy