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.valueMissingHTMLInputElement.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.