HTMLFormElement : méthode submit()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

La méthode submit() de l'interface HTMLFormElement soumet l'élément HTML <form> fourni.

Cette méthode est similaire, mais pas identique, à l'activation du <button> de soumission d'un formulaire. Lorsqu'on appelle directement cette méthode, toutefois :

Aucun évènement submit n'est déclenché. En particulier, le gestionnaire d'évènements onsubmit du formulaire n'est pas exécuté.
La validation des contraintes n'est pas déclenchée.

La méthode HTMLFormElement.requestSubmit() est équivalente à l'activation du <button> de soumission du formulaire et ne présente pas ces différences.

Un contrôle de formulaire (par exemple un bouton de soumission) dont le name ou id est submit masquera la méthode submit du formulaire. Tenter d'appeler myForm.submit(); provoque une erreur « submit is not a function » parce que, dans ce cas, submit désigne le contrôle de formulaire qui a pour name ou id la valeur submit.

Un <input> avec l'attribut type="submit" ne sera pas soumis avec le formulaire lorsque l'on utilise HTMLFormElement.submit(), alors qu'il le serait lors d'une soumission via le formulaire HTML classique.