JSON Diff (Comparar)

¿Qué es 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 }]

Características principales

Ejemplos

{"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}]}

Cómo usar

1. 1

   Pega ambos documentos JSON

   Pega el JSON original (izquierda) y el modificado (derecha). El diff en vivo se renderiza mientras escribes; las entradas grandes (>200 KB) cambian a un botón manual de Diff.

2. 2

   Filtra el ruido

   Haz clic en un preset (Timestamps / IDs / Trace) o pega patrones Extended JSON Pointer en las rutas ignoradas para eliminar campos irrelevantes.

3. 3

   Elige la vista que necesitas

   Vista lateral para revisión humana, JSON Patch (RFC 6902) para operaciones aplicables por máquinas. Usa Compartir enlace para enviar la configuración a un compañero.

Errores comunes al comparar

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 comunes

Regresión de respuesta de API

Compara respuestas de staging vs producción; ignora marcas de tiempo e IDs de petición para mostrar solo los cambios de payload significativos.

Fallos de pruebas de snapshot en CI

Pega el actual vs el esperado de un snapshot fallido en Jest/Vitest. Filtra el ruido y encuentra el cambio real en segundos.

Conflictos en package-lock / yarn.lock

Resuelve conflictos de fusión alineando dependencias por nombre; el orden de claves y los campos no relacionados dejan de ser ruido.

Auditoría de valores K8s / Helm

Alinea envs, volumeMounts y ports por nombre. Detecta ordenaciones no intencionadas frente a ediciones reales de configuración.

Cobertura de traducción i18n

Compara en.json contra zh.json estructuralmente para encontrar claves de traducción faltantes o extra sin ruido de valores.

Revisión de plan Terraform / CDK

Compara la salida del plan entre ejecuciones; la tolerancia numérica gestiona la aritmética de punto flotante, las rutas ignoradas eliminan ARNs y marcas de tiempo.

Detalles técnicos

Salida de patch conforme con RFC 6902

Genera operaciones JSON Patch válidas (add/remove/replace) con rutas RFC 6901. Verificado contra los paquetes npm fast-json-patch@3.x y rfc6902.

Traversal iterativo

Recorrido con pila explícita (sin recursión) limitado a 100.000 nodos y profundidad 64 para evitar desbordamiento de pila en entradas adversariales.

Igualdad numérica con Object.is

La tolerancia numérica predeterminada es 0 — usa Object.is para distinguir -0 de +0. Establece tolerancia > 0 para igualdad basada en épsilon.

Buenas prácticas

Filtra antes de revisar

Añade primero las rutas ignoradas (marcas de tiempo, IDs, campos de traza) y luego lee el diff. Revisar diffs ruidosos entrena el ojo a saltarse — y perderse — los cambios reales.

Coincidencia por clave para conjuntos lógicos

Si tu array representa un conjunto desordenado (envs, usuarios, dependencias), usa Coincidir por clave. El diff secuencial en conjuntos lógicos casi siempre es incorrecto.

Comparte el enlace, no las entradas

Usa Compartir enlace para enviar a un compañero tu configuración de filtros — nunca pegues JSON sensible en documentos compartidos. La URL contiene solo la configuración.

Preguntas frecuentes