.ts · text/typescript

Esquema Zod: Esquema de Validación en Ejecución Zod

Los esquemas Zod unen validación JSON en ejecución (`z.object`, `z.array`, `.optional()`) con inferencia estática mediante `z.infer`.

Respuesta rápida: Los esquemas Zod unen validación JSON en ejecución (`z.object`, `z.array`, `.optional()`) con inferencia estática mediante `z.infer`. Validación de límites API en ejecución, tRPC/React Hook Form e inferencia de tipos TypeScript de fuente única.

Tipo de estructuraCódigo tipado
Legibilidad humanaAlta
Soporte de anidaciónSí
Eficiencia de tokens LLMMedia
Extensión de archivo.ts
Tipo MIMEtext/typescript
Ideal paraValidación de límites API en ejecución, tRPC/React Hook Form e inferencia de tipos TypeScript de fuente única.

Ventajas

  • Valida JSON no confiable en ejecución y deriva tipos TypeScript estáticos
  • Detecta claves faltantes, tipos erróneos y cambios API con errores claros
  • Admite comprobación estricta (.strict()) para rechazar claves desconocidas

Compromisos

  • Añade un pequeño costo de biblioteca frente a interfaces TypeScript puras
  • Los esquemas recursivos profundos requieren anotaciones manuales explícitas
  • El modo estricto puede fallar si una API externa añade nuevos campos

Referencias

Convierte y limpia Esquema Zod localmente

Guías técnicas relacionadas

Formatos relacionados

Los 24 formatos

Preguntas frecuentes sobre Esquema Zod

¿Por qué generar esquemas Zod en lugar de solo interfaces TypeScript?

Los tipos TypeScript desaparecen en ejecución. Zod verifica las respuestas JSON reales al vuelo y exporta z.infer<typeof schema> automáticamente.

¿Qué hace la opción de objetos estrictos en JSON a Zod?

Añade .strict() a los z.object(...) generados para lanzar error ante propiedades desconocidas en lugar de descartarlas.

¿Se manejan automáticamente objetos anidados y arreglos mixtos?

Sí. Las estructuras anidadas generan z.object(), z.array(), z.union() y modificadores .nullable() / .optional() limpiamente.