CKTIS / JavaScript
HTMLInputElement.checkValidity() — verificar a validade de um campo
O método checkValidity() verifica as restrições de um único campo input e devolve um valor booleano. Se o campo for inválido e participar na validação, dispara invalid, mas não apresenta, por si só, uma mensagem 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.checkValidity()HTMLInputElement.checkValidity é um método de instância chamado sem argumentos como input.checkValidity(). Devolve false quando o campo participa na validação e viola as suas restrições; caso contrário, devolve true.
As restrições dependem do tipo de campo e de atributos como required, pattern, min e max. Um campo disabled não participa na validação: por isso, true não significa necessariamente que o seu valor seja válido. A propriedade willValidate indica se o campo participa.
Quando o resultado é false, o método dispara um evento invalid; cancelá-lo não altera o resultado. Ao contrário de reportValidity(), não apresenta uma mensagem de erro. Não submete o formulário nem verifica os outros campos.
Esta API do navegador é definida pelo HTML Living Standard, não pelo ECMAScript. É suportada pelos motores de navegador atuais; a presença do Node 24 num repositório não comprova o suporte desta API.
Exemplos
const input = document.createElement('input');
input.type = 'text';
input.required = true;
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });
console.log(input.checkValidity());
input.value = 'Ada';
console.log(input.checkValidity());
input.value = '';
input.disabled = true;
console.log(input.checkValidity());
console.log(invalidEvents);Resultado
false true true 1
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.