Was ist JSON? Struktur und häufige Fehler in 5 Minuten

JSON (JavaScript Object Notation) ist das gängigste Format zum Datenaustausch im Web. APIs geben es zurück, Konfigurationsdateien nutzen es, Logs sind voll davon. Trotz des „JavaScript” im Namen ist es sprachunabhängig — Python, Go, Java und praktisch alles andere können es lesen und schreiben. Hier das Wichtigste in fünf Minuten.

Die Bausteine

Ein JSON-Dokument besteht aus nur wenigen Typen:

• Objekt — eine Menge von Schlüssel/Wert-Paaren in geschweiften Klammern: { "name": "Ada", "age": 36 }
• Array — eine geordnete Liste in eckigen Klammern: [1, 2, 3]
• String — Text in doppelten Anführungszeichen: "hello"
• Zahl — 42, 3.14, -7 (ohne Anführungszeichen)
• Boolean — true oder false
• null — ein expliziter leerer Wert

Objekte und Arrays lassen sich beliebig tief verschachteln — so stellt JSON komplexe Daten dar.

Ein kurzes Beispiel

{
  "user": "ada",
  "active": true,
  "roles": ["admin", "editor"],
  "profile": { "age": 36, "city": "London" }
}

Das ist ein einzelnes Objekt mit einem String, einem Boolean, einem String-Array und einem verschachtelten Objekt.

Die Regeln, über die man stolpert

Die meisten „ungültiges JSON”-Fehler stammen aus wenigen Ursachen:

1. Nachgestellte Kommas. [1, 2, 3,] ist in JavaScript gültig, in JSON nicht. Entferne das Komma nach dem letzten Element.
2. Einfache Anführungszeichen. JSON verlangt doppelte Anführungszeichen für Schlüssel und String-Werte. {'name': 'Ada'} ist ungültig; es muss {"name": "Ada"} heißen.
3. Schlüssel ohne Anführungszeichen. {name: "Ada"} ist ein JavaScript-Objektliteral, kein JSON. Schlüssel müssen Strings in Anführungszeichen sein.
4. Kommentare. JSON hat keine Kommentar-Syntax. // so etwas verursacht einen Parse-Fehler.
5. Falsche Werttypen. Zahlen und Booleans dürfen nicht in Anführungszeichen stehen, außer du willst sie als String.

Wie man kaputtes JSON schnell repariert

Wenn dein Code einen Parse-Fehler wirft, ist der schnellste Weg, das Dokument durch einen Validator zu schicken. Füge es in den JSON-Formatter ein: Ist die Syntax falsch, zeigt er die ungefähre Stelle und den Grund. Ist es gültig, klicke auf „Verschönern”, um die Struktur klar zu sehen, oder auf „Minimieren”, um es vor dem Versand zu verkleinern.

Wann man JSON (nicht) verwenden sollte

JSON eignet sich hervorragend für Konfiguration und API-Payloads. Weniger ideal ist es für sehr große Datensätze (Streaming- oder Binärformate sind effizienter) oder für Dokumente mit Kommentaren (YAML oder TOML sind hier freundlicher). Für die meisten Web-Aufgaben ist JSON jedoch die Lingua franca — und jetzt kannst du sie fließend lesen.

Bereit, etwas JSON aufzuräumen? Probiere den kostenlosen JSON-Formatter — er läuft komplett im Browser, deine Daten verlassen also nie dein Gerät.