Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje