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

CKTIS / JavaScript

HTMLFormElement.requestSubmit() — изпращане на формуляр с проверка

requestSubmit() стартира стандартната процедура за изпращане на формуляр, която може да включва проверка и събитие submit. Незадължителен бутон указва кой елемент задейства изпращането и може да променя настройките му. За разлика от submit(), този метод не заобикаля тези механизми.

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

Синтаксис

form.requestSubmit();
form.requestSubmit(submitter);

HTMLFormElement.requestSubmit е метод на формуляр, дефиниран в HTML Living Standard, а не в ECMAScript. Извикването на form.requestSubmit() стартира процедурата за изпращане, която може да приключи преди интерактивната проверка на ограниченията. Например, ако формулярът не е свързан с документа, процедурата приключва, без да се извърши проверка и без да се задейства събитие submit. Ако процедурата стигне до стъпката за проверка, тя се извършва, освен ако novalidate на формуляра или formnovalidate на избрания бутон не я изключва. Неуспешната проверка спира изпращането, но успешната или пропуснатата проверка не гарантира, че ще се задейства отменяемо събитие submit. Методът връща undefined, а не резултат от проверката или Promise.

Подаването на null като незадължителен аргумент submitter е равнозначно на пропускането на аргумента. И в двата случая методът не избира автоматично първия бутон, а event.submitter има стойност null. Само ако submitter не е null, той трябва да е бутон за изпращане, свързан с този формуляр. Не е необходимо бутонът да се намира във формуляра, защото атрибутът form може да установи връзката. Елемент, който не е бутон за изпращане, причинява TypeError, а бутон за изпращане, който е свързан с друг формуляр или не е свързан с никакъв формуляр, причинява NotFoundError.

Подаденият бутон е достъпен чрез event.submitter. Атрибутите му formaction, formenctype, formmethod, formnovalidate и formtarget могат да повлияят на изпращането, а двойката му name/value може да бъде включена в данните на формуляра. requestSubmit() не генерира събитие click. За разлика от него form.submit() заобикаля както интерактивната проверка, така и събитието submit; той не е равностоен заместител. Извикването на event.preventDefault() в обработчика на submit спира изпращането по подразбиране.

В примера формулярът е свързан с документа: празно поле required блокира първия опит за изпращане, а при втория се задейства събитието submit. Това е API на браузъра; наличието на Node 24 не доказва, че API е достъпен. Таблицата за съвместимост в стандарта посочва Chrome 76+, Firefox 75+ и Safari 16+; проверете typeof HTMLFormElement === 'function' && typeof HTMLFormElement.prototype.requestSubmit === 'function' в целевата среда.

Примери

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

  const button = document.createElement('button');
  button.type = 'submit';
  button.name = 'action';
  button.value = 'save';
  form.append(input, button);
  document.body.append(form);

  let submissions = 0;
  input.addEventListener('invalid', event => {
    event.preventDefault();
    console.log('invalid');
  });
  form.addEventListener('submit', event => {
    event.preventDefault();
    submissions++;
    console.log('submit: ' + event.submitter.value);
  });

  try {
    form.requestSubmit(button);
    input.value = 'JavaScript';
    form.requestSubmit(button);
    console.log('submissions: ' + submissions);
  } finally {
    form.remove();
  }
})();

Резултат

invalid
submit: save
submissions: 1

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

Източници