Différence JSON

Comment comparer des fichiers JSON en ligne

Comparer des documents JSON avec des outils en ligne de commande basés sur le texte (comme git diff) échoue souvent car l’indentation et l’ordre des clés peuvent changer sans modifier les données réelles.

Notre moteur de diff structurel résout ce problème en trois étapes automatisées :

1. Normalisation syntaxique : Les deux documents sont analysés en représentations mémoire selon la norme RFC 8259.
2. Parcours récursif par chemin : Chaque paire clé-valeur et élément de tableau reçoit un chemin JSON explicite (ex. users[0].address.city).
3. Sortie des deltas catégorisés : Les ajouts, suppressions et modifications de valeurs ou de types sont isolés et mis en valeur visuellement.

Gestion de l’ordre des clés (Conformité RFC 8259)

Selon la spécification officielle RFC 8259, un objet JSON est un ensemble non ordonné de paires nom/valeur. Ainsi, {"a": 1, "b": 2} et {"b": 2, "a": 1} représentent exactement la même information.

Par défaut, notre outil active l’option Ignorer l’ordre des clés afin de ne pas encombrer votre rapport. Si votre application exige un ordre strict, décochez simplement l’option.

Comparaison des tableaux : ordonnés vs non ordonnés

Contrairement aux clés, les éléments d’un tableau JSON sont ordonnés par définition. Toutefois, dans de nombreuses APIs REST, les tableaux représentent des ensembles sans ordre significatif.

Notre outil propose une option Ignorer l’ordre des tableaux. Activée, elle associe les éléments par égalité profonde quelle que soit leur place, évitant de fausses alertes si un élément est inséré au début.

Export et partage des rapports de diff

Une fois la comparaison terminée, téléchargez un rapport complet au format JSON Patch (RFC 6902) ou un journal Markdown pour vos revues de code. Tout s’exécute localement dans votre navigateur pour une confidentialité totale.

Comparer du JSON par programme en Python et Node.js

Si vous devez automatiser la comparaison dans vos tests ou pipelines CI/CD, voici les méthodes standards :

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 en ligne de commande avec jq et diff

Dans les terminaux Unix et macOS, normalisez l’ordre des clés avec jq -S avant d’exécuter diff :

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

Besoin de nettoyer votre JSON avant de comparer ? Utilisez notre Formateur JSON, diagnostiquez la syntaxe avec le Validateur JSON, ou convertissez en tableur avec notre Convertisseur JSON en CSV.