AZ Tools

Generador de JSON a @typedef de JSDoc

Desarrollo

Pega cualquier objeto o arreglo JSON y obtén definiciones @typedef de JSDoc listas para usar, con cada campo mapeado a un tipo de JSDoc (string, number, boolean, type[]) y bloques @typedef separados para los objetos anidados. Perfecto para añadir tipos a JavaScript puro sin TypeScript. null y los arreglos vacíos se vuelven el tipo * (any). Todo se ejecuta localmente en tu navegador: tu JSON nunca se sube.

Typedefs de JSDoc

Cómo usar

  1. Pega o escribe tu JSON en el cuadro de entrada.
  2. Opcionalmente renombra el typedef raíz (por defecto Root).
  3. Copia los bloques @typedef generados en tu código JavaScript.

Preguntas frecuentes

¿Cómo se mapean los tipos?
Las cadenas se vuelven string, todos los números number, los booleanos boolean y los arreglos type[] según su primer elemento. Cada objeto anidado obtiene su propio @typedef y se referencia por nombre.
¿Y null o los arreglos vacíos?
Su tipo no se puede inferir de la muestra, así que null se mapea a * (any) y un arreglo vacío a *[]. Ajústalos a mano si conoces el tipo real.
¿Por qué JSDoc en lugar de TypeScript?
JSDoc @typedef te permite documentar y verificar tipos en JavaScript puro (por ejemplo con VS Code o tsc --checkJs) sin añadir un paso de compilación ni archivos .ts.
¿Se envía mi JSON a algún sitio?
No. La conversión ocurre por completo en tu navegador; no se sube nada.

Herramientas relacionadas