Como comparar dois conteúdos JSON e encontrar diferenças estruturais
Cole dois conteúdos JSON para verificar se as suas estruturas coincidem e identificar propriedades, valores ou posições de listas diferentes. O resultado indica se são idênticos e, quando aplicável, apresenta a contagem e os tipos de diferenças detetadas.
Para que serve esta comparação
O JSON Diff serve para comparar dois conteúdos JSON e perceber se as estruturas resultantes coincidem. É adequado quando pretende verificar diferenças em objetos ou listas aninhados, em vez de fazer uma comparação superficial do texto. Cada entrada é opcional e pode receber texto com dados JSON; não é necessário preencher ambas para obter um resultado.
Como comparar dois conteúdos JSON
- Separe os dois conteúdos JSON que pretende analisar. Pode usar objetos, listas ou uma combinação de estruturas aninhadas.
- Cole o primeiro conteúdo no campo de entrada correspondente e o segundo no outro campo. As entradas aceitam texto JSON e não são obrigatórias.
- Inicie a comparação.
- Se ambos os conteúdos forem JSON válidos e não contiverem apenas espaços em branco, leia o resultado estrutural. Verifique a indicação sobre a identidade das entradas e consulte as diferenças detetadas.
- Analise as diferenças por categoria: podem surgir propriedades de objetos adicionadas ou removidas, valores alterados, comprimentos de listas diferentes ou diferenças em posições correspondentes de uma lista.
- Se uma entrada estiver vazia ou contiver apenas espaços, interprete o resultado com cuidado: a operação é bem-sucedida e não apresenta diferenças, mas indica que as entradas não são idênticas.
- Se o resultado indicar uma falha de análise, reveja o texto JSON introduzido. Um conteúdo não vazio que não possa ser interpretado como JSON produz informação sobre o erro de análise e não apresenta diferenças.
A comparação considera a estrutura interpretada, incluindo objetos e listas aninhados. Por isso, confirme primeiro que os conteúdos representam dados JSON válidos antes de tirar conclusões sobre as diferenças.
Como ler o resultado
Um resultado bem-sucedido indica se as estruturas JSON interpretadas são idênticas. Quando existem diferenças, o resultado inclui também a respetiva contagem, além das alterações estruturais detetadas. Use essa informação para localizar propriedades acrescentadas ou retiradas, valores que mudaram e alterações na organização de listas.
Uma entrada em branco não deve ser confundida com uma comparação entre dois JSON equivalentes: nesse caso, não são reportadas diferenças, mas as entradas são indicadas como não idênticas. Do mesmo modo, um erro de análise significa que pelo menos um conteúdo não pôde ser interpretado; não significa que os dois conteúdos sejam iguais.
A ferramenta descreve diferenças entre estruturas JSON interpretadas. Não é uma comparação geral de texto ou formatação e não cria uma correção, uma fusão ou uma recomendação para resolver as alterações.
Exemplo prático
Uma pessoa quer confirmar se a etiqueta de idioma mudou entre duas versões de um objeto JSON.
Cole no primeiro campo {"nome":"Ana","tags":["pt"]} e no segundo {"nome":"Ana","tags":["en"]}; depois inicie a comparação.
O resultado indica que as estruturas não são idênticas e apresenta uma contagem de diferenças, com informação sobre o valor alterado; a forma exata da apresentação depende do resultado da comparação.
Limitações
- A ferramenta compara estruturas JSON interpretadas, não texto ou formatação em geral, e não produz uma fusão, uma correção ou uma recomendação para resolver diferenças.
Erros comuns
- Colar JSON inválido, como uma chave sem aspas ou uma vírgula a mais, provoca um erro de análise. Corrija a sintaxe de cada entrada e volte a iniciar a comparação.
Perguntas frequentes
O JSON Diff compara o texto ou a estrutura?
Quando ambas as entradas contêm JSON válido e não estão em branco, a ferramenta compara as estruturas interpretadas, incluindo objetos e listas aninhados.
O que acontece se deixar uma entrada vazia?
Se uma entrada estiver vazia ou contiver apenas espaços, a operação é bem-sucedida, não apresenta diferenças e indica que as entradas não são idênticas.
Como é indicado um JSON inválido?
Se um conteúdo não vazio não puder ser interpretado como JSON, o resultado indica uma falha, inclui informação sobre o erro de análise e não apresenta diferenças.