kotlin-browser/web.validation/ValidityState

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.

MDN Reference

Properties

badInput

external val badInput: Boolean

The read-only badInput property of the ValidityState interface indicates if the user has provided input that the browser is unable to convert. For example, if you have a number input element whose content is a string.

customError

external val customError: Boolean

The read-only customError property of the ValidityState interface returns true if an element doesn't meet the validation required in the custom validity set by the element's setCustomValidity() method.

patternMismatch

external val patternMismatch: Boolean

The read-only patternMismatch property of the ValidityState interface indicates if the value of an , after having been edited by the user, does not conform to the constraints set by the element's pattern attribute.

rangeOverflow

external val rangeOverflow: Boolean

The read-only rangeOverflow property of the ValidityState interface indicates if the value of an , after having been edited by the user, does not conform to the constraints set by the element's max attribute.

rangeUnderflow

external val rangeUnderflow: Boolean

The read-only rangeUnderflow property of the ValidityState interface indicates if the value of an , after having been edited by the user, does not conform to the constraints set by the element's min attribute.

stepMismatch

external val stepMismatch: Boolean

The read-only stepMismatch property of the ValidityState interface indicates if the value of an , after having been edited by the user, does not conform to the constraints set by the element's step attribute.

tooLong

external val tooLong: Boolean

The read-only tooLong property of the ValidityState interface indicates if the value of an or , after having been edited by the user, exceeds the maximum code-unit length established by the element's maxlength attribute.</p></div></div> </div> </div> </div> </div> </div> <a data-name="-1210421047%2FProperties%2F1829791389" anchor-label="tooShort" id="-1210421047%2FProperties%2F1829791389" data-filterable-set=":kotlin-browser/webMain"></a> <div class="table-row table-row_content" data-filterable-current=":kotlin-browser/webMain" data-filterable-set=":kotlin-browser/webMain"> <div class="main-subrow keyValue "> <div class=""><span class="inline-flex"> <div><a href="too-short.html"><span>too</span><wbr></wbr><span><span>Short</span></span></a></div> <span class="anchor-wrapper"><span class="anchor-icon" pointing-to="-1210421047%2FProperties%2F1829791389"></span> <div class="copy-popup-wrapper "><span class="copy-popup-icon"></span><span>Link copied to clipboard</span></div> </span></span></div> <div> <div class="title"> <div class="platform-hinted with-platform-tabs" data-platform-hinted="data-platform-hinted"> <div class="platform-bookmarks-row" data-toggle-list="data-toggle-list"><button class="platform-bookmark" data-filterable-current=":kotlin-browser/webMain" data-filterable-set=":kotlin-browser/webMain" data-active="" data-toggle=":kotlin-browser/webMain">web</button></div> <div class="content sourceset-dependent-content" data-active="" data-togglable=":kotlin-browser/webMain"><div class="symbol monospace"><span class="token keyword">external </span><span class="token keyword">val </span><a href="too-short.html">tooShort</a><span class="token operator">: </span><a href="https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html">Boolean</a></div><div class="brief "><p class="paragraph">The read-only <code class="strong lang-kotlin"><strong>tooShort</strong></code> property of the ValidityState interface indicates if the value of an <input>, <button>, <select>, <output>, <fieldset> or <textarea>, after having been edited by the user, is less than the minimum code-unit length established by the element's minlength attribute.</p></div></div> </div> </div> </div> </div> </div> <a data-name="-1211123927%2FProperties%2F1829791389" anchor-label="typeMismatch" id="-1211123927%2FProperties%2F1829791389" data-filterable-set=":kotlin-browser/webMain"></a> <div class="table-row table-row_content" data-filterable-current=":kotlin-browser/webMain" data-filterable-set=":kotlin-browser/webMain"> <div class="main-subrow keyValue "> <div class=""><span class="inline-flex"> <div><a href="type-mismatch.html"><span>type</span><wbr></wbr><span><span>Mismatch</span></span></a></div> <span class="anchor-wrapper"><span class="anchor-icon" pointing-to="-1211123927%2FProperties%2F1829791389"></span> <div class="copy-popup-wrapper "><span class="copy-popup-icon"></span><span>Link copied to clipboard</span></div> </span></span></div> <div> <div class="title"> <div class="platform-hinted with-platform-tabs" data-platform-hinted="data-platform-hinted"> <div class="platform-bookmarks-row" data-toggle-list="data-toggle-list"><button class="platform-bookmark" data-filterable-current=":kotlin-browser/webMain" data-filterable-set=":kotlin-browser/webMain" data-active="" data-toggle=":kotlin-browser/webMain">web</button></div> <div class="content sourceset-dependent-content" data-active="" data-togglable=":kotlin-browser/webMain"><div class="symbol monospace"><span class="token keyword">external </span><span class="token keyword">val </span><a href="type-mismatch.html">typeMismatch</a><span class="token operator">: </span><a href="https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html">Boolean</a></div><div class="brief "><p class="paragraph">The read-only <code class="strong lang-kotlin"><strong>typeMismatch</strong></code> property of the ValidityState interface indicates if the value of an <input>, after having been edited by the user, does not conform to the constraints set by the element's type attribute.</p></div></div> </div> </div> </div> </div> </div> <a data-name="-49265619%2FProperties%2F1829791389" anchor-label="valid" id="-49265619%2FProperties%2F1829791389" data-filterable-set=":kotlin-browser/webMain"></a> <div class="table-row table-row_content" data-filterable-current=":kotlin-browser/webMain" data-filterable-set=":kotlin-browser/webMain"> <div class="main-subrow keyValue "> <div class=""><span class="inline-flex"> <div><a href="valid.html"><span><span>valid</span></span></a></div> <span class="anchor-wrapper"><span class="anchor-icon" pointing-to="-49265619%2FProperties%2F1829791389"></span> <div class="copy-popup-wrapper "><span class="copy-popup-icon"></span><span>Link copied to clipboard</span></div> </span></span></div> <div> <div class="title"> <div class="platform-hinted with-platform-tabs" data-platform-hinted="data-platform-hinted"> <div class="platform-bookmarks-row" data-toggle-list="data-toggle-list"><button class="platform-bookmark" data-filterable-current=":kotlin-browser/webMain" data-filterable-set=":kotlin-browser/webMain" data-active="" data-toggle=":kotlin-browser/webMain">web</button></div> <div class="content sourceset-dependent-content" data-active="" data-togglable=":kotlin-browser/webMain"><div class="symbol monospace"><span class="token keyword">external </span><span class="token keyword">val </span><a href="valid.html">valid</a><span class="token operator">: </span><a href="https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html">Boolean</a></div><div class="brief "><p class="paragraph">The read-only <code class="strong lang-kotlin"><strong>valid</strong></code> property of the ValidityState interface indicates if the value of an <input> element meets all its validation constraints, and is therefore considered to be valid.</p></div></div> </div> </div> </div> </div> </div> <a data-name="1291277372%2FProperties%2F1829791389" anchor-label="valueMissing" id="1291277372%2FProperties%2F1829791389" data-filterable-set=":kotlin-browser/webMain"></a> <div class="table-row table-row_content" data-filterable-current=":kotlin-browser/webMain" data-filterable-set=":kotlin-browser/webMain"> <div class="main-subrow keyValue "> <div class=""><span class="inline-flex"> <div><a href="value-missing.html"><span>value</span><wbr></wbr><span><span>Missing</span></span></a></div> <span class="anchor-wrapper"><span class="anchor-icon" pointing-to="1291277372%2FProperties%2F1829791389"></span> <div class="copy-popup-wrapper "><span class="copy-popup-icon"></span><span>Link copied to clipboard</span></div> </span></span></div> <div> <div class="title"> <div class="platform-hinted with-platform-tabs" data-platform-hinted="data-platform-hinted"> <div class="platform-bookmarks-row" data-toggle-list="data-toggle-list"><button class="platform-bookmark" data-filterable-current=":kotlin-browser/webMain" data-filterable-set=":kotlin-browser/webMain" data-active="" data-toggle=":kotlin-browser/webMain">web</button></div> <div class="content sourceset-dependent-content" data-active="" data-togglable=":kotlin-browser/webMain"><div class="symbol monospace"><span class="token keyword">external </span><span class="token keyword">val </span><a href="value-missing.html">valueMissing</a><span class="token operator">: </span><a href="https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html">Boolean</a></div><div class="brief "><p class="paragraph">The read-only <code class="strong lang-kotlin"><strong>valueMissing</strong></code> property of the ValidityState interface indicates if a required control, such as an <input>, <select>, or <textarea>, has an empty value.</p></div></div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> <div class="footer"> <div class="footer--container"> <a href="#content" id="go-to-top-link" class="footer--button footer--button_go-to-top"></a> <div class="footer--content"> <div> <span>Generated by </span> <a class="footer--link footer--link_external" href="https://github.com/Kotlin/dokka"> Dokka </a> <div>© 2026 Copyright</div> </div> </div> </div> </div> </div> </div> </div> </body> </html>