JSON a TypeScript — Generar Interfaces y Tipos (json2ts)
Pega una muestra JSON y el generador recorre el árbol y emite un conjunto de declaraciones de interface TypeScript que la describen: la raíz se vuelve una interface nombrada, cada objeto anidado se vuelve su propia interface nombrada, los arrays se vuelven T[] y los primitivos se vuelven sus equivalentes TypeScript (string, number, boolean, null). La salida está lista para pegar en un archivo .ts sin más edición.
Úsalo para tipar la respuesta de una API nueva que integras, sembrar interfaces para un payload de formulario, producir tipos para un archivo de configuración leído en runtime, arrancar modelos desde un registro de muestra en un fixture mockeado, o generar el lado TypeScript de un pipeline de code-generation donde quieres evitar escribir interfaces a mano. También es una comprobación rápida cuando sospechas que un endpoint devuelve una forma distinta a la que los tipos afirman.
El generador maneja los casos comunes: arrays de objetos con claves distintas producen un tipo unión que cubre las variantes observadas, arrays con entradas null producen (T | null)[], las claves ausentes en algunos objetos se vuelven opcionales (key?: T), y los arrays vacíos caen a unknown[] para que los afines a mano. El resultado completo se puede copiar o descargar como archivo .ts y se regenera en vivo mientras editas el input.
El JSON y el TypeScript generado se quedan en tu navegador — nada se sube.
Sobre la conversión de JSON a TypeScript
Las interfaces TypeScript describen la forma de objetos JavaScript. Generarlas desde muestras JSON ahorra tiempo al tipar respuestas de API, archivos de configuración o registros de bases de datos.
- Genera interfaces TypeScript limpias
- Maneja objetos anidados y arrays
- Detecta tipos unión en arrays
- Descargar como archivo .ts
- Conversión en tiempo real mientras escribes
100% en tu navegador. Tus inputs nunca salen de tu navegador. Anuncios mediante AdSense (con consentimiento).
Preguntas frecuentes
¿Cómo genero tipos TypeScript desde JSON?
Pega una muestra JSON y la herramienta infiere la forma y emite declaraciones de interface TypeScript. Cada objeto se vuelve una interface, los objetos anidados se vuelven interfaces anidadas (con nombres autogenerados) y los arrays se tipan como T[]. Los campos opcionales se detectan cuando la herramienta ve la misma clave presente en algunos objetos y ausente en otros dentro de un array de muestras. Los arrays de tipos mixtos se vuelven uniones como (string | number)[].
¿El conversor JSON a TypeScript es gratis?
Sí, totalmente gratis, sin registro. Genera tantas interfaces como necesites — útil cuando una API no tiene tipos publicados y quieres arrancar un cliente tipado. JSONCraft no tiene plan premium; cada herramienta no tiene restricciones. Copia las interfaces generadas directamente a tu proyecto.
¿El conversor sube mi JSON?
No. La inferencia y la generación de código corren íntegramente en tu navegador. Nada se envía a ningún sitio, algo que importa porque las respuestas API que querrías tipar incluyen a menudo datos reales — IDs de usuario, tokens, URLs internas. Puedes pegar muestras de producción con seguridad para generar interfaces.
¿Cómo se detectan campos opcionales y uniones?
Pasa un array de muestras (no un único objeto) y la herramienta compara claves entre items: las claves presentes en todos son requeridas, las que están en algunos se marcan opcionales con ?. Para valores primitivos que varían de tipo entre muestras (a veces número, a veces null), obtienes una unión como number | null. Para arrays con tipos mixtos, obtienes una unión dentro del array. Una sola muestra da interfaces con todo requerido, así que pega arrays siempre que puedas.
¿Usar interface o type alias?
La herramienta emite interfaces por defecto porque se pueden fusionar por declaración (las puedes reabrir después) y producen mensajes de error más claros en tsc. Para formas con muchas uniones o mapped types, un type alias es más flexible. Consejo práctico: genera interfaces aquí y luego renombra o pasa a type donde tus convenciones de código lo pidan. Ambas compilan a lo mismo en runtime (nada — los tipos de TypeScript se borran).
Por Marco B. ·