Элемент HTMLFormElement: метод requestSubmit()

Метод HTMLFormElement requestSubmit() запрашивает отправку формы с использованием определённой кнопки отправки.

submitter Необязательно

Кнопка отправки, которая является членом формы.

Если submitter указывает form* атрибуты, они переопределят поведение отправки формы (например, formmethod="POST").

Если у submitter есть name атрибут или это <input type="image">, его данные будут включены в отправку формы (например, btnName=btnValue).

Если вы опустите параметр submitter, в качестве кнопки отправки будет использоваться сам элемент формы.

None (undefined).

TypeError

Выбрасывается, если указанная submitter не является кнопкой отправки.

NotFoundError DOMException

Выбрасывается, если указанная submitter не является членом формы, к которой был вызван метод requestSubmit(). Кнопка отправки должна быть потомком элемента формы или иметь атрибут form, ссылающийся на форму.

Очевидный вопрос: зачем этот метод, если у нас есть метод submit() с незапамятных времён?

Ответ прост. Метод submit() отправляет форму, но только это. requestSubmit(), с другой стороны, действует так, как будто была нажата кнопка отправки. Содержимое формы проверяется, и форма отправляется только в случае успешной проверки. После отправки формы генерируется событие submit и возвращается в объект формы.

В примере ниже форма отправляется путём попытки отправить запрос с использованием requestSubmit(), если он доступен. Если найдена кнопка отправки с идентификатором main-submit, она используется для отправки формы. В противном случае форма отправляется без параметра submitter, то есть отправляется непосредственно самой формой.

Если requestSubmit() недоступен, этот код использует метод submit() формы в качестве резервного варианта.

let myForm = document.querySelector("form");
let submitButton = myForm.querySelector("#main-submit");

if (myForm.requestSubmit) {
  if (submitButton) {
    myForm.requestSubmit(submitButton);
  } else {
    myForm.requestSubmit();
  }
} else {
  myForm.submit();
}