ElementInternals: checkValidity() 方法

基线 2023

新可用

自 2023 年 3 月起，此功能在最新的设备和浏览器版本中都能使用。此功能可能在较旧的设备或浏览器中无法使用。

checkValidity() 方法是 ElementInternals 接口的一部分，用于检查元素是否满足应用于它的任何 约束验证 规则。

如果 checkValidity 返回 false，则会在元素上触发可取消的 无效事件。

语法

js
checkValidity()

参数

无。

返回值

布尔值，如果元素满足所有验证约束，则为 true。

异常

NotSupportedError DOMException

如果元素的 formAssociated 属性未设置为 true，则抛出此异常。

示例

在下面的示例中，ElementInternals.setValidity() 用于指示元素不满足验证规则。调用 checkValidity() 返回 false。再次调用 setValidity 后，这次指示所有规则都标记为 false，checkValidity() 返回 true。

js
let element = document.getElementById("join-checkbox");
element.internals_.setValidity({ valueMissing: true }, "my message");
console.log(element.internals_.checkValidity()); // false
element.internals_.setValidity({});
console.log(element.internals_.checkValidity()); // true

规范

规范
HTML 标准
# dom-elementinternals-checkvalidity

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。