Tema 6 · Validación con Zod

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 en req.params o req.query se 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.

zodValidation.js
Solo lectura
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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.