CKTIS / JavaScript
HTMLInputElement.checkValidity() — ověření platnosti vstupního pole
Metoda checkValidity() ověřuje omezení jednoho pole input a vrací logickou hodnotu. Pokud se neplatné pole účastní validace, vyvolá událost invalid, ale sama nezobrazí chybovou zprávu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
input.checkValidity()HTMLInputElement.checkValidity je metoda instance, která se volá bez argumentů jako input.checkValidity(). Vrátí false, pokud se pole účastní validace a porušuje svá omezení; jinak vrátí true.
Omezení závisejí na typu pole a atributech, jako jsou required, pattern, min a max. Pole s atributem disabled se validace neúčastní: true tedy nemusí znamenat, že je jeho hodnota platná. Vlastnost willValidate udává, zda se pole validace účastní.
Při výsledku false metoda vyvolá událost invalid; její zrušení výsledek nezmění. Na rozdíl od reportValidity() nezobrazuje chybovou zprávu. Neodešle formulář ani nekontroluje ostatní pole.
Toto rozhraní prohlížeče definuje HTML Living Standard, nikoli ECMAScript. Podporují ho současné prohlížečové enginy; přítomnost Node 24 v repozitáři nedokazuje podporu tohoto rozhraní.
Pří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ýsledek
false true true 1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.