JSON-Vergleich

Ein zeilenweiser Textvergleich erzeugt bedeutungslose Unterschiede, sobald sich Schlüsselreihenfolge oder Leerraum ändern. Dieses Werkzeug parst beide Dokumente und vergleicht sie als Struktur: Schlüsselreihenfolge und Formatierung sind keine Unterschiede, Feldpfade und Werte schon. Das Ergebnis beantwortet direkt die Frage „Welches Feld wurde hinzugefügt, entfernt oder geändert?“.

Eine Typänderung wird gesondert gezeigt, weil sie in Integrationen zu den heimtückischsten Fehlern gehört: „77“ (Text) und 77 (Zahl) verhalten sich in vielen Systemen unterschiedlich, sehen für das Auge aber oft gleich aus.

Arrays sind der schwierigste Teil von JSON, denn zwei Arrays brauchen eine Definition von „demselben Element“. Im Modus „nach Position“ wird Element i mit Element i verglichen: Ändert sich die Reihenfolge, wirkt jedes Element geändert. Im Modus „nach Schlüsselfeld“ werden Objektelemente über den Wert eines Feldes (zum Beispiel id, sku) zugeordnet, sodass nur wirklich hinzugefügte, entfernte oder geänderte Elemente erscheinen.

Der Modus „ungeordnete Menge“ vergleicht Arrays mit bedeutungsloser Reihenfolge (wie eine Tag-Liste) über tiefe Gleichheit. Hat sich ein Element geändert, erscheint es in diesem Modus als „eines entfernt, eines hinzugefügt“, weil nichts erkennen lässt, welche Elemente zusammengehören. Für Elemente, bei denen Reihenfolge und Identität zählen, bevorzugen Sie den Schlüsselfeld-Modus.

Typische Anwendungen sind der Vergleich der Antwort einer neuen API-Version mit der alten, das Erkennen von Abweichungen vom Vertrag, der Vergleich der Konfiguration in zwei Umgebungen (Test und Produktion) oder desselben Datensatzes in zwei Systemen. Der Bericht lässt sich in ein Ticket oder einen Änderungsantrag einfügen.

Dynamische Felder (Zeitstempel, erzeugte Kennungen, Laufnummern) zeigen bei jedem Vergleich einen Unterschied; diese müssen Sie von Hand herausfiltern. Für große, dauerhaft laufende Vergleiche empfiehlt sich statt dieses Werkzeugs ein automatisierter Vertragstest.