Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

HTMLFormElement.requestSubmit() — odeslání formuláře s validací

requestSubmit() spustí standardní postup odeslání formuláře, který může zahrnovat validaci a událost submit. Volitelné tlačítko určuje prvek, který odeslání vyvolá, a může změnit jeho nastavení. Na rozdíl od submit() tato metoda uvedené mechanismy neobchází.

Verze: 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 je metoda formuláře definovaná v HTML Living Standard, nikoli v ECMAScriptu. Volání form.requestSubmit() zahájí postup odeslání, který může skončit ještě před interaktivním ověřením omezení. Pokud například formulář není připojen k dokumentu, postup skončí bez provedení validace a bez vyvolání události submit. Pokud postup dospěje ke kroku validace, validace proběhne, ledaže ji vypíná novalidate u formuláře nebo formnovalidate u vybraného tlačítka. Neúspěšná validace odeslání zastaví, ale úspěšná ani přeskočená validace nezaručuje vyvolání zrušitelné události submit. Metoda vrací undefined, nikoli výsledek validace ani příslib.

Předání hodnoty null jako volitelného argumentu submitter je stejné jako vynechání argumentu. V obou případech metoda automaticky nevybere první tlačítko a event.submitter má hodnotu null. Pouze pokud submitter není null, musí jít o odesílací tlačítko přiřazené k tomuto formuláři. Tlačítko nemusí být uvnitř formuláře, protože přiřazení lze nastavit atributem form. Prvek, který není odesílacím tlačítkem, způsobí TypeError; odesílací tlačítko přiřazené k jinému formuláři nebo k žádnému formuláři způsobí NotFoundError.

Zadané tlačítko je dostupné jako event.submitter. Jeho atributy formaction, formenctype, formmethod, formnovalidate a formtarget mohou ovlivnit odeslání a jeho dvojice name/value může být součástí dat formuláře. requestSubmit() nevyvolá událost click. Naproti tomu form.submit() obchází interaktivní validaci i událost submit; nejde o rovnocennou náhradu. Volání event.preventDefault() v obsluze události submit zastaví výchozí odeslání.

V příkladu je formulář připojen k dokumentu: prázdné pole required zablokuje první pokus o odeslání a při druhém se vyvolá událost submit. Jde o API prohlížeče; samotná přítomnost Node 24 nepotvrzuje jeho dostupnost. Tabulka kompatibility ve standardu uvádí Chrome 76+, Firefox 75+ a Safari 16+; v cílovém prostředí ověřte typeof HTMLFormElement === 'function' && typeof HTMLFormElement.prototype.requestSubmit === 'function'.

Pří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ýsledek

invalid
submit: save
submissions: 1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje