Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ValidityState — stan walidacji pola formularza

ValidityState udostępnia odczytywalne flagi błędów pola formularza. Pozwala rozróżnić brak wymaganej wartości, niepoprawny format oraz zbyt krótki tekst, z ważnym wyjątkiem dla wartości ustawianych skryptem.

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

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

ValidityState to interfejs HTML Web API, a nie część ECMAScript. Obiekt dostępny przez input.validity jest aktualizowany na bieżąco; jego flagi logiczne są tylko do odczytu. ValidityState.valid ma wartość true, gdy żadna z pozostałych flag błędów nie jest ustawiona.

ValidityState.valueMissing sygnalizuje niespełnienie wymagania required: w polu tekstowym oznacza pustą wartość. ValidityState.typeMismatch oznacza niezgodność wartości z regułami typu email lub url, a nie z typem danych JavaScript. Pusty adres e-mail sam w sobie nie powoduje tego błędu.

ValidityState.tooShort dotyczy niepustej wartości krótszej niż minlength w obsługującym go polu. Wymaga ustawionej flagi zmiany wartości i ostatniej zmiany dokonanej przez użytkownika. Przypisanie do .value nie uruchamia tej kontroli długości; samo minlength nie wymaga wypełnienia pola.

Przykład zachowuje jeden obiekt stanu i odczytuje go po zmianach. Dla 'x' flaga tooShort pozostaje false, ponieważ wartość ustawia skrypt. Uruchom go w przeglądarce; obecność Node 24 w repozytorium nie dowodzi obsługi tego API.

Przykłady

(() => {
  const input = document.createElement('input');
  input.type = 'email';
  input.required = true;
  input.minLength = 8;
  const state = input.validity;

  const show = () => console.log(JSON.stringify({
    valid: state.valid,
    valueMissing: state.valueMissing,
    typeMismatch: state.typeMismatch,
    tooShort: state.tooShort
  }));

  show();
  input.value = 'x';
  show();
  input.value = 'a@example.com';
  show();
})();

Wynik

{"valid":false,"valueMissing":true,"typeMismatch":false,"tooShort":false}
{"valid":false,"valueMissing":false,"typeMismatch":true,"tooShort":false}
{"valid":true,"valueMissing":false,"typeMismatch":false,"tooShort":false}

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

Źródła