JSON formatieren und prüfen

So funktioniert es

Fügen Sie JSON in das linke Feld ein, die formatierte Fassung erscheint sofort rechts. Die Ausgabeform bestimmt die Einrückung: 2 Leerzeichen sind in den meisten Sprachen und Editoren die Voreinstellung, 4 Leerzeichen machen die Ebenen bei tief verschachtelten Daten mit dem Auge leichter verfolgbar, und die komprimierte Fassung entfernt jedes Leerzeichen und jeden Umbruch bis auf eine einzige Zeile. Das alphabetische Sortieren der Schlüssel bleibt nicht auf der obersten Ebene: Es greift in jedes verschachtelte Objekt hinein, auch in Objekte innerhalb von Arrays, und macht damit zwei Fassungen einer Datei vergleichbar, die sich nur in der Reihenfolge ihrer Felder unterscheiden. Ist der Text kein gültiges JSON, entsteht keine Ausgabe; stattdessen erfahren Sie Zeile und Spalte, an der das Problem sichtbar wurde. Die Ergebniszeile nennt die Zahl der Zeilen davor und danach, sodass die Wirkung des Aufklappens oder Komprimierens auf einen Blick sichtbar ist. Der eingefügte Text verlässt Ihren Browser nicht.

Dieses Werkzeug ist auch als json formatieren, json validieren, json pretty print, json lesbar machen, json minimieren bekannt.

Was ist JSON?

Die Grammatik von JSON ist strenger, als sie aussieht. Schlüssel gehören in doppelte Anführungszeichen, hinter dem letzten Element darf kein Komma stehen, Kommentare sind nicht erlaubt, das Dezimalzeichen ist immer der Punkt, und zulässig sind nur Objekte, Arrays, Zeichenketten, Zahlen sowie true, false und null. Diese Strenge ist Absicht und kein Versäumnis: Bei so wenigen Regeln liest jede Sprache denselben Text gleich. Gültigkeit betrifft dabei allein die Grammatik — ein Dokument, das sauber eingelesen wird, kann trotzdem völlig falsche Daten enthalten.

Was ist die Einrückung?

Die Einrückung schiebt jede Ebene einer verschachtelten Struktur um eine feste Zahl von Leerzeichen nach innen und macht die Hierarchie damit sichtbar. Auf die Daten hat sie in JSON keinerlei Wirkung: Derselbe Inhalt, geschrieben mit zwei Leerzeichen, mit vier oder ganz ohne, ergibt beim Einlesen genau dieselben Werte. Die Einrückung ist allein für den Menschen da, der die Datei liest. Deshalb ist es kein Widerspruch, ein Dokument zum Prüfen aufzuklappen und es vor dem Einfügen an anderer Stelle wieder zu komprimieren.

Was ist der Unterschied zwischen Formatieren und Komprimieren?

Beide erhalten dieselben Daten und ändern nur das Aussehen. Formatieren fügt Umbrüche und Einrückung hinzu und macht die Struktur lesbar; das brauchen Sie zum Prüfen, zur Fehlersuche und wenn Sie die Datei jemandem zeigen. Komprimieren entfernt jedes überflüssige Leerzeichen und setzt den Text auf eine Zeile, was die Zeichenzahl senkt; das brauchen Sie für ein Feld, das nur eine Zeile annimmt. Keine der beiden Richtungen verliert Struktur: Komprimiertes JSON klappt zu denselben Werten wieder auf, denn Leerraum zwischen den Zeichen bedeutet einem Parser nichts. Nur die Schreibweise von Zahlen kann sich verschieben, weil der Text zerlegt und neu geschrieben und nicht bloß umgeschichtet wird.

So lesen Sie Zeile und Spalte in der Fehlermeldung

Ein JSON-Parser meldet den Fehler an dem ersten Zeichen, das eine Regel bricht, und das ist selten die Stelle, an der der Fehler entstanden ist. Ein nicht geschlossenes Anführungszeichen etwa fällt erst am Anfang der nächsten Zeile auf, weil bis dahin alles noch gültiger Text innerhalb einer Zeichenkette war.

Sieht die gemeldete Zeile also harmlos aus, lesen Sie die Zeile darüber. Die Verursacher sind kurz und wiederholen sich:

• Ein Komma hinter dem letzten Element — das erlaubt JSON nicht
• Schlüssel ohne Anführungszeichen oder mit einfachen statt doppelten
• Eine Zahl mit führender Null oder mit Komma als Dezimalzeichen — in JSON ist es immer der Punkt, 1,5 ist ungültig und 1.5 richtig
• Eine Klammer, die beim teilweisen Kopieren offen geblieben ist

Welche Einrückung sollten Sie wählen?

Rücken Sie ein, wenn ein Mensch das JSON liest — beim Prüfen, für eine Bildschirmaufnahme, als Anhang an eine Fehlermeldung. Zwei Leerzeichen halten die Zeilen kurz; vier machen bei tiefer Verschachtelung deutlich, welches Feld zu welchem Objekt gehört.

Komprimieren Sie, wenn eine Maschine liest: ein Konfigurationsfeld, eine Umgebungsvariable, eine Datenbankspalte oder ein Formular, das nur eine Zeile annimmt. Die Leerzeichen tragen dort keine Daten, sie brauchen nur Platz.

Was ein Umlauf nicht unverändert lässt

Das Formatieren erhält Ihre Daten, gibt die Datei aber nicht Byte für Byte zurück. Der Text wird in echte Werte zerlegt und neu geschrieben: Aus 1.0 wird 1, aus 1e3 wird 1000, und eine ganze Zahl jenseits von etwa sechzehn Stellen kommt gerundet zurück. Das liegt daran, wie Zahlen im Speicher gehalten werden, und gilt für jedes JSON-Werkzeug auf Basis eines üblichen Parsers, nicht nur für dieses.

Der zweite Fall sind doppelte Schlüssel. JSON erlaubt denselben Namen zweimal in einem Objekt, und Parser behalten das letzte Vorkommen, sodass der frühere Wert ohne Warnung aus der Ausgabe verschwindet. Formatieren Sie eine Datei, bei der das zählen könnte — etwa eine zusammengeführte Konfiguration —, zählen Sie die Schlüssel, bevor Sie das Original ersetzen.

Häufige Fragen

Wie mache ich JSON lesbar?

Fügen Sie den Text links ein und wählen Sie eine Einrückung; die formatierte Fassung entsteht rechts beim Tippen. Sie können sie kopieren oder als .json-Datei sichern.

Woran erkenne ich, ob mein JSON gültig ist?

Erscheint eine Ausgabe, ist der Text gültiges JSON. Ist er es nicht, steht an dieser Stelle eine Meldung mit Zeile und Spalte, an der das Problem sichtbar wird.

Wozu dient das Sortieren der Schlüssel?

Zum Vergleichen zweier Dateien. Zwei Exporte, die sich nur in der Feldreihenfolge unterscheiden, sehen im Vergleich völlig verschieden aus; sortieren Sie beide, bleiben nur die echten Unterschiede stehen.

Verändert das Formatieren meine Daten?

Die Werte bleiben gleich, es ändern sich nur Leerraum und, auf Wunsch, die Reihenfolge der Schlüssel. Achten sollten Sie allein auf die Schreibweise von Zahlen: Jeder Parser schreibt 1.0 als 1 und rundet ganze Zahlen jenseits von etwa sechzehn Stellen.

Wofür ist komprimiertes JSON gut?

Leerzeichen und Umbrüche bedeuten einem Parser nichts, sie brauchen nur Platz. Eine einzeilige Fassung ist das Richtige für Konfigurationsfelder, Umgebungsvariablen und jedes Formular, das eine Zeile annimmt.