Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLFormElement.requestSubmit() — pošiljanje obrazca z validacijo

requestSubmit() zažene standardni postopek pošiljanja obrazca, ki lahko vključuje validacijo in dogodek submit. Izbirni gumb določi element, ki sproži pošiljanje, in lahko spremeni njegove nastavitve. Za razliko od submit() ta metoda teh mehanizmov ne zaobide.

Različica: 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 je metoda obrazca, določena v standardu HTML Living Standard, ne pa v ECMAScriptu. Klic form.requestSubmit() zažene postopek pošiljanja, ki se lahko konča še pred interaktivnim preverjanjem omejitev. Če obrazec na primer ni povezan z dokumentom, se postopek konča brez validacije in brez sprožitve dogodka submit. Če postopek doseže korak validacije, se ta izvede, razen če jo izklopi novalidate na obrazcu ali formnovalidate na izbranem gumbu. Neuspešna validacija ustavi pošiljanje, vendar uspešna ali preskočena validacija še ne zagotavlja sprožitve preklicljivega dogodka submit. Metoda vrne undefined, ne rezultata validacije ali obljube.

Če kot izbirni argument submitter podamo null, je učinek enak kot pri klicu brez argumenta. V obeh primerih metoda ne izbere samodejno prvega gumba, vrednost event.submitter pa je null. Samo če submitter ni null, mora biti gumb za pošiljanje, povezan s tem obrazcem. Gumb ni nujno znotraj obrazca, saj lahko povezavo določi atribut form. Element, ki ni gumb za pošiljanje, povzroči TypeError, gumb za pošiljanje, povezan z drugim obrazcem ali brez povezave z obrazcem, pa povzroči NotFoundError.

Podani gumb je na voljo prek event.submitter. Njegovi atributi formaction, formenctype, formmethod, formnovalidate in formtarget lahko vplivajo na pošiljanje, njegov par name/value pa je lahko vključen v podatke obrazca. requestSubmit() ne sproži dogodka click. Nasprotno form.submit() zaobide tako interaktivno validacijo kot dogodek submit, zato ni enakovredna zamenjava. Klic event.preventDefault() v obravnavalniku dogodka submit prepreči privzeto pošiljanje.

V primeru je obrazec povezan z dokumentom: prazno polje required prepreči prvi poskus pošiljanja, pri drugem pa se sproži dogodek submit. To je API brskalnika; prisotnost Node 24 ne dokazuje, da je na voljo. Tabela združljivosti v standardu navaja Chrome 76+, Firefox 75+ in Safari 16+; v ciljnem okolju preverite typeof HTMLFormElement === 'function' && typeof HTMLFormElement.prototype.requestSubmit === 'function'.

Primeri

(() => {
  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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri