Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

FormData — vytváranie a prezeranie údajov formulára

FormData ukladá usporiadané dvojice názov–hodnota vrátane opakujúcich sa názvov. Zistite rozdiel medzi append() a set(), ako iterovať pomocou entries() a ako odosielať údaje cez fetch().

Verzia: 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 je rozhranie Web API, nie súčasť samotného ECMAScriptu. Ukladá usporiadaný zoznam dvojíc názov–hodnota; názvy sa môžu opakovať. Hodnotami sú reťazce alebo objekty File. Môžete zadať Blob, ktorý sa uloží ako súbor. Pre ostatné hodnoty platia pravidlá Web IDL na prevod na reťazec. Ak metóde append() alebo set() odovzdáte hodnotu typu Symbol, pri prevode sa vyvolá výnimka TypeError a žiadny reťazec sa neuloží.

append(name, value) pridá položku a zachová predchádzajúce položky s rovnakým názvom. FormData.set, volané ako data.set(name, value), nahradí prvú zodpovedajúcu položku a odstráni ostatné položky s týmto názvom. Ak názov neexistuje, pridá položku na koniec. Pri Blob môžete zadať tretí argument filename.

FormData.entries, volané ako data.entries(), vracia iterátor dvojíc [name, value] v poradí položiek. V príklade set("tag", "api") ponechá jedinú položku tag na pozícii prvej položky, takže sa zobrazí pred name. Nie je to obyčajný objekt: pri prevode na objekt sa nezachová viac hodnôt s rovnakým názvom.

Pri odosielaní pomocou fetch(url, { method: "POST", body: data }) nenastavujte hlavičku Content-Type ručne: prehliadač vytvorí multipart/form-data so zodpovedajúcim parametrom boundary. Príklad neodosiela žiadnu požiadavku. Dostupnosť API overte v cieľovom prehliadači; prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadačoch.

Príklady

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

Výsledok

tag=api
name=Ada

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje