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

CKTIS / JavaScript

ValidityState — estado de validação de um campo de formulário

ValidityState expõe indicadores de erro só de leitura para um campo de formulário. Permite distinguir um valor obrigatório em falta, um formato inválido e um texto demasiado curto, com uma exceção importante para valores atribuídos por scripts.

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

const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;

ValidityState é uma interface da HTML Web API, não faz parte de ECMAScript. O objeto disponível através de input.validity é atualizado em tempo real; os seus indicadores booleanos são só de leitura. ValidityState.valid tem o valor true quando nenhum dos outros indicadores de erro está definido.

ValidityState.valueMissing assinala que a restrição required não é cumprida: num campo de texto, isso significa que o valor está vazio. ValidityState.typeMismatch significa que um valor não respeita as regras do tipo email ou url, e não as de um tipo de dados JavaScript. Um endereço de email vazio não provoca, por si só, este erro.

ValidityState.tooShort aplica-se a um valor não vazio mais curto do que minlength num campo que suporte essa restrição. A flag dirty value tem de estar definida e a última alteração do valor tem de ter sido feita pelo utilizador. Atribuir .value não desencadeia esta verificação do comprimento; minlength, por si só, não exige que seja introduzido um valor.

O exemplo mantém um único objeto de estado e lê-o depois das alterações. Para 'x', tooShort continua a ser false, porque o valor é atribuído por um script. Execute-o num navegador; a presença de Node 24 no repositório não demonstra suporte para esta API.

Exemplos

(() => {
  const input = document.createElement('input');
  input.type = 'email';
  input.required = true;
  input.minLength = 8;
  const state = input.validity;

  const show = () => console.log(JSON.stringify({
    valid: state.valid,
    valueMissing: state.valueMissing,
    typeMismatch: state.typeMismatch,
    tooShort: state.tooShort
  }));

  show();
  input.value = 'x';
  show();
  input.value = 'a@example.com';
  show();
})();

Resultado

{"valid":false,"valueMissing":true,"typeMismatch":false,"tooShort":false}
{"valid":false,"valueMissing":false,"typeMismatch":true,"tooShort":false}
{"valid":true,"valueMissing":false,"typeMismatch":false,"tooShort":false}

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