Menu
CoddyTech

Gestion des erreurs

Fait partie de la section L'essentiel de Next.js du Journey React de Coddy. Leçon 27 sur 47.

Les chargements échouent. La base de données est hors service, l’enregistrement a disparu, une exception est levée. Sans plan, un seul await mal géré fait planter tout l’écran.

error.jsx est le reflet de loading.jsx : même idée, résultat opposé. Place-le à côté d’une page et il intercepte tout ce que cette page déclenche pendant le rendu :

app/
    menu/
        page.jsx
        loading.jsx    while it works
        error.jsx      when it doesn't

Contrairement à loading.jsx, il a une exigence impérative :

'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 doit être un composant client. La raison se trouve juste là dans le JSX : onClick. Un bouton de nouvelle tentative implique une interaction, et les interactions nécessitent un composant envoyé au navigateur. Oublie 'use client' et tu obtiens l’erreur de gestionnaire d’événement du chapitre précédent, sur la page même dont le rôle était de gérer les erreurs.

Il reçoit deux props :

  • error : l’erreur qui a été déclenchée, afin que tu puisses la consigner
  • reset : une fonction qui effectue un nouveau rendu de la section en échec. Appelle-la et la page réessaiera

reset est ce qui fait de cela bien plus qu’un écran de plantage plus agréable. Une perturbation qui a échoué une première fois fonctionnera souvent la deuxième fois, et l’utilisateur n’aura rien eu à recharger.

Comme les autres fichiers spéciaux, error.jsx s’applique à son propre dossier et à tout ce qui se trouve dans ses sous-dossiers : un seul fichier près de la racine sert ainsi de filet de sécurité pour toute une section du site.

Essayez vous-même

Cette leçon ne comprend pas de défi de code.

quiz iconTestez-vous

Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.

Toutes les leçons de L'essentiel de Next.js