AZ Tools

Gerador de JSON para @typedef do JSDoc

Desenvolvimento

Cole qualquer objeto ou array JSON e obtenha definições @typedef do JSDoc prontas para uso, com cada campo mapeado para um tipo do JSDoc (string, number, boolean, type[]) e blocos @typedef separados para objetos aninhados. Perfeito para adicionar tipos a JavaScript puro sem TypeScript. null e arrays vazios viram o tipo * (any). Tudo roda localmente no seu navegador — seu JSON nunca é enviado.

Typedefs do JSDoc

Como usar

  1. Cole ou digite seu JSON na caixa de entrada.
  2. Opcionalmente renomeie o typedef raiz (padrão Root).
  3. Copie os blocos @typedef gerados para o seu código JavaScript.

Perguntas frequentes

Como os tipos são mapeados?
Strings viram string, todos os números number, booleanos boolean e arrays type[] com base no primeiro elemento. Cada objeto aninhado ganha seu próprio @typedef e é referenciado por nome.
E null ou arrays vazios?
O tipo não pode ser inferido da amostra, então null mapeia para * (any) e um array vazio para *[]. Ajuste-os manualmente se souber o tipo real.
Por que JSDoc em vez de TypeScript?
JSDoc @typedef permite documentar e checar tipos em JavaScript puro (por exemplo com VS Code ou tsc --checkJs) sem adicionar uma etapa de build nem arquivos .ts.
Meu JSON é enviado para algum lugar?
Não. A conversão ocorre inteiramente no seu navegador; nada é enviado.

Ferramentas relacionadas