mitmario.dev

Verschachtelte Daten

JavaScript Im Browser 3 Min Lesezeit 4 BeispieleLektion 4 von 9

Echte Daten sind selten flach. Eine Teilnehmerin hat eine Adresse, die Adresse hat einen Ort, und in der Liste ihrer Kurse stecken wieder Objekte. Lesen kannst du das mit aneinandergehängten Zugriffen. Schwierig wird es erst, wenn eine Ebene fehlt.

Die Kette

Objekte in Objekten, Listen in Objekten
const teilnehmerin = {
  name: "Ida",
  adresse: {
    ort: "Leipzig",
    plz: "04103",
  },
  kurse: ["HTML", "CSS", "JavaScript"],
  fortschritt: [
    { kurs: "HTML", prozent: 100 },
    { kurs: "CSS", prozent: 60 },
  ],
};

// Ein Objekt im Objekt: zwei Punkte.
console.log(teilnehmerin.adresse.ort);

// Eine Liste im Objekt: Punkt, dann eckige Klammern.
console.log(teilnehmerin.kurse[0]);

// Objekte in einer Liste in einem Objekt: alles zusammen.
console.log(teilnehmerin.fortschritt[1].prozent);

// Die Kette wird von links nach rechts gelesen. Jeder Schritt
// liefert etwas, auf dem der nächste arbeitet.
console.log(teilnehmerin.fortschritt.length);

Ein Wert in einem Objekt darf selbst ein Objekt sein, eine Liste oder eine Liste aus Objekten. Zum Lesen hängst du die bekannten Zugriffe einfach aneinander. Der Punkt steht für einen Schlüssel, eckige Klammern für eine Position.

Gelesen wird von links nach rechts, und jeder Schritt arbeitet mit dem Ergebnis des vorigen weiter. teilnehmerin.fortschritt[1].prozent holt erst das Objekt, daraus die Liste, daraus den zweiten Eintrag und daraus die Zahl.

Das klingt banal. Die ganze Fehlersuche im Rest der Lektion hängt aber daran. Bricht so eine Kette ab, baue ich sie in der Eingabezeile der Console Stück für Stück nach, bis zum ersten Mal undefined dasteht.

Der Abbruch

Wenn eine Ebene in der Mitte fehlt
const ohneAdresse = { name: "Ben" };

// Die erste Ebene ist harmlos: es gibt keine adresse,
// also kommt undefined heraus. Kein Fehler.
console.log("adresse:", ohneAdresse.adresse);

// Die zweite Ebene bricht ab. Man liest hier eine Eigenschaft
// von undefined, und das geht nicht.
// Diese Zeile steht deshalb ganz unten: nach ihr läuft nichts mehr.
console.log("ort:", ohneAdresse.adresse.ort);
console.log("Diese Zeile wird nie erreicht");

Fragst du nach einer Eigenschaft, die es nicht gibt, bekommst du weiterhin undefined. Nur ist undefined selbst kein Objekt, und deshalb bricht der nächste Schritt ab.

Die Meldung dazu wirst du oft sehen. TypeError: Cannot read properties of undefined. Sie nennt sogar die Eigenschaft, nach der gesucht wurde, hier mit dem Zusatz (reading 'ort'). Firefox schreibt dieselbe Sache als can't access property "ort", ohneAdresse.adresse is undefined und sagt damit ausdrücklich, welcher Teil der Kette gefehlt hat.

Die Meldung nennt ort, aber ort ist nicht das Problem. Gefehlt hat adresse, also der Schritt davor.

Wie jeder Fehler beendet auch dieser das Skript an dieser Stelle. Deshalb steht die Zeile im Beispiel ganz unten. Und deshalb verwirrt der Fehler gleich doppelt, denn es geht nicht nur eine Ausgabe verloren, sondern alles, was danach noch gekommen wäre.

Sauber abbrechen mit ?.

Die optionale Verkettung
// Zwei Bestellungen, nur eine wird geliefert.
const mit = { nummer: 1041, lieferung: { stadt: "Halle" } };
const ohne = { nummer: 1042 };

// Mit ?. bricht die Kette sauber ab, statt einen Fehler zu werfen.
console.log("Mit Lieferung:", mit.lieferung?.stadt);
console.log("Ohne Lieferung:", ohne.lieferung?.stadt);

// Auch vor eckigen Klammern und vor einem Aufruf, dort mit Punkt.
const korb = { artikel: ["Kaffee", "Tee"] };
const leer = {};
console.log("Erster Artikel:", korb.artikel?.[0]);
console.log("Kein Artikel:", leer.artikel?.[0]);

// Und die Zeile, die es ohne ?. gar nicht bis hierhin geschafft
// hätte. Sie läuft jetzt einfach durch.
console.log("Fertig");

// Eine Ebene zu früh gesetzt hilft es dagegen nicht: ohne gibt
// es, lieferung nicht, und deshalb bricht diese Zeile ab.
// Sie steht darum ganz unten.
console.log("Zu früh gesetzt:", ohne?.lieferung.stadt);

Die optionale Verkettung ?. prüft, was links davon steht. Ist das null oder undefined, hört die Kette dort auf, und der ganze Ausdruck ergibt undefined. Sonst geht es normal weiter.

Sie steht vor dem Schritt, der schiefgehen kann. ohne.lieferung?.stadt heißt „wenn es eine Lieferung gibt, hol die Stadt“. Vor eckigen Klammern und vor einem Aufruf schreibt man sie mit Punkt, also liste?.[0] und funktion?.().

In der letzten Zeile des Beispiels steht sie eine Ebene zu weit vorn. ohne?.lieferung.stadt fragt nach ohne, und das gibt es. Fehlen darf aber lieferung, also bricht die Zeile trotzdem ab. Das Fragezeichen gehört hinter das, was fehlen darf.

Überall hinschreiben hilft auch nicht. Eine Kette mit ?. an jeder Stelle wirft nie wieder einen TypeError, aber dann sagt dir das ?. beim Lesen auch nichts mehr darüber, was fehlen darf und was nicht. Ein echter Fehler in den Daten fällt dann nicht mehr auf. Er wird nur leiser. Ich setze ?. deshalb nur dort, wo das Fehlen vorgesehen ist. Überall sonst soll es krachen, denn dann stimmt etwas nicht.

Ein Ersatzwert mit ??

Ersatzwert mit ??
const ohne = { nummer: 1042 };

// ?. liefert undefined, ?? macht daraus einen brauchbaren Wert.
console.log(ohne.lieferung?.stadt ?? "Abholung im Laden");

// Der Unterschied zum Oder aus Lektion 3.4: ?? greift nur bei
// null und undefined, || bei allem Falschen.
const einstellungen = { anzahl: 0, titel: "" };

console.log("Mit ??:", einstellungen.anzahl ?? 10);
console.log("Mit ||:", einstellungen.anzahl || 10);

console.log("Mit ??:", einstellungen.titel ?? "Ohne Titel");
console.log("Mit ||:", einstellungen.titel || "Ohne Titel");

// Deshalb ist ?? fast immer das, was du meinst, sobald 0 oder
// der leere Text gültige Werte sind.

?. liefert im Fehlfall undefined, und damit will man selten weiterarbeiten. Dazu passt ??. Es nimmt den linken Wert, außer der ist null oder undefined, dann nimmt es den rechten. ohne.lieferung?.stadt ?? "Abholung im Laden" bricht erst sauber ab und setzt dann etwas Brauchbares ein. Dasselbe Paar kommt in Abschnitt 10 an einem Element wieder.

|| greift bei allem, was falsy ist, und dazu gehören auch 0 und der leere Text. Eine Anzahl von 0 würde damit durch den Ersatzwert ersetzt, obwohl 0 eine gültige Antwort ist. ?? greift nur bei den beiden Sorten von „nichts“ und lässt 0 und "" in Ruhe.

In der Aufgabe lesen drei Funktionen aus derselben verschachtelten Liste. Zwei davon müssen mit einer Lücke rechnen.

Zum Mitnehmen

Cannot read properties of undefined nennt die Eigenschaft, die du lesen wolltest. Gefehlt hat das, was in der Kette links davor steht.

Jetzt du

Basis Konto, kostenlos

Zu 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 4 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe im Editor, direkt im Browser geprüft

    Öffnet sich mit dem Basis Konto.