Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

HTMLFormElement.checkValidity() — kontrola platnosti formulára

Metóda form.checkValidity() kontroluje obmedzenia ovládacích prvkov priradených k formuláru a vracia logickú hodnotu. Formulár neodošle ani nezobrazí štandardné validačné správy prehliadača.

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

HTMLFormElement.checkValidity je metóda webového API prehliadača, nie funkcia definovaná jazykom ECMAScript. Volanie form.checkValidity() neprijíma žiadne argumenty a synchrónne vráti true, ak každý ovládací prvok, ktorý možno validovať, spĺňa svoje obmedzenia; inak vráti false.

Kontrola zahŕňa ovládacie prvky priradené k formuláru, nielen jeho potomkov. Ovládacie prvky vypnuté pomocou disabled sa preskočia. Ak nemožno validovať žiadny ovládací prvok, výsledkom je true. Metóda vyvolá udalosť invalid na každom neplatnom ovládacom prvku; zrušenie tejto udalosti nezmení výsledok na true.

Metóda formulár neodošle ani sama nezobrazí štandardné chybové rozhranie. Pomocou form.reportValidity() môžete skontrolovať problémy a oznámiť ich používateľovi. Validácia v prehliadači nenahrádza validáciu na strane servera.

Príklad vytvorí formulár s povinným textovým poľom. Prázdne pole spôsobí výsledok false a jednu udalosť invalid; po priradení hodnoty Ada je výsledkom true. Spustite kód v prehliadači: samotné prostredie Node.js 24 nedokazuje dostupnosť tohto API.

Prí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ýsledok

false
true
1

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje