Como funciona
- Cole ou abra seu JSON.
- Escolha embelezar, minificar ou ordenar as chaves.
- Copie ou baixe o resultado.
Por que usar
- Posição e mensagem de erro precisas.
- Recuo de 2 ou 4 espaços ou tabulações.
- Ordena as chaves e mantém intactos seus valores originais.
- Tolera comentários e vírgulas finais.
Formatar e validar JSON, e corrigir os erros comuns
JSON válido num relance
Cole JSON ou abra um arquivo e ele é conferido enquanto você digita. JSON válido ganha uma marca verde e aparece formatado; JSON inválido ganha uma marca vermelha, a linha com o problema é destacada no editor e o motivo é indicado, como uma vírgula faltando ou um fim de texto inesperado. Como nada sai da página, é seguro para respostas de API, arquivos de configuração e dados com informações pessoais ou chaves.
Os erros que quase todo mundo comete
O JSON é mais rígido que o JavaScript com que se parece. Estes cinco causam a maioria dos arquivos inválidos:
| Erro | Inválido | Válido |
|---|---|---|
| Vírgula depois do último item | {"a": 1, "b": 2,} | {"a": 1, "b": 2} |
| Aspas simples | {'name': 'Ada'} | {"name": "Ada"} |
| Chaves sem aspas | {name: "Ada"} | {"name": "Ada"} |
| Comentários | {"a": 1 // note} | JSON não tem comentários |
| Valores que o JavaScript permite | NaN, undefined, 0x1F | null, ou um número simples |
Arquivos de configuração de editores e ferramentas de build costumam usar JSONC, JSON com comentários e vírgulas finais. Ative Permitir comentários e vírgulas finais para lê-los sem erros; a saída formatada então mantém os comentários.
Formatar e minificar
Dois espaços é o estilo mais comum e o que a maioria dos projetos JavaScript usa; quatro espaços e tabulações são comuns em outros lugares. Minificar remove todo espaço e quebra de linha que não esteja dentro de uma string, gerando o menor texto para enviar pela rede ou guardar num campo de banco de dados. Ordenar chaves coloca as chaves de cada objeto em ordem alfabética, em todos os níveis, o que torna dois arquivos JSON bem mais fáceis de comparar no comparador de textos.
Explorar documentos grandes na árvore
A visualização em árvore mostra objetos e arrays como listas aninhadas que você recolhe e expande, com o número de itens de cada um. Clique numa chave para copiar o caminho, como $.data.items[3].price, no estilo JSONPath que ferramentas de consulta e muitos frameworks de teste usam. Arrays longos mostram os primeiros 100 itens, com um botão para mostrar mais, então até respostas de API grandes continuam rápidas de navegar.
Tarefas relacionadas
- Transformar JSON numa planilha com JSON para CSV, que achata objetos aninhados em colunas.
- Converter para YAML ou XML com JSON para YAML e JSON para XML.
- Ler um token que contém JSON com o decodificador de JWT.
Se algo der errado
- Está inválido mas parece certo. Confira a linha destacada e a anterior: uma vírgula faltando é indicada onde começa o valor seguinte.
- Aspas curvas. Texto copiado de um documento ou de um chat pode transformar
"em aspas tipográficas, que o JSON não aceita. Digite-as de novo. - Um número longo aparece diferente na árvore. A árvore mostra os valores como o JavaScript os lê, o que não guarda exatamente mais de uns 16 dígitos significativos. O texto formatado mantém cada número como foi escrito; ainda assim, IDs longos são mais seguros guardados como strings.
Perguntas e respostas
Como valido um JSON?
Cole-o. Se não for válido, a mensagem de erro mostra a linha e a coluna do problema.
Formatar vai mudar meus números ou strings?
Não. O formatador só mexe nos espaços, então números grandes e sequências de escape são mantidos exatamente.
Meus dados são enviados para algum lugar?
Não. Tudo é processado no seu navegador.
Guias relacionados
CSV, Excel ou JSON: qual formato para seus dados?
Salvamos a mesma tabela de 100 mil linhas em CSV, em uma pasta de trabalho do Excel e em JSON, e comparamos os tamanhos, a velocidade de leitura no código e o que dá errado com datas, zeros à esquerda e números longos.