JSON Syntaxfehler: Ursachen anhand der Fehlermeldung finden

VeröffentlichtToolJSON-Formatierer und -Validator

Inhalt
  1. Warum diese Fehler so häufig auftreten
  2. JSON-Syntaxregeln und wie Sie Fehlermeldungen lesen
  3. Häufig verwechselte Syntaxfehler
  4. Zusammenfassung
  5. Häufig gestellte Fragen

Die Fehlermeldung „Unexpected token“, die beim Einfügen von JSON erscheint, bedeutet, dass eine der JSON-Syntaxregeln verletzt wurde. In der Meldung steht bereits, bei welchem Zeichen und an welcher Stelle das Problem auftritt. Dieser Beitrag fasst die häufigsten Syntaxfehler zusammen und zeigt, wie Sie anhand der Meldung die Ursache finden.

Zusammenfassung ① JSON erlaubt weder Trailing Commas (Kommas nach dem letzten Element) noch einfache Anführungszeichen, Kommentare oder Schlüssel ohne Anführungszeichen. ② Die Fehlermeldung von JSON.parse zeigt das problematische Zeichen und die Position (position) an. ③ Der Positionswert ist die Anzahl der Zeichen ab Beginn der Zeichenkette. Wenn Sie sich die Stelle davor und danach ansehen, lässt sich die Ursache eingrenzen.

Warum diese Fehler so häufig auftreten

Es kommt oft vor, dass man eine API-Antwort aus der Konsole kopiert und in eine Konfigurationsdatei einfügt, oder dass man mehrere Antworten von Hand zusammensetzt und dabei hinter dem letzten Eintrag ein Komma stehen lässt. Ebenfalls häufig: Ein Objektliteral aus JavaScript-Code wird unverändert herausgelöst und als JSON eingefügt.

Beide Syntaxformen sehen auf den ersten Blick ähnlich aus, folgen aber unterschiedlichen Regeln. Ausdrücke, die in einem JavaScript-Objektliteral funktionieren (einfache Anführungszeichen, Schlüssel ohne Anführungszeichen, Trailing Commas), sind in JSON allesamt Syntaxfehler. Übernimmt man also einen Wert, der im Code einwandfrei lief, unverändert, wirft JSON.parse sofort einen Fehler.

Das Problem: Die Fehlermeldung wirkt wie Code, etwa „Unexpected token } in JSON at position 42“. Wer nicht weiß, gegen welche Syntaxregel verstoßen wurde und worauf sich die Zahl 42 bezieht, findet die Ursache auch nach dem Lesen der Meldung nicht.

JSON-Syntaxregeln und wie Sie Fehlermeldungen lesen

JSON ist ein Standardformat mit festgelegter Syntax. Die Regeln, die in der Praxis Fehler auslösen, lassen sich auf einige wenige zusammenfassen.

  • Zeichenketten und Schlüssel stehen immer in doppelten Anführungszeichen ("). Einfache Anführungszeichen (') gibt es in der JSON-Syntax nicht.
  • Nach dem letzten Eintrag eines Objekts oder Arrays steht kein Komma (Trailing Commas sind nicht erlaubt).
  • Schlüssel müssen stets Zeichenketten in Anführungszeichen sein. Schlüssel ohne Anführungszeichen sind keine JSON-Syntax, sondern die Syntax von JavaScript-Objektliteralen.
  • Kommentare (// oder /* */) sind in der JSON-Syntax selbst nicht vorgesehen.
  • Zahlen dürfen keine überflüssige führende 0 (wie bei 01) und kein Pluszeichen (+) haben, und Werte wie NaN oder Infinity sind nicht zulässig.
  • true, false und null werden ausschließlich kleingeschrieben.

Verstößt etwas gegen eine dieser Regeln, gibt JSON.parse im Browser keinen Wert zurück, sondern wirft einen Fehler (SyntaxError).

Positionsangabe (position) in der Fehlermeldung lesen

Der Fehler enthält zwei Informationen: das problematische Zeichen und die Position (position), also an der wievielten Stelle der Zeichenkette dieses Zeichen steht. Die Position ist die Anzahl der Zeichen ab dem Anfang der Zeichenkette (0), Zeilenumbrüche eingeschlossen.

Das Format der Meldung unterscheidet sich je nach Browser-Engine. Chromium-basierte Browser zeigen position (Zeichenposition) an, Firefox-basierte Browser line und column (Zeile und Spalte). Gemeint ist aber dieselbe Stelle.

Um die Ursache zu finden, sehen Sie sich anhand dieser Position die Zeichen davor und danach an. Je länger das JSON ist, desto mühsamer und fehleranfälliger wird es allerdings, die Position von Hand abzuzählen.

Prüfen Sie es mit unserem JSON-Formatierer und -Validator.

JSON-Formatierer und -Validator

Fügen Sie Ihr JSON ein und klicken Sie auf die Formatieren-Schaltfläche, um Fehlerposition und Meldung sofort zu sehen. Die Verarbeitung erfolgt nur im Browser, es werden keine Daten an einen Server gesendet.

Häufig verwechselte Syntaxfehler

Auch wenn das Ergebnis immer „Es gibt einen Fehler“ lautet, sind die Ursachen verschieden. Die häufigsten Typen im Überblick:

FehlertypBeispielWarum es ein Fehler ist
Trailing Comma{"a":1,"b":2,}Nach dem letzten Eintrag steht kein Komma
Einfache Anführungszeichen{'a':1}Zeichenketten und Schlüssel sind nur in doppelten Anführungszeichen erlaubt
Anführungszeichen beim Schlüssel fehlen{a:1}Schlüssel müssen Zeichenketten in Anführungszeichen sein
Kommentar enthalten{"a":1} // ErklärungDie JSON-Syntax kennt keine Kommentare
undefined als Wert{"a":undefined}JSON kann undefined nicht darstellen (nur null ist möglich)
Führende 0 bei Zahlen{"a":01}Zahlen, die mit 0 beginnen, sind nur für die 0 selbst erlaubt

Trailing Commas und einfache Anführungszeichen sind in JavaScript-Code ganz normale Schreibweisen. Deshalb schleichen sie sich besonders oft ein, wenn man Werte aus dem Code kopiert und als JSON verwendet.

Zusammenfassung

  • JSON folgt einer festen Syntax mit Regeln zu doppelten Anführungszeichen, Kommas usw. und unterscheidet sich damit von JavaScript-Objektliteralen.
  • Trailing Commas, einfache Anführungszeichen, Schlüssel ohne Anführungszeichen und Kommentare sind in der Praxis die häufigsten Fehlerursachen.
  • Die Fehlermeldung von JSON.parse enthält das problematische Zeichen und die Position (position bzw. line/column).
  • Der Positionswert ist die Anzahl der Zeichen ab Beginn der Zeichenkette. Wenn Sie die Stelle davor und danach prüfen, lässt sich die Ursache eingrenzen.
  • Bei langem JSON ist es schneller und genauer, die Position mit einem Tool zu prüfen, statt sie von Hand abzuzählen.
JSON-Formatierer und -Validator

Fügen Sie Ihr JSON ein und klicken Sie auf die Formatieren-Schaltfläche, um Fehlerposition und Meldung sofort zu sehen. Die Verarbeitung erfolgt nur im Browser, es werden keine Daten an einen Server gesendet.

Häufig gestellte Fragen

Was bedeutet der Fehler „Unexpected token“ genau?

JSON.parse ist auf ein Zeichen gestoßen, das an dieser Stelle laut Syntax nicht vorkommen darf. In der Meldung stehen dieses Zeichen und die Stelle der Zeichenkette (position), an der es gefunden wurde. Wenn Sie die Stelle davor und danach prüfen, finden Sie die Ursache meist sofort.

Was bedeutet die Zahl hinter „position“?

Es ist die Anzahl der Zeichen (Zeichenindex), wobei der Anfang der Zeichenkette als 0 gilt. Zeilenumbruchzeichen werden mitgezählt. Bei position 42 liegt das Problem zum Beispiel beim 43. Zeichen ab dem Beginn der Zeichenkette.

Warum verursacht JSON mit Kommentaren einen Fehler?

Weil die JSON-Syntax selbst keine Schreibweise für Kommentare definiert. Kommentare wie // oder /* */ sind in JavaScript sowie in Erweiterungen wie JSON5 oder JSONC erlaubt, in Standard-JSON werden sie aber als Fehler behandelt.

Darf ich ein JavaScript-Objekt unverändert als JSON verwenden?

Nein. In einem JavaScript-Objektliteral dürfen Schlüssel ohne Anführungszeichen stehen, einfache Anführungszeichen verwendet werden und Trailing Commas stehen bleiben. JSON wertet all das als Syntaxfehler. Erst wenn Sie alles in doppelte Anführungszeichen setzen und das letzte Komma entfernen, ist es gültiges JSON.

Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen

Ähnliche Artikel

  1. JSON in TypeScript umwandeln: ? und | in Interfaces lesenWann steht in einem aus JSON erzeugten TypeScript-Interface ein Fragezeichen (optional) oder ein Union-Typ mit |? Die Regeln, gezeigt an einem JSON-Beispiel.
  2. JSON zu YAML: Regeln für Arrays und EinrückungWie aus JSON-Arrays YAML-Listen mit Bindestrich werden, was 2 oder 4 Leerzeichen Einrückung ändern und welche Fehler bei Kubernetes und Docker oft passieren.
  3. JSONPath-Syntax erklärt: Was $, [*] und .. auswählenWas $, .Eigenschaft, [Zahl], [*] und .. in JSONPath auswählen, gezeigt an einem Beispiel-JSON. Dazu: warum Filterausdrücke und Slices hier nicht greifen.
  4. JWT dekodieren: Aufbau, Payload lesen und exp in DatumJWT ist nur Base64URL-kodiert, nicht verschlüsselt. So lesen Sie Header und Payload aus und wandeln exp und iat in ein lesbares Datum um.
  5. JWT-Signatur prüfen: Warum die Verifizierung fehlschlägtSo funktioniert die JWT-Prüfung mit HMAC-SHA256: Aufbau des Tokens, Signaturberechnung und die zwei Ursachen für fehlgeschlagene Verifizierung.
  6. line-clamp in CSS: Warum es nicht funktioniert und wie es gehtWenn line-clamp nicht greift, fehlt meist display: -webkit-box. Der Artikel zeigt per Code, warum ein- und mehrzeiliges Abschneiden verschiedene Properties nutzen.

Passende Tools