CKTIS / JavaScript
HTMLFormElement.requestSubmit() — soumettre un formulaire avec validation
requestSubmit() lance la procédure standard de soumission d’un formulaire, qui peut inclure une validation et un événement submit. Un bouton facultatif indique quel élément déclenche la soumission et peut en modifier les paramètres. Contrairement à submit(), cette méthode ne contourne pas ces mécanismes.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
form.requestSubmit();
form.requestSubmit(submitter);HTMLFormElement.requestSubmit est une méthode de formulaire définie par le HTML Living Standard, et non par ECMAScript. L’appel form.requestSubmit() lance la procédure de soumission, qui peut s’arrêter avant la validation interactive des contraintes. Par exemple, si le formulaire n’est pas rattaché au document, la procédure s’arrête sans effectuer de validation ni déclencher d’événement submit. Si la procédure atteint l’étape de validation, la validation a lieu sauf si novalidate sur le formulaire ou formnovalidate sur le bouton sélectionné la désactive. Un échec de la validation arrête la soumission, mais une validation réussie ou ignorée ne garantit pas le déclenchement d’un événement submit annulable. La méthode renvoie undefined, et non un résultat de validation ni une promesse.
Passer null comme argument facultatif submitter revient à omettre l’argument. Dans les deux cas, la méthode ne sélectionne pas automatiquement le premier bouton et event.submitter vaut null. Ce n’est que si submitter est différent de null qu’il doit s’agir d’un bouton de soumission associé à ce formulaire. Le bouton n’a pas besoin de se trouver à l’intérieur du formulaire, car l’attribut form peut établir cette association. Un élément qui n’est pas un bouton de soumission provoque TypeError, tandis qu’un bouton de soumission associé à un autre formulaire ou à aucun formulaire provoque NotFoundError.
Le bouton transmis est accessible avec event.submitter. Ses attributs formaction, formenctype, formmethod, formnovalidate et formtarget peuvent influer sur la soumission, et sa paire name/value peut être incluse dans les données du formulaire. requestSubmit() ne déclenche pas d’événement click. En revanche, form.submit() contourne à la fois la validation interactive et l’événement submit ; ce n’est pas un remplacement équivalent. Appeler event.preventDefault() dans le gestionnaire submit empêche la soumission par défaut.
Dans l’exemple, le formulaire est rattaché au document : un champ required vide bloque la première tentative de soumission, tandis que la seconde atteint l’événement submit. Il s’agit d’une API de navigateur ; la présence de Node 24 ne prouve pas qu’elle est disponible. Le tableau de compatibilité du standard indique Chrome 76+, Firefox 75+ et Safari 16+ ; vérifiez dans l’environnement cible typeof HTMLFormElement === 'function' && typeof HTMLFormElement.prototype.requestSubmit === 'function'.
Exemples
(() => {
const form = document.createElement('form');
const input = document.createElement('input');
input.name = 'topic';
input.required = true;
const button = document.createElement('button');
button.type = 'submit';
button.name = 'action';
button.value = 'save';
form.append(input, button);
document.body.append(form);
let submissions = 0;
input.addEventListener('invalid', event => {
event.preventDefault();
console.log('invalid');
});
form.addEventListener('submit', event => {
event.preventDefault();
submissions++;
console.log('submit: ' + event.submitter.value);
});
try {
form.requestSubmit(button);
input.value = 'JavaScript';
form.requestSubmit(button);
console.log('submissions: ' + submissions);
} finally {
form.remove();
}
})();Résultat
invalid submit: save submissions: 1
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.