CKTIS / JavaScript
HTMLInputElement.setCustomValidity — własny błąd walidacji
HTMLInputElement.setCustomValidity ustawia lub usuwa własny błąd pola formularza. Pusty tekst usuwa ten błąd, ale nie wyłącza pozostałych ograniczeń.
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.setCustomValidity(message)HTMLInputElement.setCustomValidity to metoda przeglądarkowego API walidacji formularzy, zdefiniowana w HTML Living Standard, a nie w ECMAScript. Jest obsługiwana we współczesnych silnikach przeglądarek; obecność Node 24 nie potwierdza dostępności tego API.
Wywołanie input.setCustomValidity(message) z niepustym tekstem ustawia input.validity.customError na true. Przekazanie "" usuwa wyłącznie własny błąd: ograniczenia takie jak required nadal obowiązują. Metoda zwraca undefined, a nie wynik walidacji.
Sama metoda nie wyświetla komunikatu. checkValidity() sprawdza poprawność bez wyświetlania interfejsu błędu. Jeśli pole nie przejdzie walidacji, reportValidity() zwraca false, a przeglądarka informuje użytkownika o błędzie tylko wtedy, gdy zdarzenie invalid nie zostanie anulowane. Anulowanie zdarzenia nie zmienia zwracanej wartości. Elementy wyłączone z walidacji mogą zachować własny błąd, mimo że nie blokują walidowanego wysłania formularza.
Po zmianie wartości trzeba ponownie obliczyć regułę i jawnie usunąć nieaktualny błąd, zwykle w obsłudze zdarzenia input. W przykładzie końcowe false false oznacza brak własnego błędu, ale niespełnione required. Walidacja po stronie klienta nie zastępuje walidacji na serwerze.
Przykłady
const input = document.createElement("input");
input.required = true;
input.value = "admin";
function validate() {
input.setCustomValidity(
input.value === "admin" ? "Reserved name." : ""
);
}
validate();
console.log(input.validity.customError, input.checkValidity());
input.value = "alex";
validate();
console.log(input.validity.customError, input.checkValidity());
input.value = "";
validate();
console.log(input.validity.customError, input.checkValidity());Wynik
true false false true false false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.