YamlBox

JSON ferramentas · 6 min de leitura

JSON diff: comparando dados da forma como eles são realmente

Uma comparação de texto informa quais caracteres foram alterados. Uma diferença JSON informa quais valores mudaram, e essas são perguntas diferentes — muitas vezes com respostas diferentes. Como a ordem dos objetos JSON não é significativa, uma carga útil que uma comparação baseada em linhas renderiza como uma reescrita total pode ser estruturalmente idêntica, enquanto uma mudança genuína de um único valor aninhado pode se esconder dentro de uma linha minificada muito longa.

Atualizado

Por que as diferenças de texto falham em JSON

Três propriedades de JSON quebram a comparação em nível de caractere. A ordem das chaves não é significativa, portanto, o mesmo objeto serializado de duas maneiras parece diferente linha por linha. Os espaços em branco não são significativos, portanto, um documento bem impresso e seu gêmeo reduzido parecem completamente diferentes. E as matrizes são posicionais, portanto, uma única inserção desloca cada linha seguinte e produz uma cascata de diferenças falsas que enterra a única mudança real.

O que uma comparação estrutural relata em vez disso

Um diff JSON analisa ambos os documentos, percorre as árvores resultantes e relata alterações por caminho: chaves adicionadas, chaves removidas, valores que mudaram de tipo ou conteúdo e entradas de array que foram movidas. A saída parece `spec.replicas: 3 → 5` em vez de vinte linhas de contexto alterado. Essa é a informação que você precisa quando uma implantação se comporta de maneira diferente e você deseja saber o que realmente mudou na configuração.

                - spec.template.spec.containers[0].image
+   ghcr.io/acme/web:1.4.2 → ghcr.io/acme/web:1.5.0
- metadata.annotations["deployed-by"]   (removed)

Usando uma diferença de JSON no trabalho real

  • API versionamento — compare a resposta v1 e v2 para a mesma solicitação e leia a alteração do contrato diretamente dos caminhos.
  • Instantâneos de teste com falha - veja qual campo foi desviado em vez de regenerar o instantâneo e esperar.
  • Revisão da infraestrutura — diferencie um manifesto renderizado antes e depois de uma atualização do gráfico.
  • Verificações de migração — confirme uma exportação mantida em cada chave após uma alteração de esquema ou banco de dados.

A ordem é importante para arrays e não para objetos: um array reordenado é uma mudança real, enquanto um objeto reordenado não é. Uma diferença estrutural JSON sabe a diferença; uma diferença de texto nunca o fará.

Detalhes práticos que vale a pena conhecer

Ambos os documentos devem ser válidos JSON antes que qualquer comparação seja significativa, portanto os erros de validação devem surgir primeiro, com linha e coluna. Observe o desvio de tipo e também o desvio de valor: `"3"` e `3` parecem quase idênticos, mas prejudicam os consumidores que assumem um ou outro. E quando um lado está vazio ou é um único objeto enquanto o outro é um array, isso geralmente é um sinal de uma mudança de forma API em vez de uma mudança de dados. Uma comparação JSON de dois painéis torna ambos os lados visíveis ao mesmo tempo, o que é mais rápido do que comparar um arquivo com uma cópia lembrada.

Mantenha as cargas locais

As diferenças são exatamente os documentos que você menos deseja carregar: respostas de produção, cargas úteis de faturamento, exportações com linhas de clientes. Compará-los no navegador significa que a análise, a caminhada na árvore e a diferença renderizada acontecem em sua máquina, e a ferramenta continua funcionando com a rede desconectada.

JSON Diferença — perguntas frequentes

A ordem das teclas afeta uma diferença JSON?

Não. A ordem das chaves dos objetos não é significativa em JSON, então uma diferença estrutural trata as chaves reordenadas como inalteradas. Se as alterações de ordem forem significativas para você, isso é semântica JSON-com-ordem — por exemplo, um mapa serializado — e pertence a um array.

Como comparo dois arquivos JSON que não são válidos?

Eles precisam ser válidos primeiro. Execute ambos através de um formatador ou validador JSON, corrija a linha e a coluna relatadas e compare. Uma comparação sobre uma entrada malformada produz diferenças que são artefatos do erro de sintaxe, em vez de alterações reais nos dados.

Um diff JSON pode mostrar valores que foram adicionados ou removidos?

Sim – essa é a principal vantagem sobre uma comparação de texto. Os caminhos adicionados e removidos são relatados explicitamente, juntamente com os valores alterados e seus tipos, portanto, uma anotação removida é tão visível quanto uma tag de imagem alterada.

Ferramentas mencionadas nesta postagem

JSON Formatador Imprima, reduza e valide JSON com localizações exatas de erros. YAML a JSON Converta configurações Kubernetes, Docker e CI para JSON com suporte para vários documentos. JSON a TypeScript Gere interfaces digitadas a partir de JSON, com chaves opcionais e uniões inferidas. Esquema JSON a JSON Inferir um esquema JSON pronto para validação a partir de qualquer carga útil de amostra.

Navegue pela lista completa de 19 ferramentas

Mais artigos para ler

Todas as 19 postagens →