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

CKTIS / JavaScript

HTMLFormElement.checkValidity() — kontrola platnosti formuláře

Metoda form.checkValidity() kontroluje omezení ovládacích prvků přiřazených k formuláři a vrací logickou hodnotu. Formulář neodesílá ani nezobrazuje standardní validační zprávy prohlížeče.

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.checkValidity()

HTMLFormElement.checkValidity je metoda webového API prohlížeče, nikoli funkce definovaná jazykem ECMAScript. Volání form.checkValidity() nepřijímá žádné argumenty a synchronně vrací true, pokud každý ovládací prvek, který lze validovat, splňuje svá omezení; jinak vrací false.

Kontrola zahrnuje ovládací prvky přiřazené k formuláři, nejen jeho potomky. Ovládací prvky vypnuté pomocí disabled se přeskočí. Pokud nelze validovat žádný ovládací prvek, výsledkem je true. Metoda vyvolá událost invalid na každém neplatném ovládacím prvku; zrušení této události nezmění výsledek na true.

Metoda formulář neodesílá ani sama nezobrazuje standardní chybové rozhraní. Pomocí form.reportValidity() můžete problémy zkontrolovat a oznámit uživateli. Validace v prohlížeči nenahrazuje validaci na straně serveru.

Příklad vytvoří formulář s povinným textovým polem. Prázdné pole způsobí výsledek false a jednu událost invalid; po přiřazení hodnoty Ada je výsledkem true. Spusťte kód v prohlížeči: samotné prostředí Node.js 24 nedokládá dostupnost tohoto API.

Příklady

(() => {
  const form = document.createElement('form');
  const input = document.createElement('input');
  input.required = true;
  form.append(input);

  let invalidEvents = 0;
  input.addEventListener('invalid', () => { invalidEvents += 1; });

  console.log(form.checkValidity());
  input.value = 'Ada';
  console.log(form.checkValidity());
  console.log(invalidEvents);
})();

Výsledek

false
true
1

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