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 Standard
# dom-form-submit-dev

Browser-Kompatibilität

BCD tables only load in the browser