HTMLFormElement: submit() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die HTMLFormElement.submit()-Methode sendet ein angegebenes <form> ab.

Diese Methode ähnelt dem Aktivieren eines submit-<button> eines Formulars, ist jedoch nicht identisch. Beim direkten Aufrufen dieser Methode:

  • Wird kein submit-Ereignis ausgelöst. Insbesondere wird der onsubmit-Ereignishandler des Formulars nicht ausgeführt.
  • Wird die Constraint-Validierung nicht ausgelöst.

Die HTMLFormElement.requestSubmit()-Methode ist identisch mit der Aktivierung eines submit-<button> und hat diese Unterschiede nicht.

Ein Steuerelement des Formulars (wie ein Submit-Button) mit einem name- oder id-Attribut von submit wird die submit-Methode des Formulars maskieren. Der Versuch, myForm.submit(); aufzurufen, führt zu einem Fehler "submit is not a function", da in diesem Fall submit sich auf das Steuerelement des Formulars bezieht, das einen name oder id von submit hat.

Ein <input> mit dem Attribut type="submit" wird nicht mit dem Formular gesendet, wenn Sie HTMLFormElement.submit() verwenden, aber es würde gesendet werden, wenn Sie es mit der ursprünglichen HTML-Formularübermittlung tun.

Syntax

js
submit()

Parameter

Keine.

Rückgabewert

Keiner (undefined).

Beispiele

js
document.forms["my-form"].submit();

Spezifikationen

Specification
HTML
# dom-form-submit-dev

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
submit

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support