Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLFormElement.checkValidity() — sprawdzanie poprawności formularza

Metoda form.checkValidity() sprawdza ograniczenia kontrolek powiązanych z formularzem i zwraca wartość logiczną. Nie wysyła formularza ani nie wyświetla standardowych komunikatów walidacji.

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

form.checkValidity()

HTMLFormElement.checkValidity to metoda przeglądarkowego Web API, a nie funkcja zdefiniowana przez ECMAScript. Wywołanie form.checkValidity() nie przyjmuje argumentów i synchronicznie zwraca true, gdy wszystkie kontrolki podlegające walidacji spełniają swoje ograniczenia; w przeciwnym razie zwraca false.

Sprawdzane są kontrolki powiązane z formularzem, nie tylko jego potomkowie. Kontrolki wyłączone przez disabled są pomijane. Jeśli żadna kontrolka nie podlega walidacji, wynik to true. Dla każdej niepoprawnej kontrolki metoda wywołuje zdarzenie invalid; anulowanie tego zdarzenia nie zmienia wyniku na true.

Metoda nie wysyła formularza ani sama nie pokazuje standardowego interfejsu błędów. Do sprawdzenia połączonego z pokazaniem problemów służy form.reportValidity(). Walidacja w przeglądarce nie zastępuje walidacji po stronie serwera.

Przykład tworzy formularz z wymaganym polem tekstowym. Puste pole powoduje wynik false i jedno zdarzenie invalid; po przypisaniu Ada wynik to true. Uruchom kod w przeglądarce: samo środowisko Node.js 24 nie dowodzi dostępności tego API.

Przykłady

(() => {
  const form = document.createElement('form');
  const input = document.createElement('input');
  input.required = true;
  form.append(input);

  let invalidEvents = 0;
  input.addEventListener('invalid', () => { invalidEvents += 1; });

  console.log(form.checkValidity());
  input.value = 'Ada';
  console.log(form.checkValidity());
  console.log(invalidEvents);
})();

Wynik

false
true
1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła