ValidityState

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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 (en-US) 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 (en-US) Somente leitura

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

ValidityState.rangeOverflow (en-US) Somente leitura

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

ValidityState.rangeUnderflow (en-US) Somente leitura

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

ValidityState.stepMismatch (en-US) Somente leitura

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

ValidityState.tooLong (en-US) Somente leitura

É um Boolean informando se o valor ultrapassa o especificado pelo atributo maxlength para HTMLInputElement ou HTMLTextAreaElement (en-US). 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 (en-US) Somente leitura

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

ValidityState.typeMismatch (en-US) 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 (en-US) Somente leitura

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

Especificações

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

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também