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

CKTIS / JavaScript

FormData — ustvarjanje in pregledovanje podatkov obrazca

FormData shranjuje urejene pare ime–vrednost, tudi kadar se imena ponavljajo. Spoznajte razliko med append() in set(), iteriranje z entries() ter pošiljanje podatkov z fetch().

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

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 je vmesnik Web API, ne pa del samega ECMAScripta. Shranjuje urejen seznam parov ime–vrednost; imena se lahko ponavljajo. Vrednosti so nizi ali objekti File. Podate lahko Blob, ki se shrani kot datoteka. Za druge vrednosti veljajo pravila Web IDL za pretvorbo v niz. Če metodi append() ali set() podate vrednost tipa Symbol, se med pretvorbo sproži izjema TypeError in niz se ne shrani.

append(name, value) doda vnos in ohrani prejšnje vnose z istim imenom. FormData.set, klican kot data.set(name, value), zamenja prvi ustrezni vnos in odstrani preostale vnose s tem imenom. Če ime ne obstaja, doda vnos na konec. Za Blob lahko podate tretji argument filename.

FormData.entries, klican kot data.entries(), vrne iterator parov [name, value] v vrstnem redu vnosov. V primeru set("tag", "api") pusti en vnos tag na mestu prvega vnosa, zato se pojavi pred name. To ni navaden objekt: pri pretvorbi v objekt se več vrednosti pod istim imenom ne ohrani.

Pri pošiljanju z fetch(url, { method: "POST", body: data }) glave Content-Type ne nastavljajte ročno: brskalnik ustvari multipart/form-data z ustreznim parametrom boundary. Primer ne pošlje nobene zahteve. Razpoložljivost API-ja preverite v ciljnem brskalniku; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.

Primeri

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}`);
}

Rezultat

tag=api
name=Ada

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

Viri