Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ValidityState: wynik walidacji i przyczyny błędów

Odczytaj `element.validity`, aby odróżnić poprawny stan pola od braku wymaganej wartości, niezgodnego formatu lub zbyt krótkiej wartości wpisanej przez użytkownika.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;

element.validity zwraca obiekt ValidityState powiązany z kontrolką formularza. Jego właściwości logiczne są tylko do odczytu i odzwierciedlają bieżący stan: zachowany obiekt nie jest migawką. To API platformy WWW, a nie część ECMAScript.

valid ma wartość true tylko wtedy, gdy żadna flaga błędu nie jest ustawiona, także flaga niewymieniona tutaj, np. customError. Kilka flag błędu może mieć wartość true jednocześnie. valueMissing ma wartość true, gdy brakuje wartości wymaganej przez required, np. w pustym obowiązkowym polu e-mail.

typeMismatch ma wartość true, gdy niepusta wartość nie spełnia reguł składni HTML dla type="email" lub type="url". Dla e-maila atrybut multiple dopuszcza listę adresów rozdzielonych przecinkami. Puste wymagane pole e-mail ma valueMissing, a nie typeMismatch. Sprawdzenie składni nie potwierdza, że adres istnieje.

tooShort ma wartość true, gdy dla pola input lub textarea obowiązuje minlength, flaga zmiany wartości (dirty value flag) jest ustawiona, ostatniej zmiany wartości dokonał użytkownik, a niepusta wartość odczytywana przez API jest krótsza niż minimum w jednostkach kodowych UTF-16. Samo minlength nie czyni pola obowiązkowym. Przypisanie do .value nie wywołuje tego błędu, nawet po checkValidity() lub reportValidity().

Użyj valid, aby sprawdzić stan pola, a flag przyczyn do dobrania komunikatu. Dane przesłane na serwer sprawdzaj również po jego stronie: walidację w przeglądarce można ominąć.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ValidityState example</title>
</head>
<body>
  <label for="email">Email:</label>
  <input id="email" type="email" required minlength="8" autocomplete="off">
  <button type="button">Next</button>

  <script>
    (() => {
      const input = document.getElementById('email');
      const state = input.validity;
      const log = (step) => console.log([
        step, state.valid, state.valueMissing, state.typeMismatch, state.tooShort
      ].join(' '));

      input.value = '';
      log('empty');
      input.value = 'not-an-email';
      log('wrong-format');
      input.value = 'a@b.co';
      log('scripted-short');

      input.value = '';
      input.addEventListener('change', () => log('user-short'), { once: true });
    })();
  </script>
</body>
</html>

Wynik

empty false true false false
wrong-format false false true false
scripted-short true false false false
user-short false false false true

Otwórz przykład jako stronę HTML w przeglądarce i sprawdź wynik w konsoli. Po trzech pierwszych wierszach wpisz ręcznie `a@b.co` w polu i naciśnij Tab. Kolumny po etykiecie kroku to kolejno `valid`, `valueMissing`, `typeMismatch`, `tooShort`. Ten sam adres o długości sześciu jednostek kodowych UTF-16 ma poprawną składnię w obu przypadkach, ale narusza `minLength = 8` dopiero po ręcznej edycji.

Powiązane lekcje

  • JavaScript · Lekcja 22 · Średniozaawansowany · Wersja: 3

Źródła