IA no seu dispositivo — profissional e privado.

Documentos

Como comparar dois arquivos JSON (e por que uma comparação de texto engana)

Compare dois arquivos JSON e veja quais chaves foram adicionadas, removidas ou alteradas. Por que o diff de texto faz ruído, como os arrays são pareados e o que ignorar.

Atualizado em 7 de novembro de 20269 min de leitura

Para comparar dois arquivos JSON, abra o comparador Diff JSON, solte um arquivo em cada lado (ou cole o texto) e leia a lista de diferenças. Cada uma aparece como adicionada, removida, alterada ou com tipo alterado, com o caminho exato do valor. Ele compara os dados, não o texto, então chaves reordenadas e recuos diferentes não aparecem como mudanças. Essa é toda a razão de usá-lo no lugar de uma comparação de texto comum.

Por que um diff de texto de JSON faz tanto ruído

Uma comparação de texto trabalha linha por linha. O JSON não se importa com linhas. Estes dois documentos têm exatamente os mesmos dados, mas um diff de texto marca todas as linhas como diferentes: um está escrito numa única linha, o outro tem recuo de quatro espaços e as chaves aparecem em outra ordem.

O que é diferenteO diff de texto dizOs dados dizem
Recuo (2 espaços, 4 ou uma tabulação)Todas as linhas mudaramNada mudou
Arquivo inteiro minificado em uma linhaUma linha substituída por outraNada mudou
Chaves em outra ordemLinhas movidas ou reescritasNada mudou: objetos não têm ordem
1 escrito como 1.0Linha alteradaO mesmo número
Um preço que vai de 9,99 para 10,99Uma linha alteradaUm valor alterado

A última linha é a que importa para você, e num diff de texto ela fica enterrada sob as quatro primeiras. Muitas APIs devolvem as chaves numa ordem diferente a cada chamada, e muitos programas reescrevem o recuo ao salvar um arquivo, então o ruído é o caso normal, não a exceção.

Comparar dois arquivos JSON, passo a passo

1

Adicione o documento da esquerda

Abra o comparador Diff JSON. Cole o original na caixa Esquerda (original) ou solte um arquivo .json na área de soltar. A ferramenta também abre arquivos .jsonc, .geojson, .map e .txt.

2

Adicione o documento da direita

Cole ou solte a versão alterada em Direita (alterado). Se você soltar os dois arquivos de uma vez, eles são pareados pelo nome, então billing.before.json e billing.after.json caem no lado certo. Use Trocar lados se ficaram invertidos.

3

Leia as diferenças

A comparação roda enquanto você digita. Escolha Lado a lado, Em linha ou Por caminho. O resumo mostra quantas foram adicionadas, removidas e alteradas, e os botões Próxima mudança e Anterior pulam de uma para outra. Use o filtro para ver só as adicionadas, removidas, alteradas ou as mudanças de tipo.

4

Ajuste o que conta como diferença

Abra as configurações de comparação para ignorar a ordem dos arrays, maiúsculas ou espaços, definir uma tolerância numérica ou pular chaves que sempre mudam. As próximas seções explicam cada uma.

5

Exporte se precisar de um registro

Copiar resumo coloca na área de transferência uma lista simples das mudanças. Baixar patch JSON gera um arquivo padrão que transforma o documento da esquerda no da direita. Baixar Markdown gera um relatório que você pode colar em um chamado ou em um pull request.

Compare dois documentos e veja cada valor adicionado, removido e alterado por caminho. Grátis: um par por vez, até 10 MB por lado, com todas as opções e exportações incluídas. Roda no seu dispositivo, não nos nossos servidores.

Comparar dois arquivos JSON

O que o relatório mostra: adicionado, removido, alterado

A ferramenta percorre os dois documentos juntos e informa cada diferença com sua localização. Objetos são comparados chave a chave, em qualquer profundidade. Uma chave que existe só na direita foi adicionada. Uma que existe só na esquerda foi removida. Uma chave presente nos dois lados com valor diferente foi alterada. Um valor cujo tipo mudou, como o texto "3" virando o número 3, é informado à parte como tipo alterado, porque é a mudança com maior chance de quebrar o que ler o arquivo depois.

As localizações são escritas como caminhos. Em Por caminho você vê onde está cada mudança, por exemplo o nome do segundo item de uma lista de usuários. O patch exportado usa a forma padrão JSON Pointer (/users/1/name), que não é ambígua nem quando uma chave contém um ponto ou uma barra.

  • Números são comparados por valor, então 1, 1.0 e 1e0 são o mesmo número e não são apontados.
  • Reordenar as chaves de um objeto nunca é uma mudança.
  • O nível superior pode ser qualquer coisa que o JSON permita: um objeto, um array ou até uma única string ou um número.
  • Se um documento declara a mesma chave duas vezes, a ferramenta avisa, porque os analisadores guardam em silêncio só o último valor e uma diferença no anterior fica invisível.

Como os arrays são comparados

É nos arrays que as comparações de JSON dão errado. Se duas listas são comparadas estritamente posição por posição, adicionar um item no início faz todos os seguintes parecerem diferentes. A ferramenta evita isso alinhando os itens antes, e mostra ao lado do resumo qual estratégia usou.

EstratégiaQuando é usadaBoa para
Por idVocê indica um campo em Emparelhar itens por campo e todo item tem um valor único neleRegistros de uma API que vieram em outra ordem
Por maior subsequência comumO padrãoListas em que itens foram inseridos ou removidos
Como conjuntoIgnorar ordem dos arrays está ativadaTags, permissões, tudo em que a ordem não significa nada
Por posiçãoAs duas listas quase não têm nada em comumListas que realmente foram substituídas

Emparelhar por id é a opção para listas de registros. Digite o nome do campo (id é o mais comum) e uma lista reordenada aparece como reordenada, com apenas o registro que realmente mudou. A ferramenta só usa o campo se todo item o tiver e nenhum valor se repetir. Se não fosse assim, ela produziria um pareamento arrumado, porém errado, então volta ao padrão em vez de adivinhar.

Ignore o ruído: chaves, caminhos, maiúsculas e números

A comparação estrita é o padrão: cada valor, tipo e posição em um array precisa coincidir. Cada configuração relaxa exatamente uma coisa, e o relatório exportado registra quais estavam ativadas.

  • Chaves a ignorar: liste nomes como updatedAt ou requestId, separados por vírgulas. Elas são puladas onde aparecerem, em qualquer profundidade. É isso que transforma dois instantâneos de uma API em um diff legível.
  • Caminhos a ignorar: pule um local específico, com * para um nível e ** para qualquer número deles. /users/*/lastSeen pula esse campo em todos os usuários.
  • Ignorar maiúsculas e Ignorar espaços: para rótulos que mudaram de estilo ou descrições que foram reformatadas.
  • Tolerância numérica: quão próximos dois números precisam estar para contar como iguais. Com tolerância de 0,0001, o ruído de arredondamento de decimais some, mas uma mudança real de preço continua aparecendo.
  • Permitir comentários e vírgulas finais: para arquivos de configuração escritos em JSONC.

Usos típicos: mudanças de API e divergência de configuração

Para uma API que mudou, salve a resposta de antes e de depois, coloque os campos que sempre mudam (carimbos de data e hora, ids de requisição, etags) nas chaves ignoradas, e o que sobrar é a mudança real de estrutura. Para divergência de configuração entre dois ambientes, como homologação e produção, carregue os dois arquivos e olhe Por caminho: ele lista exatamente quais configurações diferem, e nada além disso. Em uma migração ou exportação, compare o arquivo antigo e o novo e baixe o relatório em Markdown como registro do que se moveu.

Se preferir continuar com um diff de texto comum, por exemplo dentro de uma ferramenta de revisão de código, primeiro deixe os dois arquivos com a mesma aparência: passe cada um pelo formatador de JSON com o mesmo recuo e coloque as chaves numa só ordem com ordenar chaves JSON. Ordenar chaves move apenas as chaves, e os valores não são tocados. Isso remove a maior parte do ruído de texto, mas não faz o que o comparador faz com arrays, tolerâncias ou campos ignorados.

Limites e o que pode dar errado

  • Tamanho: o Grátis compara um par por vez, até 10 MB por lado. O Pro eleva o tamanho ao que o seu dispositivo aguenta e compara até 50 pares ao mesmo tempo, pareados pelo nome do arquivo, com todos os relatórios e patches em um ZIP. Um arquivo acima do limite gratuito é recusado com o tamanho real e um link para o minificador, porque JSON formatado costuma ser em grande parte recuo.
  • Outros formatos: arquivos YAML, XML, CSV e Excel são recusados na entrada, com um link para o conversor certo, como YAML para JSON. Converta primeiro, compare depois.
  • "Sem diferenças" parece errado: verifique se uma configuração de ignorar, uma tolerância numérica alta ou um aviso de chave duplicada explica o resultado.
  • Diferenças demais: acima de 100.000 a lista para de crescer, mas os totais continuam exatos, e a página avisa que a lista foi truncada.
  • Uma lista muito grande em duas ordens diferentes: indique um campo id ou ative Ignorar ordem dos arrays, em vez de ler milhares de movimentos.

A comparação roda no seu dispositivo, não nos nossos servidores, então credenciais e dados de clientes de uma resposta não são enviados para serem comparados. Para uma visão geral de como o JSON se diferencia de outros formatos de dados, veja JSON vs CSV vs XML.

Perguntas frequentes

Como comparo dois arquivos JSON online?

Abra o comparador Diff JSON, solte um arquivo em cada lado ou cole o texto e leia a lista de valores adicionados, removidos e alterados. A comparação roda enquanto você digita. O plano grátis cobre um par de até 10 MB por lado.

Importa se as chaves estão em outra ordem?

Não. Objetos não têm ordem, então um objeto reordenado é comparado como idêntico. Só os arrays têm ordem, e você pode ativar Ignorar ordem dos arrays se isso também não importar.

Como comparo dois arrays JSON quando os itens mudaram de lugar?

Digite o nome de um campo único, em geral id, em Emparelhar itens por campo. Os itens se alinham então por esse valor e não pela posição, e uma lista reordenada mostra só os registros que realmente mudaram. Ou ative Ignorar ordem dos arrays.

Posso ignorar campos como carimbos de data e hora?

Sim. Liste os nomes das chaves em Chaves a ignorar, por exemplo updatedAt, requestId. Elas são puladas em qualquer profundidade. Para pular apenas um local, use Caminhos a ignorar, que aceita os curingas * e **.

Posso comparar JSON com comentários, como um arquivo de configuração?

Sim. Ative Permitir comentários e vírgulas finais, ou solte um arquivo .jsonc, que ativa a opção por você. YAML e XML não são abertos diretamente: converta-os para JSON antes.

Posso salvar as diferenças?

Sim, de três formas, todas no plano grátis: copiar um resumo simples, baixar um patch JSON RFC 6902 ou baixar um relatório em Markdown. O Pro acrescenta lotes de até 50 pares em um ZIP.

Continue lendo

Mais sobre Documentos →