JSON automatisch reparieren: Fehlermeldungen richtig lesen

Inhalt
Dieser Artikel richtet sich an alle, die in einer JSON-Datei einen Kommentar zur Erklärung eingefügt oder hinter dem letzten Eintrag ein Komma stehen gelassen haben und daraufhin die Fehlermeldung „Unexpected token" gesehen haben. Die JSON-Standardsyntax definiert Kommentare, Trailing Commas und Schlüssel ohne Anführungszeichen gar nicht – der Fehler ist also kein Zufallsbug, sondern folgerichtig. Sie erfahren sachlich, wie Sie Fehlermeldungen lesen und was die automatische Reparatur intern tatsächlich tut.
Zusammenfassung ① Die JSON-Standardsyntax kennt weder Kommentare noch Trailing Commas noch Schlüssel ohne Anführungszeichen, deshalb wirft JSON.parse sofort einen Fehler. ② Die Angabe „position" in der Fehlermeldung ist die Zeichenposition ab Textanfang, „line" ergibt sich aus der Anzahl der Zeilenumbrüche bis zu dieser Position. ③ Auto-Fix wertet den Text ohne Kommentare mit new Function wie ein lockeres JavaScript-Objektliteral aus und serialisiert das Ergebnis bei Erfolg wieder als Standard-JSON.
Warum dieser Fehler auftritt: ein typisches Szenario
Ein häufiger Fall sieht so aus: Die settings.json von VS Code oder die tsconfig.json verwenden JSONC, eine erweiterte Form von JSON, die Kommentare erlaubt. Kopieren Sie einen Ausschnitt dieser Datei unverändert in die Konfiguration eines anderen Programms oder in den Body einer API-Anfrage, behandelt das JSON.parse dieses Programms die Kommentarsyntax als ungültiges Token und bricht an dieser Stelle ab.
Ein weiterer häufiger Fall entsteht beim Löschen von Einträgen in einem Array oder Objekt. Bleibt hinter einem Eintrag, der nun der letzte ist, das Komma stehen, folgt auf dieses Komma kein Wert – das Parsen schlägt fehl. In beiden Fällen wirkt der Text für das menschliche Auge völlig normal, enthält aber Strukturen, die in der JSON-Syntax nicht vorgesehen sind.
Fehler ohne Tool selbst lesen und beheben
Sie können das direkt in der Browserkonsole (F12) prüfen. Setzen Sie den problematischen Text in Backticks und führen Sie JSON.parse(\...`)` aus. Engines auf V8-Basis wie in Chrome oder Edge werfen dann einen SyntaxError und nennen in der Meldung die Position als Zahl. Neuere V8-Versionen geben zusätzlich Zeile und Spalte an, etwa „(line 3 column 5)".
Die Position zählt ab dem Textanfang, der als 0 gilt, und gibt an, das wievielte Zeichen betroffen ist. Die Zeile ergibt sich daraus, wie viele Zeilenumbrüche bis zu dieser Position vorkommen. Fehlt in der Meldung die Zeilenangabe, können Sie anhand der Position die Zeilenumbrüche von vorn abzählen und so die Zeile bestimmen.
Haben Sie die Stelle gefunden, prüfen Sie die Umgebung davor und danach auf eine der folgenden drei Ursachen. Alle drei sind in der JSON-Standardsyntax nicht vorgesehen, weshalb die Engine an dieser Stelle stoppt:
- Kommentare, die mit
//oder/* */beginnen - Überflüssige Kommas hinter dem letzten Eintrag eines Objekts oder Arrays
- Schlüssel, die ohne Anführungszeichen geschrieben sind
Entfernen Sie diese drei Dinge von Hand oder setzen Sie die Schlüssel in Anführungszeichen, erhalten Sie gültiges Standard-JSON. Bei tief verschachtelten Dateien oder sehr vielen Einträgen müssen Sie diese Arbeit allerdings unter Umständen mehrfach wiederholen.
Mit unserem Tool ausprobieren.
Läuft zu 100 % clientseitig im Browser. Ihr eingegebenes JSON wird nicht an einen Server übertragen.

Was die Auto-Fix-Schaltfläche intern macht
Die Schaltfläche für die automatische Fehlerreparatur (Auto-Fix) überträgt die eben beschriebene Handarbeit in Code. Zuerst entfernt sie per regulärem Ausdruck //-Zeilenkommentare und /* */-Blockkommentare aus dem Text.
Danach wertet sie den verbleibenden Text mit new Function aus. new Function führt einen String als JavaScript-Code aus und akzeptiert deshalb die deutlich lockerere Syntax von JavaScript-Objektliteralen. Schlüssel ohne Anführungszeichen (sofern es gültige Bezeichner sind), Strings in einfachen Anführungszeichen und Trailing Commas hinter dem letzten Eintrag sind in der ECMAScript-Syntax von Haus aus erlaubt, die JavaScript-Engine liest sie daher ohne Fehler.
Ist die Auswertung erfolgreich, wird das entstandene JavaScript-Objekt mit JSON.stringify erneut serialisiert. Dabei erhalten Schlüssel ohne Anführungszeichen doppelte Anführungszeichen, und Trailing Commas tauchen im Ergebnis gar nicht erst auf. Das Resultat erscheint als Standard-JSON in Eingabe- und Ausgabefeld.
Damit dieses Verfahren funktioniert, muss der verbleibende Text allerdings vollständig gültiger JavaScript-Syntax entsprechen. Fehler, die auch als JavaScript nicht interpretierbar sind, etwa nicht zusammenpassende Klammern oder ein komplett fehlender Wert, lassen sich auch mit Auto-Fix nicht beheben.
Was das Statistik-Panel zählt
Sobald Text im Eingabefeld steht, aktualisiert sich das Statistik-Panel ohne zusätzliche Schaltfläche. Es versucht JSON.parse und zeigt bei Erfolg VALID, bei einem Fehler INVALID als Gültigkeitsstatus an.
Die Key-Anzahl ist nicht nur die Zahl der Eigenschaften des obersten Objekts, sondern die Summe über alle verschachtelten Objekte hinweg. Ebenso zählt die Array-Anzahl nicht nur ein einzelnes Array auf oberster Ebene, sondern alle Werte, die irgendwo in der Struktur als Array vorkommen.
Die Tiefe (Depth) ist der Höchstwert dafür, wie viele Ebenen Objekte und Arrays ineinander verschachtelt sind. Enthält ein Array ein Objekt und dieses wiederum ein Array, erhöht sich die Tiefe entsprechend.
Die Größe in Byte ist nicht die Stringlänge (.length), sondern die tatsächliche Byte-Anzahl, gemessen über ein Blob-Objekt. Wird ein String in ein Blob umgewandelt, wird er als UTF-8 kodiert. Je mehr Zeichen mit mehreren Bytes vorkommen, etwa koreanische Schriftzeichen, desto größer fällt die Größe in Byte im Vergleich zur Zeichenanzahl aus.
Häufige Verwechslungen
Die Frage „Ist das nicht JSON?" entsteht meist, wenn die folgenden drei Formate durcheinandergeraten.
| Format | Kommentare | Trailing Comma | Schlüssel ohne Anführungszeichen | Von JSON.parse akzeptiert |
|---|---|---|---|---|
| Standard-JSON | nicht erlaubt | nicht erlaubt | nicht erlaubt | ja (ursprüngliches Format) |
| JavaScript-Objektliteral | erlaubt | erlaubt | erlaubt (bei gültigen Bezeichnern) | nein |
| JSON5 | erlaubt | erlaubt | erlaubt | nein (eigener Parser nötig) |
Die Darstellung, die console.log für ein Objekt in der JavaScript-Konsole ausgibt, oder Text mit Kommentaren wie in den Konfigurationsdateien von VS Code sieht für das menschliche Auge wie JSON aus, ist für das Standard-JSON.parse aber in jedem Fall ein Fehler. Auto-Fix funktioniert deshalb, weil diese Texte meist in die Spalte „JavaScript-Objektliteral" fallen.
Eine weitere Stolperfalle: Enthält ein JavaScript-Objekt undefined oder eine Funktion als Wert, lässt JSON.stringify diese Eigenschaft im Ergebnis komplett weg (innerhalb eines Arrays wird daraus null). Wirken in dem mit Auto-Fix wiederhergestellten JSON ursprünglich vorhandene Einträge verschwunden, kann diese Regel der Grund sein.
Fazit
- Standard-JSON definiert weder Kommentare noch Trailing Commas noch Schlüssel ohne Anführungszeichen, daher wirft JSON.parse bei jedem dieser drei Elemente einen Fehler.
- Die „position" in der Fehlermeldung ist die Zeichenposition ab Textanfang, die „line" ergibt sich aus der Anzahl der Zeilenumbrüche bis zu dieser Position.
- Auto-Fix entfernt Kommentare, wertet den Text mit new Function als lockere JavaScript-Syntax aus und serialisiert das Ergebnis bei Erfolg wieder als Standard-JSON.
- Die Key- und Array-Anzahl im Statistik-Panel summiert die gesamte verschachtelte Struktur, die Größe ist die Byte-Anzahl auf Blob-Basis und nicht die Zeichenanzahl.
- Fehler, die auch als JavaScript nicht lesbar sind, etwa nicht zusammenpassende Klammern, lassen sich mit Auto-Fix nicht beheben.
Läuft zu 100 % clientseitig im Browser. Ihr eingegebenes JSON wird nicht an einen Server übertragen.
Häufig gestellte Fragen
Welche Fehler behebt die automatische Fehlerreparatur (Auto-Fix)?
Zeilen- und Blockkommentare (//, /* */), Schlüssel ohne Anführungszeichen und übrig gebliebene Trailing Commas, die gegen die JSON-Spezifikation verstoßen, erkennt Auto-Fix über die lockere Syntaxauslegung der JavaScript-Engine und baut daraus Standard-JSON auf.
Wird mein eingegebenes JSON an einen Server gesendet?
Nein. Das Tool arbeitet ausschließlich im Browser, die eingegebenen Daten werden nicht über das Netzwerk an einen Server übertragen.
Wie werden „position" und „line" in der Fehlermeldung berechnet?
Das Tool berechnet diese Werte nicht selbst neu. Es liest die Zahlen per regulärem Ausdruck aus der Fehlermeldung, die die JavaScript-Engine des Browsers erzeugt, wenn JSON.parse fehlschlägt. Die „position" ist die Zeichenposition ab Textanfang, die „line" die Zeilennummer bis zu dieser Position.
Gibt es Fälle, in denen Auto-Fix den Fehler nicht beheben kann?
Ja. Auto-Fix wertet den Text ohne Kommentare als JavaScript-Syntax aus. Lässt sich der verbleibende Text auch als JavaScript nicht interpretieren, etwa bei nicht zusammenpassenden Klammern oder einem komplett fehlenden Wert, schlägt die Reparatur fehl.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen