Menu
CoddyTech

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't

Im 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 kannst
  • reset: 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.

quiz iconTeste dich selbst

Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.

Alle Lektionen in Next.js Essentials