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

CKTIS / JavaScript

HTMLFormElement.reportValidity() — проверка на формуляр и съобщаване на грешки

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

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

Синтаксис

form.reportValidity()

HTMLFormElement.reportValidity е метод на интерфейса за формуляри, дефиниран в HTML Living Standard, а не в ECMAScript. Извикването form.reportValidity() не приема аргументи и синхронно връща true, ако всички контроли, подлежащи на валидиране, са валидни, или false, ако поне една е невалидна.

Методът изпълнява интерактивно валидиране на ограничения като required. За невалидните контроли задейства събития invalid. Браузърът може да съобщи грешките, чието обработване не е отменено; видът и текстът на съобщенията зависят от браузъра. Извикването на event.preventDefault() в обработчик на invalid потиска вграденото съобщаване за съответната грешка, но не променя резултата false.

За разлика от reportValidity(), checkValidity() проверява ограниченията без интерактивно съобщаване на грешки, но също задейства invalid. Нито един от двата метода не изпраща формуляра. Контролите, деактивирани чрез disabled, не участват във валидирането; валидирането от страна на клиента не замества проверката на данните на сървъра.

Това е API на браузъра: наличието на Node 24 не доказва, че API е достъпно. В целевата среда проверете typeof HTMLFormElement !== 'undefined' && typeof HTMLFormElement.prototype.reportValidity === 'function'. Примерът умишлено отменя invalid, за да провери булевите резултати, без да зависи от интерфейса за съобщенията за валидиране.

Примери

(() => {
  const form = document.createElement('form');
  const input = document.createElement('input');
  input.required = true;
  input.setAttribute('aria-label', 'Name');
  form.append(input);
  document.body.append(form);

  // Suppress native validation UI for deterministic console checks.
  input.addEventListener('invalid', event => event.preventDefault());

  console.log(form.reportValidity());
  input.value = 'Ada';
  console.log(form.reportValidity());

  form.remove();
})();

Резултат

false
true

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

Източници