Tratando erros de validação em ações
Retorne erros de validação e preencha novamente os campos do formulário usando fail() e ActionData.
Tratando erros de validação em ações é uma aula grátis de Sveltejs Academy no CoddyKit. Esta é a aula 4 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.
O auxiliar fail
Use fail() para retornar erros de validação com um status diferente de 2xx, sem lançar uma exceção.
import { fail } from "@sveltejs/kit";
if (!email) return fail(400, { email, missing: true });Código de status
O primeiro argumento é o status HTTP (geralmente 400 para validação).
Dados do erro
O segundo argumento são os dados enviados de volta à página. Inclua os dados inseridos pelo usuário para preencher os campos novamente.
Ler na página
A página recebe uma propriedade form com o resultado da ação.
<script>
export let form;
</script>
{#if form?.missing}<p>Please enter an email.</p>{/if}Preencher novamente os campos
Passe o valor enviado de volta por meio de fail e preencha previamente os campos para evitar uma nova digitação.
<input name="email" value={form?.email ?? ""} />Erros por campo
Use chaves de erro individuais para cada campo, permitindo uma interface mais específica.
return fail(400, { errors: { email: "Invalid" } });Combinar com a validação de esquema
Use bibliotecas como Zod ou Valibot no servidor para fazer uma análise com segurança de tipos.
Evitar lançar erros na validação
Lançar uma exceção leva a páginas de erro; fail mantém o usuário no formulário.
Redefinição do formulário após sucesso
Após o sucesso, limpe o estado do formulário retornando valores vazios ou redirecionando.
Usar com use:enhance
A propriedade form é atualizada sem recarregamento graças ao aprimoramento.
Acessibilidade
Anuncie os erros com aria-live para que os leitores de tela os leiam.
Verificação rápida
O que fail() retorna?
Recapitulação
Use fail() para erros de validação. A página os lê da propriedade form para fornecer um feedback claro ao usuário.
Perguntas Frequentes
A aula “Tratando erros de validação em ações” é grátis?
Sim — o texto completo de “Tratando erros de validação em ações” é 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 “Tratando erros de validação em ações”?
Retorne erros de validação e preencha novamente os campos do formulário usando fail() e ActionData. 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 4 de 4.
Quanto tempo leva a aula “Tratando erros de validação em ações”?
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
- +page.server.js com ações
- A diretiva use:enhance
- Aprimoramento progressivo para formulários
- Tratando erros de validação em ações