HTMLFormElement: checkValidity() 方法

Baseline 已广泛支持

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

checkValidity() 方法属于 HTMLFormElement 接口，它返回一个布尔值，指示所有关联的控件是否满足应用于它们的任何约束验证规则。该方法还会对每个无效的元素触发一个 invalid 事件，但不会在表单元素本身上触发。由于 checkValidity() 没有默认的浏览器行为，取消此 invalid 事件无效。

注意： :valid 和 :invalid CSS 伪类应用于 <form> 元素是基于其拥有的表单控件的有效性，而不是 <form> 元素本身的有效性。

语法

checkValidity()

参数

无。

返回值

如果关联控件的值没有任何有效性问题，则返回 true；否则返回 false。

示例

在下面的示例中，调用 checkValidity() 将返回 true 或 false。

const element = document.getElementById("myForm");
console.log(element.checkValidity());

规范

规范
HTML # dom-form-checkvalidity-dev

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改于 ⁨2025年4月10日⁩，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的错误