SuperAPI AI 工具集

zod-validation-utilities

编程与开发

查看项目

更新于 10-15 21:52

技能介绍

用途:为 TypeScript 服务提供生产可用的 Zod v4 模式,以较少样板代码实现可复用、类型安全的校验,适合在请求/响应边界、表单和配置加载处解析不可信输入。

主要能力:使用 z.uuid、z.email、z.url 等现代原始类型并配合 error 选项自定义错误信息;通过 z.coerce.* 在边界处做强制类型转换;用 preprocess、transform 处理未知输入;用 refine/superRefine 表达跨字段与业务规则;支持 optional、nullable、nullish、default;支持可辨识联合、数组、记录、元组等复杂结构;导出 schema 及 z.input/z.output 推断类型;可与 React Hook Form 的 zodResolver 集成。

使用方式:在处理器、队列或配置加载器等边界定义 schema;用 safeParse 优雅处理错误(检查 result.success,失败时读取 result.error,成功时使用带类型推断的 result.data),或对需快速失败的场景用 parse;共享 id、email、slug、日期、分页等小工具 schema 减少重复。

适用场景:TypeScript 服务的请求/响应校验、API 与表单输入解析、环境变量与外部系统数据校验、团队内统一强制转换与转换规则。

限制:示例针对 Zod v4,需与已安装主版本匹配;可辨识联合要求各变体具有稳定的判别键;强制类型转换可能掩盖上游数据问题,应补充边界与 refine;避免过度使用 preprocess,优先显式 z.coerce.*。详细高级模式与复杂表单工作流需参考 references/advanced-patterns.md。