JSON Diff (Comparar)

O que é JSON Diff?

// Two JSON documents that look different but are semantically equal
const a = '{"a":1,"b":2}';
const b = '{"b":2,"a":1}';

// Naive comparison — wrong
JSON.stringify(JSON.parse(a)) === JSON.stringify(JSON.parse(b));
// → false (key order differs)

// JSON Diff (this tool) — correct: key order is irrelevant
// → 0 differences

// JSON Patch (RFC 6902) for { "a": 1 } → { "a": 2 }
// [{ "op": "replace", "path": "/a", "value": 2 }]

Funcionalidades Principais

Exemplos

{"user":{"id":1,"name":"Ada","createdAt":"2024-01-01"}}

{"user":{"id":1,"name":"Ada Lovelace","createdAt":"2024-02-02"}}

{"a":1,"b":2,"c":3}

{"c":3,"a":1,"b":2}

[{"id":1,"qty":3},{"id":2,"qty":5}]

[{"id":2,"qty":5},{"id":1,"qty":4}]

{"items":[{"id":1,"price":29.99}]}

{"items":[{"id":1,"price":24.99}]}

Como Usar

1. 1

   Cole os dois documentos JSON

   Cole o JSON original (esquerda) e o modificado (direita). O diff ao vivo é renderizado enquanto você digita; entradas grandes (>200 KB) mudam para um botão Diff manual.

2. 2

   Filtre o ruído

   Clique em um preset (Timestamps / IDs / Trace) ou cole padrões de Extended JSON Pointer em Ignorar caminhos para eliminar campos irrelevantes.

3. 3

   Escolha a visualização que você precisa

   Lado a Lado para revisão humana, JSON Patch (RFC 6902) para operações aplicáveis por máquina. Use Share Link para enviar a configuração a um colega.

Armadilhas Comuns do Diff

diff a.json b.json   # text diff: 'everything changed'

JSON Diff (this tool): 0 differences

{"a": null} == {}   # collapsed by some tools

{"a": null} ≠ {}     # type-strict diff

Sequential diff: 4 modified

Match by key (id): 0 differences

{"id": 42} vs {"id": "42"}   # serialization bug

Diff reports 'modified (type)' with both values

tolerance=0:  0.30000000000000004 ≠ 0.3

tolerance=1e-9: equal

Diff: 47 modifications (45 are timestamps)

Add /createdAt, /updatedAt, /requestId to Ignore paths → 2 real changes

Casos de Uso Comuns

Regressão de Resposta de API

Compare respostas de staging vs produção; ignore timestamps e IDs de requisição para exibir apenas alterações significativas no payload.

Falhas em Testes de Snapshot de CI

Cole o real vs esperado de um snapshot falhando no Jest/Vitest. Filtre o ruído e encontre a mudança real em segundos.

Conflitos de package-lock / yarn.lock

Resolva conflitos de merge alinhando dependências por nome; ordem de chaves e campos não relacionados deixam de ser ruído.

Auditoria de Valores K8s / Helm

Combine envs, volumeMounts e ports por nome. Detecte ordenações não intencionais vs edições reais de configuração.

Cobertura de Tradução i18n

Faça diff estrutural de en.json contra zh.json para encontrar chaves de tradução faltando ou extras sem ruído de valores.

Revisão de Plano Terraform / CDK

Compare a saída do plano entre execuções; a tolerância numérica lida com aritmética de ponto flutuante, ignore caminhos descartam ARNs e timestamps.

Detalhes Técnicos

Saída de Patch Compatível com RFC 6902

Gera operações JSON Patch válidas (add/remove/replace) com caminhos RFC 6901. Verificado contra fast-json-patch@3.x e os pacotes npm rfc6902.

Travessia Iterativa

Travessia com pilha explícita (sem recursão) limitada a 100.000 nós e profundidade 64 para evitar estouro de pilha em entradas adversariais.

Igualdade Numérica com Object.is

A tolerância numérica padrão é 0 — usa Object.is para que -0 e +0 sejam distinguidos. Defina tolerância > 0 para igualdade baseada em epsilon.

Boas Práticas

Filtre Antes de Revisar

Adicione Ignorar caminhos primeiro (timestamps, IDs, campos de trace), depois leia o diff. Revisar diffs ruidosos treina o olho a pular — e perder — mudanças reais.

Combinar por Chave para Conjuntos Lógicos

Se seu array representa um conjunto desordenado (envs, usuários, dependências), use Combinar por chave. Diff sequencial em conjuntos lógicos quase sempre está errado.

Compartilhe o Link, Não as Entradas

Use Share Link para enviar a um colega sua configuração de filtro — nunca cole JSON sensível em documentos compartilhados. A URL contém apenas a configuração.

Perguntas Frequentes