Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

FormData — vytváření a prohlížení dat formuláře

FormData ukládá uspořádané dvojice název–hodnota, a to i s opakujícími se názvy. Poznejte rozdíl mezi append() a set(), iteraci pomocí entries() a odesílání dat přes fetch().

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

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 rozhraní Web API, nikoli součást samotného ECMAScriptu. Ukládá uspořádaný seznam dvojic název–hodnota; názvy se mohou opakovat. Hodnotami jsou řetězce nebo objekty File. Můžete předat Blob, který se uloží jako soubor. Pro ostatní hodnoty platí pravidla Web IDL pro převod na řetězec. Předáte-li hodnotu typu Symbol metodě append() nebo set(), při převodu se vyvolá výjimka TypeError a žádný řetězec se neuloží.

append(name, value) přidá položku a zachová dřívější položky se stejným názvem. FormData.set, volané jako data.set(name, value), nahradí první odpovídající položku a odstraní zbývající položky s tímto názvem. Pokud název neexistuje, přidá položku na konec. U Blob můžete zadat třetí argument filename.

FormData.entries, volané jako data.entries(), vrací iterátor dvojic [name, value] v pořadí položek. V příkladu set("tag", "api") ponechá jedinou položku tag na pozici první položky, takže se objeví před name. Nejde o běžný objekt: při převodu na objekt se nezachová více hodnot pod stejným názvem.

Při odesílání pomocí fetch(url, { method: "POST", body: data }) nenastavujte hlavičku Content-Type ručně: prohlížeč vytvoří multipart/form-data s odpovídajícím parametrem boundary. Příklad žádný požadavek neodesílá. Dostupnost API ověřte v cílovém prohlížeči; přítomnost Node 24 v repozitáři nedokazuje podporu v prohlížečích.

Pří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ýsledek

tag=api
name=Ada

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje