JavaScript Academy · Lekcja

Obiekt FormData

Proszę tworzyć wieloczęściowe ładunki danych z formularzy.

Obiekt FormData to bezpłatna lekcja JavaScript Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej JavaScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs JavaScript Academy zawiera 4 lekcji w sumie.

Czym jest FormData

FormData to interfejs API przeglądarki służący do tworzenia zestawu par klucz/wartość reprezentujących pola formularza i ich wartości. Jest to standardowy sposób pakowania danych, w tym plików, w celu wysłania ich na serwer.

Dane są kodowane jako multipart/form-data, który obsługuje przesyłanie danych binarnych.

Tworzenie pustego FormData

Należy utworzyć pusty obiekt FormData i dodawać pola pojedynczo za pomocą append.

const data = new FormData();
data.append('username', 'ada');
data.append('email', 'ada@example.com');

console.log(data.get('username'));

Tworzenie na podstawie elementu formularza

Do konstruktora należy przekazać element <form>, a każde nazwane pole wejściowe zostanie przechwycone automatycznie. To najczęstszy sposób użycia.

const form = document.querySelector('#signup');
const data = new FormData(form);

for (const [key, value] of data.entries()) {
  console.log(key, value);
}

append a set

append dodaje wartość, nawet jeśli dany klucz już istnieje, dzięki czemu jeden klucz może mieć wiele wartości. set zastępuje wszystkie istniejące wartości danego klucza.

const data = new FormData();
data.append('tag', 'a');
data.append('tag', 'b');
console.log(data.getAll('tag'));

data.set('tag', 'only');
console.log(data.getAll('tag'));

Odczytywanie wartości

get zwraca pierwszą wartość danego klucza, getAll zwraca wszystkie wartości jako tablicę, a has sprawdza, czy klucz istnieje.

const data = new FormData();
data.append('color', 'red');
data.append('color', 'blue');

console.log(data.get('color'));
console.log(data.getAll('color'));
console.log(data.has('color'));

Usuwanie pól

delete usuwa wszystkie wartości danego klucza. Jest to przydatne do usuwania pól przed wysłaniem danych.

const data = new FormData();
data.append('keep', '1');
data.append('remove', '2');

data.delete('remove');
console.log(data.has('remove'));
console.log(data.has('keep'));

Iterowanie po wpisach

Obiekt FormData jest iterowalny. Aby przejść po wszystkich parach, można użyć entries, keys lub values, a także pętli for...of.

const data = new FormData();
data.append('a', '1');
data.append('b', '2');

for (const key of data.keys()) {
  console.log('field: ' + key);
}

Dodawanie plików

Metoda append może przyjąć obiekt File lub Blob jako wartość. Opcjonalny trzeci argument określa nazwę pliku wysyłaną na serwer.

const fileInput = document.querySelector('#avatar');
const data = new FormData();
data.append('avatar', fileInput.files[0], 'profile.png');

console.log(data.get('avatar').name);

Dlaczego multipart/form-data

FormData jest serializowany jako multipart/form-data, który umożliwia przesłanie zarówno pól tekstowych, jak i binarnej zawartości plików w treści jednego żądania. Dlatego właśnie jest to podstawowy format używany do przesyłania plików.

const data = new FormData();
data.append('title', 'Vacation Photo');
data.append('photo', new Blob(['binary'], { type: 'image/png' }), 'pic.png');

console.log(data.has('photo'));

Konwertowanie na obiekt

W przypadku prostych formularzy zawierających wyłącznie tekst metoda Object.fromEntries może przekształcić FormData w zwykły obiekt. Należy pamiętać, że zachowuje ona tylko jedną wartość dla powtarzającego się klucza.

const form = document.querySelector('#login');
const data = new FormData(form);
const plain = Object.fromEntries(data.entries());

console.log(plain);

Dlaczego FormData jest ważny

FormData łączy formularze HTML z żądaniami sieciowymi. Zbiera pola i pliki, obsługuje powtarzające się klucze oraz bezpiecznie koduje dane binarne. Następnie odczytamy zawartość plików za pomocą FileReader, a potem wyślemy FormData za pomocą fetch.

const form = document.querySelector('#contact');
const data = new FormData(form);
data.append('source', 'web');

console.log([...data.keys()]);

Szybkie sprawdzenie

Jaka jest różnica między append a set w obiekcie FormData?

Podsumowanie: obiekt FormData

Dowiedzieli się Państwo, jak pakować dane formularza:

new FormData(form) automatycznie przechwytuje nazwane pola wejściowe.
append umożliwia używanie powtarzających się kluczy, a set je zastępuje.
Wartości można odczytywać za pomocą get, getAll i has, a iterować po nich za pomocą entries.
Dane są kodowane jako multipart/form-data, co umożliwia obsługę plików i danych binarnych.

Często zadawane pytania

Czy lekcja „Obiekt FormData” jest bezpłatna?

Tak — pełny tekst „Obiekt FormData” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu JavaScript Academy, przejdź na CoddyKit PRO. Kurs JavaScript Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Obiekt FormData”?

Proszę tworzyć wieloczęściowe ładunki danych z formularzy. Ćwiczysz JavaScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć JavaScript Academy?

Nie wymagamy żadnego doświadczenia. JavaScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.

Ile czasu zajmuje lekcja „Obiekt FormData”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji JavaScript Academy?

Tak. Każda lekcja JavaScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do JavaScript Academy