本文介绍了一个仅用一百行JavaScript代码实现的轻量级校验工具Coi。该工具借鉴Joi的设计思路，支持链式调用，通过data、isRequired、minLength等方法简化前端字段校验逻辑，提升代码可维护性。
校验工具背景与目标
在处理数据校验需求时，开发者通常会感到繁琐。
复杂的规则与大量的字段校验工作给前端开发带来了显著的工作负担。
若处理不当，代码中容易充斥大量难以维护的if-else语句。
因此，团队或项目中引入一个统一的校验工具，有助于简化开发流程。
首先，参考Joi库的设计：
Joi.string().alphanum().min(3).max(30).required()
期望我的校验工具Coi也支持链式调用，这能大幅简化代码结构。
校验过程主要涉及三个输入参数：待校验的数据、错误提示信息以及具体的校验规则。
Coi工具实现与使用
直接展示代码实现，总共一百行，逻辑清晰：
export default class Coi {
constructor(prop) {
this.input = prop
this.errorMessage = '通过校验' // 错误信息
this.pass = true // 校验是否通过
}
// 数据输入
data(input) {
if (!this.pass) return this
this.input = input
return this
}
// 必填，不能为空
isRequired(message) {
if (!this.pass) return this
if (
/^\s*$/g.test(this.input) ||
this.input === null ||
this.input === undefined
) {
this.errorMessage = message
this.pass = false
}
return this
}
// 最小长度
minLength(length, message) {
if (!this.pass) return this
if (this.input.length < length) {
this.errorMessage = message
this.pass = false
}
return this
}
// 最大长度
maxLength(length, message) {
if (!this.pass) return this
if (this.input.length > length) {
this.errorMessage = message
this.pass = false
}
return this
}
// 需要的格式 number: 数字, letter: 字母, chinese: 中文
requireFormat(formatArray, message) {
if (!this.pass) return this
let formatMap = {
number: 0,
letter: 0,
chinese: 0
}
Object.keys(formatMap).forEach(key => {
if (formatArray.includes(key)) formatMap[key] = 1
})
let formatReg = new RegExp(
`^[${formatMap.number ? '0-9' : ''}${
formatMap.letter ? 'a-zA-Z' : ''
}${formatMap.chinese ? '\u4e00-\u9fa5' : ''}]*$`
)
if (!formatReg.test(this.input)) {
this.errorMessage = message
this.pass = false
}
return this
}
// 邮箱校验
isEmail(message) {
if (!this.pass) return this
const emailReg = /^[a-z0-9]+([._\\-]*[a-z0-9])*@([a-z0-9]+[-a-z0-9]*[a-z0-9]+.){1,63}[a-z0-9]+$/
if (!emailReg.test(this.input)) {
this.errorMessage = message
this.pass = false
}
return this
}
// ulr校验
isURL(message) {
if (!this.pass) return this
const urlReg = new RegExp(
'^(?!mailto:)(?:(?:http|https|ftp)://|//)(?:\\S+(?::\\S*)?@)?(?:(?:(?:[1-9]\\d?|1\\d\\d|2[01]\\d|22[0-3])(?:\\.(?:1?\\d{1,2}|2[0-4]\\d|25[0-5])){2}(?:\\.(?:[0-9]\\d?|1\\d\\d|2[0-4]\\d|25[0-4]))|(?:(?:[a-z\\u00a1-\\uffff0-9]+-?)*[a-z\\u00a1-\\uffff0-9]+)(?:\\.(?:[a-z\\u00a1-\\uffff0-9]+-?)*[a-z\\u00a1-\\uffff0-9]+)*(?:\\.(?:[a-z\\u00a1-\\uffff]{2,})))|localhost)(?::\\d{2,5})?(?:(/|\\?|#)[^\\s]*)?$',
'i'
)
if (!urlReg.test(this.input)) {
this.errorMessage = message
this.pass = false
}
return this
}
// 自定义正则校验
requireRegexp(reg, message) {
if (!this.pass) return this
if (!reg.test(this.input)) {
this.errorMessage = message
this.pass = false
}
return this
}
}具体使用方式如下：
import Coi from 'js-coi'
const validCoi = new Coi()
validCoi
.data('1234')
.isRequired('id不能为空')
.minLength(3, 'id不能少于3位')
.maxLength(5, 'id不能多于5位')
.data('1234@qq.')
.isRequired('邮箱不能为空')
.isEmail('邮箱格式不正确')
.data('http:dwd')
.isRequired('url不能为空')
.isUrl('url格式不正确')
if (!validCoi.pass) {
this.$message.error(validCoi.errorMessage)
return
}若仅需校验单个字段，也可采用以下用法：
import Coi from 'js-coi'
const idCoi = new Coi('1234')
idCoi
.isRequired('id不能为空')
.minLength(3, 'id不能少于3位')
.maxLength(5, 'id不能多于5位')
.isEmail('id邮箱格式不正确')
.isUrl('id格式不正确')
.requireFormat(['number', 'letter', 'chinese'], 'id格式不正确')
.requireRegexp(/012345/, 'id格式不正确')
if (!idCoi.pass) {
this.$message.error(idCoi.errorMessage)
return
}总结
以上介绍了基于JavaScript实现的一个百行代码校验工具，希望能为相关开发工作提供参考。如有疑问，欢迎留言交流。感谢支持。