用途:帮助在需要校验数据、创建模式、解析输入时正确使用 Valibot 这一模块化、类型安全的模式校验库,也可用于从 Zod 迁移。
主要能力:覆盖基础模式(string、number、object、array、tuple、union、variant、picklist 等);通过 pipe 组合校验与转换动作,如 email、url、minLength、minValue、integer、trim、toLowerCase、transform;支持 optional、nullable、nullish 及默认值;支持对象 pick、omit、partial、required;支持 safeParse、is 类型守卫、异步 pipeAsync 与 parseAsync、递归 lazy、fallback 与错误展平 flatten;可通过 @valibot/to-json-schema 转换为 JSON Schema。
用法:常用安装命令 npm install valibot、yarn add valibot、pnpm add valibot、bun add valibot。推荐通配符导入 import * as v from "valibot",或用具名导入。解析用 v.parse(schema, data) 或 v.safeParse(schema, data);模式是第一参数,动作用于 pipe 内。
限制与注意:Valibot 与 Zod API 不同,不可混用;Valibot 用函数与管道而非链式方法,optional 等以包裹形式书写,默认值通过第二参数传入。异步校验需用 pipeAsync 配合 parseAsync。以上内容依据给定资料,未涉及的收费或平台信息暂未提供。