跳转到正文

JSON 转 Zod

根据 JSON 示例生成 Zod schema。嵌套对象会成为单独导出的 schema,部分数组项中缺失的键会变为 .optional(),null 值会变为 .nullable(),混合值会变为 z.union。每个 schema 还会生成一个 z.infer 类型别名,只需粘贴一次即可同时获得运行时验证和 TypeScript 类型。

重置

常见问题

嵌套对象如何命名?

每个嵌套对象都会成为独立的 Zod 类型,并以包含它的键名转换为 PascalCase 后命名,例如 address 会变为 Address。数组中的对象会使用数组键名的单数形式,例如 users 会变为 User。字段完全相同的对象会共用同一个类型。

字段在什么情况下会是可选的?

当数组中包含多个对象,且某个键在部分对象中缺失时,该字段就是可选的:schema 会添加 .optional()。每个示例中都存在的键为必填项。单个对象没有可供比较的对象,因此其中所有键都是必填项。

如何处理 null 值?

如果某个键在部分示例中为 null,在其他示例中有值,它会变为原类型后接 .nullable()。如果某个键始终为 null,工具就无法得知它的实际类型,因此会将其变为 z.null();粘贴包含实际值的示例即可生成精确类型。

会使用哪些数字类型?

整数会变为 z.number().int(),带小数的数字会变为 z.number()。同一字段同时包含两者时,schema 会使用 z.number(),因为所有整数也都是有效的数字。

如何处理无效名称的键?

键名如果不是有效的 JavaScript 标识符,例如 first-name,就会在 z.object 中加上引号,因此 schema 仍会与原始 JSON 键名完全匹配。

我的 JSON 会被上传或存储吗?

JSON 仅会发送到服务器以便为此次请求生成代码,不会被存储。生成器只会读取示例的结构和值类型,因此你可以在粘贴前将敏感值替换为类型相同的占位值。

关于 OneClick Pro

OneClick Pro 是一个免费的工具集合,包含超过 150 种网络工具,助你处理日常工作:转换图像和单位、格式化和验证代码、检查域名和 SEO,以及处理文本、日期和数字。所有工具均可免注册、免订阅使用;你输入的内容仅用于计算结果,绝不会被存储。你可以将它用作处理临时任务的快捷工具箱,也可以收藏每天都会用到的工具。