JSON a TypeScript

Interfaces, tipos y esquemas Zod

Sin base de datos: AIMRAN no guarda tus archivos, textos ni resultados

¿Qué es JSON a TypeScript?

Si trabajas con TypeScript y recibes datos en JSON de una API, escribir los tipos a mano es lento. Esta herramienta lee un ejemplo de JSON y genera automáticamente las interfaces o tipos que lo describen.

También puede generar un esquema Zod para validar esos datos en tiempo de ejecución, con el tipo derivado listo para usar.

Cómo se usa

  1. Pega tu JSON o carga el ejemplo.
  2. Elige la salida: TypeScript o Esquema Zod.
  3. Selecciona si declarar como interface o type.
  4. Escribe el nombre del tipo raíz y activa «Añadir export» si lo necesitas.
  5. Copia o descarga el código generado.

Ventajas

Detalles técnicos

La herramienta infiere un tipo estructural a partir del valor JSON: string, number, boolean, null, objetos y arrays. En los arrays, los tipos de todos los elementos se unifican; si son objetos, sus campos se fusionan y las claves ausentes en algún elemento se marcan como opcionales (?), y si los tipos difieren se genera una unión. Cada objeto anidado produce una declaración con nombre derivado de su clave. Los arrays vacíos se tipan como unknown[]. En modo Zod se generan z.object, z.array, z.union y .optional(), y se añade type Nombre = z.infer<typeof NombreSchema>. Las claves que no son identificadores válidos se escriben entre comillas.

Preguntas frecuentes

¿Cómo convierto un JSON a interface de TypeScript?

Pega el JSON, elige TypeScript e «interface», y copia el resultado. Cada objeto anidado tendrá su propia interfaz.

¿Qué diferencia hay entre interface y type?

Para describir objetos son casi equivalentes. Las interfaces se pueden ampliar y fusionar; los type permiten uniones y tipos más complejos.

¿Qué es Zod?

Una librería de TypeScript para validar datos en tiempo de ejecución. El esquema comprueba que los datos tienen la forma esperada y de él se deduce el tipo.

¿Cómo detecta los campos opcionales?

En arrays de objetos, si una clave falta en alguno de los elementos, se marca como opcional.

¿Detecta fechas en el JSON?

No. JSON no tiene tipo fecha, así que las fechas se generan como string.

Más herramientas de Desarrolladores