CKTIS / JavaScript
HTMLFormElement.checkValidity() — verificar a validade de um formulário
O método form.checkValidity() verifica as restrições dos controlos associados a um formulário e devolve um valor booleano. Não submete o formulário nem apresenta as mensagens de validação padrão do navegador.
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
form.checkValidity()HTMLFormElement.checkValidity é um método da Web API do navegador, não uma função definida pelo ECMAScript. A chamada form.checkValidity() não recebe argumentos e devolve sincronamente true se todos os controlos que podem ser validados cumprirem as respetivas restrições; caso contrário, devolve false.
A verificação abrange os controlos associados ao formulário, não apenas os seus descendentes. Os controlos desativados através de disabled são ignorados. Se nenhum controlo puder ser validado, o resultado é true. O método ativa um evento invalid em cada controlo inválido; cancelar esse evento não altera o resultado para true.
O método não submete o formulário nem apresenta, por si só, a interface de erro padrão. Utilize form.reportValidity() para verificar os problemas e comunicá-los ao utilizador. A validação no navegador não substitui a validação do lado do servidor.
O exemplo cria um formulário com um campo de texto obrigatório. O campo vazio produz false e um evento invalid; depois de atribuir Ada, o resultado é true. Execute o código num navegador: um ambiente Node.js 24, por si só, não comprova a disponibilidade desta API.
Exemplos
(() => {
const form = document.createElement('form');
const input = document.createElement('input');
input.required = true;
form.append(input);
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });
console.log(form.checkValidity());
input.value = 'Ada';
console.log(form.checkValidity());
console.log(invalidEvents);
})();Resultado
false 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.