Tratamento de Erros
Parte da seção Essenciais do Next.js do Journey de React da Coddy. Lição 27 de 47.
Os carregamentos falham. O banco de dados está fora do ar, o registro desapareceu, algo lança uma exceção. Sem um plano, um await problemático derruba a tela inteira.
error.jsx é o oposto de loading.jsx: a mesma ideia, com resultado oposto. Coloque-o ao lado de uma página e ele captura qualquer erro lançado por essa página durante a renderização:
app/
menu/
page.jsx
loading.jsx while it works
error.jsx when it doesn'tAo contrário de loading.jsx, ele tem um requisito obrigatório:
'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 precisa ser um componente cliente. O motivo está bem ali no JSX: onClick. Um botão para tentar novamente é interativo, e a interatividade precisa de um componente enviado ao navegador. Se você omitir 'use client', receberá o erro de manipulador de eventos do capítulo anterior, justamente na página cuja função era lidar com erros.
Ele recebe duas props:
error: o Error que foi lançado, para que você possa registrá-loreset: uma função que renderiza novamente a seção que falhou. Chame-a e a página tentará novamente
reset é o que faz disso mais do que uma tela de erro mais agradável. Uma falha momentânea que ocorreu uma vez muitas vezes funciona na segunda tentativa, e o usuário não precisou recarregar nada.
Assim como os outros arquivos especiais, error.jsx abrange sua própria pasta e tudo o que está dentro dela, então um único arquivo próximo à raiz funciona como uma rede de segurança para uma seção inteira do site.
Experimente você mesmo
Esta lição não inclui um desafio de código.
Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.