handleError para registro de erros do servidor
Capture erros inesperados do servidor e envie-os ao seu serviço de registro ou monitoramento.
handleError para registro de erros do servidor é uma aula grátis de Sveltejs Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Sveltejs Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Sveltejs Academy inclui 4 aulas no total.
Capturar erros
Erros inesperados no carregamento ou nos pontos de acesso podem ser observados por meio de handleError.
Exportar handleError
Exporte a partir de hooks.server.js.
export async function handleError({ error, event }) {
console.error(error);
return { message: "Something went wrong" };
}Objeto retornado
O objeto retornado fica disponível como $page.error na página de erro.
Enviar para o registro
Encaminhe os erros ao Sentry, ao Datadog ou a qualquer serviço de registro a partir deste gancho.
Evitar o vazamento de detalhes
Não retorne mensagens de erro brutas aos clientes em produção. Uma mensagem genérica + um ID de rastreamento é mais seguro.
IDs de rastreamento
Gere um ID exclusivo para cada erro, retorne-o ao usuário e registre-o internamente para oferecer suporte.
Variante do lado do cliente
hooks.client.js também oferece suporte a handleError para erros exclusivos do cliente.
Diferenciar erros
Erros esperados, provenientes de error(), ignoram handleError. Apenas erros inesperados o acionam.
Registro assíncrono
O registro pode ser assíncrono; não bloqueie a resposta se o seu registrador for lento.
Rastreamentos da pilha
Inclua rastreamentos da pilha nos seus registros; eles são essenciais para a depuração.
Páginas de erro personalizadas
Combine handleError com +error.svelte para proporcionar uma ótima experiência ao usuário.
Verificação rápida
Quando handleError é acionado?
Recapitulação
handleError em hooks.server.js registra erros inesperados de forma centralizada e define a mensagem visível ao usuário.
Perguntas Frequentes
A aula “handleError para registro de erros do servidor” é grátis?
Sim — o texto completo de “handleError para registro de erros do servidor” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Sveltejs Academy, atualize para CoddyKit PRO. O curso de Sveltejs Academy inclui 4 aulas no total.
O que vou aprender em “handleError para registro de erros do servidor”?
Capture erros inesperados do servidor e envie-os ao seu serviço de registro ou monitoramento. Você pratica Sveltejs Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Sveltejs Academy?
Nenhuma experiência prévia é necessária. Sveltejs Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.
Quanto tempo leva a aula “handleError para registro de erros do servidor”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Sveltejs Academy?
Sim. Cada aula de Sveltejs Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- O hook handle(): middleware para requisições
- handleError para registro de erros do servidor
- O hook init()
- Sequence() para compor hooks