JavaScript-Objekt in JSON umwandeln: Fehlerursachen und Lösung

VeröffentlichtToolJS-Objekt in JSON Konverter

Inhalt
  1. Wann tritt dieses Problem auf?
  2. Manuell konvertieren ohne Tool
  3. Typische Stolperfallen
  4. Zusammenfassung
  5. Häufig gestellte Fragen

Wenn Sie ein JavaScript-Objektliteral aus der Browserkonsole oder aus dem Quellcode kopieren und direkt an JSON.parse() übergeben, erhalten Sie meistens einen SyntaxError. Der Grund: JS-Objektliterale und Standard-JSON verwenden unterschiedliche Syntaxregeln. Dieser Artikel vergleicht die Unterschiede Punkt für Punkt, zeigt, wie Sie manuell konvertieren, und erklärt, wie Sie Fehlermeldungen lesen.

Kurz zusammengefasst ① Standard-JSON erlaubt für alle Schlüssel und Zeichenkettenwerte ausschließlich doppelte Anführungszeichen. Trailing Commas und Kommentare sind verboten. ② JS-Objektliterale erlauben Schlüssel ohne Anführungszeichen, Zeichenketten in einfachen Anführungszeichen und Trailing Commas. Sie sehen JSON ähnlich, folgen aber einer anderen Syntax. ③ Die position-Angabe in einem JSON.parse-Fehler nennt das Zeichen der Eingabezeichenkette (Zählung ab 0), an dem das Parsen gestoppt hat.

Wann tritt dieses Problem auf?

Typisch ist folgende Situation: Sie führen in der Konsole der Browser-Entwicklertools console.log(config) aus, um ein Objekt zu prüfen, kopieren die Ausgabe und fügen sie in den Request-Body eines API-Testtools oder in das Konfigurationsfeld eines anderen Programms ein.

Die Konsolenausgabe ist die Darstellung eines JavaScript-Werts auf dem Bildschirm. Schlüssel haben daher keine Anführungszeichen, und Zeichenketten stehen in einfachen Anführungszeichen. Übergeben Sie diesen Text an JSON.parse() oder fügen Sie ihn in ein reines JSON-Eingabefeld ein, schlägt das Parsen fehl.

Dasselbe Problem entsteht, wenn Sie ein im Quellcode definiertes Konfigurationsobjekt unverändert in eine JSON-Datei übernehmen. Der Text sieht für das Auge ähnlich aus, doch der Parser erkennt eine völlig andere Syntax.

Manuell konvertieren ohne Tool

Die Syntax von Standard-JSON ist im Internetstandard RFC 8259 festgelegt. Die wichtigsten Regeln:

  • Schlüssel eines Objekts müssen in doppelten Anführungszeichen stehen.
  • Auch Zeichenkettenwerte erlauben nur doppelte Anführungszeichen. Einfache Anführungszeichen sind ein Syntaxfehler.
  • Nach dem letzten Element eines Arrays oder Objekts darf kein Komma stehen (Trailing Comma).
  • Kommentare (// oder /* */) sind nicht erlaubt.
  • Werte wie undefined, Funktionen und Symbol lassen sich in JSON nicht darstellen.

Ist der kopierte Text tatsächlich gültige JavaScript-Syntax – also ein Objektliteral, das Sie direkt aus dem Quellcode kopiert haben –, können Sie ihn in der Konsole der Browser-Entwicklertools selbst konvertieren. So gehen Sie vor:

Schritt für Schritt in der Konsole konvertieren

  1. Öffnen Sie die Entwicklertools (in Chrome und Edge mit F12, auf dem Mac mit Cmd+Option+I).
  2. Weisen Sie den kopierten Inhalt im Konsolen-Tab einer Variablen zu. Beispiel: const obj = { name: 'kim', age: 20, }; – setzen Sie also const obj = davor und ein Semikolon ans Ende.
  3. Drücken Sie die Eingabetaste, um die Variable anzulegen, und führen Sie anschließend JSON.stringify(obj, null, 2) aus.
  4. Die in der Konsole ausgegebene Zeichenkette ist Standard-JSON. Sie erkennen Schlüssel und Zeichenketten in doppelten Anführungszeichen und das Fehlen von Trailing Commas.

Dieses Vorgehen entspricht dem tatsächlichen Ausführen von Code. Fügen Sie Code unklarer Herkunft in die Konsole ein, kann dabei ein Sicherheitsrisiko entstehen. Stammt der Wert aus einem Log, das Sie selbst erzeugt haben, oder aus vertrauenswürdigem Quellcode, ist das Risiko geringer.

Fehlerposition (position) lesen

Haben Sie dagegen einen Text für JSON gehalten und an JSON.parse() übergeben, und das Parsen ist fehlgeschlagen, können Sie die Ursache über die position-Angabe in der Fehlermeldung eingrenzen. Sie gibt an, bei welchem Zeichen – gezählt ab dem Anfang (Index 0) der Eingabezeichenkette – das Parsen gestoppt hat.

Bei der Zeichenkette {name: 'a'} ist das Zeichen an Position 0 ein { und das Zeichen an Position 1 ein n. Tritt der Fehler an dieser Stelle auf, liegt es am Schlüssel (name) ohne doppelte Anführungszeichen.

Der genaue Wortlaut der Fehlermeldung unterscheidet sich je nach Browser- und Node.js-Version. Die Bedeutung der Zahl hinter position (Zeichenposition, ab 0 gezählt) bleibt aber gleich. Zählen Sie so viele Zeichen vom Anfang der Zeichenkette ab, sehen Sie, an welchem Zeichen der Parser hängen geblieben ist.

Bei langen oder verschachtelten Objekten ist es mühsam und fehleranfällig, die Anführungszeichen einzeln zu ersetzen und Trailing Commas zu entfernen. Mit unserem Tool prüfen.

JS-Objekt in JSON Konverter

Wandelt JS-Objektliterale mit unquotierten Schlüsseln und Strings in einfachen Anführungszeichen sofort in Standard-JSON um. Ohne Installation und Anmeldung direkt im Browser.

Typische Stolperfallen

MerkmalStandard-JSONHäufige Schreibweise in JS-Objektliteralen
Schreibweise der SchlüsselDoppelte Anführungszeichen Pflicht ("name")Bezeichner ohne Anführungszeichen (name)
ZeichenkettenwerteNur doppelte Anführungszeichen erlaubt ("kim")Auch einfache Anführungszeichen erlaubt ('kim')
Komma nach dem letzten ElementVerbotenErlaubt (Trailing Comma)
KommentareNicht möglich//, /* */ möglich
undefined- und FunktionswerteNicht darstellbarAls Wert verwendbar

Liegt das JavaScript-Objekt bereits als Variable in laufendem Code vor, brauchen Sie diese Konvertierung gar nicht. Dann genügt JSON.stringify(obj). Konvertieren müssen Sie nur, wenn das Objekt ausschließlich als Text (Konsolenausgabe oder Quellcode-Ausschnitt) existiert und keine ausführbare Variable vorhanden ist.

Hat das ursprüngliche JS-Objekt einen Schlüssel mit dem Wert undefined oder einer Funktion, verschwindet dieser Schlüssel bei der Umwandlung in JSON komplett aus dem Ergebnis. Das ist kein Fehler, sondern normales Verhalten von JSON.stringify. Schlüssel mit den Werten NaN oder Infinity werden ohne Fehlermeldung zu null.

Auch das einfache Ersetzen von einfachen durch doppelte Anführungszeichen (Suchen und Ersetzen) ist riskant. Dabei werden auch einfache Anführungszeichen (Apostrophe) ersetzt, die ursprünglich im Zeichenkettenwert standen, oder das Escaping gerät durcheinander – so kann sogar ein neuer Syntaxfehler entstehen.

Zusammenfassung

  • Standard-JSON verlangt Schlüssel und Zeichenketten in doppelten Anführungszeichen, keine Trailing Commas und keine Kommentare.
  • JS-Objektliterale erlauben Schlüssel ohne Anführungszeichen, einfache Anführungszeichen und Trailing Commas. Sie sehen JSON ähnlich, werden vom Parser aber anders erkannt.
  • Bei Text, den Sie direkt aus dem Quellcode kopiert haben, können Sie ihn in der Browserkonsole einer Variablen zuweisen und mit JSON.stringify() selbst konvertieren. Das entspricht dem Ausführen von Code und ist bei Code klarer Herkunft weniger riskant.
  • Die position-Angabe eines JSON.parse-Fehlers ist die ab 0 gezählte Zeichenposition. Zählen Sie diese Stelle ab, können Sie eingrenzen, an welcher Schreibweise das Parsen gescheitert ist.
  • Einfaches Ersetzen kann wegen Anführungszeichen innerhalb von Zeichenketten Fehler erzeugen. Bei langen oder verschachtelten Objekten treten bei einer Konvertierung, die die Syntax tatsächlich auswertet, weniger Fehler auf.
JS-Objekt in JSON Konverter

Wandelt JS-Objektliterale mit unquotierten Schlüsseln und Strings in einfachen Anführungszeichen sofort in Standard-JSON um. Ohne Installation und Anmeldung direkt im Browser.

Häufig gestellte Fragen

Warum erscheint bei JSON.parse der Fehler „Unexpected token“?

Weil die übergebene Zeichenkette nicht der Standard-JSON-Syntax entspricht. Am häufigsten fehlen bei Schlüsseln die doppelten Anführungszeichen, Zeichenkettenwerte stehen in einfachen Anführungszeichen, oder nach dem letzten Element steht noch ein Trailing Comma. Zählen Sie die position-Angabe der Fehlermeldung ab, sehen Sie genau, an welchem Zeichen das Parsen gestoppt hat.

Reicht es, einfache Anführungszeichen durch doppelte zu ersetzen?

Enthalten die Zeichenkettenwerte selbst einfache oder doppelte Anführungszeichen, kann ein simples Ersetzen das Ergebnis zerstören. Anführungszeichen innerhalb von Zeichenketten werden dann wahllos mitgeändert, oder das Escaping stimmt nicht mehr. Eine Konvertierung, die die Syntax tatsächlich auswertet, vermeidet diese Probleme.

Muss ich ein vorhandenes JS-Objekt überhaupt konvertieren, um es in JSON umzuwandeln?

Gibt es im laufenden Code eine JS-Objektvariable, genügt JSON.stringify(obj), und ein zusätzlicher Konvertierungsschritt ist nicht nötig. Konvertieren müssen Sie nur, wenn das Objekt ausschließlich als Text (Konsolenausgabe oder Quellcode-Ausschnitt) vorliegt und keine ausführbare Variable existiert.

Warum sind in JSON keine Kommentare erlaubt?

Weil die Standard-JSON-Syntax (RFC 8259) keine Kommentare vorsieht. JS-Objektliterale folgen der JavaScript-Syntax und erlauben daher //- und /* */-Kommentare. Übertragen Sie sie nach JSON, führen die Kommentare zu Syntaxfehlern und müssen entfernt werden.

Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen

Ähnliche Artikel

  1. JSON-Schema erstellen: So werden Typen erkannt (Draft-07)Wie aus einem JSON-Beispiel ein Draft-07-Schema entsteht: Typerkennung bei Strings, Zahlen und Arrays, required und anyOf erklärt, plus Grenzen eines Beispiels.
  2. JSON Syntaxfehler: Ursachen anhand der Fehlermeldung findenWas die Position in JSON-Fehlermeldungen bedeutet und wie Sie typische Syntaxfehler wie Trailing Comma, einfache Anführungszeichen und Kommentare erkennen.
  3. 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.
  4. 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.
  5. 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.
  6. 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.

Passende Tools