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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.