Comparar JSON y encontrar diferencias

¿Qué hace el JSON Diff?

El JSON Diff toma dos documentos JSON — original y versión modificada — y enumera todas las diferencias de forma estructurada. Cada diferencia contiene el JSON Path completo, el valor antiguo y el nuevo, así como el tipo de cambio: añadido, eliminado, modificado o cambio de tipo.

El resultado es una vista compacta con resumen (número de cambios por categoría) y líneas de detalle. Sin registro, sin inicio de sesión, sin subida al servidor.

¿Cómo funciona la comparación?

El algoritmo recorre ambos árboles JSON recursivamente. En cada nivel comprueba:

• Objetos: se comparan las claves. Las claves faltantes cuentan como eliminadas, las nuevas como añadidas, las existentes se comparan recursivamente.
• Matrices: de forma predeterminada, basada en la posición — el elemento en el índice 0 de la izquierda se compara con el elemento en el índice 0 de la derecha. Con la directiva // ignore-array-order en la primera línea, el algoritmo cambia a igualdad de valor: los elementos se emparejan independientemente de su posición.
• Primitivos: los valores se comparan directamente. Si el tipo no coincide (p. ej., "42" frente a 42), se notifica un cambio de tipo, no solo un cambio de valor.

Antes de la comparación, cada documento se valida con JSON.parse(). Los errores de sintaxis se notifican con el número de línea.

¿Qué ejemplos de aplicación existen?

Escenario	Descripción
Comparación de respuestas de API	Comparar dos respuestas del mismo endpoint para detectar deriva de esquema.
Diff de configuración	Comprobar package.json, tsconfig.json o configuraciones de CI antes y después de un cambio.
Reconciliación de exportaciones de base de datos	Comparar dos exportaciones JSON de una base de datos para identificar registros modificados.
Ayuda en revisión de código	Comparar fixtures JSON en pruebas para encontrar cambios involuntarios.
Auditoría de feature flags	Comparar dos versiones de una configuración de feature flags para detectar indicadores activados o desactivados.
Comprobación de localización	Comparar dos archivos JSON de idioma para encontrar claves de traducción faltantes o sobrantes.

¿Qué áreas de uso existen?

Desarrollo de API y depuración. Los equipos de backend comparan respuestas de API antes y después de un despliegue. El JSON Path de cada cambio facilita la localización del punto afectado en el código. Los cambios de tipo (p. ej., "price": "9.99" → "price": 9.99) se marcan explícitamente — un error frecuente en cambios de serialización.

DevOps y gestión de configuración. Los archivos de estado de Terraform, las configuraciones de Docker Compose o los manifiestos de Kubernetes en JSON se comparan rápidamente. La opción de orden de matrices es especialmente útil en listas de variables de entorno cuyo orden es semánticamente irrelevante.

Comprobación de calidad de datos. Los analistas de datos comparan exportaciones JSON de distintas fuentes o momentos. El diff muestra no solo valores modificados, sino también desviaciones estructurales como campos faltantes o incoherencias de tipo.

Desarrollo frontend. Los datos simulados, los archivos JSON i18n y los archivos de fixtures para pruebas cambian con frecuencia. El JSON Diff ayuda a detectar cambios involuntarios en las pull requests antes de su fusión.

Preguntas frecuentes

Las respuestas a las preguntas más importantes se encuentran arriba en el bloque de preguntas frecuentes — se entregan como JSON-LD estructurado (FAQPage) para los motores de búsqueda.

¿Qué herramientas para desarrolladores están relacionadas?

Otras herramientas del ecosistema kittokit que encajan con el tema:

• JSON Formatter — formatear el código JSON de forma legible, validar y detectar errores de sintaxis con el número de línea.
• Text-Diff — comparar dos textos y resaltar las diferencias a nivel de palabra y línea con colores.
• XML Formatter — sangrar, validar y formatear el código XML de manera ordenada.