6. Validación Robusta de Esquemas y Parseo de Tipos con Zod
Crea un middleware universal para validar body, query params y headers contra esquemas Zod con inferencia de tipos estática y respuestas de error 400 detalladas.
Validación y Sanitización Estricta con Zod
Zod se ha convertido en el estándar de la industria en el ecosistema TypeScript/JavaScript moderno para validación de datos. A diferencia de validadores antiguos que mutan datos o requieren configuración verbosa, Zod no sólo valida sino que realiza coerción de tipos segura (por ejemplo, convertir strings numéricos de req.query en enteros reales) y descarta claves maliciosas no declaradas.
1. Beneficios Clave de Zod en Express
- Strip de propiedades desconocidas: Por defecto,
z.object({...}).parse()elimina cualquier propiedad enviada por el cliente que no esté en el esquema, evitando inyecciones de campos protegidos como{ "rol": "admin" }. - Coerción segura: Con
z.coerce.number(), los valores que llegan como texto enreq.paramsoreq.queryse transforman automáticamente a tipos numéricos reales. - Mensajes de error semánticos: Genera árboles detallados de problemas con el campo exacto (path) y la razón del fallo para responder con formato RFC 7807 (Problem Details).
⚡ Middleware Universal de Validación con Esquemas Zod
Validación completa de body, query y params con tipado estricto.
import { z } from 'zod';
import express from 'express';
// 1. FACTORY DEL MIDDLEWARE UNIVERSAL DE VALIDACIÓN
export const validate = (schema) => async (req, res, next) => {
try {
// Validar simultáneamente body, query y params según lo definido en el esquema
const parsed = await schema.parseAsync({
body: req.body,
query: req.query,
params: req.params,
});
// Reasignar los datos limpios, parseados y con coerción de tipos a la petición
if (parsed.body) req.body = parsed.body;
if (parsed.query) req.query = parsed.query;
if (parsed.params) req.params = parsed.params;
next();
} catch (error) {
if (error instanceof z.ZodError) {
return res.status(400).json({
success: false,
error: 'Error de validación de datos de entrada.',
details: error.errors.map((err) => ({
campo: err.path.slice(1).join('.'), // Omite el prefijo 'body' o 'query'
mensaje: err.message,
ubicacion: err.path[0],
})),
});
}
next(error);
}
};
// 2. DEFINICIÓN DE UN ESQUEMA ZOD (Ejemplo: Crear Producto)
export const createProductSchema = z.object({
body: z.object({
nombre: z
.string({ required_error: 'El nombre del producto es obligatorio.' })
.trim()
.min(3, 'El nombre debe tener al menos 3 caracteres.')
.max(100, 'El nombre no puede superar los 100 caracteres.'),
precio: z
.number({ required_error: 'El precio es obligatorio.' })
.positive('El precio debe ser mayor a cero.'),
stock: z
.number()
.int('El stock debe ser un número entero.')
.nonnegative('El stock no puede ser negativo.')
.default(0),
categoria: z.enum(['tecnologia', 'ropa', 'libros', 'servicios'], {
errorMap: () => ({ message: 'Categoría no válida.' }),
}),
}),
query: z.object({
publicar: z.coerce.boolean().optional(),
}),
});
// 3. APLICACIÓN EN UNA RUTA EXPRESS
const router = express.Router();
router.post('/productos', validate(createProductSchema), async (req, res) => {
// Aquí req.body ya está 100% tipado, sanitizado y libre de campos inyectados
const { nombre, precio, stock, categoria } = req.body;
res.status(201).json({
success: true,
data: { nombre, precio, stock, categoria },
});
});
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué comportamiento tiene Zod por defecto ante campos inesperados enviados en req.body que no fueron declarados en z.object({...})?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Express.js: Framework Backend & APIs Empresariales y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.