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

CKTIS / JavaScript

HTMLFormElement.reportValidity() — validar un formulario y mostrar errores

HTMLFormElement.reportValidity() comprueba las restricciones de validación de los controles asociados a un formulario y puede comunicar los errores al usuario. Devuelve un booleano y no envía el formulario por sí mismo.

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

HTMLFormElement.reportValidity es un método de la interfaz de formularios definido por HTML Living Standard, no por ECMAScript. La llamada form.reportValidity() no acepta argumentos y devuelve sincrónicamente true si todos los controles sujetos a validación son válidos, o false si al menos uno no lo es.

El método ejecuta la validación interactiva de restricciones como required. Lanza eventos invalid en los controles no válidos. El navegador puede comunicar los errores cuyo tratamiento no se haya cancelado; la apariencia y el texto de los mensajes dependen del navegador. Llamar a event.preventDefault() en un manejador de invalid suprime la notificación nativa de ese error, pero no cambia el resultado false.

A diferencia de reportValidity(), checkValidity() comprueba las restricciones sin mostrar errores de forma interactiva, aunque también lanza invalid. Ninguno de los métodos envía el formulario. Los controles deshabilitados mediante disabled quedan excluidos de la validación; la validación del lado del cliente no sustituye la comprobación de datos en el servidor.

Esta es una API del navegador: que Node 24 esté disponible no demuestra que esta API lo esté. En el entorno de destino, comprueba typeof HTMLFormElement !== 'undefined' && typeof HTMLFormElement.prototype.reportValidity === 'function'. El ejemplo cancela invalid deliberadamente para comprobar los resultados booleanos sin depender de la interfaz de los mensajes de validación.

Ejemplos

(() => {
  const form = document.createElement('form');
  const input = document.createElement('input');
  input.required = true;
  input.setAttribute('aria-label', 'Name');
  form.append(input);
  document.body.append(form);

  // Suppress native validation UI for deterministic console checks.
  input.addEventListener('invalid', event => event.preventDefault());

  console.log(form.reportValidity());
  input.value = 'Ada';
  console.log(form.reportValidity());

  form.remove();
})();

Resultado

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.

Fuentes