Comparador JSON

Un diff de JSON muestra las diferencias estructurales entre dos documentos JSON: claves añadidas (presentes en el segundo pero no en el primero), claves eliminadas (presentes en el primero pero no en el segundo) y valores cambiados (presentes en ambos pero con valores diferentes). Las claves sin cambios generalmente se omiten o se muestran como contexto. Un diff completo también puede detectar reordenaciones de arrays y cambios de tipo.

JSON Patch (RFC 6902) describe cambios en un documento JSON como una serie de operaciones: add, remove, replace, move, copy y test. Cada operación es un objeto con un tipo op y una ruta (JSON Pointer). Por ejemplo: {"op": "replace", "path": "/name", "value": "Alice"}. JSON Patch se usa en solicitudes HTTP PATCH y es la forma estándar de describir actualizaciones incrementales de JSON en APIs.

La comparación de arrays es complicada porque dos arrays semánticamente equivalentes pueden diferir en el orden de los elementos. La diferenciación simple compara por índice — array[0] en A frente a array[0] en B. Esto puede producir diffs engañosos cuando se insertó un elemento al principio. Los algoritmos más sofisticados usan la subsecuencia común más larga (LCS) para identificar elementos movidos. Esta herramienta compara arrays por índice para mayor simplicidad.

JSON Merge Patch (RFC 7396) es una alternativa más simple a JSON Patch. Representa los cambios como un documento JSON parcial: las claves con valores reemplazan las claves existentes; las claves con valores nulos eliminan claves; las claves ausentes del parche dejan el original sin cambios. Es más simple de construir pero menos expresivo — no puede representar establecer un valor a null sin eliminar la clave.

Casos de uso comunes: comparar respuestas de API antes y después de un cambio de código, depurar la desviación de configuración entre entornos, revisar qué cambió en un registro de base de datos basado en JSON, comparar fixtures de prueba y verificar que una migración de datos produjo el resultado esperado. El diff de JSON también es útil para entender qué cambió cuando una API de terceros actualiza su formato de respuesta.