Valibot：轻量级且模块化的数据验证库

Valibot：轻量级且模块化的数据验证库

valibotThe modular and type safe schema library for validating structural data 🤖项目地址:https://gitcode.com/gh_mirrors/va/valibot

项目介绍

Valibot 是一个创新的开放源代码项目，旨在提供一种新的方式来验证结构化数据。它重量级不到1KB（压缩后），对比Zod、Ajv、Joi和Yup等同类工具，Valibot通过其模块化API设计和代码压缩优化，在保持功能强大同时也实现了极致的小型化。无依赖性使其适用于任何JavaScript或TypeScript项目，能够帮助开发者轻松地根据定义的模式对数据进行校验。

项目快速启动

要快速开始使用Valibot，首先确保你的开发环境安装了Node.js。接下来，可以通过npm或yarn将Valibot添加到项目中：

npm install valibot --save
# 或者，如果你偏好yarn
yarn add valibot

随后，你可以开始定义并使用验证规则，例如，验证一个邮箱地址是否符合特定域：

import { email, endsWith, string } from 'valibot';

// 定义邮箱验证模式
const EmailSchema = string([email(), endsWith('@example.com')]);

// 使用模式验证数据
try {
  const validEmail = EmailSchema.parse('test@example.com');
  console.log('邮箱有效:', validEmail);
} catch (error) {
  console.error('邮箱无效:', error.message);
}

应用案例与最佳实践

邮箱验证场景

在Web表单提交时，利用Valibot可以轻松实现复杂但清晰的邮箱验证逻辑，不仅检查格式，还能定制化限制如特定域名。

// 验证用户输入邮箱是否符合特定公司域名
const validateUserInput = (input) => {
  try {
    EmailSchema.parse(input);
    return true;
  } catch {
    return false;
  }
};

console.log(validateUserInput('user@example.com')); // 返回true
console.log(validateUserInput('wrong@domain.com')); // 返回false

类型安全与合并对象模式

利用TypeScript的相似特性，Valibot支持创建复杂的模式，包括使用partial、required来控制字段的可选性，以及使用merge和pick/omit来组合或筛选模式中的字段，以适应不同层次的数据验证需求。

典型生态项目集成

虽然Valibot本身是独立的，但在现代Web开发框架和库中集成非常灵活，特别适合于那些追求性能与轻量化需求的项目，比如与SolidJS, Qwik, 或 Preact这些重视初始加载速度和内存占用的框架搭配使用。在这些框架下，Valibot可以帮助构建更健壮的数据验证层，尤其是在实施头手分离（headless）架构的电商网站、营销着陆页等项目中，保证前端数据的有效性和一致性。

由于Valibot的通用性和轻量级特性，将其融入任何JavaScript/TypeScript项目中都是一个提升数据验证效率和代码质量的选择。在实践中，开发者应该根据具体的应用场景选择合适的数据模型和验证策略，充分利用Valibot提供的灵活性和高效性，确保应用的数据处理既安全又高效。

valibotThe modular and type safe schema library for validating structural data 🤖项目地址:https://gitcode.com/gh_mirrors/va/valibot