SuperAPI AI 工具集

zod

办公与效率

查看项目

更新于 10-16 02:35

技能介绍

用途:为项目提供 Zod v4 的 schema 校验支持,用于定义数据模式、校验输入并用 parse、safeParse、parseAsync、safeParseAsync 解析,同时通过 z.infer 推断 TypeScript 类型。

主要能力:提供基础类型(string、number、boolean、bigint、date、undefined、null、void、any、unknown、never);v4 顶层字符串格式(z.email()、z.url()、z.uuid()、z.cuid()、z.cuid2()、z.ulid()、z.nanoid()、z.ipv4()、z.ipv6()、z.base64()、z.emoji())与 ISO 日期时间(z.iso.date()、z.iso.time()、z.iso.datetime()、z.iso.duration());字符串与数字约束(min、max、length、regex、trim、toLowerCase、int、positive、multipleOf、safe 等);对象、数组、元组、枚举、联合、判别联合、字面量、记录与映射,以及 partial、required、pick、omit、extend、merge、passthrough、strict、strip 等修饰;optional、nullable、nullish、default、catch;z.coerce 系列转换与 z.stringbool() 字符串布尔解析;transform、overwrite、refine、superRefine;类型推断支持 z.infer、z.input、z.output。

使用方式:在代码中从 'zod' 导入 z,定义 schema 后调用 parse 或 safeParse 校验;错误处理建议用 safeParse 获取 success 与 error 结果;复杂多字段校验用 superRefine 或多次 refine。注意 v4 与 v3 语法差异,如 z.email() 替代 z.string().email(),v3 链式写法已弃用。

适用场景:表单校验、API 响应校验、环境变量解析等。限制:资料未提供安装命令、版本发布信息与完整错误处理示例;实际行为以官方文档为准。