SuperAPI AI 工具集

zod-4

数据与分析

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能面向使用 Zod 进行数据校验与类型安全的开发场景,触发条件包括校验数据、定义 schema、处理表单,或从 Zod 3 迁移到 Zod 4。

主要能力与关键变更:Zod 4 引入顶层校验器,如 z.email()、z.url()、z.uuid(),取代 v3 的 z.string().email() 等链式写法;用 z.string().min(1) 替代 nonempty();错误配置统一为 error 字段,取代 required_error。技能还覆盖基本 schema(字符串、数字、布尔、日期、枚举、对象)、parse 与 safeParse 的区别、数组/Record/元组/可辨识联合、transform 转换、refine 与 superRefine 自定义及跨字段校验,以及 API 输入输出 schema 的写法。

使用方式:通过 z.infer<typeof Schema> 从 schema 推导 TypeScript 类型;用户输入校验应使用 safeParse,parse 仅在异常是正确错误处理策略时使用;表单场景配合 react-hook-form 的 zodResolver,且 schema 需定义在组件外部以避免每次渲染重建。

适用场景:校验用户输入、定义数据 schema、React Hook Form + Zod 表单集成、Zod 3 迁移。

限制与规则:该技能专门针对 Zod v4,应用前需确认已安装版本;schema 应定义为具名常量而非内联;避免用 any 替代类型推导;不要对不可信数据直接 parse 而不处理错误。资料未提供安装命令、版本号、收费与平台信息。