ValidityState

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since December 2018.

A interface ValidityState representa os estados de validação que um elemento pode conter de acordo com as propriedades de validação abaixo. Juntas, elas podem explicar porque um elemento é inválido (caso seja) ao ser validado.

Propriedades

Para cada uma das propriedades Booleanas abaixo, caso retorne true, isso indica a razão específica porque a validação falhou, exceto no caso da propriedade valid, que retorna true no caso do elemento ser completamente válido e false caso contrário.

ValidityState.badInput Somente leitura

É um Boolean informando se o usuário inseriu um valor que o navegador é incapaz de converter.

ValidityState.customError Somente leitura

É um Boolean informando se o elemento possui uma mensagem de validação definida por setCustomValidity() para um valor não vázio.

ValidityState.patternMismatch Somente leitura

É um Boolean informando se o valor não combina com o padrão (pattern) especificado.

ValidityState.rangeOverflow Somente leitura

É um Boolean informando se o valor é maior do que o máximo especificado pelo atributo max.

ValidityState.rangeUnderflow Somente leitura

É um Boolean informando se o valor é menor do que o mínimo especificado pelo atributo min.

ValidityState.stepMismatch Somente leitura

É um Boolean informando se o valor não segue a regra definida pelo atributo step.

ValidityState.tooLong Somente leitura

É um Boolean informando se o valor ultrapassa o especificado pelo atributo maxlength para HTMLInputElement ou HTMLTextAreaElement. OBS: Isso nunca será true em navegadores como o Firefox, pois a inserção de valores não é permitida ao alcançar o valor definido em maxlength.

ValidityState.tooShort Somente leitura

É um Boolean informando se o valor não corresponde ao especificado no atributo minlength para HTMLInputElement ou HTMLTextAreaElement.

ValidityState.typeMismatch Somente leitura

É um Boolean informando se o valor não corresponde ao tipo de entrada definida. (Um exemplo é quando type é email ou url).

ValidityState.valid Somente leitura

É um Boolean informando se o elemento é completamente válido.

ValidityState.valueMissing Somente leitura

É um Boolean informando que o elemento tem o atributo required, mas não tem value.

Especificações

Specification
HTML
# the-constraint-validation-api:validitystate-3

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
ValidityState
badInput
customError
patternMismatch
rangeOverflow
rangeUnderflow
stepMismatch
tooLong
tooShort
typeMismatch
valid
valueMissing

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Veja também