CKTIS / JavaScript
FormData — създаване и преглеждане на данни от формуляр
FormData съхранява подредени двойки име–стойност, включително с повтарящи се имена. Научете разликата между append() и set(), как се обхожда с entries() и как данните се изпращат чрез fetch().
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
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 е интерфейс от Web API, а не част от самия ECMAScript. Той съхранява подреден списък от двойки име–стойност; имената могат да се повтарят. Стойностите са низове или обекти File. Можете да подадете Blob, който се съхранява като файл. За останалите стойности се прилагат правилата на Web IDL за преобразуване в низ. Ако подадете стойност от тип Symbol на append() или set(), при преобразуването се хвърля изключение TypeError и не се съхранява низ.
append(name, value) добавя запис, като запазва предишните записи със същото име. FormData.set, извикан като data.set(name, value), заменя първия съвпадащ запис и премахва останалите записи с това име. Ако името не съществува, добавя запис в края. За Blob можете да подадете трети аргумент filename.
FormData.entries, извикан като data.entries(), връща итератор от двойки [name, value] в реда на записите. В примера set("tag", "api") оставя един запис tag на позицията на първия запис, затова той се появява преди name. Това не е обикновен обект: при преобразуване в обект няма да се запазят множество стойности под едно и също име.
При изпращане чрез fetch(url, { method: "POST", body: data }) не задавайте ръчно заглавката Content-Type: браузърът създава multipart/form-data с подходящ параметър boundary. Примерът не изпраща заявка. Проверете наличността на API в целевия браузър; наличието на Node 24 в хранилище не доказва поддръжка в браузърите.
Примери
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}`);
}Резултат
tag=api name=Ada
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.