CKTIS / JavaScript
HTMLFormElement.reportValidity() — provjera obrasca i prijava pogrešaka
HTMLFormElement.reportValidity() provjerava ograničenja validacije kontrola povezanih s obrascem i može korisniku prijaviti pogreške. Vraća boolean i ne šalje obrazac samostalno.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
form.reportValidity()HTMLFormElement.reportValidity metoda je sučelja obrasca definirana u HTML Living Standardu, a ne u ECMAScriptu. Poziv form.reportValidity() ne prima argumente i sinkrono vraća true ako su sve kontrole podložne validaciji valjane, odnosno false ako je barem jedna nevaljana.
Metoda pokreće interaktivnu validaciju ograničenja kao što je required. Na nevaljanim kontrolama aktivira događaje invalid. Preglednik može prijaviti pogreške čija obrada nije otkazana; izgled i tekst poruka ovise o pregledniku. Poziv event.preventDefault() u rukovatelju događajem invalid potiskuje izvornu prijavu te pogreške, ali ne mijenja rezultat false.
Za razliku od reportValidity(), checkValidity() provjerava ograničenja bez interaktivnog prijavljivanja pogrešaka, no i ona aktivira invalid. Nijedna metoda ne šalje obrazac. Kontrole onemogućene pomoću disabled izuzete su iz validacije; validacija na strani klijenta ne zamjenjuje provjeru podataka na poslužitelju.
Ovo je API preglednika: sama prisutnost Nodea 24 ne dokazuje dostupnost API-ja. U ciljnom okruženju provjerite typeof HTMLFormElement !== 'undefined' && typeof HTMLFormElement.prototype.reportValidity === 'function'. Primjer namjerno otkazuje invalid kako bi provjerio logičke rezultate bez ovisnosti o sučelju poruka validacije.
Primjeri
(() => {
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();
})();Rezultat
false true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.