CKTIS / JavaScript
HTMLInputElement.validity — estado de validez del campo
HTMLInputElement.validity expone el estado actual de validación de restricciones de un campo como un objeto ValidityState. Sus indicadores señalan problemas concretos, mientras que valid indica si no hay ningún indicador de error activado.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
input.validity
input.validity.valid
input.validity.valueMissingHTMLInputElement.validity es una propiedad de solo lectura que devuelve un objeto ValidityState vivo: una referencia guardada refleja los cambios posteriores del campo. Sus indicadores también son de solo lectura. Esta API del navegador está definida por HTML, no por ECMAScript; la disponibilidad de Node.js por sí sola no garantiza que sea compatible.
valueMissing indica que falta un valor obligatorio, typeMismatch que el formato no coincide con el tipo y patternMismatch que no coincide con pattern. Los demás indicadores de error son tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput y customError. Su aplicabilidad depende del tipo de campo y de las restricciones. valid vale true cuando todos los indicadores de error valen false.
Leer validity no muestra ningún mensaje ni activa invalid. checkValidity() comprueba el control y puede activar invalid; reportValidity() también puede presentar el problema al usuario. willValidate determina si participa en la validación: un campo deshabilitado puede seguir teniendo indicadores de error aunque no participe en la comprobación.
setCustomValidity('Blocked') establece customError; elimínalo con setCustomValidity(''). Corregir el valor por sí solo no elimina el error. El ejemplo muestra las actualizaciones mediante el objeto state guardado, sin volver a leer input.validity. La validación del navegador no sustituye la comprobación de datos en el servidor.
Ejemplos
const input = document.createElement('input');
input.type = 'email';
input.required = true;
const state = input.validity;
console.log(state.valueMissing, state.valid);
input.value = 'learner@example.com';
console.log(state.valueMissing, state.valid);
input.setCustomValidity('Blocked');
console.log(state.customError, state.valid);
input.setCustomValidity('');
console.log(state.customError, state.valid);Resultado
true false false true true false false true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.