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.
The HTMLFormElement.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
submit
event is raised. In particular, the form'sonsubmit
event handler is not run. - Constraint validation is not triggered.
The HTMLFormElement.requestSubmit()
method is identical to activating a
form's submit <button>
and does not have these differences.
A form control (such as a submit button) with a name
or id
of submit
will mask the form's submit
method. Trying to call myForm.submit();
throws an error "submit is not a function" because in this case submit
refers to the form control which has a name
or id
of submit
.
<input>
with attribute type="submit" will not be submitted with the
form when using HTMLFormElement.submit()
, but it would be
submitted when you do it with original HTML form submit.
Syntax
submit()
Parameters
None.
Return value
None (undefined
).
Examples
document.forms["my-form"].submit();
Specifications
Specification |
---|
HTML Standard # dom-form-submit-dev |
Browser compatibility
BCD tables only load in the browser