Menu
CoddyTech

Обработка ошибок

Часть раздела Основы Next.js путешествия по React на Coddy. Урок 27 из 47.

Загрузки завершаются с ошибкой. База данных не работает, запись исчезла, что-то выбрасывает исключение. Без плана один неудачный await выводит из строя весь экран.

error.jsx — зеркальное отражение loading.jsx: та же идея, противоположный результат. Размести его рядом со страницей, и он перехватит любые ошибки, которые эта страница выдаст во время рендеринга:

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

В отличие от loading.jsx, у него есть одно обязательное требование:

'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 должен быть клиентским компонентом. Причина прямо указана в JSX: onClick. Кнопка повтора — это интерактивный элемент, а для интерактивности нужен компонент, который отправляется в браузер. Не укажешь 'use client' — получишь ошибку обработчика событий из предыдущей главы как раз на странице, предназначенной для обработки ошибок.

Он получает два свойства:

  • error: ошибка, которая была выброшена, чтобы ты мог её записать в журнал
  • reset: функция, которая повторно отображает неудачно загруженный раздел. Вызови её, и страница попробует снова

reset — это то, что превращает сбой не просто в более красивый экран ошибки. Сбой, который однажды не удался, часто срабатывает со второй попытки, и пользователю не пришлось ничего перезагружать.

Как и другие специальные файлы, error.jsx охватывает свою папку и всё, что находится внутри неё, поэтому один файл рядом с корнем служит страховочной сеткой для целого раздела сайта.

Попробуйте сами

В этом уроке нет задания по программированию.

quiz iconПроверьте себя

В этом уроке есть небольшой тест. Начните урок, чтобы ответить на вопросы и сохранить прогресс.

Все уроки раздела Основы Next.js