Valibot 中获取对象模式键名的两种方法

Valibot 是一个用于数据验证的 TypeScript 库，它提供了强大的模式定义功能。在实际开发中，我们经常需要从定义好的模式中提取键名数组，这在动态表单生成、数据映射等场景下非常有用。

使用 keyof 方法获取类型安全的键名数组

Valibot 提供了 v.keyof() 方法，可以专门用于从对象模式中提取键名。这种方法不仅能获取键名数组，还能保持 TypeScript 的类型安全：

const fields = v.keyof(BoardSchema).options;
// 类型为 ["title", "icon", "background"]

这种方法的特点是：

1. 返回的数组元素类型是具体的字符串字面量类型
2. 完全类型安全，TypeScript 能正确推断每个键名的类型
3. 保留了 as const 的效果，适合需要精确类型的场景

使用 Object.keys 获取简单键名数组

如果你不需要严格的类型安全，也可以使用传统的 JavaScript 方法：

const fields = Object.keys(BoardSchema.entries);
// 类型为 string[]

这种方法的特点是：

1. 简单直接，不依赖特定库方法
2. 返回类型为通用的 string[]
3. 适合不需要严格类型检查的简单场景

两种方法的比较与选择建议

1. 类型安全需求：如果需要严格的类型检查，确保后续代码能正确识别每个键名，应选择 v.keyof().options 方法。

2. 性能考虑：Object.keys 是原生 JavaScript 方法，理论上性能略优，但在大多数应用中差异可以忽略。

3. 代码可读性：v.keyof() 方法更明确表达了"从模式中获取键名"的意图，代码语义更清晰。

4. 使用场景：

   • 动态表单生成：推荐使用 v.keyof() 确保类型安全
   • 简单日志或调试：Object.keys 可能更简洁

Valibot 的这两种方法为开发者提供了灵活的选择，可以根据具体需求决定使用哪种方式获取对象模式的键名。