KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLFormElement.reportValidity() — een formulier valideren en fouten melden

HTMLFormElement.reportValidity() controleert de validatievoorwaarden van besturingselementen die bij een formulier horen en kan fouten aan de gebruiker melden. De methode retourneert een boolean en verzendt het formulier niet zelf.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

form.reportValidity()

HTMLFormElement.reportValidity is een methode van de formulierinterface die is vastgelegd in de HTML Living Standard, niet in ECMAScript. De aanroep form.reportValidity() heeft geen argumenten en retourneert synchroon true als alle voor validatie in aanmerking komende besturingselementen geldig zijn, of false als er minstens één ongeldig is.

De methode voert interactieve beperkingsvalidatie uit voor voorwaarden zoals required. Bij ongeldige besturingselementen worden invalid-gebeurtenissen geactiveerd. De browser kan fouten melden waarvan de afhandeling niet is geannuleerd; het uiterlijk en de tekst van de meldingen verschillen per browser. event.preventDefault() aanroepen in een invalid-handler onderdrukt de native melding van die fout, maar verandert de uitkomst false niet.

Anders dan reportValidity() controleert checkValidity() de voorwaarden zonder interactieve foutmelding, maar ook deze methode activeert invalid. Geen van beide methoden verzendt het formulier. Besturingselementen die met disabled zijn uitgeschakeld, worden niet gevalideerd; clientvalidatie vervangt geen gegevenscontrole op de server.

Dit is een browser-API: de aanwezigheid van Node 24 bewijst niet dat de API beschikbaar is. Controleer in de doelomgeving typeof HTMLFormElement !== 'undefined' && typeof HTMLFormElement.prototype.reportValidity === 'function'. Het voorbeeld annuleert invalid bewust, zodat de booleanresultaten kunnen worden gecontroleerd zonder afhankelijk te zijn van de interface voor validatiemeldingen.

Voorbeelden

(() => {
  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();
})();

Resultaat

false
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen