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

CKTIS / JavaScript

HTMLFormElement.checkValidity() — проверка на валидността на формуляр

Методът form.checkValidity() проверява ограниченията на контролите, свързани с даден формуляр, и връща булева стойност. Той не изпраща формуляра и не показва стандартните съобщения за валидация на браузъра.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

form.checkValidity()

HTMLFormElement.checkValidity е метод от Web API на браузъра, а не функция, дефинирана от ECMAScript. Извикването form.checkValidity() не приема аргументи и синхронно връща true, ако всяка контрола, подлежаща на валидация, отговаря на ограниченията си; в противен случай връща false.

Проверката обхваща контролите, свързани с формуляра, а не само неговите наследници. Контролите, деактивирани чрез disabled, се пропускат. Ако няма контроли, подлежащи на валидация, резултатът е true. Методът задейства събитие invalid за всяка невалидна контрола; отмяната на това събитие не променя резултата на true.

Методът не изпраща формуляра и сам не показва стандартния интерфейс за грешки. Използвайте form.reportValidity(), за да проверите проблемите и да ги съобщите на потребителя. Валидацията в браузъра не заменя валидацията от страна на сървъра.

Примерът създава формуляр със задължително текстово поле. Празното поле дава резултат false и едно събитие invalid; след задаване на Ada резултатът е true. Изпълнете кода в браузър: само среда Node.js 24 не доказва, че този API е наличен.

Примери

(() => {
  const form = document.createElement('form');
  const input = document.createElement('input');
  input.required = true;
  form.append(input);

  let invalidEvents = 0;
  input.addEventListener('invalid', () => { invalidEvents += 1; });

  console.log(form.checkValidity());
  input.value = 'Ada';
  console.log(form.checkValidity());
  console.log(invalidEvents);
})();

Резултат

false
true
1

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

Източници