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

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.

Fontes