mitmario.dev

Die Fehlerarten

JavaScript Im Browser 5 Min Lesezeit 3 BeispieleLektion 1 von 6

Die Seite tut gar nichts, und in der Console steht eine rote Zeile, die wie eine Beschimpfung aussieht. Dabei ist sie die kürzeste Fassung von dem, was du wissen musst. Sie hat drei Teile, die du aus dem ersten Abschnitt kennst, nämlich Art, Text und Fundstelle. Am wichtigsten ist die Art, denn sie sagt dir, wo du überhaupt suchen musst.

SyntaxError

Ein SyntaxError lässt gar nichts laufen
console.log("Diese Zeile steht ganz oben.");

// Hinter dem Funktionsnamen fehlt die schließende Klammer.
// Damit ist die ganze Datei ungültig.
function begruessung( {
  return "Hallo";
}

console.log("Und diese hier ganz unten.");

Ein SyntaxError passiert beim Lesen, noch bevor irgendetwas ausgeführt wird. Der Browser schaut sich die Datei nämlich an, bevor er sie startet. Lässt sie sich nicht als gültiges JavaScript lesen, startet er sie gar nicht erst.

Im ersten Beispiel steht die Meldung in der Console, und sonst passiert nichts. Beide console.log bleiben stumm. Auch der ganz oben, obwohl er vor dem Fehler steht.

Wenn sich eine Seite verhält, als wäre gar kein Skript da, ist ein SyntaxError der erste Verdacht. Und dann suchst du in der ganzen Datei und nicht nur in der Zeile, an der du gerade gearbeitet hast.

Die Ursachen sind fast immer dieselben. Eine Klammer fehlt, ein Anführungszeichen ist nicht geschlossen, oder zwischen zwei Einträgen fehlt das Komma, wie in { name: "Mia" alter: 34 }. Ein Komma zu viel am Ende einer Liste stört JavaScript übrigens nicht. Das stört erst JSON in Abschnitt 16. Meistens markiert der Editor so etwas schon beim Tippen.

ReferenceError

ReferenceError und TypeError nebeneinander
// Das try/catch drumherum ist Thema der nächsten Lektion. Hier
// sorgt es nur dafür, dass du beide Fehler nacheinander siehst:
// ohne das würde schon der erste den Rest der Datei anhalten.

const anzahl = 3;

try {
  // Tippfehler im Namen. Diesen Namen gibt es nirgends.
  console.log(anzhal * 2);
} catch (fehler) {
  console.error(fehler);
}

try {
  const nutzer = null;
  // Den Namen nutzer gibt es. Er ist nur nichts, was einen
  // Namen hätte.
  console.log(nutzer.name);
} catch (fehler) {
  console.error(fehler);
}

Ein ReferenceError heißt wörtlich, dass etwas nachgeschlagen werden soll, das es an dieser Stelle nicht gibt.

Meistens ist das ein Tippfehler. Im Beispiel steht anzhal statt anzahl. Die beiden sehen sich so ähnlich, dass man zehnmal darüber liest.

Der andere häufige Fall ist der Gültigkeitsbereich aus Lektion 5.6. Den Namen gibt es schon, nur steht er woanders, in einer anderen Funktion oder einem anderen Block, und von außen ist er dann genauso wenig da wie ein Name, den es gar nicht gibt.

Die Meldung nennt den Namen immer mit, und eine schnellere Suchhilfe gibt es nicht.

TypeError

Ein TypeError ist die andere Hälfte. Den Namen gibt es, und der Wert ist auch da. Er kann nur nicht, was von ihm verlangt wird.

Im zweiten Teil des Beispiels ist nutzer gleich null, und null hat keine Eigenschaften. In Chrome lautet die Meldung dann „Cannot read properties of null“, und in Klammern steht dahinter, welche Eigenschaft es war. Firefox schreibt can't access property "name", nutzer is null und nennt dazu die Variable, in der das null steckt.

In der DOM-Arbeit steckt fast immer dasselbe dahinter. document.querySelector liefert null, wenn nichts passt, und die nächste Zeile fasst dieses null an, wie in Lektion 10.4. Bei einem TypeError in einem DOM-Skript frage ich deshalb zuerst, ob der Selektor überhaupt etwas gefunden hat.

RangeError und der Rest

Ein RangeError heißt, dass der Wert an sich in Ordnung ist, aber außerhalb dessen liegt, was erlaubt ist. new Array(-1) geht nicht, zahl.toFixed(200) geht auch nicht. Und eine Funktion, die sich endlos selbst aufruft, endet in „Maximum call stack size exceeded“. Firefox sortiert diesen Fall anders ein und meldet InternalError: too much recursion. Gemeint ist dasselbe.

Es gibt noch ein paar Arten mehr. Was dir am Anfang begegnet, ist aber praktisch immer eine von diesen vier.

Den Stacktrace lesen

Der Stacktrace zeigt, wer wen gerufen hat
function ganzUnten(wert) {
  return wert.toUpperCase();
}

function inDerMitte(wert) {
  return ganzUnten(wert);
}

function ganzOben() {
  return inDerMitte(42);
}

try {
  ganzOben();
} catch (fehler) {
  console.error(fehler);
}

Unter der Meldung steht eine Liste von Zeilen, der Stacktrace. Daran siehst du, wie das Programm überhaupt an diese Stelle gekommen ist.

Gelesen wird von oben nach unten. Die oberste Zeile ist die Stelle, an der es geknallt hat. Darunter steht, wer diese Funktion aufgerufen hat, darunter, wer den Aufrufer aufgerufen hat, und so weiter bis zum Anfang.

Im dritten Beispiel ruft ganzOben die Funktion inDerMitte auf, und die ruft ganzUnten. Geknallt hat es in ganzUnten, weil 42 kein toUpperCase kennt. Der eigentliche Fehler steckt aber in ganzOben, denn von dort kommt die 42.

Die oberste Zeile sagt also, wo es passiert ist, und die Zeilen darunter sagen, warum. Deshalb lohnt es sich, den ganzen Stacktrace zu lesen.

In fremdem Code sind die obersten Zeilen oft Bibliotheken, die dich nichts angehen. Dann zählt die erste Zeile, in der deine eigene Datei steht. Dort fange ich an.

is not a function

Eine Meldung kommt besonders oft, und fast immer steckt ein Tippfehler im Namen einer Methode dahinter.

liste.pusch(1) ist kein ReferenceError, denn liste gibt es ja. JavaScript sieht nach, ob das Objekt eine Eigenschaft pusch hat, findet keine und bekommt undefined zurück. Dann versucht es, dieses undefined aufzurufen. Und das ist ein TypeError.

Deshalb steht in der Meldung liste.pusch is not a function. Sie zeigt auf den Aufruf und nicht auf den Tippfehler. Wenn ich sie sehe, lese ich den Methodennamen Buchstabe für Buchstabe.

Bei einer Eigenschaft passiert dasselbe, nur leiser. kurs.Titel statt kurs.titel liefert undefined, und gemeldet wird erst die nächste Zeile, die damit weiterarbeitet. Suchen musst du dann dort, wo der Wert herkommt.

Warum ein Tippfehler erst beim Ausführen auffällt

Beim Laden prüft der Browser nur die Struktur, nicht die Bedeutung. Er kann zu diesem Zeitpunkt gar nicht wissen, ob es anzhal irgendwo gibt, denn der Name könnte in einer anderen Datei stehen oder erst zur Laufzeit entstehen.

Ein Tippfehler in einem Namen fällt deshalb erst auf, wenn die Zeile wirklich an die Reihe kommt. Steht sie in einem Handler, der selten läuft, bleibt so ein Fehler auch mal wochenlang unentdeckt. Das ist einer der Gründe, warum es TypeScript gibt.

In der Aufgabe benennst du zwei kaputte Stücke nur. Das dritte reparierst du.

Zum Mitnehmen

Ein SyntaxError lässt die ganze Datei nicht laufen, ein ReferenceError sucht einen Namen, den es an der Stelle nicht gibt, und ein TypeError hat einen Wert, der nicht kann, was verlangt ist. Der Stacktrace zeigt von oben nach unten, wo es geknallt hat und wie das Programm dorthin kam.

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.