CKTIS / JavaScript
HTMLInputElement.checkValidity() — sprawdzanie poprawności pola
Metoda checkValidity() sprawdza ograniczenia pojedynczego pola input i zwraca wartość logiczną. Dla niepoprawnego pola objętego walidacją emituje invalid, ale sama nie wyświetla komunikatu błędu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
input.checkValidity()HTMLInputElement.checkValidity to metoda instancji wywoływana jako input.checkValidity(), bez argumentów. Zwraca false, gdy pole podlega walidacji i narusza ograniczenia; w pozostałych przypadkach zwraca true.
Ograniczenia zależą od typu pola i atrybutów, takich jak required, pattern, min i max. Pole z disabled nie podlega walidacji: wynik true nie oznacza wtedy poprawnej wartości. Właściwość willValidate wskazuje, czy pole podlega walidacji.
Przy wyniku false metoda emituje zdarzenie invalid; jego anulowanie nie zmienia wyniku. W przeciwieństwie do reportValidity() nie wyświetla komunikatu błędu. Nie wysyła formularza ani nie sprawdza pozostałych pól.
To API przeglądarki określone w HTML Living Standard, nie w ECMAScript. Jest obsługiwane we współczesnych silnikach przeglądarek; obecność Node 24 w repozytorium nie dowodzi obsługi tego API.
Przykłady
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);Wynik
false true true 1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.