返回 JSON 响应
使用 json() 辅助函数返回结构化 JSON，并设置正确的内容类型。
返回 JSON 响应 是 CoddyKit 上的免费 Sveltejs Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Sveltejs Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Sveltejs Academy 课程共包含 4 节课。
json 辅助函数
使用来自 @sveltejs/kit 的 json()，以正确的标头返回 JSON。
import { json } from "@sveltejs/kit";
return json({ ok: true });状态码
传入第二个选项对象，以控制状态和其他标头。
return json({ ok: false }, { status: 400 });自定义标头
通过 headers 添加 cache-control、CORS 或其他内容。
return json(data, { headers: { "cache-control": "max-age=60" } });手动响应
如果需要非 JSON 正文，也可以返回原始的 Response 对象。
return new Response("plain text", { headers: { "content-type": "text/plain" } });类型安全的正文
使用 TypeScript 可以为响应正文指定类型，方便使用者。
流式 JSON
对于超大集合，请以流的形式传输以换行符分隔的 JSON 数据块。
分页
在响应中包含 nextCursor 或页面元数据，以便实现清晰的分页。
错误结构
采用统一的错误封装格式，例如 { error: { code, message } }，以提高清晰度。
ETag 缓存
为稳定的响应设置 ETag 标头，以实现 HTTP 层面的缓存。
内容协商
使用 Accept 标头在 JSON 和其他格式之间进行切换。
最佳实践
即使发生错误，API 也应始终返回 JSON。客户端需要一致的数据结构。
快速检查
如何使用正确的标头返回 JSON？
回顾
使用 json() 便捷地返回带有状态和标头的 JSON。对于非 JSON 响应，请返回原始的 Response。
用 AI 导师学习 HTML — 免费
在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。
- 课程
- 41
- 课程
- 163
常见问题解答
「返回 JSON 响应」课时是免费的吗？
是的 — 「返回 JSON 响应」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Sveltejs Academy 课程的其余内容，请升级到 CoddyKit PRO。 Sveltejs Academy 课程共包含 4 节课。
「返回 JSON 响应」这节课中我会学到什么？
使用 json() 辅助函数返回结构化 JSON，并设置正确的内容类型。 你通过在浏览器中直接运行的动手代码来练习 Sveltejs Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Sveltejs Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Sveltejs Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「返回 JSON 响应」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Sveltejs Academy 课中编写并运行代码吗？
能。每节 Sveltejs Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。