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

CKTIS / JavaScript

ValidityState.valid — validade global do controlo

ValidityState.valid é uma propriedade booleana só de leitura: tem o valor true quando nenhum dos indicadores de erro de validação do controlo está definido.

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

element.validity.valid

ValidityState.valid, acessível através de element.validity.valid, tem o valor true quando todos os outros indicadores de erro em ValidityState têm o valor false. Esta é uma API do navegador definida pelo HTML Standard, não uma funcionalidade de uma edição específica do ECMAScript.

O objeto validity é atualizado em tempo real. No exemplo, o campo obrigatório vazio é inválido; introduzir Ada elimina o erro de valor em falta. Uma mensagem não vazia em setCustomValidity() define um erro personalizado; setCustomValidity('') elimina-o.

Ler valid não apresenta uma mensagem nem dispara invalid. Também não significa que o controlo participe na validação: willValidate indica se está elegível. checkValidity() tem em conta essa elegibilidade, enquanto reportValidity() também pode apresentar o problema.

Exemplos

const input = document.createElement('input');
input.required = true;
const state = input.validity;
console.log(state.valid);
input.value = 'Ada';
console.log(state.valid);
input.setCustomValidity('Rejected');
console.log(state.valid);
input.setCustomValidity('');
console.log(state.valid);

Resultado

false
true
false
true

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