CKTIS / JavaScript
HTMLFormElement.requestSubmit() — odoslanie formulára s validáciou
requestSubmit() spustí štandardný postup odoslania formulára, ktorý môže zahŕňať validáciu a udalosť submit. Voliteľné tlačidlo určuje prvok, ktorý odoslanie vyvolá, a môže zmeniť jeho nastavenia. Na rozdiel od submit() táto metóda uvedené mechanizmy neobchádza.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
form.requestSubmit();
form.requestSubmit(submitter);HTMLFormElement.requestSubmit je metóda formulára definovaná v HTML Living Standard, nie v ECMAScripte. Volanie form.requestSubmit() začne postup odoslania, ktorý sa môže skončiť ešte pred interaktívnym overením obmedzení. Ak napríklad formulár nie je pripojený k dokumentu, postup sa skončí bez validácie a bez vyvolania udalosti submit. Ak postup dospeje ku kroku validácie, validácia sa vykoná, pokiaľ ju nevypína novalidate na formulári alebo formnovalidate na vybranom tlačidle. Neúspešná validácia odoslanie zastaví, ale úspešná ani preskočená validácia nezaručuje vyvolanie zrušiteľnej udalosti submit. Metóda vracia undefined, nie výsledok validácie ani prísľub.
Zadanie hodnoty null ako voliteľného argumentu submitter má rovnaký účinok ako vynechanie argumentu. V oboch prípadoch metóda automaticky nevyberie prvé tlačidlo a event.submitter má hodnotu null. Iba ak submitter nie je null, musí ísť o odosielacie tlačidlo priradené k tomuto formuláru. Tlačidlo nemusí byť vo formulári, pretože priradenie možno nastaviť atribútom form. Prvok, ktorý nie je odosielacím tlačidlom, spôsobí TypeError; odosielacie tlačidlo priradené k inému formuláru alebo k žiadnemu formuláru spôsobí NotFoundError.
Zadané tlačidlo je dostupné ako event.submitter. Jeho atribúty formaction, formenctype, formmethod, formnovalidate a formtarget môžu ovplyvniť odoslanie a jeho dvojica name/value môže byť súčasťou údajov formulára. requestSubmit() nevyvolá udalosť click. Naopak, form.submit() obchádza interaktívnu validáciu aj udalosť submit; nejde o rovnocennú náhradu. Volanie event.preventDefault() v obsluhe udalosti submit zastaví predvolené odoslanie.
V príklade je formulár pripojený k dokumentu: prázdne pole required zablokuje prvý pokus o odoslanie a pri druhom sa vyvolá udalosť submit. Ide o API prehliadača; samotná prítomnosť Node 24 nepotvrdzuje jeho dostupnosť. Tabuľka kompatibility v štandarde uvádza Chrome 76+, Firefox 75+ a Safari 16+; v cieľovom prostredí overte typeof HTMLFormElement === 'function' && typeof HTMLFormElement.prototype.requestSubmit === 'function'.
Príklady
(() => {
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();
}
})();Výsledok
invalid submit: save submissions: 1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.