Abschnitt 10 · Lektion 6
Synthese: die Seite auslesen
Auf der Seite stehen Karten, und du willst die Summe ihrer Stunden wissen und welche Kurse im Browser laufen. Die Daten dafür stehen schon im Markup, in data-Attributen und Überschriften. Am Ende dieses Abschnitts hast du also wieder ein Array aus Objekten, wie am Ende von Abschnitt 7. Nur kommen die Daten diesmal von der Seite.
Zwei Schritte statt einem
<article class="kurs" data-id="html" data-kurs-stunden="13"><h2>HTML</h2></article>
<article class="kurs" data-id="git" data-kurs-stunden="9"><h2>Git</h2></article> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
h2 {
font-size: 1.2rem;
margin: 1.25rem 0 0.5rem;
} // Suchen, Umwandeln und Rechnen in einer Schleife.
let summe = 0;
for (const el of document.querySelectorAll(".kurs")) {
summe = summe + Number(el.dataset.kursStunden);
}
console.log("vermischt:", summe);
// Erst eine Datenstruktur, dann die Rechnung.
const kurse = Array.from(document.querySelectorAll(".kurs")).map((el) => ({
id: el.dataset.id,
stunden: Number(el.dataset.kursStunden),
}));
console.log("Daten:", kurse);
const gesamt = kurse.reduce((s, kurs) => s + kurs.stunden, 0);
console.log("gerechnet:", gesamt);
// Der zweite Weg ist länger und hat zwei Vorteile: man sieht
// die Daten in der Console, und die Rechnung kommt ohne DOM aus. Naheliegend ist, alles in einem Rutsch zu machen. Suchen, umwandeln, rechnen. Das geht und ist kürzer, hat aber zwei Nachteile, die man erst später merkt.
Erstens siehst du die Daten nie. Stimmt das Ergebnis nicht, hast du eine Zahl und keinen Hinweis, an welcher Stelle es schiefging. Mit einem Zwischenschritt steht die ganze Struktur in der Console, Eintrag für Eintrag zum Aufklappen, und ein falsches data-Attribut fällt sofort auf.
Zweitens hängt die Rechnung am DOM. Solange document mitten in der Summe steht, kannst du sie nicht ohne Seite ausprobieren, nicht wiederverwenden und nicht einzeln prüfen.
Ich mache deshalb erst Daten und rechne dann. Das ist dieselbe Grenze zwischen „schmutzig“ und „belastbar“ wie beim Aufräumen von Eingaben in Abschnitt 8. Nur kommt die Unordnung hier aus dem Markup statt aus einer Eingabe.
Eine Funktion je Element
<article class="kurs" data-id="html" data-kurs-stunden="13" data-im-browser="true"><h2>HTML</h2></article>
<article class="kurs" data-id="git" data-kurs-stunden="9" data-im-browser="false"><h2>Git</h2></article> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
h2 {
font-size: 1.2rem;
margin: 1.25rem 0 0.5rem;
} // Eine Funktion, die aus einem Element einen Datensatz macht.
// Alle Umwandlungen stehen hier und sonst nirgends.
function alsKurs(el) {
return {
id: el.dataset.id,
titel: el.querySelector("h2").textContent,
stunden: Number(el.dataset.kursStunden),
imBrowser: el.dataset.imBrowser === "true",
};
}
const kurse = Array.from(document.querySelectorAll(".kurs")).map(alsKurs);
console.log(kurse);
// Ab hier ist alles Abschnitt 6 und 7, ohne ein einziges
// document.
console.log("Titel:", kurse.map((k) => k.titel));
console.log("im Browser:", kurse.filter((k) => k.imBrowser).map((k) => k.id));
console.log("Summe:", kurse.reduce((s, k) => s + k.stunden, 0)); Sauber wird es mit einer kleinen Funktion, die aus einem Element einen Datensatz macht, und einem Array.from(...).map(...) darüber.
In dieser Funktion stehen alle Umwandlungen an einer Stelle. Das Number(...) für die Stunden, das === "true" für den Wahrheitswert und das querySelector("h2").textContent für den Titel. Willst du später wissen, wie eine Eigenschaft entsteht, musst du nur an dieser einen Stelle nachsehen.
map nimmt eine Funktion entgegen, also kannst du sie direkt übergeben, map(alsKurs) statt map((el) => alsKurs(el)). Das kam in Lektion 5.7, und mit einem Namen wie alsKurs liest sich die Zeile wie ein Satz. Ab dieser Zeile kommt kein document mehr vor, und alles Weitere ist Abschnitt 6 und 7.
Die Funktion kannst du auch einzeln ausprobieren. alsKurs(document.querySelector(".kurs")) antwortet in der Eingabezeile der Console mit {id: "html", titel: "HTML", stunden: 13, imBrowser: true}. Ein Element hinein, ein Datensatz heraus, ohne den Rest des Programms. kurse allein zeigt die ganze Liste zum Aufklappen.
Der Gewinn zeigt sich beim Umbau
<ul class="liste">
<li data-id="html" data-kurs-stunden="13">HTML</li>
<li data-id="git" data-kurs-stunden="9">Git</li>
</ul> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
} // Dieselben Daten wie vorher in ganz anderem Markup, eine
// Liste statt Artikeln, der Titel direkt im Element.
function alsKurs(el) {
return {
id: el.dataset.id,
titel: el.textContent,
stunden: Number(el.dataset.kursStunden),
};
}
const kurse = Array.from(document.querySelectorAll(".liste li")).map(alsKurs);
console.log(kurse);
// Und die Auswertung darunter ist Wort für Wort dieselbe wie
// im Beispiel davor. Nur die eine Funktion oben hat sich
// geändert.
console.log("Titel:", kurse.map((k) => k.titel));
console.log("Summe:", kurse.reduce((s, k) => s + k.stunden, 0)); Im dritten Beispiel stehen dieselben Daten in ganz anderem Markup. Eine Liste statt Artikeln, und der Titel steht direkt im Element statt in einer Überschrift.
Die Auswertung darunter ist Wort für Wort dieselbe. Geändert hat sich nur die eine Funktion oben. Stünde document über die ganze Rechnung verteilt, müsstest du jede Zeile anfassen. Markup ändert sich oft, zum Beispiel wenn jemand das Aussehen anpasst, und dabei soll die Auswertung nicht kaputtgehen.
Diese Richtung, von der Seite zu den Daten, gibt es überhaupt nur, weil Daten manchmal schon auf der Seite stehen. Baut ein Server die Seite und schreibt die Daten gleich mit hinein, ist das der Normalfall, und dann liest man sie meistens besser von dort, statt sie ein zweites Mal aus dem Netz zu holen.
Wenn kein Element passt
<h1>Eine Seite ganz ohne Kurse</h1> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
h1 {
font-size: 1.5rem;
margin: 0 0 0.75rem;
} function alsKurs(el) {
return { id: el.dataset.id, stunden: Number(el.dataset.kursStunden) };
}
const kurse = Array.from(document.querySelectorAll(".kurs")).map(alsKurs);
console.log("Anzahl:", kurse.length);
// Alles Weitere läuft durch, weil eine leere NodeList harmlos ist.
console.log("Kennungen:", kurse.map((k) => k.id));
console.log("Summe mit Startwert:", kurse.reduce((s, k) => s + k.stunden, 0));
// Nur reduce ohne Startwert bricht ab. Diese Zeile steht
// deshalb ganz unten.
console.log("ohne Startwert:", kurse.reduce((s, k) => s + k.stunden));
console.log("Diese Zeile wird nie erreicht"); querySelectorAll liefert eine leere NodeList und nicht null, also läuft die ganze Kette auch dann durch, wenn kein einziges Element passt. Array.from liefert ein leeres Array, map ebenfalls und filter auch.
Abbrechen kann dann nur ein reduce ohne Startwert, mit TypeError: Reduce of empty array with no initial value. Das ist die Warnung aus Lektion 6.7, und hier trifft sie öfter. Eine Seite ohne Einträge ist nämlich ein ganz normaler Zustand, zum Beispiel nach dem Filtern. Ein Startwert kostet nichts und erspart dir diesen Fall.
In der Aufgabe machen drei Funktionen aus vier Karten Daten. Zwei davon rechnen nur noch mit dem, was die erste liefert.
Zum Mitnehmen
Aus dem DOM werden zuerst Daten, und gerechnet wird danach. Dann lässt sich die Rechnung ohne Seite prüfen, und das Markup darf sich ändern, ohne dass die Auswertung bricht.
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 4 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe im Editor, direkt im Browser geprüft
Öffnet sich mit dem Basis Konto.