SuperAPI AI 工具集

ts-zod-v4

编程与开发

查看项目

更新于 10-16 05:53

技能介绍

用途:这是面向 Zod 4(TypeScript/JavaScript)使用场景的参考手册技能,作为仓库内 Zod 4 用法的参考来源。资料基于 zod@4.6.5(release v4.6.5,commit 59bbc03e10c636b9eb3c393dfeb552819774ec21)。

主要能力:覆盖定义首个模式、解析数据、推断类型;字符串格式校验(email、UUID、URL、ISO datetime);对象形态控制(z.object、strictObject、looseObject、catchall、partial、deepPartial);集合类型(数组、元组、记录、映射、集合);联合与可空性(optional、nullable、nullish、xor、判别联合);递归模式;自定义校验(refine、superRefine、check);转换与预处理(preprocess、transform、pipe);默认值与兜底(default、prefault、catch);编解码(z.codec、z.decode、z.encode);错误定制与格式化(z.treeifyError、z.flattenError、z.prettifyError);JSON Schema 转换(z.toJSONSchema、z.fromJSONSchema);元数据与注册表;特殊类型(instanceof、file、function、branded、readonly)。另含编译校验相关主题(validate、validateAsync、compile)。

使用方式:资料建议不要按顺序通读,而是先选定一个目标文件:宽泛任务从 sections/.md 入手,窄的 API 问题从 topics/.md 入手;仅当首个文件无法回答时才沿 See also 继续。默认使用 zod 包,只有用户明确要求时才使用 zod/mini、@zod/mini 或 zod/v4/core。

适用场景:API 请求或响应校验、由模式驱动的配置、表单或环境变量校验、同一模式复用于运行时解析与静态类型、调试 ZodError 与面向用户的错误信息、将 Zod 模式转为 JSON Schema 或附加元数据。

限制:除上述内容外,安装命令、收费、价格等信息暂未提供;资料提示除非用户明确要求,否则忽略 release notes、版本管理、迁移与库作者内部实现。