Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

FormData — izrada i pregled podataka obrasca

FormData pohranjuje uređene parove naziv–vrijednost, uključujući ponovljene nazive. Saznajte razliku između append() i set(), kako iterirati pomoću entries() i kako slati podatke putem fetch().

Verzija: 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 sučelje Web API-ja, a ne dio samog ECMAScripta. Pohranjuje uređeni popis parova naziv–vrijednost; nazivi se mogu ponavljati. Vrijednosti su nizovi znakova ili objekti File. Možete zadati Blob, koji se pohranjuje kao datoteka. Za ostale vrijednosti primjenjuju se pravila Web IDL-a za pretvorbu u niz znakova. Ako metodi append() ili set() proslijedite vrijednost tipa Symbol, tijekom pretvorbe dolazi do iznimke TypeError i nijedan se niz znakova ne pohranjuje.

append(name, value) dodaje unos i zadržava ranije unose s istim nazivom. FormData.set, pozvan kao data.set(name, value), zamjenjuje prvi odgovarajući unos i uklanja preostale unose s tim nazivom. Ako naziv ne postoji, dodaje unos na kraj. Za Blob možete zadati treći argument filename.

FormData.entries, pozvan kao data.entries(), vraća iterator parova [name, value] redoslijedom unosa. U primjeru set("tag", "api") ostavlja jedan unos tag na mjestu prvog unosa pa se pojavljuje prije name. To nije običan objekt: pretvorbom u objekt neće se sačuvati više vrijednosti pod istim nazivom.

Pri slanju pomoću fetch(url, { method: "POST", body: data }) nemojte ručno postavljati zaglavlje Content-Type: preglednik stvara multipart/form-data s odgovarajućim parametrom boundary. Primjer ne šalje zahtjev. Provjerite dostupnost API-ja u ciljnom pregledniku; prisutnost Node 24 u repozitoriju ne dokazuje podršku u preglednicima.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori