HTMLButtonElement: checkValidity() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("HTML DOM")}}
The **checkValidity()** method of the {{domxref("HTMLButtonElement")}} interface returns a boolean value which indicates if the element meets any constraint validation rules applied to it. If false, the method also fires an {{domxref("HTMLElement/invalid_event", "invalid")}} event on the element. Because there's no default browser behavior for checkValidity(), canceling this invalid event has no effect. It always returns true if the {{HTMLElement("button")}} element is not a candidate for constraint validation (its {{domxref("HTMLButtonElement/willValidate", "willValidate")}} is false).
توجه: An HTML {{htmlelement("button")}} element of the "submit" type with a non-null {{domxref("HTMLButtonElement.validationMessage", "validationMessage")}} is considered invalid, will match the CSS {{cssxref(":invalid")}} pseudo-class, and will cause checkValidity() to return false. Use the {{domxref("HTMLButtonElement.setCustomValidity()")}} method to set the {{domxref("HTMLButtonElement.validationMessage")}} to the empty string to set the {{domxref("HTMLButtonElement.validity", "validity")}} state to be valid.
Syntax
checkValidity()Parameters
None.
Return value
Returns true if the element's value has no validity problems or if it's not a candidate for constraint validation; otherwise, returns false.
Examples
In the following example, calling checkValidity() returns either true or false.
const element = document.getElementById("myButton");
console.log(element.checkValidity());Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("HTMLButtonElement.reportValidity()")}}
- {{HTMLElement("button")}}
- {{HTMLElement("form")}}
- Learn: Client-side form validation
- Guide: Constraint validation
- CSS {{cssxref(":valid")}} and {{cssxref(":invalid")}} pseudo-classes