Was vergleicht der JSON-Diff-Prüfer?

Er vergleicht zwei JSON-Dokumente anhand ihres Inhalts, nicht anhand ihrer Schreibweise. Jeder hinzugefügte, entfernte oder geänderte Wert wird mit seinem Pfad aufgeführt und in beiden Editoren markiert. So sehen Sie auf einen Blick, wie sich eine API-Antwort, eine Konfigurationsdatei oder ein Datenexport zwischen zwei Versionen geändert hat.

So verwenden Sie das Tool

  1. Fügen Sie das ursprüngliche JSON in das erste Feld und das geänderte JSON in das zweite ein oder geben Sie es dort ein.
  2. Die Unterschiede werden sofort angezeigt, nach Art gezählt und der Reihe nach aufgelistet.
  3. Klicken Sie auf einen Unterschied, um in beiden Editoren dorthin zu springen, oder klicken Sie auf eine Markierung in einem Editor, um die entsprechende Zeile in der Liste zu finden.
  4. Öffnen Sie den Tab „JSON Patch“, um dieselben Unterschiede als JSON-Patch-Operationen zu kopieren oder herunterzuladen.

Wenn eines der Dokumente kein gültiges JSON ist, zeigt das Tool an, um welches Dokument es sich handelt, und nennt Zeile und Spalte des Fehlers. Die Fehlerstelle wird im entsprechenden Editor markiert.

Was gilt als Unterschied?

  • Reihenfolge der Schlüssel, Einrückungen, Leerzeichen und Zeilenumbrüche zählen nicht: {"a": 1, "b": 2} und {"b": 2, "a": 1} sind identisch.
  • Datentypen zählen: Die Zahl 1 und die Zeichenkette "1" sind unterschiedliche Werte. Zahlen werden anhand ihres Werts verglichen, daher sind 1.0 und 1 gleich.
  • Bei Arrays zählt die Reihenfolge. Elemente, die Objekte mit einem Feld id oder _id sind, werden anhand dieses Felds zugeordnet. Bei einer geänderten Reihenfolge werden daher die verschobenen Elemente angezeigt, statt jede Zeile als geändert zu markieren.
  • Andere Array-Elemente werden anhand ihres Werts zugeordnet. Ein Wert, der mitten in eine Liste eingefügt wird, gilt als eine Hinzufügung. Objekte ohne id werden anhand ihrer Position im Array verglichen.
  • Lange Zeichenketten werden als vollständige Werte verglichen: Bei einer geänderten Zeichenkette werden der alte und der neue Text angezeigt.

Ergebnisse lesen

  • Hinzugefügte Werte werden grün, entfernte rot dargestellt. Geänderte Werte werden mit dem alten Wert gefolgt vom neuen Wert angezeigt. Bei einem verschobenen Array-Element wird angezeigt, an welcher Stelle es vorher war und an welcher es jetzt steht.
  • Pfade werden als JSONPath angegeben und beginnen mit $, dem gesamten Dokument: $.items[2].name bezeichnet den Wert von name beim dritten Element in items. Schlüssel mit Leerzeichen oder anderen Sonderzeichen werden in Klammern geschrieben, zum Beispiel $["first name"].
  • Der Pfad eines entfernten Werts bezeichnet seine Stelle im ursprünglichen Dokument. Bei einem hinzugefügten oder geänderten Wert bezeichnet der Pfad seine Stelle im geänderten Dokument.

JSON Patch

Der Tab „JSON Patch“ gibt die Unterschiede als Operationen des JSON-Patch-Standards (RFC 6902) aus: add, remove, replace und move. Jede Operation enthält einen Pfad im JSON-Pointer-Format, zum Beispiel /items/0/price. Werden die Operationen der Reihe nach auf das ursprüngliche Dokument angewendet, ergibt sich das geänderte Dokument. Bibliotheken für die meisten Programmiersprachen können die Operationen für Sie anwenden. Laden Sie sie als patch.json herunter.

Funktionsweise

Das Tool analysiert beide Dokumente in Ihrem Browser und vergleicht sie mit der Bibliothek jsondiffpatch. Diese ordnet Array-Elemente mithilfe eines Algorithmus für die längste gemeinsame Teilfolge zu und erkennt verschobene Elemente. Nichts, was Sie einfügen, wird irgendwohin hochgeladen.

Beispiele

  • {"price": 3} und {"price": 3.25}: $.price wurde von 3 zu 3.25 geändert
  • ["organic", "local"] und ["organic", "vegan", "local"]: $[1] hinzugefügt, "vegan"
  • {"hours": {"sat": "8-14"}} und {"hours": {}}: $.hours.sat entfernt
  • Eine Produktliste mit IDs, bei der die Reihenfolge geändert und ein Preis angepasst wurde: ein verschobenes Element und ein geänderter Preis, nicht Änderungen in jeder Zeile

Funktionen

  • Vergleicht JSON nach Inhalt und ignoriert Reihenfolge der Schlüssel und Formatierung
  • Hinzugefügte, entfernte, geänderte und verschobene Werte mit ihren Pfaden
  • Unterschiede in beiden Editoren markiert; anklicken, um dorthin zu springen
  • Array-Elemente werden anhand von id oder _id zugeordnet
  • JSON-Patch-Ausgabe (RFC 6902) zum Kopieren oder Herunterladen
  • Zeile und Spalte von Syntaxfehlern
  • Läuft in Ihrem Browser