MDN self-hosted library · e01.org

HTMLFormElement: submit() method

HTML DOM

HTML DOM

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's onsubmit 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

Browser compatibility