База знанияИзпитен център
BGБългарски
Избери език13

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}

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници