HTMLFormElement: submit() method
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.
TheHTMLFormElement.submit() method submits a given<form>.
This method is similar, but not identical to, activating a form's submit<button>. When invoking this method directly, however:
- No
submitevent is raised. In particular, the form'sonsubmitevent handler is not run. - Constraint validation is not triggered.
TheHTMLFormElement.requestSubmit() method is identical to activating aform's submit<button> and does not have these differences.
A form control (such as a submit button) with aname orid ofsubmit will mask the form'ssubmit method. Trying to callmyForm.submit(); throws an error "submit is not a function" because in this casesubmit refers to the form control which has aname orid ofsubmit.
<input> with attribute type="submit" will not be submitted with theform when usingHTMLFormElement.submit(), but it would besubmitted when you do it with original HTML form submit.
In this article
Syntax
submit()Parameters
None.
Return value
None (undefined).
Examples
document.forms["my-form"].submit();Specifications
| Specification |
|---|
| HTML> # dom-form-submit-dev> |