CKTIS / JavaScript
HTMLFormElement.requestSubmit() — inviare un modulo con la convalida
requestSubmit() avvia la procedura standard di invio del modulo, che può includere la convalida e un evento submit. Un pulsante opzionale identifica l’elemento che avvia l’invio e può modificarne le impostazioni. A differenza di submit(), questo metodo non aggira tali meccanismi.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
form.requestSubmit();
form.requestSubmit(submitter);HTMLFormElement.requestSubmit è un metodo dei moduli definito da HTML Living Standard, non da ECMAScript. La chiamata form.requestSubmit() avvia la procedura di invio, che può interrompersi prima della convalida interattiva dei vincoli. Per esempio, se il modulo non è collegato al documento, la procedura termina senza eseguire la convalida né generare un evento submit. Se la procedura raggiunge la fase di convalida, questa viene eseguita a meno che novalidate sul modulo o formnovalidate sul pulsante selezionato non la disattivi. Se la convalida fallisce, l’invio si interrompe, ma superarla o saltarla non garantisce che venga generato un evento submit annullabile. Il metodo restituisce undefined, non un risultato della convalida né una promessa.
Passare null come argomento opzionale submitter equivale a omettere l’argomento. In entrambi i casi il metodo non seleziona automaticamente il primo pulsante e event.submitter vale null. Solo se submitter è diverso da null deve essere un pulsante di invio associato a questo modulo. Il pulsante non deve necessariamente trovarsi all’interno del modulo, perché l’attributo form può stabilire l’associazione. Un elemento che non è un pulsante di invio causa TypeError, mentre un pulsante di invio associato a un altro modulo o a nessun modulo causa NotFoundError.
Il pulsante fornito è disponibile tramite event.submitter. I suoi attributi formaction, formenctype, formmethod, formnovalidate e formtarget possono influire sull’invio; inoltre, la coppia name/value può essere inclusa nei dati del modulo. requestSubmit() non genera un evento click. Al contrario, form.submit() aggira sia la convalida interattiva sia l’evento submit; non è un sostituto equivalente. Chiamare event.preventDefault() nel gestore submit interrompe l’invio predefinito.
Nell’esempio il modulo è collegato al documento: un campo required vuoto blocca il primo tentativo di invio, mentre il secondo arriva all’evento submit. Questa è un’API del browser; la presenza di Node 24 non ne dimostra la disponibilità. La tabella di compatibilità dello standard indica Chrome 76+, Firefox 75+ e Safari 16+; verifica typeof HTMLFormElement === 'function' && typeof HTMLFormElement.prototype.requestSubmit === 'function' nell’ambiente di destinazione.
Esempi
(() => {
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();
}
})();Risultato
invalid submit: save submissions: 1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.