CKTIS / JavaScript
HTMLFormElement.reportValidity() — overenie formulára a oznámenie chýb
HTMLFormElement.reportValidity() kontroluje validačné obmedzenia ovládacích prvkov spojených s formulárom a môže používateľovi oznámiť chyby. Vráti boolean a samo formulár neodošle.
Verzia: 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 je metóda rozhrania formulára definovaná v HTML Living Standard, nie v ECMAScripte. Volanie form.reportValidity() neprijíma žiadne argumenty a synchrónne vráti true, ak sú všetky ovládacie prvky podliehajúce validácii platné, alebo false, ak je aspoň jeden neplatný.
Metóda spúšťa interaktívne overovanie obmedzení, ako je required. Pri neplatných ovládacích prvkoch vyvoláva udalosti invalid. Prehliadač môže oznámiť chyby, ktorých spracovanie nebolo zrušené; vzhľad a znenie správ závisia od prehliadača. Volanie event.preventDefault() v obsluhe invalid potlačí natívne oznámenie danej chyby, ale nezmení výsledok false.
Na rozdiel od reportValidity() metóda checkValidity() kontroluje obmedzenia bez interaktívneho oznamovania chýb, ale tiež vyvoláva invalid. Ani jedna z metód formulár neodošle. Ovládacie prvky vypnuté pomocou disabled sú z validácie vynechané; validácia na strane klienta nenahrádza kontrolu údajov na serveri.
Ide o API prehliadača: samotná prítomnosť Node 24 nedokazuje jeho dostupnosť. V cieľovom prostredí skontrolujte typeof HTMLFormElement !== 'undefined' && typeof HTMLFormElement.prototype.reportValidity === 'function'. Príklad zámerne ruší invalid, aby sa dali overiť boolovské výsledky bez závislosti od rozhrania validačných správ.
Príklady
(() => {
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();
})();Výsledok
false true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.