ValidityState

Baseline Widely available

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

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

Veja também