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

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.

Fuentes