JSON ist das verbreitetste Austauschformat des Webs: API-Antworten, Konfigurationsdateien, Datenexporte. Es ist für Menschen lesbar, aber auch sehr streng, und ein einziges vergessenes oder überflüssiges Komma genügt, damit ein Programm es nicht mehr lesen kann. Dieser Ratgeber erklärt die Regeln, wie man einen Fehler diagnostiziert und wie man von einem Format zum anderen wechselt, ohne die Daten zu beschädigen.
Die Regeln, die Sie kennen sollten
Ein JSON-Dokument enthält Objekte ({"Schlüssel": Wert}), Arrays ([1, 2, 3]), Zeichenketten, Zahlen, true, false und null. Sonst nichts. Diese Regeln erklären fast jeden Fehler:
- Schlüssel und Zeichenketten stehen in doppelten Anführungszeichen. Einfache ('a') sind nicht gültig.
- Kein Komma nach dem letzten Element eines Objekts oder Arrays.
- Keine Kommentare. Weder // noch /* */ gibt es in JSON.
- Keine Sonderwerte wie NaN, Infinity oder undefined.
- Schlüssel müssen in Anführungszeichen stehen, anders als bei JavaScript-Objekten.
Formatieren und validieren, Schritt für Schritt
- Fügen Sie das JSON in JSON-Formatierer ein oder ziehen Sie eine Datei hinein (höchstens 25 Millionen Zeichen). Es wird sofort eingerückt, mit 2 Leerzeichen, 4 Leerzeichen oder einem Tabulator, und Schlüssel lassen sich auf jeder Ebene alphabetisch sortieren.
- Durchsuchen Sie das Ergebnis als farbigen Code oder als einklappbaren Baum; bei einem großen Dokument öffnet der Baum nur die nützlichen Ebenen und zeigt lange Listen in Blöcken zu 100.
- Lesen Sie bei einem Fehler die Meldung: Zeile, Spalte, Auszug mit Zeiger und wahrscheinliche Ursache (überflüssiges Komma, einfache Anführungszeichen, Schlüssel ohne Anführungszeichen, Kommentar, NaN).
Warum große Zahlen eine Falle sind
JavaScript stellt alle Zahlen als Gleitkommazahlen doppelter Genauigkeit dar: Jenseits von 9.007.199.254.740.991 (2⁵³ − 1) werden ganze Zahlen nicht mehr exakt abgebildet. Die Kennung 12345678901234567890, von einem JavaScript-Programm gelesen und wieder geschrieben, wird zu 12345678901234567000. Die meisten Werkzeuge machen diesen Umweg unbemerkt. Unsere übernehmen Zahlen so, wie Sie sie geschrieben haben: Eine 20-stellige Kennung, 92.50 oder 1E5 ändern sich nicht. Enthalten Ihre Daten lange Kennungen, übertragen Sie sie besser als Zeichenketten.
Häufige Fehler
- Ein JavaScript-Objekt (Schlüssel ohne Anführungszeichen, einfache Anführungszeichen) kopieren und für JSON halten.
- Ein Komma nach dem letzten Element stehen lassen, eine Gewohnheit aus anderen Sprachen.
- JSON mit Kommentaren aus einer Konfigurationsdatei (JSONC) in ein Werkzeug einfügen, das striktes JSON verlangt.
- Eine CSV ohne BOM in Excel öffnen und beschädigte Umlaute sehen.
- Kennungen mit mehr als 15 Stellen durch ein Werkzeug umwandeln, das sie rundet.
Ehrliche Grenzen
- Höchstens 25 Millionen Zeichen: Darüber nutzen Sie ein Kommandozeilenwerkzeug.
- Doppelte Schlüssel werden gemeldet und beibehalten, ihre Bedeutung ist aber je nach Leser verschieden: Vermeiden Sie sie.
- Eine CSV ist ein flaches Format: Die Umwandlung tief verschachtelten JSONs kostet Lesbarkeit.
Häufige Fragen
Warum wird mein JSON abgelehnt, obwohl es in JavaScript funktioniert?
Weil ein JavaScript-Objekt Schlüssel ohne Anführungszeichen, einfache Anführungszeichen und abschließende Kommas akzeptiert, die JSON verbietet.
Werden meine Daten irgendwohin gesendet?
Nein. Formatierung, Validierung und Umwandlung laufen in Ihrem Browser.
Wie verhindere ich, dass Excel eine versteckte Formel in einer CSV ausführt?
Unser Konverter setzt jedem Text, der mit =, +, - oder @ beginnt, ein Apostroph voran. Echte Zahlen bleiben unberührt.
Kann ich Kommentare in JSON schreiben?
Nein. Für kommentierte Konfiguration nutzen Sie YAML oder ein abgeleitetes Format wie JSONC, das strikte JSON-Werkzeuge ablehnen.
Welche Einrückung soll ich wählen?
2 Leerzeichen sind die im Web verbreitetste Konvention; 4 Leerzeichen oder ein Tabulator sind ebenfalls üblich. Das ist eine Frage der Teamkonvention; die Bedeutung der Daten ändert sich nicht.