Formatar JSON

Organize um JSON bagunçado, minifique para enviar ou encontre a linha com erro. Seus dados não saem do navegador.

Cole o JSON e clique em Formatar. Atalho: Ctrl ou Cmd + Enter.

Indentação
Opções

Como usar

  1. Cole o JSON na caixa de entrada ou clique em Abrir arquivo para escolher um arquivo .json.
  2. Clique em Formatar para indentar ou em Minificar para remover espaços e quebras de linha.
  3. Se houver erro, aparecem a linha, a coluna e a causa. Clique em Ir para o erro para pular até ele.

As regras do JSON

O JSON é definido pela RFC 8259 (dezembro de 2017). Ele tem só sete tipos de valor: objeto {}, array [], string, número, true, false e null, e essas três palavras são sempre minúsculas. Qualquer valor pode ficar no nível de cima, então "olá" ou 42 sozinhos já são JSON válido.

  • Strings usam aspas duplas. A aspa, a barra invertida e os caracteres de controle U+0000 a U+001F (inclusive a quebra de linha) precisam de escape, como \", \\, \n ou \u00e9.
  • Números são decimais, sem zero à esquerda, sem sinal de mais e com ponto como separador decimal. 0.5 e 1e-3 valem; .5, 1., 007, 0,5, 0x1F, NaN e Infinity, não.
  • Espaços permitidos: espaço, tab, quebra de linha e retorno de carro, em volta de { } [ ] : ,.
  • Nomes dentro de um objeto deveriam ser únicos. Se repetirem, a RFC diz que o comportamento de quem recebe é imprevisível. O JSON.parse do navegador fica com o último valor; esta ferramenta mantém os dois ao formatar.

JSON trocado entre sistemas abertos deve estar em UTF-8 e sem marca de ordem de bytes (BOM) no início. A ferramenta remove a BOM se encontrar uma.

Os erros mais comuns

  • Vírgula no fim: [1, 2,] → [1, 2]
  • Aspas simples: {'a': 'b'} → {"a": "b"}
  • Nome sem aspas: {a: 1} → {"a": 1}
  • Valores do Python: True, None → true, null
  • Vírgula decimal: {"preco": 9,95} → {"preco": 9.95}
  • Caminho do Windows: "C:\dados" → "C:\\dados"
  • Comentário: // nota → removido

A ferramenta confere o texto caractere por caractere, então consegue dizer a causa, e não só a posição. Para {"a": 1 "b": 2} ela mostra Linha 1, coluna 9: Falta uma vírgula entre dois valores. Um True do Python recebe Escreva true em minúsculas. Vírgula decimal dentro de array é ainda pior: [9,95] é válido, mas são dois números, 9 e 95.

JSON não é objeto JavaScript

O JSON parece um literal de objeto do JavaScript, mas é bem mais rígido. O JavaScript aceita nomes sem aspas, aspas simples, vírgula no fim, comentários, undefined, funções e números hexadecimais; o JSON não aceita nenhum deles. O contrário funciona: desde o ES2019, todo texto JSON válido também é uma expressão JavaScript válida.

Números grandes e ordem das chaves

Formatar e Minificar só mexem nos espaços. Em {"id":12345678901234567890,"preco":25000.50}, os dois números ficam como estão. Passando por JSON.parse, o ID viraria 12345678901234567000 e o preço 25000.5, porque números em JavaScript só são exatos até 253 − 1. Ordenar chaves segue a ordem dos códigos de caractere: maiúsculas antes das minúsculas e é depois de z.

Perguntas frequentes

Meu JSON é enviado para algum servidor?
Não. Tudo roda no seu navegador, então dá para usar com arquivos de configuração, respostas de API ou dados que contêm tokens.
Números grandes e caracteres especiais mudam?
Não. A ferramenta só reorganiza os espaços sem mexer no conteúdo, então números longos, como um ID de 19 dígitos, e escapes como \u00e9 ficam exatamente como estavam. Um formatador que passa por JSON.parse transforma 12345678901234567890 em 12345678901234567000.
Quais são os erros mais comuns?
Vírgula depois do último item de uma lista ou objeto, aspas simples em vez de duplas, nomes de propriedade sem aspas, comentários e valores como undefined ou True. Nada disso é permitido no JSON padrão.
Posso escrever decimais com vírgula?
Não. No JSON o separador decimal é sempre o ponto: 9.95. Com 9,95 dentro de um objeto, a vírgula vira separador e aparece um erro; num array, [9,95] passa sem erro, mas vira dois números. Se precisar da vírgula, guarde o valor como texto: "9,95".
Dá para validar JSON com comentários, como o tsconfig.json?
Dá para abrir, mas ele será marcado como inválido, porque o JSON padrão da RFC 8259 não tem comentários. Arquivos como o tsconfig.json são lidos por analisadores que aceitam comentários. Tire os comentários se precisar de JSON válido.
Qual o tamanho máximo de arquivo?
Dá para abrir arquivos de até 50 MB, e os de alguns MB costumam ser processados sem espera perceptível. Acima de um milhão de caracteres, a verificação automática durante a digitação fica desligada; clique em Formatar ou Validar para conferir.