Get to know MDN better
Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2022.
La méthode requestSubmit() de l'interface HTMLFormElement demande que le formulaire soit soumis en utilisant un bouton de soumission spécifique.
Un bouton de soumission qui est membre du formulaire.
Si le submitter précise des attributs form*, ils remplaceront le comportement de soumission du formulaire (par exemple, formmethod="POST").
Si le submitter a un attribut name ou s'il s'agit d'un <input type="image">, ses données seront incluses dans la soumission du formulaire (par exemple, btnName=btnValue).
Si vous omettez le paramètre submitter, l'élément formulaire lui‑même est utilisé comme soumetteur.
Aucun (undefined).
-- TypeError
La question évidente est : pourquoi cette méthode existe‑t‑elle, alors que nous disposons de la méthode submit() depuis toujours ?
La réponse est simple. submit() soumet le formulaire, mais c'est tout ce qu'elle fait. requestSubmit(), en revanche, agit comme si un bouton de soumission avait été cliqué. Le contenu du formulaire est validé, et le formulaire est soumis seulement si la validation réussit. Une fois le formulaire soumis, l'événement submit est renvoyé à l'objet form.
Dans l'exemple ci‑dessous, le formulaire est soumis en tentant d'utiliser requestSubmit() si cette méthode est disponible. Si un bouton de soumission ayant pour ID main-submit est trouvé, il est utilisé pour soumettre le formulaire. Sinon, le formulaire est soumis sans paramètre submitter, donc il est soumis directement par l'élément form lui‑même.
Si, en revanche, requestSubmit() n'est pas disponible, ce code revient à appeler la méthode submit() du formulaire.
| HTML # dom-form-requestsubmit-dev |
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Cette page a été modifiée le 7 déc. 2025 par les contributeur·ice·s du MDN.
Votre modèle pour un internet meilleur.
Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.