Acerca de Comparador de JSON

Una herramienta de JSON diff compara dos documentos por estructura en lugar de por texto, así que ves qué cambió en los datos y no en el formato.

Pega el JSON original de un lado y el JSON modificado del otro, y la comparación se actualiza al instante en una tabla de valores añadidos, eliminados y modificados, con la ruta de cada uno.

Cómo usar la herramienta JSON Diff

Pega el documento original en la primera entrada y el documento modificado en la segunda.
Lee los contadores de resumen en la parte superior, mostrados como +N -N ~N, para dimensionar el cambio.
Recorre la tabla de resultados: tipo de cambio, ruta, valor anterior, valor posterior.
Sigue una ruta como a.b[2] hasta tu archivo de origen; las claves se unen con puntos y los arreglos usan un índice.

Cuándo conviene usarlo

Comparar la configuración entre dos entornos, por ejemplo un JSON de staging frente al de producción.
Revisar cómo cambió la respuesta de una API entre dos versiones de un servicio antes de depender de la nueva forma.
Investigar qué se movió realmente dentro de un package-lock.json u otro manifiesto de dependencias generado.
Comprobar qué modificó una herramienta después de reserializar un archivo de infraestructura como código o un manifiesto de Kubernetes.

Cómo se reportan las rutas y los tipos de cambio

Cada fila apunta a una única ubicación del documento, escrita como leerías el valor en código para que sea fácil de localizar en el archivo de origen.

Añadido: la ruta existe solo en el documento modificado, y la columna de valor posterior muestra el nuevo valor.
Eliminado: la ruta existe solo en el original, y la columna de valor anterior muestra lo que había allí.
Modificado: la ruta existe en ambos lados con valores distintos, así que las dos columnas están llenas.
Una ruta como a.b[2] significa la clave b dentro del objeto a, y luego el elemento en el índice 2 de ese arreglo.

Preguntas frecuentes sobre Comparar JSON

¿Por qué reformatear el archivo no produce ninguna diferencia?: Porque ambos lados se analizan primero. La indentación, el orden de las claves y los finales de línea no forman parte de la estructura analizada, así que nunca aparecen como diferencias.
¿Por qué insertar un elemento en un arreglo marca como modificado todo lo que viene después?: Los arreglos se comparan por índice. Una inserción desplaza cada elemento posterior a una nueva posición, así que cada posición desplazada se reporta como un cambio. Es inherente a la comparación posicional, no un defecto.
¿Qué pasa si uno de los lados no es JSON válido?: Ambas entradas deben analizarse correctamente. Si cualquiera de los dos lados está mal formado, se muestra un error de análisis en lugar de una comparación.
¿Qué se muestra cuando los dos documentos coinciden?: La herramienta indica de forma explícita que no hay diferencias estructurales, en vez de dejar un resultado vacío que podría parecer un fallo.
¿Mis datos se suben a algún lado?: No. El análisis y la comparación se ejecutan localmente en tu navegador con la biblioteca microdiff, así que nada de lo que pegas se envía a wetool.site ni a ningún otro servidor.

JSON diff frente a diff de texto plano

Un diff de texto compara líneas de caracteres, así que claves reordenadas, un cambio de dos espacios a cuatro o finales de línea distintos aparecen como diferencias aunque los datos sean idénticos, y las ediciones reales quedan sepultadas en ese ruido. Un JSON diff analiza primero ambos documentos y reporta solo diferencias semánticas, de modo que el orden de las claves y el formato se ignoran. Usa un diff de texto cuando importen los bytes exactos, y este cuando solo importen los datos.

Leer los resultados sin dejarse engañar

La comparación estructural responde con precisión a una pregunta acotada, así que conviene saber qué te dice la tabla y qué no.

Una lista larga de cambios concentrada en un solo arreglo suele apuntar a una única inserción o a un reordenamiento, más que a muchas ediciones independientes.
Los tipos importan: la cadena 1 y el número 1 son valores distintos y se reportan como un cambio.