Zod

Validación de esquemas con TypeScript primero e inferencia de tipos estática
por @colinhacks

Sitio Web • Discord • 𝕏 • Bluesky

¡Zod 4 ya es estable! Lee las notas de la versión aquí.

Featured sponsor: Jazz

Interested in featuring? Get in touch.

Introducción

Zod es una biblioteca de validación orientada a TypeScript. Usando Zod, puedes definir esquemas que puedes usar para validar datos, desde un simple string hasta un objeto anidado complejo.

import * as z from "zod";
 
const User = z.object({
  name: z.string(),
});
 
// algunos datos no confiables...
const input = { /* stuff */ };
 
// ¡el resultado analizado está validado y es seguro en tipos!
const data = User.parse(input);
 
// así que puedes usarlo con confianza :)
console.log(data.name);

Características

Cero dependencias externas
Funciona en Node.js y todos los navegadores modernos
Pequeño: paquete núcleo de 2kb (gzipped)
API inmutable: los métodos devuelven una nueva instancia
Interfaz concisa
Funciona con TypeScript y JS plano
Conversión integrada a JSON Schema
Ecosistema extenso

Instalación

npm install zod

Zod también está disponible como @zod/zod en jsr.io.

Zod también proporciona un archivo llms.txt.

Requisitos

Zod se prueba contra TypeScript v5.5 y posteriores. Las versiones anteriores pueden funcionar pero no están oficialmente soportadas.

`"strict"`

Debes habilitar el modo strict en tu tsconfig.json. Esta es una mejor práctica para todos los proyectos TypeScript.

// tsconfig.json
{
  // ...
  "compilerOptions": {
    // ...
    "strict": true
  }
}

Zod tiene un ecosistema próspero de bibliotecas, herramientas e integraciones. Consulta la página del Ecosistema para ver una lista completa de bibliotecas que soportan Zod o están construidas sobre él.

También contribuyo a los siguientes proyectos, que me gustaría destacar:

tRPC - APIs tipificadas de extremo a extremo, con soporte para esquemas Zod
React Hook Form - Validación de formularios basada en hooks con un resolver Zod
zshy - Creado originalmente como la herramienta de construcción interna de Zod. Herramienta de construcción sin bundler y con baterías incluidas para bibliotecas TypeScript. Impulsado por tsc.