Fehlerbehandlung
Teil des Abschnitts Next.js Essentials der React-Journey von Coddy. Lektion 27 von 47.
Ladevorgänge schlagen fehl. Die Datenbank ist nicht erreichbar, der Datensatz ist verschwunden, irgendetwas wirft einen Fehler. Ohne einen Plan reißt ein einziges fehlerhaftes await den ganzen Bildschirm mit sich.
error.jsx ist das Spiegelbild von loading.jsx: dieselbe Idee, gegenteiliges Ergebnis. Lege es neben einer Seite ab, und es fängt alles ab, was diese Seite beim Rendern auslöst:
app/
menu/
page.jsx
loading.jsx while it works
error.jsx when it doesn'tIm Gegensatz zu loading.jsx gibt es eine zwingende Voraussetzung:
'use client';
export default function Error({ error, reset }) {
return (
<div>
<h2>Couldn't load the menu</h2>
<button onClick={reset}>Try again</button>
</div>
);
}error.jsx muss eine Client-Komponente sein. Der Grund ist direkt im JSX zu sehen: onClick. Eine Schaltfläche zum erneuten Versuchen ist interaktiv, und Interaktivität erfordert eine Komponente, die an den Browser ausgeliefert wird. Lässt du 'use client' weg, erhältst du den Ereignisbehandlungsfehler aus dem letzten Kapitel – und zwar auf genau der Seite, deren Aufgabe es war, Fehler zu behandeln.
Es erhält zwei Props:
error: der ausgelöste Fehler, damit du ihn protokollieren kannstreset: eine Funktion, die den fehlgeschlagenen Abschnitt erneut rendert. Rufe sie auf, und die Seite versucht es erneut
reset macht daraus mehr als nur einen schöneren Absturzbildschirm. Ein kurzer Aussetzer, der einmal fehlgeschlagen ist, funktioniert oft beim zweiten Mal, und der Nutzer musste nichts neu laden.
Wie die anderen speziellen Dateien deckt error.jsx den eigenen Ordner und alles darunter Verschachtelte ab, sodass eine Datei nahe der Wurzel einen ganzen Bereich der Website absichert.
Probier es selbst
Diese Lektion enthält keine Programmieraufgabe.
Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.