CKTIS / JavaScript
HTMLFormElement.reportValidity() — ověření formuláře a oznámení chyb
HTMLFormElement.reportValidity() kontroluje validační omezení ovládacích prvků spojených s formulářem a může uživateli oznámit chyby. Vrací boolean a samo formulář neodešle.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
form.reportValidity()HTMLFormElement.reportValidity je metoda rozhraní formuláře definovaná v HTML Living Standard, nikoli v ECMAScriptu. Volání form.reportValidity() nepřijímá žádné argumenty a synchronně vrací true, pokud jsou všechny ovládací prvky podléhající validaci platné, nebo false, pokud je alespoň jeden neplatný.
Metoda spouští interaktivní ověřování omezení, například required. U neplatných ovládacích prvků vyvolává události invalid. Prohlížeč může oznámit chyby, jejichž zpracování nebylo zrušeno; vzhled a znění zpráv závisí na prohlížeči. Volání event.preventDefault() v obsluze invalid potlačí nativní oznámení dané chyby, ale nezmění výsledek false.
Na rozdíl od reportValidity() metoda checkValidity() kontroluje omezení bez interaktivního oznamování chyb, ale také vyvolává invalid. Ani jedna z metod formulář neodesílá. Ovládací prvky vypnuté pomocí disabled se z validace vynechávají; validace na straně klienta nenahrazuje kontrolu dat na serveru.
Jde o API prohlížeče: samotná přítomnost Node 24 jeho dostupnost nedokládá. V cílovém prostředí ověřte typeof HTMLFormElement !== 'undefined' && typeof HTMLFormElement.prototype.reportValidity === 'function'. Příklad záměrně ruší invalid, aby bylo možné ověřit logické výsledky bez závislosti na rozhraní validačních zpráv.
Pří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ýsledek
false true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.