CKTIS / JavaScript
ValidityState — състояние на проверка на формулярно поле
ValidityState предоставя флагове за грешки на формулярно поле само за четене. С тях могат да се различат липсваща задължителна стойност, невалиден формат и прекалено кратък текст, с важно изключение за стойности, зададени от скриптове.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;ValidityState е интерфейс на HTML Web API, а не част от ECMAScript. Обектът, достъпен чрез input.validity, се актуализира в реално време; булевите му флагове са само за четене. ValidityState.valid има стойност true, когато нито един от останалите флагове за грешка не е зададен.
ValidityState.valueMissing показва, че ограничението required не е изпълнено: при текстово поле това означава празна стойност. ValidityState.typeMismatch означава, че стойността не отговаря на правилата за типа email или url, а не на правилата за тип данни в JavaScript. Празен имейл адрес сам по себе си не причинява тази грешка.
ValidityState.tooShort се отнася за непразна стойност, по-къса от minlength, в поле, което поддържа това ограничение. Флагът dirty value трябва да е зададен, а последната промяна на стойността трябва да е направена от потребителя. Присвояването на .value не задейства тази проверка за дължина; само по себе си minlength не изисква въвеждане на стойност.
Примерът запазва един обект на състоянието и го прочита след промените. При 'x' tooShort остава false, защото стойността се задава от скрипт. Изпълнете го в браузър; наличието на Node 24 в хранилището не доказва поддръжка на този API.
Примери
(() => {
const input = document.createElement('input');
input.type = 'email';
input.required = true;
input.minLength = 8;
const state = input.validity;
const show = () => console.log(JSON.stringify({
valid: state.valid,
valueMissing: state.valueMissing,
typeMismatch: state.typeMismatch,
tooShort: state.tooShort
}));
show();
input.value = 'x';
show();
input.value = 'a@example.com';
show();
})();Резултат
{"valid":false,"valueMissing":true,"typeMismatch":false,"tooShort":false}
{"valid":false,"valueMissing":false,"typeMismatch":true,"tooShort":false}
{"valid":true,"valueMissing":false,"typeMismatch":false,"tooShort":false}Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.