Abschnitt 10 · Lektion 4
Wenn nichts gefunden wird
Die Seite tut nichts mehr, und in der Console steht „Cannot read properties of null“, in Firefox „can’t access property …, … is null“. Wenn du mit dem DOM anfängst, ist das die Meldung, die dir am ehesten begegnet. Es gibt nur wenige Ursachen dafür, und genauso wenige Arten, damit umzugehen.
Woher der Fehler kommt
<h1 id="titel">Meine Seite</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;
} // Ein Treffer, alles normal.
console.log("gefunden:", document.querySelector("#titel").textContent);
// Kein Treffer ergibt null. Kein Fehler, noch nicht.
console.log("nicht gefunden:", document.querySelector("#gibtesnicht"));
// Der Fehler kommt erst beim nächsten Schritt. Eine
// Eigenschaft von null zu lesen geht nicht.
// Diese Zeile steht deshalb ganz unten.
console.log(document.querySelector("#gibtesnicht").textContent);
console.log("Diese Zeile wird nie erreicht"); querySelector liefert null, wenn nichts passt. Das allein ist noch kein Fehler. Gerade das macht es unangenehm, denn die Zeile mit dem querySelector läuft durch.
Der Fehler kommt eine Zeile später, sobald jemand eine Eigenschaft von null liest. Das ist derselbe TypeError wie in Lektion 7.4. Nur kommt er hier nicht aus fehlenden Daten, sondern aus einem Element, das es nicht gibt.
Wie jeder Fehler beendet er das Skript an dieser Stelle, und alles danach geht mit verloren. Tut eine Seite plötzlich gar nichts mehr, steht in der Console meistens diese Meldung, und mit einem Klick auf die Fundstelle darin landest du in der passenden Zeile im Editor.
Die Ursachen
<h1 class="titel">Meine Seite</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;
} // Ursache 1: Tippfehler oder falscher Selektor. Hier steht
// eine Klasse im Markup, gesucht wird eine id.
console.log("mit Raute:", document.querySelector("#titel"));
console.log("mit Punkt:", document.querySelector(".titel"));
// Ursache 2: Groß- und Kleinschreibung im Selektor.
console.log("groß:", document.querySelector(".Titel"));
// Ursache 3: das Element gibt es erst später. Hier noch nicht.
console.log("noch nicht da:", document.querySelector("#spaeter"));
const neu = document.createElement("div");
neu.id = "spaeter";
document.body.append(neu);
console.log("jetzt da:", document.querySelector("#spaeter").id);
// Die vierte Ursache kannst du hier nicht sehen: ein Skript,
// das vor dem Markup läuft, findet gar nichts. Deshalb defer,
// siehe Lektion 1.2. Es sind immer dieselben. Gehst du sie der Reihe nach durch, findest du sie schneller.
- Der Selektor stimmt nicht. Eine Klasse im Markup, eine
idim Code, ein Punkt statt einer Raute, ein Bindestrich zu viel, und beim Lesen sieht alles richtig aus. - Die Schreibweise stimmt nicht. Selektoren für Klassen und
idunterscheiden Groß- und Kleinschreibung,.Titelfindet.titelnicht. - Der Zeitpunkt stimmt nicht. Das Element gibt es noch nicht, weil es erst durch eine Aktion entsteht. In Abschnitt 11 ist das der Normalfall und kein Problem, solange die Reihenfolge stimmt.
- Das Skript läuft vor dem Markup und findet gar nichts. Das zeigt das Beispiel nicht, und deshalb steht
deferschon in Lektion 1.2. FindetquerySelectorjedes Element auf der Seite nicht, liegt es fast immer daran.
Zwei Behandlungen
<h1 id="titel">Meine Seite</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;
} // Behandlung 1: früh aussteigen. Passt, wenn ohne das
// Element nichts Sinnvolles mehr zu tun ist.
function fuellen(selektor) {
const el = document.querySelector(selektor);
if (!el) return;
console.log("gefüllt:", el.textContent);
}
fuellen("#titel");
fuellen("#gibtesnicht");
console.log("läuft weiter");
// Behandlung 2: optional zugreifen. Passt, wenn du einen
// Ersatzwert hast und weitermachen willst.
const text = document.querySelector("#gibtesnicht")?.textContent ?? "nicht gefunden";
console.log("mit ?.:", text);
// Und wo das Fehlen ein echter Fehler ist, lässt man es
// krachen. Eine stille Seite ohne Wirkung ist schlimmer als
// eine laute Meldung in der Console. Früh aussteigen passt, wenn ohne das Element nichts Sinnvolles mehr zu tun ist. if (!el) return; steht dann als zweite Zeile der Funktion, und der Rest darf sich darauf verlassen, dass es das Element gibt. Das ist dieselbe Grenze wie beim Aufräumen von Eingaben in Abschnitt 8.
Optional zugreifen passt, wenn es einen Ersatzwert gibt und es weitergehen soll. Dafür sind ?. und ?? aus Abschnitt 7 da, hier eben mit einem Element statt mit Daten.
Und manchmal ist gar keine Behandlung die richtige. Fehlt ein Element, das da sein müsste, ist das ein Fehler in der Seite, und den will man nicht abfangen. Eine laute Meldung in der Console ist dann besser als eine Seite, die stillschweigend nichts tut, und wer jeden querySelector in ein ?. packt, bekommt diesen Hinweis nie wieder zu sehen.
Die leere Liste
<h1>Meine Seite</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;
} // querySelectorAll liefert nie null, sondern eine leere NodeList.
const nichts = document.querySelectorAll(".gibtesnicht");
console.log("Typ:", typeof nichts, "| Länge:", nichts.length);
// Deshalb tut eine Schleife darüber einfach nichts.
nichts.forEach((el) => console.log("das kommt nie"));
console.log("und läuft weiter");
// Auch Array.from und map bleiben leer statt zu werfen.
console.log("map:", Array.from(nichts).map((el) => el.textContent));
// Das ist bequem und hat eine Kehrseite: ein Tippfehler im
// Selektor fällt hier nicht auf. Es passiert einfach nichts,
// und niemand sagt dir, warum.
const karten = document.querySelectorAll(".kartee");
console.log("Anzahl:", karten.length); querySelectorAll verhält sich anders. Es liefert nie null, sondern eine leere NodeList. Deshalb kracht dort nichts. Eine Schleife über eine leere NodeList läuft null Mal, Array.from liefert ein leeres Array und map ebenfalls.
Die Kehrseite ist, dass ein Tippfehler im Selektor nicht auffällt. Es passiert einfach nichts, und keiner sagt dir, warum. querySelector bringt wenigstens eine Fehlermeldung. Wenn eine Schleife über Elemente scheinbar nichts tut, gebe ich als Erstes die length aus. Steht dort 0, ist der Selektor schuld und nicht die Schleife.
In der Aufgabe kommen zwei Funktionen damit zurecht, dass ein Selektor ins Leere zeigt. Die eine mit einem Ersatztext, die andere mit einer Zahl.
Zum Mitnehmen
querySelector liefert ohne Treffer null, und erst der Zugriff danach wirft. querySelectorAll liefert eine leere NodeList, und eine Schleife darüber tut still nichts.
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.