Command Palette

Search for a command to run...

JS

JSON a TypeScript

Genera interfaces TypeScript a partir de cualquier ejemplo de JSON. Infiere tipos anidados, combina arrays de objetos en una única interfaz, marca como opcionales las claves nulas o ausentes y emite código limpio y exportable. 100 % en el navegador.

PatrocinadoEl hosting detrás de Toolz.devHostinger Partner
Lanza tu web con Hostinger
  • Dominio gratis
  • SSL gratis
  • Garantía de reembolso de 30 días
4.6 en Trustpilot con más de 73.000 reseñas
Aprovecha la oferta Código de cupón

¿Qué es el conversor de JSON a TypeScript?

El conversor de JSON a TypeScript lee un valor JSON de ejemplo (la respuesta de una API, un archivo de configuración, un registro de base de datos) y escribe las interfaces TypeScript que lo describen. Los objetos anidados se convierten en interfaces propias con nombre, los arrays de objetos se fusionan en una única interfaz de elemento en lugar de una unión interminable, y las claves que son nulas o faltan en algunos registros se marcan como opcionales. Pegas los datos que ya tienes y obtienes los tipos que de otro modo tendrías que escribir a mano.

Tipar a mano la respuesta de una API es tedioso y propenso a errores de una forma muy concreta: escribes lo que *crees* que devuelve el endpoint, no lo que devolvió realmente. Los campos en los que nunca reparaste se omiten, un entero que a veces es nulo se tipa como `number`, y el fallo aparece en producción, en tiempo de ejecución, en lugar de en tu editor. Generar los tipos directamente a partir de una respuesta real cierra esa brecha, porque la forma contra la que compilas es la que envió el servidor.

Todo se ejecuta en tu navegador. El motor de inferencia es TypeScript sin dependencias, no un envoltorio de un servicio remoto, de modo que las respuestas, que a menudo contienen tokens de acceso, datos de clientes e identificadores internos, nunca salen de la página. Elige entre interfaces o alias de tipo, activa o desactiva la palabra clave `export` y los modificadores `readonly`, ajusta el ancho de la sangría y luego copia el resultado o descarga un archivo .ts.

Una forma rápida de ver qué te aporta la conversión de JSON a TypeScript es el ejemplo incorporado. Pulsa Cargar ejemplo y después Generar. Obtienes tres interfaces: `Root`, `Owner` y `Release`. La segunda versión no tiene la clave `notes`, por lo que la interfaz fusionada `Release` muestra `notes?: string`, y `retiredAt` es nulo en el único registro, así que queda como `retiredAt?: null`. Es el resultado honesto, porque un solo valor nulo no aporta pruebas del tipo real. Para convertir JSON a TypeScript con un endpoint real, pega varios registros para que la inferencia tenga más con qué comparar.

Las interfaces generadas describen el ejemplo que proporcionaste, no la API a la que llamas, y esa distinción es todo el riesgo. Un campo presente en todos los objetos de tu ejemplo se marca como obligatorio aunque el servidor a veces lo omita, y un campo nulo en el ejemplo no se distingue de uno que siempre es nulo. Los arrays vacíos son el caso más claro: un array sin elementos no dice nada sobre lo que contiene. La fusión de arrays ayuda aquí al combinar todos los objetos de una lista en una sola interfaz y marcar como opcionales las claves que faltan en algunas entradas, de modo que un ejemplo más grande y variado produce un tipo más fiel. Si la API tiene un esquema o un documento OpenAPI, genera los tipos a partir de él y usa esta herramienta para explorar una respuesta sin documentar.

¿Cómo usar el conversor de JSON a TypeScript?

  1. Pega tu JSON

    Pega la respuesta de una API, un archivo de datos de prueba o cualquier valor JSON. Si quieres ver cómo se tratan los objetos anidados, los arrays y los campos nulos, carga primero el ejemplo.

  2. Pon nombre al tipo raíz

    Indica el nombre del tipo raíz, normalmente el del recurso, como User o Invoice. Las interfaces anidadas se nombran automáticamente a partir de su clave, y los nombres de los elementos de un array se pasan a singular (releases pasa a ser Release).

  3. Elige el estilo de salida

    Elige entre interfaz o alias de tipo, decide si exportar cada declaración, añade modificadores readonly si tu código prefiere estructuras inmutables y fija la sangría en 2 o 4 espacios.

  4. Genera, y luego copia o descarga

    Pulsa Generar. Revisa los opcionales y las uniones inferidos, y después copia el código al portapapeles o descárgalo como archivo .ts listo para meter en tu carpeta de tipos.

Características principales

  • Extracción de interfaces anidadas

    Cada objeto anidado se convierte en su propia interfaz reutilizable con nombre, en lugar de una forma anónima en línea, de modo que puedes importar y referenciar los tipos internos por separado.

  • Fusión inteligente de arrays

    Un array de objetos se fusiona en una única interfaz de elemento. Las claves presentes en unos registros y ausentes en otros pasan a ser opcionales, que es justo como se comportan los datos reales de una API paginada.

  • Tratamiento de nulos a tu medida

    Elige si un valor nulo significa que la clave es opcional o si null debe formar parte de la unión. Ambas convenciones son habituales y la herramienta no impone ninguna a tu código.

  • Interfaces o alias de tipo

    Emite `interface User {}` o `type User = {}` según tus reglas de lint, con los modificadores opcionales `export` y `readonly` aplicados de forma coherente en todas las declaraciones.

Preguntas frecuentes

Pega tu JSON en el editor, indica el nombre del tipo raíz y pulsa Generar. La herramienta infiere el tipo de cada clave, extrae los objetos anidados a interfaces propias y genera código que puedes copiar directamente a un archivo .ts. Sin registro y sin subir nada: la inferencia se ejecuta en tu navegador.

Comments

0 comments

0/2000 characters

No comments yet. Be the first to share your thoughts!

json to typescriptjson to typescript interfaceconvert json to typescriptjson to interface generatortypescript type generatorjson to typegenerate typescript from jsonapi response typestypescript interface from apijson schema to typescript