CKTIS / JavaScript
HTMLInputElement.setCustomValidity — персонализирана грешка при проверка
HTMLInputElement.setCustomValidity задава или изчиства персонализираната грешка на поле във формуляр. Празният низ изчиства тази грешка, но не изключва останалите ограничения.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
input.setCustomValidity(message)HTMLInputElement.setCustomValidity е метод от API за проверка на формуляри в браузъра, дефиниран от HTML Living Standard, а не от ECMAScript. Поддържа се от съвременните браузърни енджини; наличието на Node 24 не доказва, че този API е достъпен.
Извикването на input.setCustomValidity(message) с непразен низ задава input.validity.customError на true. Подаването на "" изчиства само персонализираната грешка: ограничения като required продължават да важат. Методът връща undefined, а не резултат от проверка.
Методът сам по себе си не показва съобщение. checkValidity() проверява валидността, без да показва съобщение за грешка. Ако полето не премине проверката, reportValidity() връща false, а браузърът уведомява потребителя за проблема само ако събитието invalid не е отменено. Отмяната на събитието не променя върнатата стойност. Елементи, изключени от проверката, могат да запазят персонализирана грешка, въпреки че не блокират валидираното изпращане на формуляр.
След промяна на стойността преизчислете правилото и изрично изчистете всяка остаряла грешка, обикновено в обработчик на събитието input. В примера крайното false false означава, че няма персонализирана грешка, но required не е изпълнено. Проверката от страна на клиента не заменя проверката от страна на сървъра.
Примери
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());Резултат
true false false true false false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.