CKTIS / JavaScript
ValidityState — estado de validación de un campo de formulario
ValidityState expone indicadores de error de solo lectura para un campo de formulario. Permite distinguir entre un valor obligatorio ausente, un formato no válido y un texto demasiado corto, con una excepción importante para los valores asignados por scripts.
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
const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;ValidityState es una interfaz de la API Web HTML, no forma parte de ECMAScript. El objeto disponible mediante input.validity se actualiza en tiempo real; sus indicadores booleanos son de solo lectura. ValidityState.valid vale true cuando no está activado ninguno de los otros indicadores de error.
ValidityState.valueMissing indica que no se cumple la restricción required: en un campo de texto, significa que el valor está vacío. ValidityState.typeMismatch significa que un valor incumple las reglas del tipo email o url, no las de un tipo de datos de JavaScript. Una dirección de correo vacía no provoca este error por sí sola.
ValidityState.tooShort se aplica a un valor no vacío que es más corto que minlength en un campo compatible con esa restricción. Es necesario que esté activada la marca dirty value y que el último cambio del valor lo haya hecho el usuario. Asignar .value no activa esta comprobación de longitud; minlength por sí solo no exige que se introduzca un valor.
El ejemplo conserva un único objeto de estado y lo consulta después de los cambios. Para 'x', tooShort sigue siendo false porque el valor lo asigna un script. Ejecútalo en un navegador; que Node 24 esté en el repositorio no demuestra que esta API sea compatible.
Ejemplos
(() => {
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}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.