Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.valueMissing

HTMLInputElement.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.

Źródła