mitmario.dev

Synthese: die Liste aus dem Netz

JavaScript Im Browser 3 Min Lesezeit 3 BeispieleLektion 6 von 7

Den Katalog vom Server laden, die Kurse für den Einstieg heraussuchen, sortieren und zeigen, und dabei jeden der vier Zustände bedienen. Das soll die Seite können. JSON, fetch, die Fehlerbehandlung und die Ladezustände aus diesem Abschnitt kommen dafür an einer Stelle zusammen.

Die Reihenfolge

Jede ladende Ansicht folgt demselben Ablauf. Zustand auf „lädt“, laden, prüfen, ob die Antwort brauchbar ist, umformen, zeichnen, Zustand zurücksetzen. Ein catch außen herum bedient den vierten Zustand.

An dieser Reihenfolge ändert sich nie etwas, egal was geladen wird. Anders ist jedes Mal nur die Umformung in der Mitte.

Drei Schichten statt einer Funktion

Drei Schichten nebeneinander
const statusFeld = document.getElementById("status");
const liste = document.getElementById("liste");

// Schicht 1: holen. Weiß nichts von der Seite.
async function holen(adresse) {
  const antwort = await fetch(adresse);
  if (!antwort.ok) {
    throw new Error(`Server meldet ${antwort.status}`);
  }
  return await antwort.json();
}

// Schicht 2: umformen. Weiß nichts vom Netz und nichts von
// der Seite. Eine gewöhnliche Funktion über einer Liste.
function fuerDenEinstieg(kurse) {
  return kurse
    .filter((kurs) => kurs.stufe === "einstieg")
    .sort((a, b) => a.stunden - b.stunden);
}

// Schicht 3: zeichnen. Weiß nichts vom Netz.
function zeichnen(kurse) {
  liste.replaceChildren();
  for (const { titel, stunden } of kurse) {
    const eintrag = document.createElement("li");
    eintrag.textContent = `${titel} (${stunden} h)`;
    liste.append(eintrag);
  }
}

async function anzeigen() {
  statusFeld.textContent = "Lädt ...";
  try {
    const roh = await holen("/lernen/api/katalog.json");
    const kurse = fuerDenEinstieg(roh);
    zeichnen(kurse);
    statusFeld.textContent = kurse.length === 0 ? "Keine Einträge" : "";
  } catch (fehler) {
    zeichnen([]);
    statusFeld.textContent = "Konnte nicht geladen werden.";
  }
}

document.getElementById("los").addEventListener("click", anzeigen);

Alles ließe sich in eine einzige async-Funktion schreiben, und die Versuchung ist groß, denn das liest sich so schön von oben nach unten. Trotzdem stehen im ersten Beispiel drei Funktionen nebeneinander, und jede weiß so wenig wie möglich.

  • holen kennt Adressen und Antworten und weiß nicht, was mit den Daten passiert.
  • fuerDenEinstieg kennt nur Listen. Vom Netz und von der Seite weiß sie nichts, und in ein anderes Projekt ließe sie sich einfach kopieren.
  • zeichnen kennt nur die Seite und weiß nicht, woher die Daten kommen.

anzeigen verbindet die drei und führt den Zustand.

Warum die Umformung eine eigene Funktion ist

Die Umformung allein prüfen
function fuerDenEinstieg(kurse) {
  return kurse
    .filter((kurs) => kurs.stufe === "einstieg")
    .sort((a, b) => a.stunden - b.stunden);
}

// Ein fester Datensatz reicht. Er muss nicht echt sein, er
// muss nur die Fälle enthalten, die dich interessieren.
const probe = [
  { titel: "Node", stufe: "aufbau", stunden: 21 },
  { titel: "CSS", stufe: "einstieg", stunden: 34 },
  { titel: "HTML", stufe: "einstieg", stunden: 13 },
];

console.log("Ergebnis:", JSON.stringify(fuerDenEinstieg(probe)));
console.log("Anzahl:", fuerDenEinstieg(probe).length);

// Und die Randfälle, die man sonst nie zu Gesicht bekommt.
console.log("Leere Liste:", JSON.stringify(fuerDenEinstieg([])));
console.log("Nichts für den Einstieg:", JSON.stringify(fuerDenEinstieg([{ titel: "Web Security", stufe: "profi", stunden: 18 }])));

Was die Aufteilung eigentlich bringt, merkst du, sobald etwas nicht stimmt. Eine Umformung, die nichts vom Netz weiß, kannst du mit einem festen Datensatz aufrufen, sofort und ohne Server, so oft du willst, und in derselben Sekunde weißt du, ob sie das Richtige tut.

fuerDenEinstieg steht im zweiten Beispiel bereit, und du kannst sie in der Eingabezeile der Console direkt aufrufen, mit Daten, die du dir gerade ausdenkst. fuerDenEinstieg([]) antwortet mit (0) []. Bei einer Liste mit einem Eintrag siehst du, was übrigbleibt, ohne Klick, ohne Laden und ohne Warten.

Im Reiter „Netzwerk“ steht dabei keine einzige Anfrage. Beim ersten Beispiel brauchte es einen Klick auf den Button, ein wenig Warten und danach eine Zeile für katalog.json in der Liste. Hier ist gar kein Netz beteiligt.

Steckt dieselbe Logik mitten in der Ladefunktion, geht das nicht mehr. Dann heißt jede Änderung laden, klicken, warten und aus dem Ergebnis auf der Seite rückwärts erschließen, was die Umformung getan hat.

Mit einem festen Datensatz kommst du außerdem an die Randfälle heran, an die leere Liste und an die Liste, in der nichts übrigbleibt. Der echte Server liefert beide nie. Passieren werden sie später trotzdem.

Alte Bekannte

Die Umformung selbst ist nichts Neues, filter, sort und oft noch map aus Abschnitt 6, dazwischen ein Vergleich. Das Zeichnen kennst du aus Abschnitt 11. Liste leeren, für jeden Eintrag ein Element bauen, einhängen. Neu ist nur, dass die Daten von außen kommen und deshalb ein Zustand dazugehört.

Wenn die Antwort anders aussieht als erwartet

Wenn die Antwort anders aussieht
function zaehlen(rumpf) {
  // Erst prüfen, dann arbeiten.
  if (!Array.isArray(rumpf)) {
    console.warn("Keine Liste, sondern:", typeof rumpf);
    return 0;
  }
  return rumpf.length;
}

console.log("Liste:", zaehlen([1, 2, 3]));
console.log("Objekt:", zaehlen({ kurse: [1, 2, 3] }));
console.log("null:", zaehlen(null));

// Ohne die Prüfung sähe das so aus.
try {
  console.log("Ohne Prüfung:", null.length);
} catch (fehler) {
  console.error("Ohne Prüfung:", fehler.message);
}

Die Daten kommen von einem Server, den vielleicht jemand anderes betreut, und der ändert sich, ohne zu fragen. Was gestern eine Liste war, ist heute ein Objekt mit der Liste darin. Was gestern immer eine Zahl war, ist heute manchmal null. Beides kommt vor.

„Dann stürzt es halt ab“ ist darauf keine Antwort, denn abstürzen tut die Seite von jemandem, der nichts dafür kann.

Der Aufwand dagegen ist klein. Eine Prüfung mit Array.isArray, bevor über etwas gelaufen wird, ein ?. beim Zugriff auf eine Ebene, die es geben sollte, und ein ?? mit einem sinnvollen Ersatzwert. Alle drei kennst du schon.

Im dritten Beispiel stehen beide Fassungen nebeneinander. Die geprüfte meldet eine Null, und die ungeprüfte wirft einen TypeError.

In der Aufgabe kommt alles an einem Stück zusammen, eine Umformung, die ohne Netz geprüft wird, und eine Ansicht, die alle Zustände bedient.

Zum Mitnehmen

Laden, umformen und zeichnen sind drei Funktionen, und nur die äußere führt den Zustand. Die Umformung lässt sich so ohne Netz mit festen Daten prüfen, auch an den Rändern.

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 3 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe im Editor, direkt im Browser geprüft

    Öffnet sich mit dem Basis Konto.