调用 form.checkValidity() 可自动递归校验所有子控件原生规则,无需遍历;仅 form 内且具校验属性(如 required、type="email")的启用控件参与,disabled、hidden、willValidate=false 的被跳过;返回布尔值,需配合 reportValidity() 显示提示。

直接在 form 元素上调用 checkValidity() 即可动态检查所有子表单控件(input、select、textarea 等)是否满足原生校验规则,无需遍历子元素——浏览器自动递归校验全部可验证子项。
确保 form 结构正确且校验属性已声明
只有包裹在 <form></form> 标签内的控件才参与 checkValidity() 校验。独立于 form 的输入框(如配置面板中用 div 包裹的 input)会完全被忽略,checkValidity() 甚至无法调用(报错 TypeError)。
- 每个需校验的字段必须有标准属性,例如
required、type="email"、minlength="3"、pattern="^[\w-]+@[\w-]+\.[a-z]{2,}$" - 禁用字段(
disabled)和willValidate === false的元素不参与校验,会被跳过 - 隐藏字段(
type="hidden")默认不校验,即使加了required也无效
在合适时机显式触发并响应结果
checkValidity() 不会自动弹出提示,只返回 true 或 false。若需用户可见反馈,应配合 reportValidity()。
- 提交前校验:在
submit事件处理器第一行写if (!form.checkValidity()) return false;—— 这会触发:invalid伪类、首个错误字段获得焦点,并在用户已交互过的字段上显示气泡(Chrome/Firefox 行为一致) - 实时校验(如“保存草稿”按钮):调用
form.checkValidity()判断整体状态,再根据返回值启用/禁用按钮,或统一调用form.reportValidity()强制展示全部错误提示 - 避免在
input事件中频繁调用reportValidity(),它每次都会聚焦第一个错误项,干扰用户输入;推荐仅在关键操作点(提交、切换步骤、离开页面前)触发
处理自定义校验与后端联动
当业务规则超出原生能力(如用户名唯一性),需用 setCustomValidity() 扩展,但必须严格管理其生命周期。
立即学习“前端免费学习笔记(深入)”;
- 每次用户输入后,先调用
input.setCustomValidity('')清空旧错误,再根据新值判断是否设新消息(如input.setCustomValidity('该邮箱已被注册')) - 后端返回校验失败时,找到对应字段,执行
field.setCustomValidity(message)+field.reportValidity()+field.focus(),三步缺一不可 - 清空自定义错误后,原生规则(如
required)立即恢复生效;不清空则后续任何输入都判定为非法
注意兼容性与常见陷阱
现代浏览器(IE10+、所有主流新版)均支持 checkValidity(),但行为细节需留意。
- 检测支持只需判断:
typeof document.createElement('form').checkValidity === 'function',不要依赖oninvalid事件是否存在 -
novalidate属性必须加在form标签上,否则仍会触发默认校验;加了之后,checkValidity()仍可用,只是 submit 不再自动拦截 - 粘贴、JS 赋值、
valueAsNumber修改等操作不会自动触发校验,必须手动调用checkValidity()或reportValidity()



















