CKTIS / JavaScript
HTMLFormElement.requestSubmit() — slanje obrasca uz provjeru valjanosti
requestSubmit() pokreće standardni postupak slanja obrasca, koji može uključivati provjeru valjanosti i događaj submit. Neobvezni gumb određuje element koji pokreće slanje i može promijeniti njegove postavke. Za razliku od submit(), ova metoda ne zaobilazi te mehanizme.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
form.requestSubmit();
form.requestSubmit(submitter);HTMLFormElement.requestSubmit metoda je obrasca definirana u standardu HTML Living Standard, a ne u ECMAScriptu. Poziv form.requestSubmit() pokreće postupak slanja, koji može završiti i prije interaktivne provjere ograničenja. Ako, primjerice, obrazac nije povezan s dokumentom, postupak završava bez provjere valjanosti i bez pokretanja događaja submit. Ako postupak dođe do koraka provjere valjanosti, provjera se provodi osim ako je ne isključi novalidate na obrascu ili formnovalidate na odabranom gumbu. Neuspješna provjera zaustavlja slanje, ali uspješna ili preskočena provjera ne jamči pokretanje otkazivog događaja submit. Metoda vraća undefined, a ne rezultat provjere valjanosti ni obećanje.
Prosljeđivanje vrijednosti null kao neobveznog argumenta submitter ima isti učinak kao izostavljanje argumenta. U oba slučaja metoda ne odabire automatski prvi gumb, a event.submitter ima vrijednost null. Samo ako submitter nije null, mora biti gumb za slanje povezan s ovim obrascem. Gumb se ne mora nalaziti unutar obrasca jer se veza može uspostaviti atributom form. Element koji nije gumb za slanje uzrokuje TypeError, a gumb za slanje povezan s drugim obrascem ili bez veze s obrascem uzrokuje NotFoundError.
Zadani gumb dostupan je kao event.submitter. Njegovi atributi formaction, formenctype, formmethod, formnovalidate i formtarget mogu utjecati na slanje, a njegov par name/value može biti uključen u podatke obrasca. requestSubmit() ne pokreće događaj click. Nasuprot tome, form.submit() zaobilazi i interaktivnu provjeru valjanosti i događaj submit, pa nije ravnopravna zamjena. Poziv event.preventDefault() u rukovatelju događaja submit zaustavlja zadano slanje.
U primjeru je obrazac povezan s dokumentom: prazno polje required blokira prvi pokušaj slanja, a pri drugom se pokreće događaj submit. Riječ je o API-ju preglednika; sama prisutnost Node 24 ne potvrđuje njegovu dostupnost. Tablica kompatibilnosti standarda navodi Chrome 76+, Firefox 75+ i Safari 16+; u ciljnom okruženju provjerite typeof HTMLFormElement === 'function' && typeof HTMLFormElement.prototype.requestSubmit === 'function'.
Primjeri
(() => {
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();
}
})();Rezultat
invalid submit: save submissions: 1
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.