Ajuda

Formatar JSON online: indente e valide seu JSON

Com esta ferramenta você consegue formatar JSON: cole um JSON bruto ou minificado e receba de volta indentado, colorido e verificado. Números grandes, a ordem das chaves e chaves duplicadas saem exatamente como você escreveu. Se o JSON estiver quebrado, você vê o que há de errado e em qual linha e coluna.


Como formatar JSON online passo a passo

Para usar este formatador, siga estes passos:

  1. Cole seu JSON na caixa JSON bruto (nela está escrito “Cole o JSON bruto aqui...”). O que você cola é formatado na hora. Se você digitar, o resultado se atualiza cerca de 300 milissegundos depois que você parar.
  2. Leia o resultado em JSON formatado. Chaves, strings, números, true / false e null têm cada um a sua cor. Linhas longas rolam para o lado em vez de quebrar, para que a indentação continue fácil de ler.
  3. Se o JSON for válido, “JSON válido.” aparece abaixo do resultado. Se não for, uma caixa vermelha JSON inválido explica o motivo.
  4. Selecione Copiar no título do resultado. O botão mostra “Copiado” por um instante, e o que você cola é texto simples, sem cores.
  5. Selecione Limpar embaixo para esvaziar a caixa e começar de novo.

JSON pretty print com 2 espaços, 4 espaços ou tabulação

Selecione o ícone de engrenagem ao lado do título para abrir Indentação. As opções são 2 espaços (o padrão), 4 espaços e Tabulação. O resultado muda assim que você escolhe, e a configuração vale também para o texto que você copia. Assim você pode indentar JSON do jeito que o seu projeto pede.

Dois espaços dão as linhas mais curtas em dados muito aninhados. Quatro espaços ou tabulações combinam com o guia de estilo de muitos projetos.

Por que números e ordem das chaves não mudam

A maioria dos formatadores lê seu texto como um objeto e o imprime de novo. Essa ida e volta reescreve dados sem avisar. Este json formatter lê o texto original, confere com as regras do JSON e altera apenas os espaços em branco entre os elementos. Todo o resto é copiado caractere por caractere.

Veja o mesmo texto {"id":12345678901234567890,"price":1.0,"tag":"a","tag":"b","b":1,"2":3} passando por esta ferramenta e por JSON.parse seguido de JSON.stringify:

Isso importa para IDs de banco de dados, números de pedido e preços copiados da resposta de uma API: o texto formatado traz os mesmos dados do original, só que mais fácil de ler.

Validar JSON e entender as mensagens de erro

Para validar JSON, a ferramenta confere JSON estrito (RFC 8259). Quando o texto não passa, a caixa JSON inválido dá o motivo em linguagem simples e “Linha N, coluna M” do primeiro problema encontrado. Casos típicos:

A mesma caixa cobre ainda uma string que nunca é fechada, uma barra invertida de escape inválida e um colchete que continua aberto no fim (“O texto termina cedo demais”). Um espaço não separável colado de uma página da web ou de um chat aparece como U+00A0 para que você o encontre e apague, e uma marca de ordem de bytes bem no início de um arquivo é ignorada.

Um exemplo com várias linhas: em {"a": 1,, "b": 2 e "c": 3}, falta a vírgula na segunda linha. A ferramenta informa “Linha 3, coluna 2”, as aspas de abertura de "c", onde antes deveria haver uma vírgula.

Limites e o que a ferramenta não faz


Perguntas frequentes

Como formatar JSON online?

Cole seu JSON na caixa “JSON bruto”. Ele é formatado na hora ao colar, ou cerca de 300 milissegundos depois que você parar de digitar, e o resultado indentado aparece abaixo em “JSON formatado”. Selecione “Copiar” para levá-lo. A formatação acontece no navegador, então seu JSON nunca é enviado.

Como fazer um json pretty print com 4 espaços ou tabulações?

Selecione o ícone de engrenagem ao lado do título para abrir o menu “Indentação” e escolha 2 espaços, 4 espaços ou “Tabulação”. O padrão são 2 espaços, e o resultado muda assim que você escolhe outra opção.

Como usar o validador JSON online para saber se meu JSON é válido?

Basta colar. Um documento válido é formatado e “JSON válido.” aparece abaixo do resultado. Um inválido mostra uma caixa vermelha “JSON inválido” com o motivo em linguagem simples e a linha e a coluna do problema.

Por que meu JSON dá erro de vírgula no final?

O JSON não permite vírgula depois do último item de um objeto ou de uma lista, como em [1, 2,]. A ferramenta aponta o fechamento que vem depois da vírgula sobrando. Apague a vírgula e o JSON é formatado.

O JSON pode ter comentários?

Não. O JSON estrito (RFC 8259) não tem sintaxe de comentário, então // e /* */ são erros, mesmo que alguns arquivos de configuração os aceitem. A ferramenta informa “O JSON não permite comentários.” na linha e na coluna exatas, e você remove o comentário para continuar.

O que significa o erro json unexpected token?

Significa que o analisador encontrou, naquele ponto, um caractere que não esperava. Esta ferramenta diz qual caractere encontrou, o que esperava no lugar (por exemplo, uma vírgula ou um fechamento) e informa a linha e a coluna, o que costuma bastar para ver o erro de digitação.

Formatar muda meus números ou a ordem das chaves?

Não. A ferramenta confere seu texto original e reescreve apenas os espaços em branco entre os elementos. Números, strings, ordem das chaves e chaves duplicadas são copiados exatamente, então 12345678901234567890 não é arredondado e 1.0 continua 1.0. JSON.parse seguido de JSON.stringify muda tudo isso.

Meu JSON é enviado para algum lugar?

Não. O JSON é formatado inteiramente no seu dispositivo e nada é enviado nem salvo.

Qual a diferença entre json formatter, json beautifier e validador json?

Um formatter e um beautifier acrescentam quebras de linha e indentação para que o JSON fique fácil de ler. Um validador confere se o texto é um JSON válido. Esta ferramenta faz as duas coisas em um passo: valida de forma estrita e, se o JSON for válido, formata.