Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

HTMLInputElement.validity — estado de validade do campo

HTMLInputElement.validity expõe o estado atual de validação das restrições de um campo através de um objeto ValidityState. Os seus indicadores assinalam problemas específicos, enquanto valid indica se não está ativo nenhum indicador de erro.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

input.validity
input.validity.valid
input.validity.valueMissing

HTMLInputElement.validity é uma propriedade só de leitura que devolve um objeto ValidityState dinâmico: uma referência guardada reflete alterações posteriores no campo. Os respetivos indicadores também são só de leitura. Esta API do navegador é definida por HTML, não por ECMAScript; a disponibilidade de Node.js, por si só, não garante o seu suporte.

valueMissing indica a ausência de um valor obrigatório, typeMismatch um formato incompatível com o tipo e patternMismatch uma incompatibilidade com pattern. Os restantes indicadores de erro são tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput e customError. A sua aplicabilidade depende do tipo de campo e das restrições. valid tem o valor true quando todos os indicadores de erro têm o valor false.

A leitura de validity não apresenta uma mensagem nem dispara invalid. checkValidity() verifica o controlo e pode disparar invalid; reportValidity() também pode apresentar o problema ao utilizador. willValidate determina a participação na validação: um campo desativado pode continuar a ter indicadores de erro, apesar de não participar na verificação.

setCustomValidity('Blocked') define customError; limpe-o com setCustomValidity(''). Corrigir o valor, por si só, não elimina o erro. O exemplo mostra as atualizações através do objeto state guardado, sem voltar a ler input.validity. A validação do navegador não substitui a verificação de dados no servidor.

Exemplos

const input = document.createElement('input');
input.type = 'email';
input.required = true;
const state = input.validity;

console.log(state.valueMissing, state.valid);
input.value = 'learner@example.com';
console.log(state.valueMissing, state.valid);
input.setCustomValidity('Blocked');
console.log(state.customError, state.valid);
input.setCustomValidity('');
console.log(state.customError, state.valid);

Resultado

true false
false true
true false
false true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes