Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

HTMLInputElement.checkValidity() — comprobar la validez de un campo

El método checkValidity() comprueba las restricciones de un único campo input y devuelve un booleano. Si el campo no es válido y participa en la validación, dispara invalid, pero no muestra por sí mismo un mensaje de error.

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.checkValidity()

HTMLInputElement.checkValidity es un método de instancia que se llama sin argumentos como input.checkValidity(). Devuelve false cuando el campo participa en la validación e incumple sus restricciones; en los demás casos devuelve true.

Las restricciones dependen del tipo de campo y de atributos como required, pattern, min y max. Un campo disabled no participa en la validación: por tanto, true no significa necesariamente que su valor sea válido. La propiedad willValidate indica si el campo participa.

Si el resultado es false, el método dispara un evento invalid; cancelarlo no cambia el resultado. A diferencia de reportValidity(), no muestra un mensaje de error. No envía el formulario ni comprueba otros campos.

Esta API del navegador está definida por el HTML Living Standard, no por ECMAScript. Es compatible con los motores actuales de los navegadores; que Node 24 esté presente en un repositorio no demuestra que esta API sea compatible.

Ejemplos

const input = document.createElement('input');
input.type = 'text';
input.required = true;
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });

console.log(input.checkValidity());
input.value = 'Ada';
console.log(input.checkValidity());
input.value = '';
input.disabled = true;
console.log(input.checkValidity());
console.log(invalidEvents);

Resultado

false
true
true
1

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.

Fuentes