JSON.parse-Fehler finden und verstehen

Wenn JSON.parse in JavaScript auf ungültigen Text trifft, wirft es eine SyntaxError-Ausnahme. Deren Meldung ist je nach Browser unterschiedlich formuliert und oft wenig hilfreich: Mal heißt es, ein Zeichen sei unerwartet, mal wird eine Position in Form eines Zeichen-Offsets genannt, den man ohne Werkzeug erst mühsam in eine Zeile umrechnen muss. Bei einem kurzen JSON ist das noch überschaubar, doch bei einem Dokument mit tausenden Zeichen wird die Suche nach der eigentlichen Stelle schnell aufwändig. Erschwerend kommt hinzu, dass der Parser die Position meldet, an der er stolpert, nicht unbedingt die Stelle, an der der Fehler entstanden ist. Ein fehlendes Komma am Ende einer Zeile fällt dem Parser oft erst am Beginn der nächsten Zeile auf. Dieses Werkzeug übersetzt die kryptische Meldung in eine klare Angabe von Zeile, Spalte und Ursache.

Ehrlich gesagt kann kein Werkzeug beliebig kaputtes JSON zuverlässig von selbst reparieren, denn dazu müsste es Ihre Absicht kennen. Fehlt zum Beispiel ein Anführungszeichen, ist nicht immer eindeutig, ob ein Wert vorzeitig endet oder ob ein weiterer Text dazugehört. Deshalb setzt dieses Werkzeug bewusst auf einen anderen Ansatz: Es lokalisiert den Fehler präzise und erklärt seine Ursache, überlässt die eigentliche Korrektur aber Ihnen. Das ist kein Nachteil, sondern die verlässlichere Methode, denn Sie behalten die Kontrolle über den Inhalt und riskieren keine stillen Fehlinterpretationen. In der Praxis genügt die genaue Angabe von Position und Grund meist, um den Fehler in wenigen Sekunden zu beheben. Sie sehen, welches Zeichen fehlt oder überflüssig ist, springen an die Stelle und setzen die Korrektur bewusst. So bleibt das Ergebnis genau das, was Sie beabsichtigt haben.

Die überwiegende Mehrheit der Parse-Fehler geht auf eine kleine Zahl von Ursachen zurück. Ganz vorne steht das fehlende oder überzählige Komma: Zwischen zwei Elementen muss genau eines stehen, nach dem letzten jedoch keines. Ebenso häufig sind einfache statt doppelter Anführungszeichen, denn JSON verlangt für Schlüssel und Zeichenketten immer doppelte. Eine nicht geschlossene Klammer, ob geschweift oder eckig, führt dazu, dass der Parser das Ende des Dokuments erreicht, ohne die Struktur abschließen zu können. Nicht maskierte Sonderzeichen in Textwerten, versehentliche Kommentare und ein abgeschnittenes Dateiende gehören ebenfalls zu den Klassikern. Manchmal ist auch ein unsichtbares Steuerzeichen am Anfang der Datei die Ursache. Das Werkzeug ordnet den gefundenen Fehler einer dieser Kategorien zu und benennt sie ausdrücklich. Kennen Sie die typischen Muster, erkennen Sie schon an der Erklärung, welcher Handgriff nötig ist.

Ein wichtiges Detail für das Beheben ist, dass der Parser stets beim ersten Fehler anhält. JSON ist eine streng verschachtelte Struktur, in der ein einziger falscher Token die gesamte weitere Interpretation unmöglich macht. Deshalb sehen Sie zunächst nur einen Fehler, auch wenn das Dokument mehrere enthält. Nach der Korrektur des ersten Problems kann beim erneuten Prüfen ein zweites auftauchen, das der Parser vorher gar nicht erreicht hat. Das ist normal und kein Zeichen dafür, dass Ihre erste Korrektur falsch war. Die gemeldete Position ist der Zeichen-Offset ab dem Dateianfang, ergänzt um Zeile und Spalte. Genau diese Angabe liefert auch JSON.parse in JavaScript, nur dass sie dort in einer schwerer lesbaren Ausnahme steckt. Indem Sie die Positionsangabe direkt auf Ihren Editor übertragen, springen Sie ohne Umweg zur betroffenen Zeile und sparen sich langes Suchen.

Auch der Fehlerfinder arbeitet vollständig lokal in Ihrem Browser. Das eingefügte oder geladene JSON wird nicht hochgeladen, nicht gespeichert und nicht an Dritte weitergegeben, sondern ausschließlich als JavaScript in der geladenen Seite verarbeitet. Damit können Sie auch fehlerhafte Dokumente mit vertraulichen Inhalten gefahrlos untersuchen, etwa eine kaputte Konfigurationsdatei mit internen Schlüsseln. Die lokale Verarbeitung sorgt zugleich für Tempo, weil kein Netzwerkweg nötig ist, und funktioniert nach dem ersten Laden der Seite sogar offline. Wenn Ihr JSON nach der Korrektur wieder wohlgeformt ist, aber inhaltlich bestimmten Regeln folgen soll, hilft die optionale Prüfung gegen ein JSON Schema. Sie kontrolliert Datentypen, Pflichtfelder und erlaubte Werte und ergänzt so die reine Fehlersuche um eine strukturelle Ebene. Es ist keine Anmeldung nötig, es gibt kein Wasserzeichen und keine künstliche Begrenzung außer dem Speicher Ihres Browsers.