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.