Valibot 中如何验证日期字段的先后关系

在表单验证场景中，经常需要验证两个日期字段的先后关系。本文将以 Valibot 这个 TypeScript 校验库为例，演示如何实现"截止时间必须早于或等于服务时间"的业务规则验证。

基础场景分析

假设我们有一个包含两个日期字段的 Schema 定义：

export const PlannedDishSchema = v.object({
  servingTime: v.pipe(v.date()),
  closingTime: v.pipe(v.date()),
})

业务需求是确保 closingTime 不大于 servingTime。这种跨字段的验证在 Valibot 中可以通过组合使用高级验证器来实现。

验证方案实现

方案一：使用 forward 和 partialCheck

对于可能存在未定义属性的场景，推荐使用 forward 和 partialCheck 的组合：

const PlannedDishSchema = v.object({
  servingTime: v.pipe(v.date()),
  closingTime: v.pipe(v.date()),
}).pipe(
  v.forward(
    v.partialCheck((input) => {
      if (input.closingTime > input.servingTime) {
        return {
          issue: {
            validation: 'date',
            message: '截止时间必须早于或等于服务时间',
            input: input.closingTime,
          },
        }
      }
      return { output: input }
    })
  )
)

这种方案的优点：

1. 处理了可能存在的未定义属性
2. 提供了清晰的错误信息
3. 保持了类型安全

方案二：使用 check 验证器

如果确定所有属性都有默认值且不会为 undefined，可以使用更简单的 check 验证器：

const PlannedDishSchema = v.object({
  servingTime: v.pipe(v.date()),
  closingTime: v.pipe(v.date()),
}).pipe(
  v.check((input) => input.closingTime <= input.servingTime)
)

技术要点解析

1. forward 验证器：允许在对象验证后执行额外的验证逻辑
2. partialCheck：专门用于处理可能包含未定义属性的对象验证
3. check：简单的布尔条件验证，适用于确定类型的场景

最佳实践建议

1. 根据数据完整性选择验证方案：

   • 不确定属性是否完整时使用 partialCheck
   • 确定类型完整时使用 check

2. 错误信息设计：

   • 提供明确的错误提示
   • 包含验证失败的字段值

3. 性能考虑：

   • 简单的条件验证优先使用 check
   • 复杂场景才使用 forward + partialCheck 组合

通过合理使用 Valibot 的这些高级验证功能，可以优雅地实现各种复杂的业务规则验证需求。