SuperAPI AI 工具集

zod4

通用与其它

查看项目

更新于 10-15 23:44

技能介绍

用途:本技能面向使用 Zod 4 进行数据模式校验的开发者,适用于从 Zod 3 迁移、学习 Zod 4 惯用写法或新建校验逻辑的场景。

主要能力:梳理 Zod 4 的高影响破坏性变更,包括 z.record() 需两个参数(z.record(z.string(), z.string()))、.strict() 改为 z.strictObject({...})、.passthrough() 改为 z.looseObject({...})、err.format() 改为 z.treeifyError(err)、z.coerce 的输入类型由 string 变为 unknown;说明 .default() 行为变化(输入为 undefined 时直接返回默认值而不解析,需用 .prefault() 保留旧行为)。同时介绍新特性:z.file() 文件校验(.min/.max/.mime)、z.templateLiteral() 模板字面量类型、.meta() 模式元数据、z.globalRegistry 全局注册表、z.locales 国际化错误信息,以及体积更小、可 tree-shaking 的函数式 API Zod Mini(zod/mini,如 z.pipe、z.minLength、z.regex 等)。

使用方式:安装命令为 npm install zod@^4.0.0。迁移可按模式进行:替换 z.record 调用、将 .strict() 改为 z.strictObject、将错误格式化改为 z.treeifyError、修正 .default() 与输出类型不匹配的问题。社区 codemod 可用 npx zod-v3-to-v4 自动修复部分破坏性变更。

适用场景与限制:适合 TypeScript 项目的数据校验、表单与 API 输入校验及版本升级。资料未提供性能基准、包体积具体数值、各平台兼容性及收费信息;具体细节需参考官方文档与迁移指南。