JSON-Formatter

Was Formatieren tatsächlich tut

JSON zu formatieren ist ein Parsen mit anschließendem Neu-Serialisieren. Das Dokument wird in einen Wert gelesen und dann mit einem Zeilenumbruch nach jedem Komma und einer festen Einrückung pro Verschachtelungsebene zurückgeschrieben. Am Datenmodell ändert sich nichts — nur die Bytes zwischen den Tokens.

Diese Unterscheidung ist wichtig, denn zwei Dinge werden auf dem Rundweg normalisiert, und man sollte wissen, welche:

• Zahlen werden in ihrer kürzesten Form neu ausgegeben. 1.50 wird zu 1.5, 1e3 wird zu 1000 und -0 wird zu 0. Der Wert ist identisch, die Schreibweise kanonisch.
• Unnötige String-Escapes fallen weg. "\u0041" wird zu "A". Escapes, die JSON verlangt — Anführungszeichen, Backslashes und Steuerzeichen — bleiben erhalten.
• Ganzzahlen über 2⁵³−1 verlieren Genauigkeit. Das ist eine Eigenschaft des JavaScript-Zahlentyps, nicht dieses Werkzeugs. Trage große IDs als Strings.

Die Einrückungsbreite wählen

Das Einrückungsmenü wirkt sofort und wird für den nächsten Besuch gemerkt. Als Daumenregel:

• 2 Leerzeichen — API-Antworten, alles, was in ein Code-Review kommt, und alles, was der Ausgabe von JSON.stringify(v, null, 2) entsprechen muss.
• 4 Leerzeichen — handgepflegte Konfigurationsdateien, flach verschachtelt, aber mit langen Zeilen.
• Tabulator — Dateien in einem Repository, in dem sich die Beteiligten über die Breite nicht einig sind.

Dieselbe Arbeit auf der Kommandozeile

jq . input.json formatiert mit 2 Leerzeichen — dieselbe Ausgabe, die diese Seite in der Standardeinstellung erzeugt. Die Browser-Variante gewinnt, wenn das JSON in der Zwischenablage und nicht in einer Datei liegt, wenn du lieber durch einen Baum klickst als 4.000 Zeilen zu lesen, oder wenn die Daten etwas enthalten, das du nicht durch ein ungeprüftes Werkzeug schicken willst.

Ein Dokument formatieren, das sich nicht parsen lässt

Ein Formatter kann nicht einrücken, was er nicht lesen kann: Ein ungültiges Dokument liefert daher einen Fehler statt einer Ausgabe. Der Fehlerbereich zeigt Zeile, Spalte, die betroffene Quellzeile mit einer Markierung genau unter dem Zeichen und das, was der Parser dort erwartet hat. Zum Fehler springen setzt den Cursor auf dieses Zeichen. Ist das Problem einer der häufigen Fast-JSON-Fehler, behebt Reparieren ihn und formatiert in einem Schritt — den vollständigen Katalog der Ursachen führt der Validator.