JSON a TypeScript
Genera interfaces o tipos de TypeScript a partir de JSON, con tipos anidados, campos opcionales y uniones.
100 % privado: todo se ejecuta en tu navegador y no se sube nada.
Cómo convertir JSON a TypeScript
Sin registro ni instalación: funciona directamente en tu navegador.
- Paso 1:Pega una muestra JSON representativa (una respuesta de API, un archivo de configuración o un fixture) o haz clic en Cargar ejemplo.
- Paso 2:Define el nombre del tipo raíz y elige interface o type, export, readonly y unknown.
- Paso 3:Copia las definiciones generadas en tu proyecto o descárgalas como archivo .ts.
Preguntas frecuentes sobre JSON a TypeScript
¿Cómo genero interfaces de TypeScript a partir de JSON?
Pega tu JSON en el cuadro de entrada y la herramienta generará al instante sus interfaces de TypeScript. El objeto principal recibe el nombre raíz que elijas y cada objeto anidado obtiene su propia interfaz.
¿Cómo se detectan las propiedades opcionales?
Cuando un array contiene varios objetos, el generador los compara. Una propiedad que falta en al menos un elemento se marca como opcional con ?, y una propiedad cuyos valores tienen tipos distintos recibe un tipo unión.
¿Debo usar interface o type?
Ambos describen la forma de un objeto. Las interfaces pueden extenderse y fusionarse, lo que encaja con APIs públicas y librerías; los alias type pueden expresar uniones y tipos mapeados. Elige según las convenciones de tu código: la herramienta admite ambos.
¿Por qué un array vacío se convierte en unknown[]?
Un array vacío no da información sobre sus elementos. unknown[] mantiene tu código seguro en modo estricto y te obliga a acotar el tipo; desactiva la opción si prefieres any[].
¿Se envía mi JSON a un servidor?
No. La generación de tipos se realiza por completo en tu navegador, así que las respuestas privadas de API y los datos internos nunca salen de tu dispositivo.
Herramientas Relacionadas
Genera tipos de TypeScript desde JSON automáticamente
Escribir a mano interfaces de TypeScript para cada respuesta de API es lento y propenso a errores, sobre todo cuando los payloads contienen objetos y arrays anidados. Este conversor gratuito de JSON a TypeScript lee una muestra de tu JSON y genera definiciones de tipos precisas en un segundo: cada objeto anidado se convierte en su propia interfaz con nombre, los arrays en listas tipadas y los valores primitivos en string, number, boolean o null. Los nombres se derivan de las claves en PascalCase y los tipos de los elementos de arrays se ponen en singular, así que addresses se convierte en Address y categories en Category.
Cuando un array contiene objetos con claves distintas, el generador los combina en una sola interfaz y marca como opcionales las propiedades que faltan en algunos elementos, mientras que los valores que cambian de tipo se convierten en uniones como string | null. Puedes elegir declaraciones interface o type, añadir la palabra clave export, hacer todas las propiedades readonly y usar unknown en lugar de any para arrays vacíos y cumplir con el modo estricto. Todo se ejecuta en tu navegador, así que los payloads internos de tus APIs nunca salen de tu equipo: pega, copia el resultado en tu proyecto y obtén autocompletado y seguridad de tipos al instante.