JSON – Der komplette Leitfaden zu Syntax und Datenformat 2026

Was du über JSON wissen musst:

• JSON steht für JavaScript Object Notation – ein Klartextformat zum Speichern und Austauschen strukturierter Daten
• Es gibt sechs Datentypen: Zeichenfolgen, Zahlen, Booleans, null, Arrays und Objekte
• Die Syntaxregeln sind streng: Schlüssel müssen Strings in doppelten Anführungszeichen sein, nachgestellte Kommas machen sie ungültig, und Kommentare gibt es nicht
• Daten werden mit Objekten (Schlüssel/Wert-Paaren in geschweiften Klammern) und Arrays (geordneten Listen in eckigen Klammern) strukturiert – beide können verschachtelt werden
• In JavaScript wandelt es JSON.parse() einen JSON-String in ein Objekt um; JSON.stringify() macht das Gegenteil
• JSON ist das Standardformat für REST-APIs, vor allem weil jede Sprache und jeder Browser es nativ verarbeiten kann
• Mit JSON Schema kannst du die erwartete Struktur eines Dokuments definieren und validieren, bevor deine Anwendung es verarbeitet
• JSONP ist ein veralteter Workaround für Cross-Origin-Probleme – in moderneren Anwendungen wurde es größtenteils durch CORS ersetzt

Was JSON ist und warum es wichtig ist

JSON (JavaScript Object Notation) ist ein leichtgewichtiges Datenformat zum Speichern und Austauschen strukturierter Daten. Es ist ein Klartextformat, das jede große Sprache nativ lesen und schreiben kann – und genau deshalb wird es fast überall verwendet. Die Vorteile von JSON sind einfach: keine speziellen Bibliotheken, keine Konvertierungsschichten und eine Struktur, die direkt zu den Objekten passt, mit denen Entwickler ohnehin arbeiten. Douglas Crockford hat es Anfang der 2000er definiert, und heute ist es in RFC 8259 und ECMA-404 standardisiert.

JSON vs. XML: Die wichtigsten Unterschiede

Im Vergleich zwischen JSON und XML geht es vor allem um die Wortfülle. XML umschließt jeden Wert in öffnenden und schließenden Tags; JSON verwendet Schlüssel/Wert-Paare mit minimaler Interpunktion, und das JSON-Format passt unmittelbar zu den Datenstrukturen, mit denen du bereits in deinem Code arbeitest.

Hier sind die gleichen Daten in beiden Formaten:

XML:

<user>
  <name>Alice</name>
  <age>30</age>
</user>

JSON:

{
  "name": "Alice",
  "age": 30
}

XML ist nach wie vor sinnvoll für Dokument-Markup und Unternehmenssysteme mit strengen Schemaanforderungen. Bei APIs und Konfigurationsdateien wirst du in der Praxis meist JSON begegnen.

JSON vs CSV und YAML

Vergleicht man JSON und CSV, so kann CSV flache Tabellendaten noch gut abbilden, stößt aber bereits an seine Grenzen, wenn deine Daten irgendeine Hierarchie aufweisen. Der Vergleich zwischen JSON und YAML ist enger – YAML unterstützt dieselben Strukturen wie JSON und erlaubt Kommentare, was für Konfigurationsdateien wirklich nützlich ist, aber ein einziges falsch gesetztes Leerzeichen kann die ganze Datei unbrauchbar machen. JSON ist weniger flexibel als YAML, dafür aber universeller unterstützt, nachsichtiger mit Fehlern und robuster.

Vorteile von JSON

Was zeichnet JSON im Vergleich zu den Alternativen aus? Die Vorteile von JSON sind hauptsächlich praktischer Natur. Das JSON-Format wird universell unterstützt: Browser parsen es nativ, jede Sprache bringt einen eingebauten Parser mit, und beide Seiten eines API-Aufrufs können es ohne Zwischenschritt lesen.

Die einzige echte Einschränkung: keine Kommentarsyntax. Für Konfigurationsdateien in der Versionskontrolle ist das ärgerlich. Bei API-Payloads vermisst sie niemand.

JSON-Syntax verstehen

Die JSON-Syntax hat zwei Strukturen: Objekte (Schlüssel/Wert-Paare in geschweiften Klammern) und Arrays (geordnete Listen in eckigen Klammern). Alles andere ist ein Wert innerhalb einer dieser beiden Strukturen.

Die Regeln sind streng und unnachgiebig:

• Schlüssel müssen Strings in doppelten Anführungszeichen sein
• Keine abschließenden Kommata – der Parser lehnt die gesamte Datei ab
• Keine Kommentare, Punkt.
• Paare sind durch Kommata getrennt
• Werte müssen einer der sechs unterstützten Datentypen sein

JSON-Schlüssel/Wert-Paare erklärt

Ein JSON-Objekt ist eine Sammlung von Schlüssel/Wert-Paaren. Hier ist ein JSON-Beispiel mit typischen Server-Konfigurationsdaten:

{
  "hostname": "server01",
  "port": 8080,
  "active": true
}

Die JSON-Syntax bleibt immer gleich, unabhängig davon, was die Daten darstellen. Eine Serverkonfiguration und ein Benutzerprofil sind strukturell identisch – nur unterschiedliche Schlüssel und Werte.

Überblick über die JSON-Datentypen

JSON unterstützt genau sechs Datentypen. Hier siehst du, wie jeder davon aussieht – und wo typischerweise Fehler passieren. Jedes JSON-Beispiel unten ist absichtlich minimal gehalten; in der Praxis werden diese einfach innerhalb von Objekten und Arrays verschachtelt.

String

Ein JSON-String ist jede Folge von Unicode-Zeichen in doppelten Anführungszeichen. Er ist der am häufigsten verwendete JSON-Datentyp – und der häufigste Fehler besteht darin, einfache Anführungszeichen zu verwenden, die nicht zulässig sind.

{ "city": "Munich" }

Zahl

JSON unterscheidet nicht zwischen Ganzzahlen und Gleitkommazahlen – beide sind nach den JSON-Datentypen-Spezifikationen einfach Zahlen. Dieses JSON-Beispiel umfasst beides:

{ "cores": 8, "price": 6.99 }

Boolean

Ein JSON-Boolean ist true oder false. Kleinbuchstaben, keine Anführungszeichen – das sind die einzigen gültigen Optionen, und das gilt konsistent für alle JSON-Datentypen, die Wahrheitswerte darstellen.

{ "enabled": true, "debug": false }

Null

JSON null steht für das Fehlen eines Werts und ist ein eigener Datentyp – kein Synonym für einen leeren String oder die Zahl Null.

{ "middleName": null }

Ein Feld, das auf null gesetzt ist, und ein Feld, das nicht existiert, sind technisch unterschiedliche Dinge. Behalte das im Hinterkopf, wenn du Parser schreibst.

Array

Ein JSON-Array ist eine geordnete Liste von Werten in eckigen Klammern – einer der vielseitigsten JSON-Datentypen, da es Strings, Zahlen, Objekte oder andere Arrays enthalten kann.

{ "ports": [80, 443] }

Objekt

Indem du ein JSON-Objekt in ein anderes verschachtelst, modellierst du echte hierarchische Strukturen. Es ist der ausdrucksstärkste JSON-Datentyp und das Muster, auf dem die meisten echten API-Antworten basieren.

{
  "server": {
    "hostname": "server01",
    "port": 8080
  }
}

Wie man JSON-Daten speichert

Die Wahl zwischen einem JSON-Objekt und einem JSON-Array hängt davon ab, ob deine Daten benannte Eigenschaften oder eine geordnete Sammlung sind. Die meisten Antworten im echten JSON-Format verwenden beide zusammen.

JSON-Objekte verwenden

Ein JSON-Objekt eignet sich am besten für Daten mit benannten Eigenschaften – einen Benutzerdatensatz oder eine einzelne API-Ressource. Die JSON-Syntax ist durchweg die gleiche, und jedes JSON-Beispiel folgt demselben Schlüssel/Wert-Muster.

{ "id": 1, "name": "Alice", "active": true }

JSON-Arrays verwenden

Ein JSON-Array ist für geordnete Sammlungen gedacht – also überall dort, wo du mit mehreren Instanzen derselben Struktur arbeitest. Dieses JSON-Beispiel zeigt auch, wie sich Objekte ganz natürlich in Arrays verschachteln lassen. Genau dieses Muster findest du in den meisten API-Antworten.

[
  { "id": 1, "name": "Alice" },
  { "id": 2, "name": "Bob" }
]

Verschachtelte Objekte und Arrays in JSON

JSON in der Praxis enthält fast immer Verschachtelungen. Ein JSON-Objekt enthält ein JSON-Array, dieses Array enthält weitere Objekte, diese Objekte enthalten weitere Werte. Die Spezifikation kennt keine Tiefenbegrenzung, auch wenn Produktions-APIs oft überraschend tief verschachtelt sind, bevor jemand auf die Idee kommt, sie zu vereinfachen. Hier ist ein klares JSON-Beispiel:

{
  "cluster": "eu-west",
  "nodes": [
    { "id": "node1", "status": "active" },
    { "id": "node2", "status": "standby" }
  ]
}

Mit JSON im Code arbeiten

Die beiden Funktionen, die du ständig brauchst, sind JSON.parse und JSON.stringify. JSON-Schema-Validierung wird wichtig, sobald du externe oder nicht vertrauenswürdige Daten verarbeitest. Zusammen decken sie die meisten echten JSON-Szenarien in JavaScript ab.

JSON mit JSON.parse parsen

Beim JSON.parse-Vorgang wird ein JSON-String eingelesen und als JavaScript-Objekt zurückgegeben. Das ist der Standard-Einstiegspunkt zum Verarbeiten von API-Antworten, und jedes gute JSON-Tutorial wird dir sagen, dass du ihn in die Fehlerbehandlung einbetten solltest.

const data = JSON.parse('{"name":"Alice","age":30}');
console.log(data.name); // "Alice"

Gib ein ungültiges JSON ein, und es gibt <wpml_ignored_tag wpml_name=“code“ wpml_value=“U3ludGF4RXJyb3I=“ wpml_attrs=““/> zurück. Packe nicht vertrauenswürdige Eingaben immer in einen try/catch-Block – genau dieser Fehler taucht in Produktionslogs am häufigsten auf.

try {
  const data = JSON.parse(input);
} catch (e) {
  console.error("Invalid JSON:", e.message);
}

JSON.stringify() Methode

Jedes JSON-Tutorial behandelt JSON.stringify zusammen mit JSON.parse, weil du beim Arbeiten mit APIs beide brauchst. JSON.stringify() geht in die andere Richtung – Objekt rein, String raus.

const str = JSON.stringify({ name: "Alice", age: 30 });
// '{"name":"Alice","age":30}'

Gib ein drittes Argument für einzurückende Ausgaben an. Genau danach suchen die meisten, wenn sie JSON hübsch gestalten wollen. Die JSON.stringify-Methode ist wahrscheinlich die am häufigsten verwendete JSON-Funktion in JavaScript.

JSON.stringify(obj, null, 2);

JSON-Schema-Validierung

JSON-Schema ist ein Vokabular zur Beschreibung der erwarteten Struktur eines JSON-Dokuments. Du definierst Pflichtfelder und die zulässigen JSON-Datentypen und schickst eingehende Daten dann durch einen Validator, bevor deine Anwendung sie verarbeitet.

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age":  { "type": "integer", "minimum": 0 }
  },
  "required": ["name"]
}

Fehlerhafte Daten direkt am Einstiegspunkt abzufangen ist besser, als sie erst drei Funktionen später zu debuggen. Gerade bei API-Eingaben ist JSON-Schema-Validierung eines der am stärksten unterschätzten Werkzeuge im Stack.

JSON in APIs und Webanwendungen

Das Standard-JSON-Format eignet sich am besten für REST-APIs. Wenn du einen JSON-API-Aufruf machst, kommt die Antwort fast immer als JSON-Objekt oder -Array zurück, mit Content-Type: application/json im Header. Abgesehen von JSONP wickelt das Web den Austausch strukturierter Daten schon seit weit über einem Jahrzehnt so ab.

Wie JSONP funktioniert

JSONP (JSON with Padding) ist ein Workaround aus der Zeit vor CORS für Cross-Origin-Einschränkungen. Statt rohe JSON-API-Daten zurückzugeben, verpackt der Server die Antwort in einen Funktionsaufruf:

callback({ "name": "Alice" });

Der Browser lädt es als Skript-Tag und führt es aus. Heute begegnet dir JSONP meist nur noch in älteren Codebasen – zu wissen, was es ist, spart dir zwanzig Minuten Verwirrung, wenn du darüber stolperst.

JSON-API-Format

JSON:API ist eine formale Spezifikation zur Strukturierung der API-Antworten im JSON-Format. Es standardisiert, wie Ressourcen und Fehler im Response-Body erscheinen, sodass jeder dafür gebaute Client jeden kompatiblen JSON-API-Endpunkt ohne eigene Parsing-Logik nutzen kann. Gut zu wissen, wenn du eine öffentliche API baust oder mit einer großen API integrierst.

JSON-Merkblatt

Eine Kurzreferenz zu JSON-Syntax, JSON-Datentypen und typischen JSON-Beispielmustern:

JSON FAQ