KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

FormData — formuliergegevens maken en bekijken

FormData slaat geordende naam-waardeparen op, ook wanneer namen vaker voorkomen. Leer het verschil tussen append() en set(), hoe je met entries() itereert en hoe je de gegevens met fetch() verstuurt.

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

const data = new FormData();
data.append(name, value);
data.set(name, value);
data.set(name, blob, filename);
for (const [name, value] of data.entries()) { /* ... */ }

FormData is een interface van de Web API en geen onderdeel van ECMAScript zelf. De interface slaat een geordende lijst met naam-waardeparen op; namen mogen vaker voorkomen. Waarden zijn tekenreeksen of File-objecten. Je kunt een Blob opgeven, dat als bestand wordt opgeslagen. Voor andere waarden gelden de regels van Web IDL voor omzetting naar een tekenreeks. Geef je een Symbol-waarde door aan append() of set(), dan treedt tijdens die omzetting een TypeError op en wordt er geen tekenreeks opgeslagen.

append(name, value) voegt een item toe en behoudt eerdere items met dezelfde naam. FormData.set, aangeroepen als data.set(name, value), vervangt het eerste overeenkomende item en verwijdert de overige items met die naam. Als de naam niet bestaat, wordt er een item achteraan toegevoegd. Voor een Blob kun je een derde argument opgeven: filename.

FormData.entries, aangeroepen als data.entries(), geeft een iterator met [name, value]-paren in de volgorde van de items terug. In het voorbeeld laat set("tag", "api") één tag-item op de positie van het eerste item staan, waardoor het vóór name verschijnt. Dit is geen gewoon object: bij omzetting naar een object blijven meerdere waarden met dezelfde naam niet behouden.

Stel bij verzending met fetch(url, { method: "POST", body: data }) de Content-Type-header niet handmatig in: de browser maakt multipart/form-data met een passende boundary-parameter. Het voorbeeld verstuurt geen verzoek. Controleer of de API beschikbaar is in de doelbrowser; de aanwezigheid van Node 24 in een repository bewijst niet dat browsers de API ondersteunen.

Voorbeelden

const data = new FormData();
data.append("tag", "javascript");
data.append("tag", "web");
data.set("name", "Ada");
data.set("tag", "api");

for (const [name, value] of data.entries()) {
  console.log(`${name}=${value}`);
}

Resultaat

tag=api
name=Ada

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