浏览器与 Web API / 系统课时
约束验证与自定义错误
约束验证与自定义错误
浏览器原生约束验证可以在不引入表单库的情况下处理必填、格式和字段间一致性。本课将把 HTML 约束、ValidityState、checkValidity() 与 setCustomValidity() 串成一套可运行流程,并说明怎样避免自定义错误无法清除的问题。
学习目标
- 使用
required、type和pattern声明字段约束 - 读取
ValidityState并区分常见失败原因 - 使用
checkValidity()、reportValidity()和setCustomValidity()完成自定义验证
浏览器如何生成验证状态
表单控件会把声明式约束转换为一个只读的 validity 对象。valueMissing 表示必填值为空,typeMismatch 表示邮箱等内置类型不匹配,patternMismatch 表示未通过正则约束,customError 则来自 setCustomValidity()。只有所有失败标记都为 false 时,validity.valid 才为 true。

checkValidity() 只返回布尔结果,并会让无效控件触发 invalid 事件;reportValidity() 还会请求浏览器显示原生错误提示。提示文案和样式由浏览器决定,因此业务上需要固定文案时,应使用 setCustomValidity(),再配合页面中的错误区域呈现。
完整示例:组合原生约束与字段间验证
下面的页面同时验证邮箱、订单编码和两次密码。订单编码要求三个大写字母、一个短横线和四位数字;确认密码属于跨字段规则,无法只靠 HTML 属性表达,因此由 JavaScript 设置自定义错误。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>约束验证示例</title>
</head>
<body>
<form id="signupForm" novalidate>
<label>
邮箱
<input name="email" type="email" required>
</label>
<label>
订单编码
<input name="orderCode" required pattern="[A-Z]{3}-[0-9]{4}">
</label>
<label>
密码
<input id="password" name="password" type="password" required minlength="8">
</label>
<label>
确认密码
<input id="confirmPassword" type="password" required>
</label>
<button type="submit">验证并提交</button>
</form>
<p id="result" aria-live="polite"></p>
<script>
const form = document.querySelector('#signupForm');
const password = document.querySelector('#password');
const confirmPassword = document.querySelector('#confirmPassword');
const result = document.querySelector('#result');
function syncPasswordError() {
const hasMismatch =
confirmPassword.value !== '' &&
confirmPassword.value !== password.value;
// 空字符串会清除上一次设置的 customError。
confirmPassword.setCustomValidity(
hasMismatch ? '两次输入的密码不一致' : ''
);
}
password.addEventListener('input', syncPasswordError);
confirmPassword.addEventListener('input', syncPasswordError);
form.addEventListener('submit', (event) => {
event.preventDefault();
syncPasswordError();
if (!form.checkValidity()) {
form.reportValidity();
result.textContent = '验证失败:请修正表单中的错误';
return;
}
result.textContent = '验证通过:可以进入实际提交逻辑';
});
</script>
</body>
</html>预期结果
输入 abc@example.com、ABC-2026 和两次相同的八位以上密码:
验证通过:可以进入实际提交逻辑
订单编码填写 abc-26,或两次密码不同:
验证失败:请修正表单中的错误把代码保存为 validation.html 后直接用浏览器打开即可。不同浏览器展示的气泡样式可能不同,但页面中的结果文本应与上述分支一致。
读取 ValidityState 定位错误
同一控件可能同时受多条规则影响,页面自定义提示应按“空值、内置类型、格式、业务规则”的顺序选择,避免字段为空时先显示格式错误。常用状态可以直接从 input.validity 读取。
| 状态 | 含义 | 适合的提示 |
|---|---|---|
valueMissing |
必填控件没有值 | 此项不能为空 |
typeMismatch |
值不符合 email 等内置类型 |
请输入有效的邮箱地址 |
patternMismatch |
值不符合 pattern |
订单编码格式应为 ABC-1234 |
customError |
存在自定义错误文本 | 使用 validationMessage 读取 |
当所有状态都未失败时,validity.valid 为 true。错误区域应在字段恢复有效后同步清空,不能只更新控件状态而保留旧提示。
关键边界与常见错误
pattern 会对整个输入值进行匹配,不需要再手动添加 ^ 和 $。隐藏字段如果仍启用且带有 required,依然可能阻止提交;不参与当前流程的字段应移除约束或设置为 disabled。最常见的错误是只调用一次 setCustomValidity('错误'),却在值恢复正确后没有调用 setCustomValidity(''),导致控件永久无效。