Abschnitt 16 · Lektion 1
JSON
Zwei Programme müssen sich Daten schicken. Eines läuft im Browser, das andere auf einem Server, vielleicht in einer ganz anderen Sprache, und über die Leitung geht dabei nur Text. JSON ist die Vereinbarung, wie dieser Text aussieht. Der Name steht für JavaScript Object Notation, und die Schreibweise ist tatsächlich von JavaScript-Objekten abgeschaut. Benutzt wird sie inzwischen überall, von Python bis Java.
Zwei Funktionen, mehr ist es nicht
<p>Ein Text wird zum Objekt und wieder zum Text.</p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
} // Das hier ist ein Text. Nichts weiter.
const text = '{"titel":"JavaScript","stunden":47,"imBrowser":true}';
console.log("Typ vorher:", typeof text);
console.log("Länge des Textes:", text.length);
// parse macht daraus ein echtes Objekt.
const kurs = JSON.parse(text);
console.log("Typ danach:", typeof kurs);
console.log("Titel:", kurs.titel);
console.log("Stunden mal zwei:", kurs.stunden * 2);
// Und stringify macht daraus wieder Text.
console.log("Zurück:", JSON.stringify(kurs));
// Mit dem dritten Argument wird es lesbar. Das ist die Einrückung.
console.log(JSON.stringify(kurs, null, 2)); JSON.parse nimmt Text und gibt ein Objekt zurück. JSON.stringify nimmt ein Objekt und gibt Text zurück.
Im ersten Beispiel stehen beide Richtungen. Bei typeof steht vorher string und danach object. text.length gibt es, weil ein Text eine Länge hat, und rechnen kannst du mit kurs.stunden erst nach JSON.parse.
Das dritte Argument von stringify ist die Einrückung. JSON.stringify(kurs, null, 2) bricht die Ausgabe um und rückt sie zwei Leerzeichen ein, und beim Fehlersuchen ist das der Unterschied zwischen lesbar und unlesbar.
Die Regeln sind strenger, als sie aussehen
Ein JSON-Text sieht aus wie ein Stück JavaScript, ist aber deutlich enger gefasst.
- Schlüssel stehen immer in doppelten Anführungszeichen.
{"a": 1}ist gültig,{a: 1}nicht. - Texte stehen ebenfalls in doppelten Anführungszeichen, einfache gibt es in JSON nicht.
- Nach dem letzten Eintrag steht kein Komma. In JavaScript darf eines stehen bleiben, in JSON nicht.
- Kommentare gibt es nicht, weder mit
//noch mit den Sternchen. undefinedgibt es nicht,nullschon.- Erlaubt sind genau sechs Sorten von Werten, Text, Zahl, Wahrheitswert,
null, Array und Objekt.
In der Eingabezeile der Console kannst du die Liste durchprobieren, und die Antwort kommt sofort.
JSON.parse('{a: 1}') beschwert sich mit Expected property name or '}' in JSON at position 1 (line 1 column 2) (in Firefox JSON.parse: expected property name or '}' at line 1 column 2 of the JSON data). Gemeint ist der Schlüssel ohne Anführungszeichen.
Bei JSON.parse('{"a": 1,}') kommt Expected double-quoted property name in JSON at position 8 (line 1 column 9) (in Firefox JSON.parse: expected double-quoted property name at line 1 column 9 of the JSON data). Nach dem Komma wurde ein weiterer Schlüssel erwartet, und stattdessen kam die schließende Klammer.
Bei JSON.parse('') kommt Unexpected end of JSON input (in Firefox JSON.parse: unexpected end of data at line 1 column 1 of the JSON data). Ein leerer Text ist kein gültiges JSON. So sieht es später aus, wenn ein Server nichts zurückgibt.
Wenn du die Regeln von oben einmal durchgehst und für jede den passenden Fehler suchst, bist du in zwei Minuten fertig und musst nichts auswendig lernen.
parse wirft bei kaputtem Text
<p>Drei Texte, zwei davon sind kein gültiges JSON.</p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
} const proben = [
'{"a":1}',
"{a:1}",
'{"a":1,}',
];
for (const probe of proben) {
try {
const wert = JSON.parse(probe);
console.log("Gelesen:", JSON.stringify(wert));
} catch (fehler) {
console.warn("Kaputt:", probe, "->", fehler.message);
}
}
// Ohne try/catch bricht die ganze Datei ab. Alles darunter läuft nicht mehr.
try {
JSON.parse("");
} catch (fehler) {
console.error("Auch ein leerer Text ist kein JSON:", fehler.message);
} Die Regeln sind so eng, dass um JSON.parse wirklich ein try/catch gehört. Eines um alles hilft nicht weiter, das kam schon in Lektion 14.2. Aber eines um eine Stelle, die nachweislich wirft, ist Handwerk.
Und JSON.parse wirft nachweislich, bei einem Schlüssel ohne Anführungszeichen, bei einem Komma zu viel und bei einem leeren Text. Im zweiten Beispiel stehen alle drei Meldungen.
Darauf stellt man sich ein, weil der Text meistens von woanders kommt, aus dem Netz, aus dem Browserspeicher oder aus einer Datei. Geschrieben hat ihn jemand anders. Ob er in Ordnung ist, weiß vorher niemand.
Was auf dem Weg verlorengeht
<p>Fünf Eigenschaften rein, drei kommen zurück.</p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
} const eintrag = {
titel: "JavaScript",
stunden: 47,
leer: undefined,
zeigen: function () {
return "hallo";
},
angelegt: new Date("2026-01-15T10:00:00Z"),
};
const text = JSON.stringify(eintrag);
console.log("Als Text:", text);
const zurueck = JSON.parse(text);
console.log("Schlüssel vorher:", Object.keys(eintrag));
console.log("Schlüssel danach:", Object.keys(zurueck));
// Das Datum ist da, aber es ist kein Datum mehr.
console.log("Typ von angelegt:", typeof zurueck.angelegt);
console.log("Wert:", zurueck.angelegt); Hier wird es unangenehm, denn stringify beschwert sich nicht. Es lässt einfach weg, was es nicht darstellen kann.
- Eigenschaften mit dem Wert
undefinedverschwinden, nicht alsnull, sondern ganz. - Funktionen verschwinden ebenfalls. Ein Objekt mit Methoden verliert auf dem Weg durch JSON sein Verhalten und behält nur seine Daten.
- Ein
Datewird zu Text. Es verschwindet also nicht, kommt aber als Text zurück und nicht als Datum, und wer danach.getFullYear()aufruft, bekommt einenTypeError. Wird das Datum wieder als Datum gebraucht, muss es beim Lesen von Hand zurückverwandelt werden.
Im dritten Beispiel gehen fünf Eigenschaften hinein, und drei kommen zurück. Die beiden Object.keys-Ausgaben stehen untereinander.
JSON kann Daten und kein Verhalten, und was nicht in einer Textdatei stehen kann, überlebt den Weg nicht. Dafür ist das Format gemacht, denn ein Programm in einer anderen Sprache könnte mit einer JavaScript-Funktion sowieso nichts anfangen.
In der Aufgabe schreibst du drei kleine Funktionen rund um JSON, und eine davon fängt kaputten Text ab.
Zum Mitnehmen
JSON ist Text mit engen Regeln. JSON.parse wirft bei kaputtem Text, JSON.stringify lässt Funktionen und undefined still weg und macht aus einem Datum einen Text.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe im Editor, direkt im Browser geprüft
Öffnet sich mit dem Basis Konto.