JSON formatieren

Was den Hin- und Rückweg übersteht

Formatieren heißt parsen und neu ausgeben, und Zahlen sind der einzige Teil, der als der von Ihnen getippte Text übernommen wird. Das reicht weiter als der Fall großer Ganzzahlen, den der Hinweis zählt: Jede Zahl, deren kürzeste JavaScript-Schreibweise von Ihrer abweicht, wird aus der Quelle neu ausgegeben – 1.10 behält seine Null am Ende, 1e5 bleibt in Exponentialschreibweise, und eine negative Null bleibt negativ. In der Warnung werden nur unsichere Ganzzahlen gezählt, weil dort die Alternative eine stille Verfälschung wäre und nicht bloß eine aufgeräumte Schreibweise.

Strings werden nicht als Text übernommen. Escape-Sequenzen werden beim Einlesen dekodiert und bei der Ausgabe neu geschrieben, \u0041 kommt also als A zurück und ein maskierter Schrägstrich ohne Maskierung. Der Wert ist identisch, die Bytes sind es nicht – das spielt nur in einer Situation eine Rolle, dort aber eine große: Wenn etwas weiter hinten zwei JSON-Dateien Byte für Byte vergleicht, ist es kein Nullvorgang, eine davon durch einen Formatierer zu schicken.

Zwei Verhaltensweisen auf Objektebene sollten Sie kennen, bevor Sie einer Neuformatierung vertrauen. Doppelte Schlüssel werden stillschweigend aufgelöst, der letzte gewinnt – genau so, wie der Parser des Browsers sie auflöst. Ein Dokument mit zwei „id“-Feldern wird ohne Beanstandung formatiert und kommt mit einem zurück, und nichts verrät Ihnen, dass es das andere gab. Und die Reihenfolge der Schlüssel entspricht nur bei Schlüsseln, die keine Ganzzahlen sind, der Ihrer Datei: Ein Objekt mit „1“, „2“ und „name“ kommt mit den Zahlenschlüsseln zuerst zurück, in numerischer Reihenfolge, weil JavaScript selbst Objekteigenschaften so ordnet. Gewöhnliche Schlüssel behalten die Reihenfolge, in der Sie sie geschrieben haben.

Wenn Sie etwas anderes brauchen

Wenn Sie eine tsconfig.json, eine ESLint-Konfiguration oder eine VS-Code-Einstellungsdatei haben, zeigt diese Seite auf die Kommentare und nachgestellten Kommas, statt um sie herum zu formatieren – für ein JSON-Tool die richtige Antwort und für Ihre Datei das falsche Tool. Das ist JSONC, und Ihr Editor parst es bereits; auf der Kommandozeile lesen json5 und dasel es, ohne so zu tun, als wäre es JSON.

Für alles über das Einrücken hinaus hat ein Formatierer die falsche Form. jq erledigt mit einem Ausdruck, wofür ein Einfügefeld keine Bedienelemente hat: jq -S . sortiert die Schlüssel jedes Objekts, damit sich zwei Antworten vergleichen lassen, jq 'del(.token)' entfernt ein Feld, bevor Sie eine Payload jemandem zeigen, und jq -c fasst ein Array von Objekten zu den JSON Lines zusammen, die eine Pipeline erwartet. Außerdem liest es eine Datei statt der Zwischenablage – der entscheidende Unterschied, sobald das Dokument größer ist, als Sie bequem markieren können.