De JSON a TypeScript
Convierte un ejemplo de JSON en interfaces de TypeScript, con los objetos anidados extraídos en tipos con nombre propio.
Qué hace
De JSON a TypeScript analiza la entrada de verdad y la vuelve a serializar, en lugar de ir adivinando con patrones. La estructura se conserva donde el formato de destino puede expresarla, y se aplana de forma predecible donde no.
Cuándo sirve
Mover datos entre cosas que no se ponen de acuerdo sobre el formato: una API que responde en una forma, una hoja de cálculo que solo abre otra, un archivo de configuración que una herramienta se niega a leer, una exportación que tiene que convertirse en importación.
Límites y advertencias
Los formatos no son equivalentes, así que algún detalle no sobrevive al viaje — las estructuras anidadas tienen que aplanarse para una salida en tabla, y los comentarios y las diferencias de tipo se pierden en los dos sentidos. Una entrada no válida se señala en vez de adivinarse. Todo ocurre en tu navegador, así que el archivo nunca sale de tu dispositivo.
Cómo funciona
- Pega una respuesta real de la API que estás tipando.
- Los objetos anidados se convierten en interfaces propias, los arrays toman el tipo de sus elementos.
- Copia el resultado en tu proyecto.
Preguntas frecuentes
- ¿Qué pasa con los arrays de tipos mixtos?
- Obtienes una unión, por ejemplo (string | number)[]. Adivinar a partir del primer elemento es como los generadores producen tipos que se rompen en producción.
- ¿Por qué los campos null pasan a ser opcionales?
- Porque un null en una respuesta de ejemplo casi siempre significa que el campo puede faltar o estar vacío. Apaga el interruptor si tu API envía de verdad null cada vez.
- Un ejemplo no es toda la API.
- Exacto, y es el límite honesto de este enfoque. Un campo ausente en tu ejemplo no puede aparecer en los tipos. Pega la respuesta más completa que tengas.
- ¿Se suben mis archivos a alguna parte?
- No. Esta herramienta funciona por completo en tu navegador, así que el archivo nunca sale de tu dispositivo.