ValidityState

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 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 # validitystate

Compatibilidade com navegadores

Veja também

Help improve MDN

Learn how to contribute

This page was last modified on ⁨27 de abr. de 2025⁩ by MDN contributors.

View this page on GitHub • Report a problem with this content