Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLFormElement.reportValidity() — walidacja formularza z informacją dla użytkownika

HTMLFormElement.reportValidity() sprawdza ograniczenia walidacyjne kontrolek powiązanych z formularzem i może pokazać błędy użytkownikowi. Zwraca boolean i samo nie wysyła formularza.

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.reportValidity()

HTMLFormElement.reportValidity to metoda interfejsu formularza zdefiniowana w HTML Living Standard, a nie w ECMAScript. Wywołanie form.reportValidity() nie przyjmuje argumentów i synchronicznie zwraca true, gdy wszystkie kontrolki podlegające walidacji są poprawne, lub false, gdy przynajmniej jedna jest niepoprawna.

Metoda uruchamia interaktywną walidację ograniczeń, takich jak required. Dla niepoprawnych kontrolek wyzwala zdarzenia invalid. Przeglądarka może zgłosić użytkownikowi błędy, których obsługa nie została anulowana; wygląd i treść komunikatów zależą od przeglądarki. Wywołanie event.preventDefault() w obsłudze invalid wyłącza natywne zgłoszenie danego błędu, ale nie zmienia wyniku false.

W odróżnieniu od reportValidity(), checkValidity() sprawdza ograniczenia bez interaktywnego zgłaszania błędów, choć także wyzwala invalid. Żadna z tych metod nie wysyła formularza. Kontrolki wyłączone przez disabled nie podlegają walidacji; walidacja po stronie klienta nie zastępuje sprawdzania danych na serwerze.

To API przeglądarkowe: obecność Node 24 nie dowodzi jego dostępności. W docelowym środowisku sprawdź typeof HTMLFormElement !== 'undefined' && typeof HTMLFormElement.prototype.reportValidity === 'function'. Przykład celowo anuluje invalid, aby sprawdzać wartości logiczne bez zależności od interfejsu komunikatów.

Przykłady

(() => {
  const form = document.createElement('form');
  const input = document.createElement('input');
  input.required = true;
  input.setAttribute('aria-label', 'Name');
  form.append(input);
  document.body.append(form);

  // Suppress native validation UI for deterministic console checks.
  input.addEventListener('invalid', event => event.preventDefault());

  console.log(form.reportValidity());
  input.value = 'Ada';
  console.log(form.reportValidity());

  form.remove();
})();

Wynik

false
true

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

Źródła