Agent Skills
返回列表
安全JSON解析

安全JSON解析

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 的说明,把 @user_f1b049da/dmn20264958 安全JSON解析技能安装到当前的 AI 助手中。

技能介绍

你要解决的是这几个具体问题

在 localStorage 里存未完成的草稿、用户粘贴进来的 JSON 片段、偶然返回非 JSON 文本的接口,这些场景里如果直接用 JSON.parse,一个空字符串、半截内容或格式缺失就会抛 SyntaxError。只做一次 try/catch 只能挡掉异常,没办法给业务一个统一的兜底出口,页面状态还是可能卡在损坏值里。

这个技能如何工作

技能围绕 destr 封装了面向场景的解析逻辑,核心是本地草稿恢复场景下的 parseDraft 函数:它读取草稿内容后用 destr 做安全解析,失败时返回预设的默认值,而不是抛出异常。保存草稿时仍使用 JSON.stringify,读取侧被保护起来。

对粘贴板 JSON 片段和接口偶发文本,同样的思路可以复用:解析失败就给出明确的 fallback,或者输出一条提示,而不是让异常扩散。

注意它的工作边界

它不是 schema 校验工具,不会验证对象的字段类型、必填项或结构完整性。destr 解析成功的返回值不能直接当作已校验的业务对象,如果需要严格约束,得另接 Zod 或 Ajv。

也不要在未加保护的逻辑里裸调用 JSON.parse,否则这个技能就不能覆盖到那一部分风险。

使用场景

  • 在前端页面做未完成草稿自动保存时,需要安全读取localStorage中的JSON草稿并兜底
  • 用户粘贴JSON片段到输入框时,需要处理非法内容不导致页面崩溃
  • 接口偶发返回非JSON文本时,需要将异常结果转为默认值继续运行
  • 做数据草稿恢复功能时,需要避免JSON解析异常拖垮整个页面状态

适合人员

  • 负责前端草稿保存功能的工程师,需要处理localStorage中JSON草稿的异常恢复
  • 做数据粘贴板工具的开发者,需要解决用户粘贴JSON片段时的格式校验问题
  • 对接第三方接口的后端开发者,需要处理接口返回非JSON文本的兜底逻辑
  • 开发富文本编辑器的工程师,需要保障未保存内容恢复时的稳定性