KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLFormElement.requestSubmit() — een formulier verzenden met validatie

requestSubmit() start de standaardprocedure voor het verzenden van een formulier, die validatie en een submit-event kan omvatten. Een optionele knop geeft aan welk element de verzending start en kan de instellingen ervan wijzigen. In tegenstelling tot submit() omzeilt deze methode deze mechanismen niet.

Versie: 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 is een formuliermethode die is gedefinieerd in de HTML Living Standard, niet in ECMAScript. De aanroep form.requestSubmit() start de verzendprocedure, die al vóór de interactieve beperkingsvalidatie kan stoppen. Als het formulier bijvoorbeeld niet met het document is verbonden, stopt de procedure zonder validatie uit te voeren of een submit-event te activeren. Bereikt de procedure de validatiestap, dan wordt de validatie uitgevoerd, tenzij novalidate op het formulier of formnovalidate op de geselecteerde knop die uitschakelt. Als de validatie mislukt, stopt de verzending, maar ook als de validatie slaagt of wordt overgeslagen, is een annuleerbaar submit-event niet gegarandeerd. De methode retourneert undefined, geen validatieresultaat of Promise.

null meegeven als optioneel argument submitter heeft hetzelfde effect als het argument weglaten. In beide gevallen selecteert de methode niet automatisch de eerste knop en is event.submitter gelijk aan null. Alleen als submitter niet null is, moet het een verzendknop zijn die aan dit formulier is gekoppeld. De knop hoeft niet in het formulier te staan, omdat het form-attribuut die koppeling kan instellen. Een element dat geen verzendknop is, veroorzaakt TypeError; een verzendknop die aan een ander formulier of aan geen enkel formulier is gekoppeld, veroorzaakt NotFoundError.

De opgegeven knop is beschikbaar als event.submitter. De attributen formaction, formenctype, formmethod, formnovalidate en formtarget kunnen de verzending beïnvloeden; ook kan het name/value-paar deel uitmaken van de formuliergegevens. requestSubmit() verstuurt geen click-event. form.submit() omzeilt daarentegen zowel de interactieve validatie als het submit-event en is geen gelijkwaardige vervanging. Met event.preventDefault() in de submit-handler voorkom je de standaardverzending.

In het voorbeeld is het formulier met het document verbonden: een leeg required-veld blokkeert de eerste verzendpoging en bij de tweede wordt het submit-event geactiveerd. Dit is een browser-API; de aanwezigheid van Node 24 bewijst niet dat deze beschikbaar is. De compatibiliteitstabel van de standaard vermeldt Chrome 76+, Firefox 75+ en Safari 16+; controleer in de doelomgeving typeof HTMLFormElement === 'function' && typeof HTMLFormElement.prototype.requestSubmit === 'function'.

Voorbeelden

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

Resultaat

invalid
submit: save
submissions: 1

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen