Comparar dois arquivos JSON

Como comparar dois arquivos JSON

1. Colocar os dois documentos. Cole o texto ou solte um .json em cada caixa. A leitura acontece nesta aba, sem upload.
2. Ler a lista de diferenças. Cada linha é uma diferença: o caminho, se foi incluída, removida ou alterada, e o valor de cada lado.
3. Ignorar o que é só sintaxe. Chaves em outra ordem e outra indentação não geram linha nenhuma.
4. Levar a lista adiante. Baixe em CSV ou copie, e cole no chamado ou na revisão.

Por que um diff de texto pinta tudo de vermelho

{"b":1,"a":2} e {"a":2,"b":1} são o mesmo objeto. Quase toda biblioteca que regrava um JSON muda a ordem das chaves, troca a indentação ou tira a quebra de linha do final. Um comparador de texto, linha contra linha, mostra então o arquivo inteiro como alterado — e as duas mudanças que importavam se perdem no meio.

Aqui os dois lados são interpretados antes da comparação. O que sobra na lista é só o que mudaria o comportamento de quem consome o JSON.

Homologação contra produção: o caso de uso mais comum

A pergunta que traz a maioria das pessoas a um comparador de JSON é «a resposta mudou entre um ambiente e outro?» — ou entre a versão antiga e a nova de uma integração. Cole a resposta de homologação de um lado e a de produção do outro. Se a única diferença for que o servidor novo escreve as chaves em outra ordem, o resultado é zero diferenças, e isso também é uma resposta.

Acentos: o que conta como igual e o que não conta

• "S\u00e3o Paulo" e "São Paulo" são iguais. O escape \u00e3 é só outra forma de escrever ã dentro de um JSON, e muitas bibliotecas escapam todo caractere acentuado ao gravar. Como a comparação é feita depois da leitura, essa troca não aparece como diferença.
• Um ã composto e um a seguido de til combinante são diferentes. Na tela os dois parecem idênticos, mas são sequências Unicode diferentes (NFC e NFD), e a comparação é exata, caractere a caractere. Se uma linha mostra o mesmo texto dos dois lados, é isso. A página não normaliza essa forma.
• O arquivo é lido como UTF-8, que é o que o padrão JSON exige. Um .json salvo em ANSI (Windows-1252) por algum sistema antigo aparece com os acentos quebrados; esta página não tenta adivinhar a codificação de arquivos JSON.

Tipos são comparados, não convertidos

5 e "5" são diferentes, assim como false e 0, ou null e uma chave ausente. No Brasil aparece muito um caso a mais: um valor que um sistema manda como número, 1234.5, e o outro como texto formatado, "1.234,50". Isso é relatado como tipo alterado no caminho exato — que é justamente o tipo de mudança silenciosa que quebra uma integração numa versão menor.

Arrays guardam a ordem; objetos, não

As chaves de um objeto formam um conjunto, sem ordem. Os itens de um array formam uma sequência, e a ordem é a informação. Por isso [1,2,3] contra [3,2,1] dá duas posições alteradas, e um item acrescentado no fim aparece como uma única inclusão em itens[3]. Subárvores longas são resumidas numa célula ({4 fields}, [9 items] — esse resumo sai em inglês), e as linhas abaixo dizem o que mudou dentro.

O que esta página não faz

• Mesclar. Ela lista diferenças; não produz um terceiro documento.
• Casar itens de array por id. Arrays são comparados por posição. Se os dois arquivos têm os mesmos registros em outra ordem, ordene antes — ou, se os dados forem tabela, comparar duas planilhas casa as linhas por uma coluna chave.
• Consertar JSON quebrado. Um arquivo que não abre é relatado com a posição em que o interpretador reclamou: vírgula sobrando, aspas simples, comentário.
• Ler JSON Lines ou JSON5. Só JSON padrão.

Respostas de API costumam ter dados que não deveriam sair daqui

Um JSON colado num comparador costuma ser uma resposta de API, um arquivo de configuração ou uma exportação — com token, chave de acesso ou CPF de cliente no meio. Os dois documentos são lidos e comparados pelo JavaScript desta aba. Nenhuma requisição leva o conteúdo deles.

O TableDI 2 é um aplicativo de desktop para o trabalho com arquivos que se repete a cada período: ele guarda suas fontes, suas regras e a entrega como um trabalho, e no mês seguinte você coloca os arquivos novos e roda de novo. Tudo roda na sua própria máquina. Ele compara arquivos de planilha de um período para o outro; para JSON avulso, esta página basta.