Auxiliares error() e redirect()
Lance erros tipados e redirecionamentos a partir de funções load e ações.
Auxiliares error() e redirect() é uma aula grátis de Sveltejs Academy no CoddyKit. Esta é a aula 3 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.
Dois auxiliares integrados
error() e redirect() de @sveltejs/kit tratam das duas principais ramificações voltadas ao usuário.
Auxiliar error
Lança um erro estruturado com status e mensagem.
import { error } from "@sveltejs/kit";
error(404, "Not found");Auxiliar redirect
Envia o usuário para outra URL com um status 3xx.
import { redirect } from "@sveltejs/kit";
redirect(303, "/login");Códigos de status para redirecionamento
301 para permanente, 302 para temporário, 303 para «consulte outra» (comum após POST), 307/308 para preservar o método.
Usar em load
Chame dentro do carregamento para redirecionar antes da renderização.
if (!session) redirect(303, "/login");Usar em ações
As ações de formulário podem redirecionar após o processamento bem-sucedido.
Padrão de lançamento
Ambos os auxiliares lançam exceções; o código subsequente fica inacessível. O TypeScript faz o estreitamento corretamente.
Nunca os capture
Não envolva esses auxiliares em try/catch; deixe o SvelteKit tratá-los.
Status 401 x 403
Use 401 quando o usuário não estiver autenticado; 403 quando estiver autenticado, mas não tiver permissão.
Combinar com URLs
Crie URLs com o construtor URL para garantir uma codificação segura.
redirect(303, `/login?next=${encodeURIComponent(url.pathname)}`);Uso real
Fluxos de autenticação, redirecionamentos de URLs obsoletas e tratamento de recursos ausentes.
Verificação rápida
Por que usar redirect() em vez de return?
Recapitulação
Use error() para falhas e redirect() para navegação. Ambos lançam exceções e interrompem o código seguinte.
Perguntas Frequentes
A aula “Auxiliares error() e redirect()” é grátis?
Sim — o texto completo de “Auxiliares error() e redirect()” é 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 “Auxiliares error() e redirect()”?
Lance erros tipados e redirecionamentos a partir de funções load e ações. 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 3 de 4.
Quanto tempo leva a aula “Auxiliares error() e redirect()”?
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