Saltar al contenido

JSON a Zod

Genera esquemas Zod a partir de una muestra JSON. Los objetos anidados se convierten en esquemas exportados propios; las claves que faltan en algunos elementos de un arreglo se vuelven .optional(), los valores nulos se vuelven .nullable() y los valores mixtos se vuelven z.union. Cada esquema también obtiene un alias de tipo z.infer, para que una sola entrada proporcione validación en tiempo de ejecución y tipos TypeScript.

Restablecer

Preguntas frecuentes

¿Cómo se nombran los objetos anidados?

Cada objeto anidado se convierte en su propio tipo Zod, cuyo nombre se basa en la clave que lo contiene y sigue PascalCase; por ejemplo, address se convierte en Address. Los objetos dentro de arreglos adoptan el singular de la clave del arreglo; por ejemplo, users se convierte en User. Los objetos con exactamente los mismos campos comparten un tipo.

¿Cuándo es opcional un campo?

Cuando un arreglo contiene varios objetos y a algunos les falta una clave, ese campo es opcional: el esquema añade .optional(). Las claves presentes en todas las muestras son obligatorias. Un objeto único no tiene otro con el que compararse, así que todas sus claves son obligatorias.

¿Cómo se gestionan los valores nulos?

Una clave que es nula en algunas muestras y tiene un valor en otras se convierte en el tipo seguido de .nullable(). Si una clave siempre es nula, la herramienta no puede determinar su tipo real, así que se convierte en z.null(); pegue una muestra con un valor real para obtener un tipo preciso.

¿Qué tipos se usan para los números?

Los números enteros se convierten en z.number().int() y los números con fracciones, en z.number(). Si un mismo campo contiene ambos, el esquema usa z.number(), porque todos los enteros también son números válidos.

¿Qué ocurre con las claves que no son nombres válidos?

Las claves que no son identificadores JavaScript válidos, como first-name, se escriben entre comillas en z.object, para que el esquema siga coincidiendo exactamente con las claves originales de JSON.

¿Se carga o almacena mi JSON?

El JSON se envía al servidor solo para generar el código de esta solicitud y no se almacena. El generador solo lee la estructura y los tipos de valores de la muestra, así que puede reemplazar los valores sensibles por marcadores de posición del mismo tipo antes de pegarla.

Acerca de OneClick Pro

OneClick Pro es una colección gratuita de más de 150 herramientas web para las tareas cotidianas: convertir imágenes y unidades, dar formato y validar código, consultar dominios y SEO, y trabajar con texto, fechas y números. Todas las herramientas funcionan sin registro ni suscripción; los datos que introduce solo se utilizan para calcular el resultado y nunca se almacenan. Úsela como una caja de herramientas para tareas puntuales o añada a favoritos las que utiliza a diario.