Sveltejs Academy · 课时

处理操作中的验证错误

使用 fail() 和 ActionData 返回验证错误,并重新填充表单字段。

第 4 / 4 课13 个步骤

处理操作中的验证错误 是 CoddyKit 上的免费 Sveltejs Academy 课时。 这是第 4 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Sveltejs Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Sveltejs Academy 课程共包含 4 节课。

fail 辅助函数

使用 fail() 在不抛出错误的情况下,以非 2xx 状态返回验证错误。

import { fail } from "@sveltejs/kit";
if (!email) return fail(400, { email, missing: true });

状态码

第一个参数是 HTTP 状态码(验证时通常使用 400)。

错误数据

第二个参数是发送回页面的数据。请包含用户输入,以便重新填充表单。

在页面中读取

页面会收到包含操作结果的 form 属性。

<script>
  export let form;
</script>
{#if form?.missing}<p>Please enter an email.</p>{/if}

重新填充字段

通过 fail 传回已提交的值,并预填输入框,避免用户重新输入。

<input name="email" value={form?.email ?? ""} />

字段级错误

为每个字段使用单独的错误键,以实现细粒度的界面显示。

return fail(400, { errors: { email: "Invalid" } });

结合模式验证

在服务器端使用 Zod 或 Valibot 等库进行类型安全的解析。

避免通过抛出错误进行验证

抛出错误会导致显示错误页面;fail 则会让用户停留在表单页面。

成功后重置表单

成功后,通过返回空值或进行重定向来清除表单状态。

与 use:enhance 一起使用

得益于 enhance,表单属性无需重新加载页面就会更新。

无障碍性

使用 aria-live 播报错误,让屏幕阅读器能够读出这些错误。

快速检查

fail() 会返回什么?

回顾

使用 fail() 处理验证错误。页面会从 form 属性中读取这些错误,以提供友好的反馈。

免费开始

用 AI 导师学习 HTML — 免费

在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。

课程
41
课程
163

常见问题解答

「处理操作中的验证错误」课时是免费的吗?

是的 — 「处理操作中的验证错误」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Sveltejs Academy 课程的其余内容,请升级到 CoddyKit PRO。 Sveltejs Academy 课程共包含 4 节课。

「处理操作中的验证错误」这节课中我会学到什么?

使用 fail() 和 ActionData 返回验证错误,并重新填充表单字段。 你通过在浏览器中直接运行的动手代码来练习 Sveltejs Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Sveltejs Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Sveltejs Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 4 节课,共 4 节。

「处理操作中的验证错误」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Sveltejs Academy 课中编写并运行代码吗?

能。每节 Sveltejs Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 带有操作的 +page.server.js
  2. use:enhance 指令
  3. 表单的渐进增强
  4. 处理操作中的验证错误
← 返回 Sveltejs Academy