CKTIS / JavaScript
FormData — budowanie i przeglądanie danych formularza
FormData przechowuje uporządkowane pary nazw i wartości, również z powtarzającymi się nazwami. Poznaj różnicę między append() i set(), iterowanie przez entries() oraz zasady wysyłania danych przez fetch().
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
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 to interfejs Web API, a nie element samego ECMAScript. Przechowuje uporządkowaną listę par nazwa–wartość; nazwy mogą się powtarzać. Wartościami są ciągi znaków lub obiekty File. Można przekazać Blob, który zostanie zapisany jako plik. W przypadku pozostałych wartości stosuje się konwersję na ciąg znaków zgodnie z regułami Web IDL. Przekazanie wartości typu Symbol do append() lub set() powoduje zgłoszenie wyjątku TypeError podczas tej konwersji; żaden ciąg znaków nie zostaje zapisany.
append(name, value) dopisuje wpis, zachowując wcześniejsze wpisy o tej samej nazwie. FormData.set, wywoływane jako data.set(name, value), zastępuje pierwszy pasujący wpis i usuwa pozostałe o tej nazwie. Gdy nazwa nie istnieje, dopisuje wpis na końcu. Dla Blob można podać trzeci argument filename.
FormData.entries, wywoływane jako data.entries(), zwraca iterator par [name, value] w kolejności wpisów. W przykładzie set("tag", "api") pozostawia jeden wpis tag w miejscu pierwszego, dlatego pojawia się on przed name. To nie jest zwykły obiekt: zamiana na obiekt nie zachowa wielu wartości pod tą samą nazwą.
Przy wysyłaniu przez fetch(url, { method: "POST", body: data }) nie ustawiaj ręcznie nagłówka Content-Type: przeglądarka tworzy multipart/form-data z pasującym parametrem boundary. Przykład nie wysyła żądania. Dostępność API należy sprawdzić w docelowej przeglądarce; obecność Node 24 w repozytorium nie dowodzi obsługi w przeglądarkach.
Przykłady
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}`);
}Wynik
tag=api name=Ada
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.