Confronta JSON

Come confrontare file JSON online

Il confronto di documenti JSON con strumenti basati sulle righe di testo (come git diff o comparatori di testo) fallisce spesso perché formattazione e ordine delle chiavi possono variare senza modificare i dati reali.

Il nostro motore di diff strutturale risolve questo problema in tre passaggi automatizzati:

1. Normalizzazione sintattica: Entrambi i documenti vengono analizzati in rappresentazioni di memoria secondo lo standard RFC 8259.
2. Attraversamento ricorsivo dei percorsi: A ogni coppia chiave-valore e elemento di array viene assegnato un percorso JSON esplicito (es. users[0].address.city).
3. Output differenze categorizzato: Aggiunte, rimozioni e modifiche di valori o tipi vengono isolate ed evidenziate visivamente con badge dedicati.

Gestione dell’ordine delle chiavi (Conformità RFC 8259)

Secondo la specifica ufficiale RFC 8259, un oggetto JSON è una raccolta non ordinata di coppie nome/valore. Pertanto, {"a": 1, "b": 2} e {"b": 2, "a": 1} rappresentano gli stessi identici dati semantici.

Per impostazione predefinita, la modalità Ignora ordine chiavi è attiva per evitare notifiche superflue. Se la tua API richiede un ordine rigoroso, deseleziona semplicemente l’opzione.

Confronto array: ordinati vs non ordinati

A differenza delle chiavi, gli elementi di un array JSON sono ordinati per definizione. Tuttavia, in molte API REST, gli array rappresentano insiemi in cui l’ordine non ha rilevanza.

Il nostro strumento offre l’opzione Ignora ordine array. Se abilitata, gli elementi vengono abbinati in base all’uguaglianza profonda evitando false differenze se viene inserito un elemento in cima.

Esportazione e condivisione dei report di diff

Al termine del confronto puoi scaricare un report completo in formato JSON Patch (RFC 6902) o come changelog Markdown per pull request e code review. Poiché tutto viene eseguito localmente nel browser, i tuoi dati rimangono riservati.

Confrontare JSON a livello di codice in Python e Node.js

Se hai bisogno di automatizzare il confronto JSON nelle tue suite di test o pipeline CI/CD, ecco le implementazioni consigliate:

Python (DeepDiff)

import json
from deepdiff import DeepDiff

# Load JSON files or API responses
with open('original.json') as f1, open('modified.json') as f2:
    original_data = json.load(f1)
    modified_data = json.load(f2)

# Deep structural diff with key-order independence
differences = DeepDiff(original_data, modified_data, ignore_order=False)

print("Added keys:", differences.get('dictionary_item_added', {}))
print("Removed keys:", differences.get('dictionary_item_removed', {}))
print("Values changed:", differences.get('values_changed', {}))
print("Type changes:", differences.get('type_changes', {}))

Node.js / TypeScript (fast-json-patch)

import fs from 'node:fs';
import { compare } from 'fast-json-patch';

// Read and parse documents locally
const original = JSON.parse(fs.readFileSync('original.json', 'utf8'));
const modified = JSON.parse(fs.readFileSync('modified.json', 'utf8'));

// Generate standard RFC 6902 JSON patch differences
const delta = compare(original, modified);
console.log('Structured differences:', delta);
// Output: [ { op: 'replace', path: '/user/age', value: 26 }, ... ]

Diff JSON da riga di comando con jq e diff

Negli ambienti Unix e macOS, normalizza l’ordine delle chiavi con jq -S prima di eseguire diff:

# Sort keys alphabetically with jq, then run unified diff
diff -u <(jq -S . original.json) <(jq -S . modified.json)

Vuoi sistemare il tuo JSON prima di confrontarlo? Formattalo con il Formattatore JSON, diagnostica la sintassi con il Validatore JSON, o convertilo in tabella con il Convertitore da JSON a CSV.