JSON-Arrays und -Objekte schreiben: Struktur und Verschachtelung für Einsteiger
Fazit: JSON kennt nur zwei Container: das Objekt für benannte Felder, das Array für geordnete Listen. Lernen Sie, beide zu kombinieren, das richtige zu wählen und die drei häufigsten Fehler zu korrigieren: Schein-Arrays mit numerischen Schlüsseln, abschließende Kommas und einfache Anführungszeichen.

JSON gibt Ihnen nur zwei Container: Das Objekt trägt benannte Felder, das Array trägt geordnete Listen — und fast jeder kaputte Payload erklärt sich durch Anführungszeichen, Kommas oder eine Liste, die als Schein-Objekt geschrieben wurde.
Erstens: JSON hat nur zwei Container
So komplex eine API-Antwort auch sein mag, sie reduziert sich auf zwei Container und sechs Wertetypen. Ein Objekt ist eine Sammlung von Schlüssel-Wert-Paaren in geschweiften Klammern {}; ein Array ist eine geordnete Liste von Werten in eckigen Klammern []. Ein Wert kann ein String, eine Zahl, true, false, null sein — oder wiederum ein Objekt oder Array. Objekte in Arrays, Arrays in Objekten: Diese Rekursion ist die gesamte Ausdruckskraft von JSON.
{
"user": { "name": "Ada", "active": true },
"roles": ["admin", "editor"],
"lastLogin": null,
"loginCount": 42
}
Daraus folgt eine praktische Konsequenz: Bei einem verwirrenden Payload nicht Zeichen für Zeichen lesen. Prüfen Sie zuerst, ob das äußerste Zeichen { oder [ ist. Bei einem Objekt lesen Sie es als benannte Felder; bei einem Array lesen Sie es als Liste und steigen dann Ebene für Ebene hinab. Das Syntaxdiagramm auf json.org passt auf eine einzige Seite, gerade weil zwei Strukturen plus Rekursion alles abdecken.
Zweitens: Objekte schreiben, vier harte Regeln
Objekte sind der Ort, an dem Einsteiger die meisten Fehler machen, aber die Regeln reduzieren sich auf vier:
- Schlüssel müssen Strings in doppelten Anführungszeichen sein.
{name: "Ada"}und{'name': 'Ada'}sind beide ungültig; korrekt ist{"name": "Ada"}. JavaScript-Objektliterale erlauben nackte Schlüssel und einfache Anführungszeichen, JSON nicht — das ist die häufigste Verwechslung zwischen beiden. - Trennen Sie Paare mit Kommas und lassen Sie niemals ein Komma nach dem letzten Paar stehen.
{"a": 1, "b": 2,}schlägt mitUnexpected token }an der schließenden Klammer fehl. - Schlüssel sollten eindeutig sein. RFC 8259 formuliert das als SHOULD, nicht MUST: Doppelte Schlüssel erzeugen keinen Fehler, aber ob der erste oder letzte Wert erhalten bleibt, hängt von der Implementierung ab, und die Sprachen weichen ab. Verlassen Sie sich nie darauf.
- Die Reihenfolge der Schlüssel hat keine Bedeutung.
{"a":1,"b":2}und{"b":2,"a":1}sind dasselbe Objekt; Diff-Tools und Vergleichsfunktionen ignorieren die Schlüsselreihenfolge. Wenn die Reihenfolge zählt, gehören die Daten in ein Array.
Drittens: Arrays schreiben, die Reihenfolge ist Daten
Arrays speichern Werte nach Position, und die Indizierung beginnt bei 0: In ["admin", "editor"] ist der String "editor" das [1]. Diese Reihenfolge ist bedeutsam — das ist der wesentliche Unterschied zwischen Arrays und Objekten. Nach Relevanz sortierte Suchergebnisse, nach Datum geordnete Log-Einträge: Diese Information lebt nur in der Sequenz, und die Umwandlung in ein Objekt zerstört sie.
Zwei praktische Empfehlungen. Erstens: Halten Sie die Elemente homogen. [{"id":1},{"id":2}] ist deutlich einfacher zu verarbeiten als [1, "text", true] — legal, aber jeder Consumer muss an jedem Schritt die Typen prüfen. Zweitens: Ein leeres Array [] ist ein völlig gültiger Wert. Wenn ein Listenfeld noch keinen Inhalt hat, geben Sie [] statt null aus, damit der Consumer nicht erst die Existenz und dann die Leere prüfen muss.
[
{ "city": "Tokyo", "population": 13960000 },
{ "city": "Delhi", "population": 16780000 }
]
Viertens: Verschachtelung, die vier Formen echter Payloads
Reale Daten sind nur diese zwei Container, ineinander verschachtelt, und die Muster reduzieren sich auf vier Formen:
| Form | Wie es aussieht | Typischer Einsatz |
|---|---|---|
| Objekt enthält Array | {"tags": ["a","b"]} |
Listenfeld einer Entität |
| Array von Objekten | [{"id":1},{"id":2}] |
Datensatzlisten, paginierte Ergebnisse |
| Objekt enthält Objekt | {"db": {"host": "..."}} |
Gruppierte Konfiguration, Adressblöcke |
| Array von Arrays | [[1,2],[3,4]] |
Matrizen, Tabellenzeilen |
Eine typische API-Antwort nutzt ein Objekt als Hülle und ein Array als Inhalt:
{
"code": 0,
"data": {
"items": [
{ "id": 1, "title": "first" },
{ "id": 2, "title": "second" }
],
"page": 1,
"total": 2
}
}
Verschachteln Sie nicht um des Verschachtelns willen. Jenseits von drei bis vier Ebenen werden Zugriffspfade unlesbar, und der Consumer-Code schwillt parallel an. Felder, die immer zusammen reisen, gehören in ein Unterobjekt: Ersetzen Sie addrCity und addrZip durch address: {city, zip}.
Fünftens: Objekt oder Array, eine Entscheidungstabelle
| Frage | Antwort | Warum |
|---|---|---|
| Hat jeder Wert einen Namen? | Objekt | Zugriff per Schlüssel; Felder hinzufügen oder entfernen bricht nichts |
| Ist es eine Liste ähnlicher Datensätze? | Array | Reihenfolge zählt; map und filter sind möglich |
| Schneller Schlüsselzugriff nötig? | Objekt, nach ID indiziert | O(1)-Zugriff statt Durchlauf |
| Mehrere Attribute einer Entität? | Objekt | Attribute haben keine inhärente Reihenfolge |
| Wachsende Sammlung ähnlicher Elemente? | Array | Die Länge dehnt sich frei |
Ein Anti-Pattern verdient eigene Erwähnung: ein Array mit einem Objekt zu imitieren, dessen Schlüssel "0", "1", "2" sind. Es parst ohne Fehler, aber Sie verlieren die Längensemantik und die Iterationswerkzeuge eines echten Arrays, und Consumer müssen Object.keys sortieren, bevor sie irgendetwas lesen. Wenn die Schlüssel fortlaufende Nummern sind, schreiben Sie ein echtes Array. Umgekehrt gilt: Eine Liste von Schlüssel-Wert-Paaren wie [{"key":"theme","value":"dark"}] ist schlechter als das Objekt {"theme": "dark"} — außer die Schlüssel sind wirklich dynamisch und lassen sich nicht vorab deklarieren.
Sechstens: drei häufige Fehler und ihre Meldungen
| Fehlerhafte Form | Typischer Fehler | Korrektur |
|---|---|---|
Abschließendes Komma {"a":1,} |
Unexpected token } |
Letztes Komma entfernen |
Einfache Anführungszeichen / nackte Schlüssel {name:'Ada'} |
Unexpected token ' / Expected property name |
Doppelte Anführungszeichen für Schlüssel und Strings, immer |
Python-Literale True / None |
Unexpected token T |
Ersetzen durch true / null |
| Schein-Array mit numerischen Schlüsseln | Kein Fehler, falsche Semantik | Als echtes Array umschreiben |
Zwei Debug-Gewohnheiten: Parser melden die Position meist nach dem fehlerhaften Zeichen — wenn Sie also position 42 sehen, schauen Sie ein bis zwei Zeichen zurück; und einen riesigen Einzeiler-JSON zuerst formatieren — Zeilen- und Spaltennummern schlagen Zeichenoffsets jedes Mal. Der komplette Fehlerkatalog steht in der JSON-Fehler-Lookup-Tabelle, der Schritt-für-Schritt-Triage-Ablauf in JSON-Parse-Fehler beheben.
Siebtens: nach dem Schreiben die Struktur prüfen
Handgeschriebenes JSON sollte vor der Übergabe immer durch einen Parser laufen. Die leichteste Prüfung ist ein Einzeiler:
python3 -m json.tool config.json > /dev/null && echo OK
jq empty config.json && echo OK
Online fügen Sie den Inhalt auf der Seite JSON-Formatierer und -Validator ein — Syntaxfehler kommen mit Zeile und Spalte zurück. Wechseln Sie in die Baumansicht, um den Typ jeder Ebene auf einen Blick zu sehen: ob eine Zahl als String interpretiert wurde, ob die Array-Längen stimmen. Und wenn das Publikum nicht technisch ist, lässt sich ein Array-of-Objects-Payload auf der Seite JSON zu Tabelle in Zeilen und Spalten entfalten — das prüft nebenbei, ob Ihre Daten wirklich eine reguläre Datensatzliste sind.
Fragen zum Feld, das ein Array hätte sein sollen, oder zur Umgestaltung einer zu tiefen Verschachtelung gehören zur Typmodellierung — die nächste Lektüre ist sechs Typen, Zahlenpräzision und Encoding-Fallstricke.
Kann man JSON-Arrays und -Objekte ineinander umwandeln?
Ja, aber nicht verlustfrei. Ein Objekt in ein Array umzuwandeln bedeutet meist, Schlüssel in Werte zu verwandeln und den Schlüsselzugriff zu verlieren; ein Array in ein Objekt umzuwandeln erfordert, für jedes Element einen Schlüssel zu erfinden, und die Herkunft dieser Schlüssel ist ein neues Designproblem. Entscheiden Sie danach, wie der Consumer die Daten liest, nicht nach syntaktischer Bequemlichkeit.
Dürfen Objektschlüssel doppelt vorkommen?
Syntaxtechnisch ja — RFC 8259 sagt nur, dass Schlüssel eindeutig SEIN SOLLTEN. Aber JavaScript behält den letzten Wert, während manche Bibliotheken der C-Familie den ersten behalten: Das Verhalten unterscheidet sich zwischen Parsern. In Signaturen, Diffs oder Hashes führen doppelte Schlüssel zu direkten Diskrepanzen. Vermeiden Sie sie auf der Produzentenseite und behandeln Sie Duplikate aus unbekannten Quellen als Risiko auf der Consumer-Seite.
Kann ein Array Werte unterschiedlicher Typen enthalten?
Syntaxtechnisch ja: [1, "a", true] ist gültiges JSON. Aber heterogene Arrays erzwingen Typprüfungen an jeder Position im Consumer-Code, und sie lassen sich schwer in einem Schema ausdrücken. Außer bei Matrizen und Tupeln, wo die Position die Semantik ist, halten Sie Arrays homogen.
Warum scheitert {name:'json'} an der Validierung?
Weil JSON doppelte Anführungszeichen um jeden Schlüssel und jeden String-Wert verlangt. {name:'json'} ist ein JavaScript-Objektliteral, kein JSON. Ersetzen Sie es durch {"name": "json"}, und die Validierung geht durch. Einfache Anführungszeichen, nackte Schlüssel und Kommentare gehören zu Dialekten wie JSON5/JSONC, die eigene Parser statt des Standard-JSON.parse erfordern.