CKTIS / JavaScript
HTMLFormElement.checkValidity() — comprobar la validez de un formulario
El método form.checkValidity() comprueba las restricciones de los controles asociados a un formulario y devuelve un valor booleano. No envía el formulario ni muestra los mensajes de validación estándar del navegador.
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
form.checkValidity()HTMLFormElement.checkValidity es un método de la API Web del navegador, no una función definida por ECMAScript. La llamada form.checkValidity() no acepta argumentos y devuelve true de forma síncrona si todos los controles que pueden validarse cumplen sus restricciones; de lo contrario, devuelve false.
La comprobación abarca los controles asociados al formulario, no solo sus elementos descendientes. Se omiten los controles desactivados mediante disabled. Si ningún control puede validarse, el resultado es true. El método dispara un evento invalid en cada control no válido; cancelar ese evento no cambia el resultado a true.
El método no envía el formulario ni muestra por sí mismo la interfaz de error estándar. Usa form.reportValidity() para comprobar los problemas y comunicárselos al usuario. La validación del navegador no sustituye a la validación del lado del servidor.
El ejemplo crea un formulario con un campo de texto obligatorio. El campo vacío produce false y un evento invalid; después de asignar Ada, el resultado es true. Ejecuta el código en un navegador: un entorno Node.js 24 por sí solo no demuestra que esta API esté disponible.
Ejemplos
(() => {
const form = document.createElement('form');
const input = document.createElement('input');
input.required = true;
form.append(input);
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });
console.log(form.checkValidity());
input.value = 'Ada';
console.log(form.checkValidity());
console.log(invalidEvents);
})();Resultado
false 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.