Back to Content

HTMLFormElement: checkValidity() method

files/en-us/web/api/htmlformelement/checkvalidity/index.md

latest1.5 KB
Original Source

{{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.

[!NOTE] 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

js-nolint
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 if or false.

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also