ElementInternals: validity property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.
The validity read-only property of the ElementInternals interface returns a ValidityState object which represents the different validity states the element can be in, with respect to constraint validation.
Value
A ValidityState object.
Exceptions
NotSupportedErrorDOMException-
Thrown if the element does not have its
formAssociatedproperty set totrue.
Examples
The following example shows a custom checkbox component with formAssociated set to true, the value of validity.valid is logged to the console.
js
class CustomCheckbox extends HTMLElement { static formAssociated = true; constructor() { super(); this.internals_ = this.attachInternals(); } // … } window.customElements.define("custom-checkbox", CustomCheckbox); let element = document.getElementById("custom-checkbox"); console.log(element.internals_.validity.valid); Specifications
| Specification |
|---|
| HTML # dom-elementinternals-validity |
Browser compatibility
Loading…