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

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.

Fontes