Superstruct 中如何定义带正则和长度限制的字符串结构

在 TypeScript 项目中，数据验证是一个常见需求。Superstruct 作为一个强大的运行时类型检查库，提供了灵活的方式来定义数据结构约束。本文将重点介绍如何同时使用正则表达式和长度限制来定义字符串结构。

基本字符串验证

Superstruct 提供了 string() 基础验证器来确保值是字符串类型。但实际业务场景中，我们通常需要更复杂的验证规则。

组合验证器

Superstruct 的强大之处在于验证器的可组合性。我们可以通过 pattern 和 size 验证器的组合来实现复杂的字符串验证：

import { string, pattern, size } from 'superstruct'

// 定义邮箱正则
const emailRegex = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/

// 组合验证：必须符合邮箱格式且长度在5-50字符之间
const EmailStruct = size(
  pattern(string(), emailRegex),
  5,  // 最小长度
  50  // 最大长度
)

实际应用示例

假设我们需要验证用户姓名，要求：

1. 符合特定命名规则（如只允许字母和连字符）
2. 长度在2-40个字符之间

可以这样定义结构：

import { object, string, pattern, size } from 'superstruct'

// 姓名正则：允许字母、空格和连字符
const nameRegex = /^[a-zA-Z\- ]+$/

const UserNameStruct = object({
  firstName: size(pattern(string(), nameRegex), 2, 40),
  lastName: size(pattern(string(), nameRegex), 2, 40)
})

验证顺序的重要性

Superstruct 会按照验证器的组合顺序执行验证。在上面的例子中：

1. 首先检查值是否为字符串
2. 然后验证是否符合正则表达式
3. 最后检查长度是否在指定范围内

这种顺序确保了验证的高效性 - 如果前一步验证失败，后续验证就不会执行。

性能考虑

对于复杂的验证场景，特别是高频调用的验证逻辑，建议：

1. 尽量使用简单的正则表达式
2. 将最可能失败的验证放在前面
3. 考虑将复杂验证拆分为多个简单验证

Superstruct 的这种组合式验证方式既保持了灵活性，又能通过合理的验证器排序来优化性能。

总结

通过 Superstruct 的验证器组合功能，我们可以轻松构建出既符合业务需求又具备良好性能的数据验证结构。正则表达式与长度限制的组合只是其中一个典型应用场景，开发者可以根据实际需求灵活组合各种验证器。