Erros esperados e inesperados
Diferencie erros esperados visíveis ao usuário de erros inesperados do servidor.
Erros esperados e inesperados é 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.
Duas categorias
O SvelteKit distingue erros esperados, lançados intencionalmente, de erros inesperados, causados por falhas.
Esperado: error()
Chame error(status, message) para casos de falha conhecidos.
if (!post) error(404, "Post not found");Inesperado: exceções não capturadas
Qualquer outra exceção lançada é inesperada. O SvelteKit oculta a mensagem dos clientes por motivos de segurança.
Por que ocultar mensagens
Mensagens de erro inesperadas podem revelar detalhes da pilha ou da implementação. Exibir uma mensagem genérica é mais seguro.
handleError
Use handleError nos ganchos para registrar erros inesperados e personalizar a mensagem genérica.
Padrão: validar entradas
Chame error() quando as entradas forem inválidas; permita que as falhas reais surjam como inesperadas.
Auxiliar de redirecionamento
redirect() também é intencional: use-o para páginas que exigem autenticação ou para URLs movidas.
Recuperação com try/catch
Envolva chamadas externas arriscadas em try/catch e recorra a uma alternativa de forma adequada, evitando páginas de erro.
Tipos do TypeScript
O error() do SvelteKit é tipado; ele lança uma exceção, portanto o restante do código é alcançável após a lógica de retorno antecipado.
Escolha do código de status
404 para não encontrado, 401 para não autenticado, 403 para proibido e 500 para erros do servidor.
Evitar lançar erros simples
Um throw new Error simples em caminhos voltados ao usuário recebe tratamento inesperado. Use error() para proporcionar uma experiência clara.
Verificação rápida
O que error(404) faz de diferente de throw new Error?
Recapitulação
Use error() para falhas intencionais com mensagens visíveis; permita que as falhas reais sejam lançadas e registradas por handleError.
Perguntas Frequentes
A aula “Erros esperados e inesperados” é grátis?
Sim — o texto completo de “Erros esperados e inesperados” é 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 “Erros esperados e inesperados”?
Diferencie erros esperados visíveis ao usuário de erros inesperados do servidor. 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 “Erros esperados e inesperados”?
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
- +error.svelte para páginas de erro personalizadas
- Erros esperados e inesperados
- Auxiliares error() e redirect()
- Páginas de erro em layouts aninhados