用途:处理 z-schema 校验产生的错误,供应用层展示或程序化消费。z-schema 以 ValidateError 抛出错误,其 .details 为 SchemaErrorDetail 数组,本技能围绕该结构展开。
主要能力:每个 SchemaErrorDetail 含 message、code、params、path、keyword、inner、schemaPath、schemaId、title、description。可通过 try/catch 捕获 ValidateError,或用 validateSafe 返回 { valid, err } 安全模式。combinator(anyOf、oneOf、not)会产生 inner 嵌套错误,可用递归 walkErrors 遍历,或用 collectLeafErrors 拍平得到全部叶子错误。可将 JSON Pointer 路径转为点号字段名,生成 Record<string, string[]> 的表单字段错误映射。
用法:创建校验器时可用 ZSchema.create({ reportPathAsArray: true }) 让 path 返回数组,或用 breakOnFirstError: true 只报首个错误。校验时可传 includeErrors 或 excludeErrors 过滤错误码;也可事后用 filter 按 code 筛选。可建立 code 到友好文案的映射函数,覆盖 INVALID_TYPE、OBJECT_MISSING_REQUIRED_PROPERTY、MINIMUM、MAXIMUM、MIN_LENGTH、MAX_LENGTH、PATTERN、ENUM_MISMATCH、INVALID_FORMAT 等,未命中则回退 detail.message。keyword 字段可用于按触发关键字分类。
适用场景:表单校验错误展示、API 错误响应整理、批量数据校验结果过滤与去噪。
限制:资料未提供该技能的具体安装方式、平台范围与收费信息;完整错误码列表需参考 validating-json-data 技能的 error-codes 参考文件。