Abschnitt 16 · Lektion 3
Fehler behandeln
Eine Adresse gibt es nicht mehr, und der Server antwortet mit 404. Der eigene Code läuft trotzdem weiter, als wäre nichts gewesen. Für fetch ist ein 404 nämlich kein Fehler.
Was das bedeutet
<p>Die Adresse gibt es nicht. Trotzdem läuft alles durch.</p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
} async function versuchen() {
try {
const antwort = await fetch("/lernen/api/gibtesnicht.json");
// Diese Zeile wird erreicht. Das ist der Punkt der Lektion.
console.log("Der try-Block läuft weiter.");
console.log("ok:", antwort.ok);
console.log("status:", antwort.status);
} catch (fehler) {
console.error("Hier kommt niemand an:", fehler.message);
}
}
versuchen(); Wenn du eine Adresse anfragst, die es nicht gibt, geht die Anfrage raus, der Server antwortet, und die Antwort kommt an. Alles hat funktioniert. Nur steht in der Antwort nicht das, was du wolltest, sondern die Nachricht „gibt es hier nicht“.
Aus Sicht von fetch ist das ein Erfolg. Das Promise löst auf, das await liefert eine Antwort, der try-Block läuft weiter, und das catch bekommt nichts davon mit.
Im ersten Beispiel steht die Ausgabe untereinander. Der try-Block läuft, ok ist false, status ist 404, und das catch bleibt stumm.
Im Reiter „Netzwerk“ steht die Anfrage mit ihrem Status 404, und zwar genau in dem Moment, in dem der Code ungerührt weiterläuft. Die schlechte Nachricht ist sauber übermittelt und ordentlich zugestellt worden. Hingesehen hat nur niemand.
Wenn du die Zeile aufklappst, siehst du, wie ordentlich. Der Server hat Kopfzeilen mitgeschickt und einen Rumpf, und darin steht { "fehler": "Nicht gefunden" }. Das ist eine vollständige, gut gemeinte Antwort, und der Code könnte sie einfach lesen. Er tut es bloß nicht.
Solche Fehler fallen oft erst im Betrieb auf. Solange der Server antwortet, merkt niemand etwas. Fällt er aus oder ändert sich eine Adresse, arbeitet der Code mit einer Antwort weiter, in der gar keine Daten stehen.
Den Status selbst prüfen
Jede Antwort bringt eine Statusnummer mit, und antwort.ok fasst sie zu einem Wahrheitswert zusammen. ok ist genau dann true, wenn der Status zwischen 200 und 299 liegt. Die Nummern fallen in vier Gruppen.
- 2xx heißt, es hat geklappt, und
200ist der Normalfall. - 3xx heißt, es liegt woanders. Weiterleitungen folgt
fetchvon selbst, und meistens sieht man sie gar nicht. - 4xx heißt, die Anfrage war das Problem.
404gibt es nicht,401heißt nicht angemeldet,403nicht erlaubt,400unverständlich. - 5xx heißt, der Server hat ein Problem.
500ist der Klassiker,503heißt überlastet oder in Wartung.
Grob gesagt heißt eine Vier vorn, dass die eigene Seite falsch gefragt hat. Eine Fünf heißt, der Server hat ein Problem.
Erst prüfen, dann lesen
<p>Dasselbe zweimal, einmal mit vorhandener und einmal mit fehlender Adresse.</p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
} async function holen(adresse) {
try {
const antwort = await fetch(adresse);
// Erst den Status prüfen, dann lesen.
if (!antwort.ok) {
throw new Error(`Server meldet ${antwort.status}`);
}
const daten = await antwort.json();
console.log("Geladen:", daten.length, "Einträge");
} catch (fehler) {
console.warn("Nicht geklappt:", fehler.message);
}
}
async function beides() {
await holen("/lernen/api/kurse.json");
await holen("/lernen/api/gibtesnicht.json");
}
beides(); Sollen beide Fälle gleich behandelt werden, machst du aus dem schlechten Status selbst einen Fehler. Erst kommt fetch, dann if (!antwort.ok) throw new Error(...), und dann wird gelesen. Ab da reicht ein einziges catch für beides, für die kaputte Verbindung und für die schlechte Antwort.
Die Prüfung steht vor dem await antwort.json(). Der Übungsserver schickt auch beim 404 noch JSON, aber viele Server schicken eine HTML-Seite. Dann wirft json() mit Unexpected token '<', "<!doctype "... is not valid JSON (in Firefox JSON.parse: unexpected character at line 1 column 1 of the JSON data), und in der Meldung geht es um JSON statt um den 404.
Wann das catch wirklich greift
<p>Jetzt greift das catch wirklich.</p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
} // Port 1 sperrt der Browser von sich aus, die Anfrage geht gar nicht erst raus.
const NIRGENDWO = "http://127.0.0.1:1/daten.json";
async function versuchen() {
try {
const antwort = await fetch(NIRGENDWO);
console.log("Kommt hier nie an. Status:", antwort.status);
} catch (fehler) {
console.warn("Das catch greift:", fehler.name);
console.warn("Die Meldung ist je nach Browser eine andere.");
}
}
versuchen(); Abgelehnt wird ein fetch, wenn gar keine Antwort zustande kommt. Das passiert ohne Netz, bei einem Servernamen, den es nicht gibt, oder wenn eine Sicherheitsregel des Browsers die Anfrage verhindert.
Dann kommt ein TypeError, und der Wortlaut der Meldung ist je nach Browser ein anderer. Ich verlasse mich deshalb nie auf den Text, sondern nur darauf, dass es passiert ist. Bricht der eigene Code die Anfrage ab, heißt der Fehler AbortError, und das kommt in der nächsten Lektion.
Im dritten Beispiel geht die Anfrage an Port 1, und den sperrt der Browser selbst. Diesmal ist die Ausgabe genau umgekehrt. Der try-Block bricht ab, und das catch meldet sich.
Im Reiter „Netzwerk“ steht der Unterschied als ein Wort. Beim 404 stand dort die Zahl 404, hier steht fehlgeschlagen, und einen Status gibt es gar nicht. Das liegt an der Sache selbst, denn ein Status kommt vom Server, und hier war nie einer beteiligt.
Steht eine Zahl in der Zeile, hat jemand geantwortet, und das catch bleibt stumm. Steht fehlgeschlagen da, ist die Anfrage nie angekommen, und dann greift das catch.
Zwei verschiedene Meldungen
Die Meldung für die Console und die Meldung für den Menschen vor dem Bildschirm sind zwei verschiedene Texte.
In die Console gehört alles, Adresse, Status und der ursprüngliche Fehler, damit du später nachvollziehen kannst, was passiert ist.
Auf die Seite gehört ein Satz, mit dem jemand etwas anfangen kann, etwa „Die Kursliste konnte nicht geladen werden. Bitte versuch es später noch einmal.“ Ein TypeError: Failed to fetch auf der Seite (in Firefox NetworkError when attempting to fetch resource.) hilft dort niemandem.
In der Aufgabe hält eine Funktion die drei Ausgänge auseinander, Erfolg, schlechten Status und eine Verbindung, die gar nicht zustande kommt.
Zum Mitnehmen
Ein 404 löst ganz normal auf, und nur antwort.ok verrät ihn. Ins catch kommt erst, was gar keine Antwort bekommt, und der eigene Code macht einen schlechten Status deshalb selbst zum Fehler.
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 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe im Editor, direkt im Browser geprüft
Öffnet sich mit dem Basis Konto.