HTMLFormElement: checkValidity() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("HTML DOM")}}
The **checkValidity()** method of the {{domxref("HTMLFormElement")}} interface returns a boolean value which indicates if all associated controls meet any constraint validation rules applied to them. The method also fires an {{domxref("HTMLElement/invalid_event", "invalid")}} event on each invalid element, but not on the form element itself. Because there's no default browser behavior for checkValidity(), canceling this invalid event has no effect.
توجه: The {{cssxref(":valid")}} and {{cssxref(":invalid")}} CSS pseudo-classes are applied to <form> elements based on the validity of its owned form controls, not the validity of the <form> element itself.
Syntax
checkValidity()Parameters
None.
Return value
Returns true if the associated controls' values have no validity problems; otherwise, returns false.
Examples
In the following example, calling checkValidity() would return true or false.
const element = document.getElementById("myForm");
console.log(element.checkValidity());Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("HTMLFormElement.reportValidity()")}}
- {{HTMLElement("form")}}
- Learn: Client-side form validation
- Guide: Constraint validation