Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła