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.