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.