ValidityState

The ValidityState interface represents the validity states that an element can be in, with respect to constraint validation. Together, they help explain why an element's value fails to validate, if it's not valid.

Properties

For each of these Boolean properties, a value of true indicates that the specified reason validation may have failed is true, with the exception of the valid property, which is true if the element's value obeys all constraints.

ValidityState.badInput Read only
Is a Boolean indicating the user has provided input that the browser is unable to convert.
ValidityState.customError Read only
Is a Boolean indicating the element's custom validity message has been set to a non-empty string by calling the element's setCustomValidity() method.
ValidityState.patternMismatch Read only
Is a Boolean indicating the value does not match the specified pattern.
ValidityState.rangeOverflow Read only
Is a Boolean indicating the value is greater than the maximum specified by the max attribute.
ValidityState.rangeUnderflow Read only
Is a Boolean indicating the value is less than the minimum specified by the min attribute.
ValidityState.stepMismatch Read only
Is a Boolean indicating the value does not fit the rules determined by the step attribute (that is, it's not evenly divisible by the step value).
ValidityState.tooLong Read only
Is a Boolean indicating the value exceeds the specified maxlength for HTMLInputElement or HTMLTextAreaElement objects. Note: This will never be true in Gecko, because elements' values are prevented from being longer than maxlength.
ValidityState.tooShort Read only
Is a Boolean indicating the value fails to meet the specified minlength for HTMLInputElement or HTMLTextAreaElement objects.
ValidityState.typeMismatch Read only
Is a Boolean indicating the value is not in the required syntax (when type is email or url).
ValidityState.valid Read only
Is a Boolean indicating the element meets all constraint validations, and is therefore considered to be valid.
ValidityState.valueMissing Read only
Is a Boolean indicating the element has a required attribute, but no value.

Specifications

Specification Status Comment
WHATWG HTML Living Standard
The definition of 'ValidityState' in that specification.
Living Standard Live Standard
HTML5.1
The definition of 'ValidityState' in that specification.
Recommendation No change from the previous snapshot HTML5.
HTML5
The definition of 'ValidityState' in that specification.
Recommendation First snapshot of  WHATWG HTML Living Standard containing this interface.

Browser compatibility

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) 10 (Yes) 10.0.3
badInput ? (Yes) 29 (29) ? ? 10.0.3
Feature Android Chrome for Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
badIndput ? ? 29.0 (29) ? ? ?

See also

Document Tags and Contributors

 Last updated by: erikadoyle,