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 gegebenes <form> ab.

Diese Methode ist ähnlich, aber nicht identisch mit dem Aktivieren eines Absende-<button> eines Formulars. Bei direkter Anwendung dieser Methode jedoch:

  • Wird kein submit Ereignis ausgelöst. Insbesondere wird der onsubmit Ereignishandler des Formulars nicht ausgeführt.
  • Die Einschränkungsvalidierung wird nicht ausgelöst.

Die HTMLFormElement.requestSubmit() Methode ist identisch mit dem Aktivieren eines Absende-<button> eines Formulars und weist diese Unterschiede nicht auf.

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

<input> mit dem Attribut type="submit" wird nicht mit dem Formular gesendet, wenn man HTMLFormElement.submit() verwendet, aber es würde gesendet werden, wenn Sie das originäre HTML-Formular-Submit verwenden.

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