CKTIS / JavaScript
HTMLInputElement.checkValidity() — preverjanje veljavnosti vnosnega polja
Metoda checkValidity() preveri omejitve enega polja input in vrne logično vrednost. Če neveljavno polje sodeluje pri preverjanju, sproži invalid, vendar sama ne prikaže sporočila o napaki.
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
input.checkValidity()HTMLInputElement.checkValidity je metoda primerka, ki jo brez argumentov pokličemo kot input.checkValidity(). Vrne false, kadar polje sodeluje pri preverjanju in krši svoje omejitve; sicer vrne true.
Omejitve so odvisne od vrste polja in atributov, kot so required, pattern, min in max. Polje z atributom disabled ne sodeluje pri preverjanju: true zato ne pomeni nujno, da je njegova vrednost veljavna. Lastnost willValidate pove, ali polje sodeluje.
Če je rezultat false, metoda sproži dogodek invalid; njegova preklic ne spremeni rezultata. Za razliko od reportValidity() ne prikaže sporočila o napaki. Ne pošlje obrazca in ne preveri drugih polj.
Ta brskalniški API določa HTML Living Standard, ne ECMAScript. Podpirajo ga sodobni brskalniški pogoni; prisotnost Node 24 v repozitoriju ne dokazuje podpore za ta API.
Primeri
const input = document.createElement('input');
input.type = 'text';
input.required = true;
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });
console.log(input.checkValidity());
input.value = 'Ada';
console.log(input.checkValidity());
input.value = '';
input.disabled = true;
console.log(input.checkValidity());
console.log(invalidEvents);Rezultat
false true 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.