SuperAPI AI 工具集

json-safety

前端与建站

查看项目

更新于 10-16 05:47

技能介绍

用途:这是一条前端代码审查规则,主题是“带错误处理地安全解析 JSON”。它适用于审查脚本、客户端组件、打包产物以及与 JSON 解析相关的运行时行为,同时检查源码和浏览器执行路径。

主要能力:

  1. 找出文件中所有 JSON.parse() 调用,检查是否被 try/catch 包裹,以及结果在使用前是否经过校验。
  2. 为所有 JSON.parse() 调用补充 try/catch 错误处理,并增加结构校验,防止意外数据结构导致问题。
  3. 解释 JSON.parse 为何会抛错、安全解析应是什么样,以及何时使用 schema 校验库。
  4. 代码审查时标记违反规则的导入、事件处理器、运行时副作用或阻塞操作,并说明如何在浏览器中验证改动。

要点:JSON.parse() 对非法输入抛 SyntaxError,未捕获会崩溃;API 响应、localStorage 值、用户数据都可能格式错误。应在解析处捕获错误,而非等到应用逻辑深处因缺失属性报错。解析后先校验数据形状再访问属性。JSON.stringify() 对无法序列化的值可能返回 undefined。来自外部源的数据建议使用类型安全解析器(Zod、Valibot)。

使用方式:按 Check、Fix、Explain、Code Review 四种模式执行。完整实现细节、代码示例与框架相关指引见 references/rule.md。规则页:https://frontendchecklist.io/rules/javascript/json-safety

限制:资料未提供具体代码示例、框架适配细节、安装命令或收费信息。