CKTIS / JavaScript
HTMLInputElement.validity — състояние на валидност на поле за въвеждане
HTMLInputElement.validity предоставя текущото състояние на проверката на ограниченията на поле за въвеждане като обект ValidityState. Флаговете му обозначават конкретни проблеми, а valid показва дали няма зададен флаг за грешка.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
input.validity
input.validity.valid
input.validity.valueMissingHTMLInputElement.validity е свойство само за четене, което връща жив обект ValidityState: запазена препратка отразява последващи промени в полето за въвеждане. Флаговете му също са само за четене. Този API на браузъра е дефиниран от HTML, а не от ECMAScript; наличието на Node.js само по себе си не гарантира поддръжка.
valueMissing показва липсваща задължителна стойност, typeMismatch — формат, несъответстващ на типа, а patternMismatch — несъответствие с pattern. Останалите флагове за грешка са tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput и customError. Приложимостта им зависи от типа на полето и ограниченията. valid е true, когато всички флагове за грешка са false.
Четенето на validity не показва съобщение и не задейства invalid. checkValidity() проверява контролата и може да задейства invalid; reportValidity() може допълнително да покаже проблема на потребителя. willValidate определя участието във валидирането: деактивирано поле за въвеждане все пак може да има флагове за грешка, въпреки че не участва в проверката.
setCustomValidity('Blocked') задава customError; изчистете го с setCustomValidity(''). Самото коригиране на стойността не премахва грешката. Примерът показва актуализациите чрез запазения обект state, без повторно прочитане на input.validity. Проверката в браузъра не замества проверките на данните от страна на сървъра.
Примери
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);Резултат
true false false true true false false true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.