Yup:JavaScript 里做数据校验,用它就够了

详解React Hook Form 和 Yup 实现输入表单的验证 阅读详情

Yup:JavaScript 里做数据校验,用它就够了

正文顶部截图

Yup 在 GitHub 上有 23.6K Star,是一个 JavaScript/TypeScript 的数据校验库。它的核心工作就一件事:定义数据的形状,然后在运行时检查输入是否符合这个形状。

前端表单提交、后端接口入参、配置文件解析,这些场景都离不开数据校验。Yup 的做法是让你用链式调用的方式把校验规则写出来,然后扔一个值进去,要么通过,要么报错。

能做什么

Yup 支持常见的数据类型:string、number、boolean、date、array、object、tuple。每种类型都有一套内置的校验方法。

举个例子,定义一个用户对象的校验规则:

import { object, string, number, date } from 'yup';

let userSchema = object({
  name: string().required(),
  age: number().required().positive().integer(),
  email: string().email(),
  website: string().url().nullable(),
  createdOn: date().default(() => new Date()),
});

写法很直白:string().required() 就是必填字符串,number().positive().integer() 就是正整数。链条可以任意组合,从简单到复杂的校验规则都能表达。

拿到数据之后调 validate 方法:

let user = await userSchema.validate(inputData);

如果数据不合法,直接抛 ValidationError,错误信息里包含字段路径和具体原因。

类型转换

Yup 不只是校验,还能做类型转换。从 JSON 或表单拿到的数据经常是字符串,Yup 可以帮你转成正确的类型:

let parsedUser = userSchema.cast({
  name: 'jimmy',
  age: '24',
  createdOn: '2014-09-23T19:25:25Z',
});
// { name: 'jimmy', age: 24, createdOn: Date }

age 从字符串 '24' 变成了数字 24,createdOn 从 ISO 字符串变成了 Date 对象。这个能力在处理 API 响应或表单数据时很实用。

还可以自定义转换逻辑:

let reversedString = string()
  .transform((currentValue) => currentValue.split('').reverse().join(''))
  .cast('dlrow olleh'); // "hello world"

转换函数组成管道,前一个的输出是后一个的输入。

TypeScript 支持

Yup 的 TypeScript 支持做得很到位。可以从 schema 直接推导出静态类型:

import { InferType } from 'yup';

type User = InferType<typeof userSchema>;
// {
//   name: string;
//   age: number;
//   email?: string | undefined
//   website?: string | null | undefined
//   createdOn: Date
// }

反过来也行,先定义 TypeScript 类型,再写 schema,让 Yup 检查两者是否一致。这样 schema 和类型之间的同步问题就解决了。

自定义校验

内置方法不够用的时候,可以用 test 方法加自定义规则:

string().test(
  'is-james',
  (d) => `${d.path} is not James`,
  (value) => value == null || value === 'James',
);

第一个参数是校验名称,第二个是错误信息,第三个是校验函数。校验函数返回 true 就通过,返回 false 就报错。

条件校验用 when 方法,可以根据某个字段的值动态调整另一个字段的规则:

string().when('otherField', {
  is: (val) => val > 0,
  then: (schema) => schema.required(),
  otherwise: (schema) => schema.optional(),
});

异步校验

Yup 内置了异步校验的支持。校验函数可以返回 Promise,比如去后端检查用户名是否已占用:

string().test('unique', '用户名已存在', async (value) => {
  const res = await checkUsername(value);
  return res.available;
});

调用 validate 本身就是异步的,返回 Promise,可以直接 await。

错误处理

校验失败时抛出的 ValidationError 包含详细信息:错误消息、字段路径、输入值。可以通过 inner 属性拿到所有字段的错误(对象校验时),也可以用 validateAt 只校验某个嵌套路径。

错误消息支持国际化,可以自定义模板或直接替换消息函数。

README区域截图

兼容 Standard Schema

Yup 支持 Standard Schema 规范。这意味着用 Yup 定义的 schema 可以被其他兼容 Standard Schema 的工具直接使用,不用额外适配。

适合谁用

用 JavaScript 或 TypeScript 做前后端开发的人,只要涉及表单校验、API 入参校验、配置文件解析,都可以考虑 Yup。它跟 React Hook Form、Formik 等表单库的配合也很成熟。如果你已经在用 Zod 想换个口味,Yup 的 API 设计风格不同,但功能覆盖面差不多。

ript 做前后端开发的人,只要涉及表单校验、API 入参校验、配置文件解析,都可以考虑 Yup。它跟 React Hook Form、Formik 等表单库的配合也很成熟。如果你已经在用 Zod 想换个口味,Yup 的 API 设计风格不同,但功能覆盖面差不多。

React表单开发的瑞士军刀:Formik与Yup实战指南 性能优化:使用useMemo包裹schema对象,避免重复创建错误聚焦:结合react-focus-on库实现首次提交后显示所有错误表单复用:将通用校验规则抽离为独立模块,如validations/user.js状态重置:formik.resetForm()替代手动清空字段渐进披露:根据touched状态实现分步验证提示移动端适配:配合react-hook-form的useFieldArray优化渲染日志监控:在onSubmitFail回调中捕获未处理的验证错误效率武器库。 阅读详情

相关推荐

Unity简单操作:PostProcessing的使用

Postprocessing是一个unity2018版本的集成后期插件,有了这个插件,之后用unity开发时,后期调整颜色、光晕等会很方便。 目录 新建一个postprocessing profile(配置文件)。​ 参数说明: 新建一个postprocessing profile(配置文件)。 在主相机下加一个组件PostProcess Layer。 注意:需要将相机的Layer层设置与Post Process Layer 下的Volume blending(体积混合)...

weixin_39114763的博客 7370

Yup 实用技巧:在 Web 开发中实现可靠的数据验证

在现代 Web 开发中,数据的准确性和完整性至关重要。无论是在前端表单数据提交阶段,还是后端 API 接收到的数据,都需要进行严格的校验,以确保数据的可靠性和安全性。Yup 是一个功能强大且易用的 JavaScript 验证库,它能以声明式的方式对数据结构进行验证,广泛应用于 React、Vue 等前端框架以及其他 JavaScript 应用中。本文将详细介绍 Yup 的功能及其在实际项目中的应用,帮助开发者更高效地进行数据校验。在实际开发中,默认的错误信息可能无法满足需求。});age: 16。

乐闻世界 2603

SAP-PM设备模块-PM主数据之功能位置

SAP-PM模块学习

TRUIXIANG的博客 5139

Vue and uniapp 表单校验之 yup:十分滴好用!

在前端开发中,表单校验是一个必不可少的环节。yup是一个强大的 JavaScript 表单校验库,能够帮助我们轻松实现复杂的表单校验逻辑。本文将详细介绍如何在 Vue 项目中使用yup进行表单校验。

qq_1401820561的博客 578

【开源训练数据集2】10个最适合机器学习的股票市场数据集

​随着加密货币在世界各地的兴起,人们现在有比以往更多的投资方式。然而,这并不像低买高卖那么简单。如果你能准确预测股市,你就会成为地球上最富有的人之一。因此,之前已经有关于如何利用情绪分析来预测股市的研究。对于那些希望构建类似预测模型的人,本文将介绍 10 个用于机器学习的股票市场和加密货币数据集。

u010542847的博客 2139

逆向分析踩坑记:当Frida在x86模拟器上‘看不见’ARM的so文件时,我们该如何手动定位与验证?

本文探讨了在x86模拟器上使用Frida进行逆向分析时,无法检测到ARM架构so文件的解决方案。通过分析内存映射、Frida的视觉盲区及手动定位技术,提供了兼容层、混合调试和原生ARM环境三种实用方案,帮助逆向工程师突破工具限制,实现精准定位与验证。

weixin_27697385的博客 225

Formik 与 Material UI 集成实战:基于 useFormik 与 Yup 构建带校验的登录表单

本指南以仓库中的 [examples/with-material-ui](https://link.gitcode.com/i/f63c28597d9cc259f5fedeebd963789c) 配套示例为核心,完整讲解如何将 Formik 与 Material UI 组件(TextField、Button)组合,构建一个带 Yup 校验的登录表单。通过阅读本文,你将掌握 `useFormik`

gitblog_00737的博客 757

openlayers全面教程306+【目录】

vue+openlayers系列教程旨在为开发者提供简单快捷的示例。在每一个示例中,解释相应的API知识点。

大剑师兰特的GIS世界 2万+

推荐开源项目:Yup - 精准的数据验证解决方案

在现代Web开发中,数据验证是确保应用健壮性和用户体验的关键环节。今天,我们将探索一个强大的数据解析和验证库——Yup,它为开发者提供了一种优雅的方式来构建运行时的值解析和验证模式。 ## 项目介绍 Yup是一个专为JavaScript和TypeScript设计的模式构建器,旨在简化从简单到复杂的输入数据的验证和转换过程。通过定义清晰的模式,Yup允许你不仅验证数据的有效性,还可以对其进行转换...

gitblog_00117的博客 829

Windows服务器环境下 OpenCode Skill 下载与运行全流程实战指南(小白版)

Windows服务器环境下 OpenCode Skill 下载与运行全流程实战指南(小白版),OpenCode技能安装与使用指南,分为四个步骤:1)准备Windows服务器环境并确认OpenCode可用;2)通过Git或直接下载方式获取Skill;3)配置技能路径至.opencode/config.json;4)运行测试技能。关键点包括路径配置必须使用双反斜杠、确保Python环境正确安装、管理员权限运行等。文中提供了文本总结技能的完整案例,从创建skill.yaml和main.py到注册运行的全流程,并针

专注于编程、AI、人工智能等多个领域内容研究和分析 1084

华为OD机试 - 小扇和小船的数字游戏 - 二进制(Python/JS/C/C++ 2024 C卷 200分)

二进制表示:任何数 n 的二进制表示中,要找到下一个有相同数量的1的数,我们需要在最低位的0后面的最低位的1进行操作。右侧交换法则:找到右侧的第一个0,位于第一个1的左边,将这个0变成1(提升这个位),并将这个1变成0(下移这个位)。调整尾部1:为了得到最小的数,将所有低于已交换的1的位重置,使得所有1尽可能靠右。

学Java,找哪吒 1163

Yup与Formik配合应用详解及2025年最新校验方法解析

本文深入解析了Yup与Formik在React表单验证中的协作机制。Formik负责表单状态管理和交互处理,Yup则专注于验证规则定义,二者结合提供声明式的表单解决方案。文章通过完整代码示例展示了实际应用场景,包括表单字段定义、Yup验证规则配置以及Formik的状态管理流程。随着技术发展,2025年已出现Zod等更先进的替代方案,开发者可根据项目需求选择最适合的验证工具。该内容为React开发者提供了从传统方案到最新技术的完整表单验证知识体系。

ya3288426755的博客 1043

5G无线关键技术 — 新型传输波形技术和先进编码与调制技术

目录 1、OFDM传输波形技术 2、滤波器组多载波 (Filterbank multicarrier:FBMC) 3、先进编码与调制技术 4、空间调制(Spatial Modulation SM) 5、频率正交幅度调制 1、OFDM传输波形技术 OFDM是当前Wi-Fi和LTE标准中的高速无线通信的主要传信模式。 LTECP配置 子载波间隔 CP长度Tcp 有用符号长度Tu CP比例..

Fanjufei的博客 2130

Yup对象模式验证:10个快速上手技巧与终极入门指南

Yup是一个简单而强大的JavaScript对象模式验证库,专门用于运行时值解析和验证。无论您是前端开发者还是Node.js工程师,Yup都能帮助您轻松处理表单验证、API数据校验等场景。在本文中,我们将分享10个实用的Yup验证技巧,帮助您快速掌握这个强大的工具。✨ ## 🚀 为什么选择Yup验证库? Yup被设计为"Dead simple Object schema validation

gitblog_00126的博客 1098

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版

Part-E1-SDIO-Specification-Ver4.00-Final-120220.pdf:最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版,包括SDIO 接口的外设,SDIO 接口官方协议等。

Unform表单验证指南:使用Yup实现高效校验

在现代Web应用开发中,表单验证是确保数据完整性和用户体验的关键环节。Unform作为一个专注于表单状态管理的库,采用了灵活的设计理念:它不内置验证功能,而是允许开发者自由选择最适合项目需求的验证方案。本文将深入探讨如何在Unform中集成Yup这一强大的验证库,实现专业级的表单验证功能。 ## 为什么选择Yup进行验证 Yup是一个功能强大且直观的JavaScript对象模式验证器,特别适合...

gitblog_00481的博客 343

Probability and Statistics - 4th edition

Probability and Statistics - 4th edition

React-formik、yup基本使用方法(建议收藏)

formik 概述 使用formik配合yup可以快速帮助我们实现表单校验并提示错误信息 // 安装 npm install formik --save // 在页面中引入 import { Form, Field, withFormik, ErrorMessage } from “formik” 官网地址:formik 基本使用 FORM formik的Form组件是围绕原生form标签的小包装,可以快速的重置表单或提交表单 使用 组件替代原生的标签 并且使用withFormik高阶组

Dt_man的博客 4566

Devexpress16.2.6破解工具

Devexpress16.2.6破解工具Devexpress16.2.6破解工具Devexpress16.2.6破解工具Devexpress16.2.6破解工具

终极Yup验证库完全指南:从零开始掌握JavaScript对象验证

在现代JavaScript开发中,数据验证是确保应用程序稳定性和安全性的关键环节。Yup作为一款简单高效的对象模式验证库,以其直观的API设计和强大的验证能力,成为开发者处理数据验证的首选工具。本文将深入解析Yup的核心架构、使用方法和最佳实践,帮助你快速掌握这一必备开发技能。 ## 为什么选择Yup进行数据验证? Yup采用"Dead simple Object schema validat

gitblog_00114的博客 492

React表单校验实战:用Formik+Yup构建高可用登录验证体系

表单校验是前端工程中连接用户体验与系统可靠性的关键环节,其本质是状态管理、规则执行与错误反馈的协同过程。在React生态中,原生useState易导致校验逻辑碎片化、错误映射失焦及提交控制失效;而Formik通过统一的状态契约(values/errors/touched/submitting)将校验抽象为可追踪、可调试的数据流,Yup则以声明式链式语法提供可序列化、可定位、可组合的业务规则表达能力。二者结合,不仅支撑L1即时反馈(如邮箱格式拦截)、L2规则同步(如密码强度校验)与L3服务端终审的分层防御体系

weixin_30800987的博客 381

终极 Yup 项目常见问题解决方案:轻松掌握对象 schema 验证技巧

在开发过程中,数据验证是确保应用程序稳定性和可靠性的关键环节。**Yup** 作为一款“Dead simple Object schema validation”库,为开发者提供了简洁而强大的对象 schema 验证解决方案。本文将深入探讨 Yup 项目中常见的问题及实用解决方案,帮助新手和普通用户快速上手并高效应用 Yup 进行数据验证。 ## 一、Yun 基础概念与安装 ### 1.1 什

gitblog_00511的博客 519

【参数校验】的实现方案:前端校验、后端校验、数据库校验

参数校验的实现可以根据具体的应用场景、技术栈和业务需求选择不同的方法。以下是几种常见的实现方式,以及在不同层次(如前端、后端、数据库层)上如何进行参数校验的指导。 1. 前端校验 2. 后端校验 3. 数据库层校验

宋冠巡的博客 2679

Yup验证库的10个核心特性:为什么成为开发者的首选

Yup是一个简单易用的对象模式验证库,专为JavaScript和TypeScript设计。作为"Dead simple Object schema validation"项目,Yup以其简洁的API和强大的功能赢得了开发者的青睐。在本文中,我们将深入探讨Yup的10个核心特性,揭示它为何成为前端开发中数据验证的首选工具。 ## 🔥 强大的TypeScript支持 Yup为TypeScript

gitblog_00463的博客 811

GitHub星标15万+的Yup项目

Yup是一个用于对象模式验证的JavaScript库,它的API设计简洁而强大,特别适合React、Vue等前端框架的表单验证需求。Yup以其简洁的API设计、强大的验证功能和出色的性能,确实当之无愧地成为了GitHub上最受欢迎的表单验证库之一。我用过很多验证库,但Yup的集成体验是最流畅的。.oneOf([yup.ref('password'), null], '两次密码不一致'),相比其他验证库,Yup的语法非常直观。yup.date().max(new Date()) // 不能晚于今天。

2509_93945468的博客 467

2025性能之王:Zod vs Joi vs Yup验证库极限对决

你还在为表单验证焦头烂额?用户输入错误导致系统崩溃?数据校验逻辑占代码量30%以上?本文通过3大场景12项指标,全方位测评当前最流行的Zod、Joi、Yup三大验证库,帮你选对工具节省90%调试时间。读完本文你将获得: - 真实场景下的性能对比数据 - 各库优缺点的深度解析 - 基于项目类型的选型指南 - 性能优化的实操技巧 ## 测试环境与方法 本次测评基于Node.js v20.10.0环...

gitblog_00692的博客 625

GitHub星标8万+的Yup项目

今天我们就来盘一盘!**链式调用真爽快**:支持`.string().email().min(5)`这样的流畅写法,代码可读性直接拉满。有开发者实测,改用Yup后校验代码量减少了**60%**。最近发布的v1.0版本还加入了**Schema组合继承**功能,老项目迁移也更顺滑了。**总结**:Yup的火爆绝非偶然,它用极致简洁的API解决了开发者多年的痛点。**体积小能量大**:Yup的压缩版仅有4KB,却提供了强大的校验能力。1. **中文文档友好**:详细的类型定义示例,连Ts类型提示都帮你生成好。

2509_93945572的博客 404

如何在Node.js中实现数据验证?

对于特定的验证需求,你可能需要编写自定义验证函数。示例代码if (!数据验证是确保Node.js应用安全和健壮性的关键步骤。你可以通过JavaScript内置类型检查、Node.js核心模块、第三方库或自定义函数来实现数据验证。选择合适的验证方法取决于你的具体需求和应用的复杂性。在设计验证逻辑时,务必考虑到数据的多样性和潜在的异常情况,以确保应用能够优雅地处理无效或恶意数据。最后问候亲爱的朋友们,并邀请你们阅读我的全新著作书籍详情。

有我更精彩的博客 908

Web 版翻译者资料库

本项目是桌面版《翻译者资料库》的 Web 移植版,基于 Spring Boot 3.3、Thymeleaf、Bootstrap 5.3 与 MySQL 8.0 构建。它面向翻译写作提供资料、词汇、句库、文本工具、对照制作、查找、备份恢复及旧库迁移等功能,完整继承桌面版核心业务规则,支持一键启动与离线访问。

howard2005的专栏 199
上一篇: React 面试题库:44k Star 的面试备战手册
下一篇: Coding Interview University:35 万人用过的面试备战指南
普通网友
博客等级 码龄151天 0粉丝 16原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值