Sveltejs Academy · 课时

使用 +error.svelte 创建自定义错误页面

创建显示状态码和消息的自定义错误用户界面。

第 1 / 4 课13 个步骤

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

自定义错误界面

在任意路由文件夹中创建 +error.svelte,即可定制错误页面。

根错误页面

src/routes/+error.svelte 会捕获任何未被嵌套错误边界捕获的错误。

<!-- +error.svelte -->
<script>
  import { page } from "$app/stores";
</script>
<h1>{$page.status}: {$page.error?.message}</h1>

访问状态

$page.status 提供 HTTP 状态码(404、500 等)。

访问消息

$page.error.message 提供您传递给 error() 的消息,或 handleError 生成的通用消息。

预渲染差异

静态错误页面可以预渲染;动态错误页面会针对每个请求进行渲染。

嵌套边界

将 +error.svelte 放在子文件夹中,即可将错误界面限定到特定部分。

友好消息

请定制消息:404 应建议用户前往其他位置,500 应表示歉意并链接到支持页面。

跟踪 ID

显示 handleError 返回的跟踪 ID,以便用户向支持人员提供该 ID。

恢复链接

务必提供返回路径:主页链接、搜索框或重新加载按钮都可以。

品牌设计

请将错误页面设计得与应用的其余部分一致;它也是用户体验的一部分。

响应式更新

如果用户在错误上下文中导航,$page 会更新,使界面保持最新。

快速检查

如何访问错误状态?

总结

按文件夹放置 +error.svelte,以限定错误界面的范围。读取 $page.status 和 $page.error。

免费开始

用 AI 导师学习 HTML — 免费

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

课程
41
课程
163

常见问题解答

「使用 +error.svelte 创建自定义错误页面」课时是免费的吗?

是的 — 「使用 +error.svelte 创建自定义错误页面」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Sveltejs Academy 课程的其余内容,请升级到 CoddyKit PRO。 Sveltejs Academy 课程共包含 4 节课。

「使用 +error.svelte 创建自定义错误页面」这节课中我会学到什么?

创建显示状态码和消息的自定义错误用户界面。 你通过在浏览器中直接运行的动手代码来练习 Sveltejs Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Sveltejs Academy 需要有经验吗?

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

「使用 +error.svelte 创建自定义错误页面」课时需要多长时间?

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

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

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

此课程中的所有课时

  1. 使用 +error.svelte 创建自定义错误页面
  2. 预期错误与意外错误
  3. error() 与 redirect() 辅助函数
  4. 嵌套布局中的错误页面
← 返回 Sveltejs Academy