JSON para TypeScript
Transforme uma amostra JSON comum em um alias de tipo TypeScript legível. Inspecione campos opcionais e matrizes mistas e copie o código ou salve um arquivo TypeScript. O resultado descreve a estrutura observada e precisa de revisão; ele não valida dados futuros em tempo de execução.
Gere um tipo de JSON
- Cole um documento JSON ou carregue o exemplo. Objetos, arrays e valores primitivos na raiz são aceitos dentro dos limites. Comentários, vírgulas finais, chaves duplicadas após decodificação e unidades substitutas UTF-16 sem par são rejeitados.
- Escolha um nome de tipo raiz começando com uma letra maiúscula ASCII, seguida por letras, dígitos ou sublinhados, com até 64 caracteres. Selecione dois ou quatro espaços e Gerar tipo.
- Revise os campos inferidos e a qualificação somente de amostra. Copy grava apenas o código atual; Baixar TypeScript salva o mesmo código UTF-8 que json-types.ts. A edição de uma entrada limpa o resultado antigo.
Como funciona a inferência de amostra
Valores primitivos tornam-se null, boolean, number ou string. Strings que parecem datas, identificadores ou números continuam sendo strings. Os tokens numéricos são classificados sem conversão; number não garante precisão numérica em JavaScript.
Objetos no mesmo contexto são agrupados. Uma chave é opcional quando falta em pelo menos um objeto do grupo. Um null explícito é um valor; portanto, opcional e anulável são conceitos diferentes. Objetos vazios também contam.
Arrays combinam os elementos observados recursivamente, sem criar tuplas de tamanho fixo. Arrays vazios podem usar elementos de arrays não vazios no mesmo contexto; se não houver elementos, o resultado é unknown[]. Caminhos de propriedades diferentes não compartilham evidências.
O resultado é um alias de tipo exportado com tipos aninhados embutidos, chaves entre aspas e formatação estável. Um conjunto de objetos sem chaves usa uma assinatura de índice de string com valor unknown, que é permissiva em vez de vazia exata. Nenhuma heurística enum, discriminante, dicionário, data ou UUID é aplicada.
Exemplos obrigatórios, opcionais e anuláveis
No exemplo, o primeiro objeto tem id 1, label Ada e score null; o segundo tem id 2 e score 4. Como id e score aparecem nos dois objetos, são obrigatórios. label aparece uma vez e torna-se opcional. score combina null e number.
Para um objeto cujo campo left é uma matriz vazia e o campo right contém 1, left permanece unknown[] e right se torna number[] . Para duas matrizes items correspondentes, uma vazia e outra contendo 1, sua evidência de elemento compartilhado produz number[] .
Ao mesclar objetos com kind ok e value e objetos com kind error e message, kind torna-se uma string e value e message tornam-se opcionais. A relação original se perde, permitindo combinações não observadas. Revise esses casos se precisar de uma união discriminada.
Inferência e limites de tamanho
Uma amostra não pode estabelecer todos os campos futuros, valores faltantes ou variantes. As declarações geradas são tipos de tempo de compilação, não um validador de tempo de execução, um esquema de objeto exato ou uma prova de que uma resposta da API está correta.
A entrada é limitada a 256 KiB de texto UTF-8, profundidade 32 e 20.000 registros. Cada valor JSON conta uma vez e cada membro do objeto adiciona mais dois registros. A saída é limitada a 1 MiB, incluindo formatação e sua nova linha final. Os limites rejeitam toda a operação sem um resultado truncado.
É permitido um único BOM no início. Nomes duplicados após a decodificação e unidades substitutas UTF-16 sem par são rejeitados por interoperabilidade. Tokens numéricos podem ter até 1024 caracteres e expoente de magnitude até 100000; não se infere bigint nem garantia de precisão.
A ferramenta aceita texto JSON e emite um alias de tipo. Ele não importa arquivos ou URLs, não executa amostras, gera interfaces ou código de tempo de execução, infere esquema JSON, traduz chaves ou instala um compilador em seu navegador. Revise as declarações no projeto TypeScript onde você as usará.
Amostras e códigos permanecem no fluxo de trabalho desta página
A ferramenta não envia a amostra ao servidor, salva histórico, cria links com a entrada nem adiciona telemetria com JSON, chaves, nomes de tipo ou código gerado. Copiar e baixar são ações solicitadas pelo usuário. Serviços existentes do site, extensões e o uso posterior do código ficam fora dessa descrição.
Perguntas de JSON para TypeScript
Fontes e referências
- rfc-editor.orgRFC 8259Sintaxe JSON e interoperabilidade.
- typescriptlang.orgTypeScript: Everyday TypesAliases, matrizes e uniões TypeScript.
- typescriptlang.orgTypeScript: Object TypesPropriedades de objetos e assinaturas de índice.
- typescriptlang.orgTypeScript: unknownO tipo unknown para valores sem informação observada.
- typescriptlang.orgTypeScript: Erased TypesAs declarações de tipo não fornecem validação em tempo de execução.
Fontes revisadas em 2026-11-15. Agrupamento, nomes e limites são políticas desta ferramenta.
Ferramentas relacionadas
JSON para YAML
Converta JSON em YAML localmente, preservando o texto dos números e as strings entre aspas; copie ou baixe o resultado completo.
Abrir ferramenta — JSON para YAMLConversor de YAML para JSON
Converta YAML em JSON localmente com texto numérico exato, aliases limitados e cópia ou download completos.
Abrir ferramenta — Conversor de YAML para JSONFormatador de YAML
Ajuste o recuo do YAML e copie o resultado verificado, preservando comentários e detalhes do texto original.
Abrir ferramenta — Formatador de YAMLFormatador XML
Verifique XML 1.0 com espaços de nomes, formate ou compacte localmente e copie ou baixe o resultado em UTF-8.
Abrir ferramenta — Formatador XMLFormatador e validador JSON
Verifique a sintaxe JSON, formate ou minifique localmente e copie ou baixe o resultado preservando os dados originais.
Abrir ferramenta — Formatador e validador JSON