CKTIS / JavaScript
HTMLFormElement.requestSubmit() — Formular mit Validierung absenden
requestSubmit() startet das standardmäßige Formularübermittlungsverfahren, das eine Validierung und ein submit-Ereignis umfassen kann. Eine optionale Schaltfläche legt fest, welches Element das Absenden auslöst, und kann die Übermittlungseinstellungen ändern. Anders als submit() umgeht diese Methode diese Mechanismen nicht.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
form.requestSubmit();
form.requestSubmit(submitter);HTMLFormElement.requestSubmit ist eine Formularmethode, die im HTML Living Standard und nicht in ECMAScript definiert ist. Der Aufruf form.requestSubmit() startet das Übermittlungsverfahren, das schon vor der interaktiven Einschränkungsvalidierung enden kann. Ist das Formular beispielsweise nicht mit dem Dokument verbunden, endet das Verfahren ohne Validierung und ohne submit-Ereignis. Erreicht das Verfahren den Validierungsschritt, wird validiert, sofern nicht novalidate am Formular oder formnovalidate an der ausgewählten Schaltfläche die Validierung deaktiviert. Schlägt die Validierung fehl, wird die Übermittlung gestoppt. Eine erfolgreiche oder übersprungene Validierung garantiert jedoch nicht, dass ein abbrechbares submit-Ereignis ausgelöst wird. Die Methode gibt undefined zurück, weder ein Validierungsergebnis noch ein Promise.
Wird für das optionale Argument submitter der Wert null übergeben, verhält sich die Methode genauso wie ohne Argument. In beiden Fällen wählt sie nicht automatisch die erste Schaltfläche aus, und event.submitter ist null. Nur wenn submitter nicht null ist, muss es sich um eine mit diesem Formular verknüpfte Absende-Schaltfläche handeln. Sie muss sich nicht im Formular befinden, da das form-Attribut die Verknüpfung herstellen kann. Ein Element, das keine Absende-Schaltfläche ist, verursacht TypeError; eine Absende-Schaltfläche, die mit einem anderen oder mit keinem Formular verknüpft ist, verursacht NotFoundError.
Die übergebene Schaltfläche ist über event.submitter verfügbar. Ihre Attribute formaction, formenctype, formmethod, formnovalidate und formtarget können die Übermittlung beeinflussen; außerdem kann ihr name/value-Paar in die Formulardaten eingehen. requestSubmit() löst kein click-Ereignis aus. Im Gegensatz dazu umgeht form.submit() sowohl die interaktive Validierung als auch das submit-Ereignis und ist kein gleichwertiger Ersatz. event.preventDefault() im submit-Handler verhindert die standardmäßige Übermittlung.
Im Beispiel ist das Formular mit dem Dokument verbunden: Ein leeres required-Feld blockiert den ersten Absendeversuch; beim zweiten wird das submit-Ereignis ausgelöst. Dies ist eine Browser-API; Node 24 allein belegt nicht, dass sie verfügbar ist. Die Kompatibilitätstabelle des Standards nennt Chrome 76+, Firefox 75+ und Safari 16+; prüfe in der Zielumgebung typeof HTMLFormElement === 'function' && typeof HTMLFormElement.prototype.requestSubmit === 'function'.
Beispiele
(() => {
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();
}
})();Ergebnis
invalid submit: save submissions: 1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.