Cargando herramienta…

Convierte una respuesta JSON en tipos

Tipar a mano la respuesta de una API es lento y fácil de equivocar. Pega un ejemplo JSON real y QodeCat escribe las declaraciones de TypeScript en vivo mientras escribes, listas para copiar en tu proyecto.

  • Tipos anidados con nombre: Cada objeto anidado se convierte en su propia interface, con el nombre de su clave.
  • Campos opcionales: Una clave que falta en algunos elementos de un array se marca con ?.
  • Uniones: Los arrays mixtos pasan a tipos unión, null pasa a T | null y los arrays vacíos a unknown[].
  • Opciones: Nombre raíz, interface o alias de tipo, propiedades readonly y la palabra clave export.

¿Por qué usar esta herramienta?

Aprende de todos los elementos del array

En lugar de mirar solo el primer elemento, el generador combina todos los objetos de un array. Las claves que aparecen solo a veces pasan a ser opcionales, y un campo que es string en un elemento y null en otro queda como string | null.

Errores claros, datos privados

Si el JSON no es válido, ves la línea y la columna del problema. La conversión se ejecuta por completo en tu navegador, así que las respuestas de API con datos de clientes o tokens nunca se suben.

Preguntas frecuentes

P. ¿Qué pasa con las claves que no son identificadores válidos?

Claves como "first-name" o "2fa" se escriben entre comillas, lo cual es TypeScript válido. Los nombres de interface se forman con la clave en PascalCase, por ejemplo WithSpace para "with space".

P. ¿Los objetos con la misma estructura se unen en un tipo?

Sí. Si dos claves contienen objetos con exactamente la misma estructura, el generador declara una sola interface y la usa para ambas, así la salida queda corta.

P. ¿Elijo interface o type?

Ambos describen la misma forma. Las interfaces se pueden extender y fusionar, y los alias de tipo son prácticos para uniones. Usa el estilo de tu proyecto; la opción cambia todas las declaraciones a la vez.