Valibot中Optional默认值的行为解析

2025-05-29 14:21:52作者：薛曦旖Francesca

Valibot是一个用于数据验证的JavaScript库，它提供了丰富的验证器和类型转换功能。在使用过程中，开发者可能会对optional验证器的默认值行为产生疑问。本文将详细解析Valibot中optional验证器的工作机制，并介绍如何正确实现字段默认值功能。

Optional验证器的默认行为

Valibot的optional验证器设计用于处理可能为undefined的字段。它的核心行为是：

当输入值为undefined时，会使用开发者提供的默认值
对于其他所有值（包括空字符串、null、0等），都会保留原始值不变

这种设计决策基于类型安全的考虑，确保开发者明确知道哪些情况下会使用默认值。例如：

const Schema = v.object({
  email: v.optional(v.string(), 'test@example.com')
});

// 当email为undefined时，会使用默认值
v.parse(Schema, {}); // { email: 'test@example.com' }

// 当email为空字符串时，保留空字符串
v.parse(Schema, { email: '' }); // { email: '' }

实现真正的默认值功能

如果需要实现"当值为空时使用默认值"的功能，Valibot提供了更灵活的组合方式。可以使用pipe和transform来实现：

const Schema = v.object({
  email: v.pipe(
    v.string(),
    v.transform((value) => value || 'test@example.com')
  )
});

// 空字符串会被替换为默认值
v.parse(Schema, { email: '' }); // { email: 'test@example.com' }

这种实现方式更加灵活，可以根据业务需求自定义"空值"的判断逻辑。例如：

// 自定义空值判断
const DefaultString = (defaultValue) => 
  v.pipe(
    v.string(),
    v.transform((value) => value.trim() === '' ? defaultValue : value)
  );

const Schema = v.object({
  name: DefaultString('Anonymous')
});