Cómo comparar dos JSON y detectar diferencias estructurales

Qué puedes comprobar con la herramienta

JSON Diff sirve para contrastar dos textos que contienen datos JSON y comprobar si sus estructuras analizadas coinciden. No compara el texto como una cadena de caracteres: interpreta cada entrada JSON y revisa sus objetos, sus matrices y los valores que contienen. Así puede ayudarte a revisar respuestas de una API, configuraciones o datos que han cambiado entre dos versiones, siempre que puedas disponer de ambas entradas.

Cómo comparar dos JSON paso a paso

1. Prepara las dos entradas. Copia el primer JSON en el campo de entrada inicial y el segundo en el campo siguiente. Las dos entradas son opcionales, pero para una comparación útil deben contener JSON válido y no estar formadas únicamente por espacios en blanco.

2. Comprueba el formato. Revisa que cada objeto use comillas dobles en sus nombres y cadenas, que las llaves y los corchetes estén equilibrados y que no haya una coma después del último elemento. Si trabajas con matrices, conserva el orden de sus posiciones.

3. Inicia la comparación. Ejecuta la herramienta con las dos entradas preparadas. La comparación analiza las estructuras resultantes, incluidos los objetos y las matrices anidados, en lugar de limitarse a buscar diferencias visuales entre líneas.

4. Lee el estado de la comparación. Busca la indicación de si las entradas analizadas son idénticas. Si hay diferencias, revisa también el recuento y el detalle comunicado para localizar propiedades añadidas o eliminadas, valores modificados, cambios en la longitud de una matriz o diferencias dentro de posiciones correspondientes.

5. Corrige el origen si aparece un error. Cuando una entrada no se puede interpretar como JSON, la operación termina sin diferencias reportadas e incluye información sobre el error de análisis. Corrige esa entrada y vuelve a ejecutarla; no trates el resultado fallido como una comparación válida.

Cómo interpretar el resultado y sus límites

Una comparación correcta indica si las estructuras interpretadas son idénticas. Si lo son, no esperes un listado de cambios. Si no lo son, el recuento de diferencias te ayuda a valorar el alcance de la variación y el detalle permite distinguir entre una propiedad nueva, una propiedad ausente, un valor cambiado, una matriz con otra longitud o una diferencia en una posición relacionada.

Hay una excepción importante al revisar entradas vacías: si una de las dos está vacía o solo contiene espacios, la herramienta termina correctamente, no informa de diferencias y señala que las entradas no son idénticas. Ese resultado no equivale a haber comparado dos documentos JSON completos.

Por ejemplo, una persona pega un JSON de configuración con {"modo":"prueba","puertos":[80,443]} y otra versión con {"modo":"produccion","puertos":[80,443,8080]}. Tras ejecutar la comparación, el resultado puede tener la forma de una indicación de que las entradas no son idénticas, un recuento de diferencias y detalles sobre un valor modificado y una longitud de matriz distinta. La herramienta informa de la variación; no genera una corrección ni decide qué versión debes conservar.

Ten presente también el alcance: el resultado describe diferencias estructurales entre los dos JSON interpretados. No sustituye una revisión del significado de los datos ni funciona como una comparación general de texto. El contrato declarado de la herramienta especifica que no tiene acceso a la red, pero ese dato no permite concluir dónde se ejecuta ni cómo se gestionan los datos introducidos.

Ejemplo práctico

Una persona revisa dos versiones de una configuración para localizar cambios en un modo de ejecución y en la lista de puertos.

Pega el JSON de configuración de prueba y su segunda versión en las dos entradas, y ejecuta la comparación.

El resultado indica que las entradas no son idénticas, incluye un recuento de diferencias y detalla un valor modificado y una longitud de matriz distinta.

Limitaciones

• La herramienta compara estructuras JSON interpretadas, no texto general. Su contrato declarado especifica que no tiene acceso a la red, pero esto no informa sobre el entorno de ejecución ni sobre la gestión de los datos introducidos.

Errores frecuentes

• Causa: una entrada contiene JSON no válido, por ejemplo, comillas simples o una coma sobrante. Corrección: valida y corrige ambos textos antes de repetir la comparación; un resultado con error no incluye diferencias utilizables.

Preguntas frecuentes

¿Puedo comparar JSON con objetos y matrices anidados?

Sí, siempre que las dos entradas contengan JSON válido y no estén vacías o formadas solo por espacios. La herramienta interpreta los datos y compara también sus objetos y matrices anidados.

¿Qué tipos de cambios puede detectar?

El resultado puede señalar propiedades añadidas o eliminadas, valores modificados, cambios en la longitud de una matriz y diferencias dentro de posiciones correspondientes. Cuando detecta diferencias, también comunica su recuento.

¿Qué ocurre si dejo una entrada en blanco?

Si una entrada está vacía o contiene solo espacios, la operación termina correctamente, no muestra diferencias y señala que las entradas no son idénticas. Por tanto, no representa una comparación entre dos JSON completos.

¿La herramienta compara un JSON que tiene errores de formato?

No. Si una entrada no se puede analizar como JSON, el resultado es fallido, no incluye diferencias reportadas y aporta información sobre el error de análisis. Corrige el formato y vuelve a ejecutar la comparación.