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

CKTIS / JavaScript

HTMLFormElement.checkValidity() — preverjanje veljavnosti obrazca

Metoda form.checkValidity() preveri omejitve kontrolnikov, povezanih z obrazcem, in vrne logično vrednost. Obrazca ne pošlje in ne prikaže standardnih validacijskih sporočil brskalnika.

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

HTMLFormElement.checkValidity je metoda spletnega API-ja brskalnika, ne funkcija, ki bi jo določal ECMAScript. Klic form.checkValidity() ne sprejme argumentov in sinhrono vrne true, če vsak kontrolnik, ki ga je mogoče validirati, izpolnjuje svoje omejitve; sicer vrne false.

Preverjanje zajema kontrolnike, povezane z obrazcem, ne le njegovih potomcev. Kontrolniki, onemogočeni z disabled, so izpuščeni. Če ni nobenega kontrolnika, ki bi ga bilo mogoče validirati, je rezultat true. Metoda sproži dogodek invalid na vsakem neveljavnem kontrolniku; preklic tega dogodka rezultata ne spremeni v true.

Metoda obrazca ne pošlje in sama ne prikaže standardnega vmesnika za napake. Uporabite form.reportValidity() za preverjanje težav in njihovo sporočanje uporabniku. Validacija v brskalniku ne nadomesti validacije na strežniški strani.

Primer ustvari obrazec z obveznim besedilnim poljem. Prazno polje povzroči rezultat false in en dogodek invalid; po dodelitvi vrednosti Ada je rezultat true. Kodo zaženite v brskalniku: okolje Node.js 24 samo po sebi ne dokazuje, da je ta API na voljo.

Primeri

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

Rezultat

false
true
1

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

Viri