CKTIS / JavaScript
HTMLInputElement.validity — stan poprawności pola
HTMLInputElement.validity udostępnia bieżący stan spełnienia ograniczeń pola jako obiekt ValidityState. Jego flagi wskazują konkretne problemy, a valid informuje, czy żadna flaga błędu nie jest ustawiona.
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
input.validity
input.validity.valid
input.validity.valueMissingHTMLInputElement.validity jest właściwością tylko do odczytu, zwracającą żywy obiekt ValidityState: zachowana referencja odzwierciedla późniejsze zmiany pola. Flagi również są tylko do odczytu. To API przeglądarki określone w HTML, nie funkcja ECMAScript; sama dostępność Node.js nie zapewnia jego obsługi.
valueMissing oznacza brak wymaganej wartości, typeMismatch niezgodność z formatem typu, a patternMismatch niezgodność z pattern. Pozostałe flagi błędów to tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput i customError. Ich zastosowanie zależy od typu pola i ograniczeń. valid ma wartość true, gdy wszystkie flagi błędów są false.
Odczyt validity nie wyświetla komunikatu ani nie wywołuje zdarzenia invalid. checkValidity() sprawdza pole i może wywołać invalid; reportValidity() może dodatkowo pokazać problem użytkownikowi. willValidate określa udział w walidacji: pole wyłączone może nadal mieć flagi błędów, choć nie uczestniczy w sprawdzaniu.
setCustomValidity('Blocked') ustawia customError; usuń błąd przez setCustomValidity(''). Sama poprawa wartości go nie usuwa. Przykład pokazuje aktualizację zachowanego obiektu state bez ponownego odczytu input.validity. Walidacja przeglądarki nie zastępuje sprawdzania danych na serwerze.
Przykłady
const input = document.createElement('input');
input.type = 'email';
input.required = true;
const state = input.validity;
console.log(state.valueMissing, state.valid);
input.value = 'learner@example.com';
console.log(state.valueMissing, state.valid);
input.setCustomValidity('Blocked');
console.log(state.customError, state.valid);
input.setCustomValidity('');
console.log(state.customError, state.valid);Wynik
true false false true true false false true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.