JSON formatieren und auf gültige Syntax prüfen

JSON-Text lesbar machen und prüfen

Der JSON Formatter hilft Ihnen dabei, JSON-Text übersichtlich darzustellen und seine syntaktische Lesbarkeit prüfen zu lassen. Das ist nützlich, wenn eine kopierte Konfiguration schwer zu lesen ist oder eine JSON-Antwort mit klaren Zeilenumbrüchen betrachtet werden soll. Die Ausgabe lässt sich an unterschiedliche Zwecke anpassen: Eine frei wählbare Einrückung verbessert die Darstellung, eine optionale Sortierung ordnet die Schlüssel von Objekten, und eine kompakte Ausgabe reduziert Einrückungen und Zeilenumbrüche.

Die Prüfung bezieht sich auf die Frage, ob der eingegebene Text als JSON eingelesen werden kann. Sie ersetzt keine Prüfung eines bestimmten Datenmodells oder einer fachlichen Struktur. Ein Text kann also syntaktisch lesbar sein, ohne dass daraus eine Aussage über die Bedeutung seiner Inhalte folgt. Für die Bedienung benötigen Sie JSON-Text; das Eingabefeld darf jedoch auch leer bleiben. In diesem Sonderfall wird kein formatierter Inhalt erzeugt.

JSON formatieren: Vorgehen

1. Fügen Sie den zu prüfenden JSON-Text in das Eingabefeld ein. Wenn Sie keine Eingabe eintragen, wird leerer Text verwendet. Eine leere oder nur aus Leerraum bestehende Eingabe hat eine besondere Bedeutung und sollte daher nicht mit einer erfolgreichen Formatierung verwechselt werden.

2. Wählen Sie die gewünschte Einrückung. Die Voreinstellung beträgt 2. Eine kleinere Einrückung kann die Darstellung gedrängter halten, während eine größere Einrückung Ebenen deutlicher voneinander absetzt. Diese Einstellung betrifft die formatierte Darstellung, nicht den Inhalt der JSON-Daten.

3. Lassen Sie die optionale Schlüsselsortierung ausgeschaltet, wenn die Reihenfolge der Objektschlüssel aus der Eingabe beibehalten werden soll. Aktivieren Sie sie, wenn die Schlüssel in der formatierten Ausgabe geordnet erscheinen sollen. Die Sortierung ist standardmäßig deaktiviert.

4. Aktivieren Sie die kompakte Ausgabe, wenn Sie eine Darstellung ohne die übliche Einrückung benötigen. In diesem Modus verwendet der erzeugte JSON-Text kompakte Trennzeichen für Kommas und Doppelpunkte, statt die Ausgabe mit Einrückungen zu strukturieren. Standardmäßig ist diese Option deaktiviert.

5. Starten Sie die Verarbeitung und lesen Sie das Ergebnis. Bei gültigem JSON wird der Text eingelesen und als formatierter JSON-Text ausgegeben. Unicode-Zeichen können dabei im formatierten Text erhalten bleiben. Prüfen Sie bei Bedarf zunächst die gut lesbare Variante und wählen Sie erst danach eine kompakte Darstellung oder eine andere Einrückung für den vorgesehenen Verwendungszweck.

Ausgabe und Fehlermeldungen verstehen

Eine erfolgreiche Verarbeitung mit formatiertem Inhalt zeigt, dass der eingegebene Text als JSON eingelesen werden konnte. Die Darstellung wird durch die gewählten Optionen beeinflusst. Die Einrückung verändert den Abstand zwischen verschachtelten Ebenen, die Schlüsselsortierung ordnet die Schlüssel von Objekten in der Ausgabe, und die kompakte Ausgabe verwendet weniger sichtbare Strukturierung durch Leerraum und Zeilenumbrüche. Diese Einstellungen ändern die Darstellungsform; aus dem Ergebnis folgt keine fachliche Bewertung der enthaltenen Werte.

Bei nicht parsebarem JSON wird die Verarbeitung als fehlgeschlagen gemeldet. Der eingereichte Text bleibt als zurückgegebener Inhalt erhalten, zusätzlich werden Einzelheiten zum Parsing-Fehler angegeben. Nutzen Sie diese Angaben, um die betreffende Stelle im Eingabetext zu untersuchen, und führen Sie die Verarbeitung nach der Korrektur erneut aus. Ändern der Einrückung oder Aktivieren der Schlüsselsortierung behebt keine fehlerhafte JSON-Syntax.

Leerer oder ausschließlich aus Leerraum bestehender Text ist ein gesonderter Fall: Die Verarbeitung gilt als erfolgreich, es entsteht jedoch kein formatierter Inhalt und es wird angezeigt, dass kein JSON eingegeben wurde. Wenn Sie eine Ausgabe erwarten, prüfen Sie deshalb zuerst, ob tatsächlich Text im Eingabefeld steht. Bei gültigem JSON können Umlaute und andere Unicode-Zeichen im formatierten Text erhalten bleiben; die erfolgreiche Verarbeitung hängt trotzdem von einer lesbaren JSON-Syntax ab.

Praktisches Beispiel

Sie möchten eine kurze JSON-Konfiguration vor der Weitergabe lesbar prüfen.

Fügen Sie den JSON-Text {"name":"Mira","version":1} ein, lassen Sie die Einrückung auf 2 und starten Sie die Verarbeitung. Aktivieren Sie danach die Schlüsselsortierung und vergleichen Sie die Darstellung der Objekt-Schlüssel.

Bei gültigem JSON erscheint formatierter JSON-Text. Bei einem Syntaxfehler wird die Verarbeitung als fehlgeschlagen gemeldet, der eingereichte Text bleibt erhalten und Parsing-Details werden ergänzt.

Einschränkungen

• Die Verarbeitung prüft, ob JSON-Text eingelesen und formatiert werden kann. Sie bewertet nicht die fachliche Bedeutung oder ein bestimmtes Datenmodell; bei nicht parsebarem Text wird keine formatierte Ausgabe erzeugt.

Häufige Fehler

• Ursache: Der eingegebene Text ist syntaktisch nicht als JSON einlesbar. Korrektur: Lesen Sie die angegebenen Parsing-Details, prüfen Sie den betroffenen Abschnitt des Textes und starten Sie die Verarbeitung nach der Korrektur erneut.

Häufige Fragen

Bleiben Umlaute und andere Unicode-Zeichen erhalten?

Wenn der JSON-Text gültig eingelesen werden kann, können Unicode-Zeichen im formatierten Text erhalten bleiben. Die Zeichen erhalten jedoch keine Sonderbehandlung, wenn der übrige Text wegen fehlerhafter Syntax nicht parsebar ist.

Werden JSON-Schlüssel automatisch sortiert?

Nur bei aktivierter Option. Die Schlüsselsortierung ist standardmäßig ausgeschaltet; nach dem Aktivieren werden die Schlüssel von Objekten in der formatierten Ausgabe geordnet.

Was passiert bei einer leeren oder fehlerhaften Eingabe?

Wenn das Eingabefeld leer ist oder nur aus Leerraum besteht, gilt die Verarbeitung als erfolgreich, aber ohne formatierten Inhalt. Enthält das Feld dagegen nicht parsebaren JSON-Text, wird die Verarbeitung als fehlgeschlagen gemeldet und es werden Parsing-Details angegeben.