CKTIS / JavaScript
HTMLInputElement.checkValidity() — overenie platnosti vstupného poľa
Metóda checkValidity() overuje obmedzenia jedného poľa input a vracia logickú hodnotu. Ak sa neplatné pole zúčastňuje validácie, vyvolá udalosť invalid, ale sama nezobrazí chybovú správu.
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
input.checkValidity()HTMLInputElement.checkValidity je metóda inštancie, ktorá sa volá bez argumentov ako input.checkValidity(). Vráti false, ak sa pole zúčastňuje validácie a porušuje svoje obmedzenia; inak vráti true.
Obmedzenia závisia od typu poľa a atribútov, ako sú required, pattern, min a max. Pole s atribútom disabled sa validácie nezúčastňuje: true teda nemusí znamenať, že jeho hodnota je platná. Vlastnosť willValidate udáva, či sa pole zúčastňuje validácie.
Pri výsledku false metóda vyvolá udalosť invalid; jej zrušenie výsledok nezmení. Na rozdiel od reportValidity() nezobrazuje chybovú správu. Neodošle formulár ani nekontroluje ostatné polia.
Toto rozhranie prehliadača definuje HTML Living Standard, nie ECMAScript. Podporujú ho súčasné prehliadačové enginy; prítomnosť Node 24 v repozitári nedokazuje podporu tohto rozhrania.
Príklady
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);Výsledok
false true 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.