Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLFormElement.reportValidity() — preverjanje obrazca in poročanje o napakah

HTMLFormElement.reportValidity() preveri omejitve preverjanja kontrolnikov, povezanih z obrazcem, in lahko uporabniku sporoči napake. Vrne logično vrednost in obrazca ne pošlje samodejno.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

form.reportValidity()

HTMLFormElement.reportValidity je metoda vmesnika obrazca, določena v HTML Living Standard, ne pa v ECMAScriptu. Klic form.reportValidity() ne sprejme argumentov in sinhrono vrne true, če so vsi kontrolniki, ki se preverjajo, veljavni, oziroma false, če je vsaj eden neveljaven.

Metoda izvede interaktivno preverjanje omejitev, kot je required. Pri neveljavnih kontrolnikih sproži dogodke invalid. Brskalnik lahko sporoči napake, katerih obravnava ni bila preklicana; videz in besedilo sporočil sta odvisna od brskalnika. Klic event.preventDefault() v obravnavalniku invalid prepreči izvorno poročanje o tej napaki, ne spremeni pa rezultata false.

Za razliko od reportValidity() metoda checkValidity() preveri omejitve brez interaktivnega poročanja o napakah, vendar prav tako sproži invalid. Nobena od metod ne pošlje obrazca. Kontrolniki, onemogočeni z disabled, so izključeni iz preverjanja; preverjanje na strani odjemalca ne nadomesti preverjanja podatkov na strežniku.

To je API brskalnika: prisotnost Node 24 ne dokazuje, da je API na voljo. V ciljnem okolju preverite typeof HTMLFormElement !== 'undefined' && typeof HTMLFormElement.prototype.reportValidity === 'function'. Primer namerno prekliče invalid, da preveri logične rezultate brez odvisnosti od uporabniškega vmesnika za validacijska sporočila.

Primeri

(() => {
  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();
})();

Rezultat

false
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri