JSON (JavaScript Object Notation) ist das wohl am weitesten verbreitete Datenformat im Web. Ob API-Antworten, Konfigurationsdateien oder der Austausch zwischen Frontend und Backend – kaum eine moderne Anwendung kommt ohne JSON aus. Trotzdem stolpern selbst erfahrene Entwickler regelmäßig über fehlende Kommas, falsche Anführungszeichen oder unübersichtlich verschachtelte Strukturen. Dieser Artikel erklärt, wie JSON aufgebaut ist, welche Fehler am häufigsten passieren und wie du chaotisches JSON sauber lesbar machst.
Was ist JSON überhaupt?
JSON ist ein textbasiertes, sprachunabhängiges Format zum Speichern und Übertragen strukturierter Daten. Es entstand ursprünglich aus der JavaScript-Syntax, wird heute aber von praktisch jeder Programmiersprache unterstützt. Der große Vorteil: Es ist gleichzeitig für Menschen lesbar und für Maschinen einfach zu parsen.
Ein JSON-Dokument besteht im Kern aus zwei Strukturen: Objekten (Schlüssel-Wert-Paare in geschweiften Klammern { }) und Arrays (geordnete Listen in eckigen Klammern [ ]). Diese lassen sich beliebig tief ineinander verschachteln.
Die erlaubten Datentypen
JSON kennt nur eine kleine, klar definierte Menge an Datentypen. Genau das macht es so robust und vorhersehbar:
- String: Text in doppelten Anführungszeichen, z. B.
"Arthur". Einfache Anführungszeichen sind nicht erlaubt. - Number: Ganzzahlen oder Dezimalzahlen, z. B.
42oder3.14. Keine führenden Nullen, kein Tausenderpunkt. - Boolean:
trueoderfalse, immer kleingeschrieben. - null: repräsentiert einen leeren oder unbekannten Wert.
- Object: eine Sammlung von Schlüssel-Wert-Paaren.
- Array: eine geordnete Liste von Werten beliebigen Typs.
Wichtig: Schlüssel (Keys) müssen in JSON immer als String in doppelten Anführungszeichen stehen – anders als in reinem JavaScript, wo Anführungszeichen oft optional sind.
Die häufigsten JSON-Fehler
Die meisten JSON-Parsing-Fehler haben überraschend banale Ursachen. Wenn du eine Fehlermeldung wie "Unexpected token" oder "Unexpected end of input" siehst, liegt es fast immer an einem dieser Punkte:
- Trailing Comma: Ein Komma nach dem letzten Element eines Objekts oder Arrays ist in JSON verboten – im Gegensatz zu modernem JavaScript.
- Fehlendes Komma: Zwischen zwei Schlüssel-Wert-Paaren oder Array-Elementen muss immer ein Komma stehen.
- Einfache statt doppelte Anführungszeichen:
'text'ist ungültig, korrekt ist"text". - Kommentare: Klassisches JSON erlaubt keine Kommentare. Wer welche braucht, nutzt Formate wie JSONC.
- Nicht escapte Sonderzeichen: Anführungszeichen oder Backslashes innerhalb eines Strings müssen mit
\escaped werden.
Solche Fehler aufzuspüren ist mit bloßem Auge mühsam, besonders bei großen Dokumenten. Mit dem JSON Formatter fügst du dein JSON einfach ein und bekommst die fehlerhafte Stelle sofort markiert – ganz ohne Server-Upload, denn die Verarbeitung läuft direkt im Browser.
Warum Formatierung so wichtig ist
API-Antworten kommen oft minifiziert an, also ohne Zeilenumbrüche und Leerzeichen, um Bandbreite zu sparen. Für Maschinen ist das ideal, für Menschen aber unlesbar. Eine saubere Einrückung mit zwei oder vier Leerzeichen pro Ebene macht die Struktur sofort erkennbar: Welche Werte gehören zu welchem Objekt, wie tief ist etwas verschachtelt, wo endet ein Array?
Mit dem JSON Formatter verwandelst du eine kompakte, einzeilige API-Antwort mit einem Klick in eine übersichtlich eingerückte Darstellung. Umgekehrt kannst du formatiertes JSON auch wieder minifizieren, wenn du es kompakt weitergeben möchtest.
Keys sortieren für bessere Vergleichbarkeit
Ein oft unterschätztes Feature ist das alphabetische Sortieren der Schlüssel. Wenn du zwei JSON-Objekte miteinander vergleichen willst – etwa zwei Konfigurationsdateien oder zwei API-Versionen – erleichtert eine einheitliche Reihenfolge der Keys den Diff enorm. Unterschiede springen direkt ins Auge, statt durch unterschiedliche Reihenfolgen verschleiert zu werden.
JSON im Entwickleralltag
JSON begegnet dir an unzähligen Stellen: in REST- und GraphQL-APIs, in package.json deines Node-Projekts, in den Settings deiner IDE, in NoSQL-Datenbanken wie MongoDB und in Logdateien moderner Anwendungen. Ein gutes Verständnis des Formats und ein zuverlässiges Werkzeug zum Prüfen sparen im Alltag viel Zeit.
Wenn du JSON nicht nur formatieren, sondern in andere Formate überführen möchtest, hilft dir der JSON zu CSV Konverter, um Arrays von Objekten in Tabellenform zu bringen. Weitere praktische Werkzeuge für den Entwickleralltag findest du in unserer Webtools-Übersicht.
Best Practices für sauberes JSON
- Verwende konsistente Einrückung – entscheide dich projektweit für zwei oder vier Leerzeichen.
- Halte Schlüsselnamen einheitlich, etwa durchgängig
camelCaseodersnake_case. - Vermeide unnötig tiefe Verschachtelung; flache Strukturen sind leichter zu warten.
- Validiere JSON vor dem Deploy oder Commit, um Laufzeitfehler zu vermeiden.
- Nutze
nullbewusst statt leerer Strings, wenn ein Wert tatsächlich fehlt.
Häufige Fragen
Was ist der Unterschied zwischen JSON und einem JavaScript-Objekt?
JSON ist ein reines Textformat mit strengen Regeln: Keys müssen in doppelten Anführungszeichen stehen, es gibt keine Kommentare und keine Funktionen. Ein JavaScript-Objekt im Code ist flexibler. JSON ist die serialisierte, transportierbare Form von Daten.
Werden meine Daten beim Formatieren hochgeladen?
Beim JSON Formatter auf kotsch.tech läuft die gesamte Verarbeitung lokal im Browser. Deine Daten verlassen dein Gerät nicht, was besonders bei sensiblen API-Antworten oder Konfigurationen wichtig ist.
Wie finde ich heraus, an welcher Stelle mein JSON kaputt ist?
Ein guter Formatter zeigt dir die Position des Fehlers an – etwa die Zeile oder das unerwartete Zeichen. So musst du nicht das gesamte Dokument durchsuchen, sondern gehst direkt zur problematischen Stelle.