JavaScript Academy · Lekcja

Przesyłanie plików za pomocą Fetch

Proszę wysyłać pliki na serwer za pomocą FormData.

Przesyłanie plików za pomocą Fetch to bezpłatna lekcja JavaScript Academy na CoddyKit. To lekcja 4 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.

Przesyłanie za pomocą fetch

Aby wysłać pliki na serwer, należy wysłać żądanie POST z treścią FormData za pomocą fetch. Przeglądarka automatycznie koduje dane jako multipart/form-data, w tym zawartość plików.

Tworzenie obiektu FormData

Należy pobrać plik z pola wejściowego i dodać go za pomocą append wraz z pozostałymi polami do obiektu FormData.

const file = document.querySelector('#picker').files[0];
const data = new FormData();
data.append('avatar', file);
data.append('userId', '42');

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

Podstawowe żądanie POST

Obiekt FormData należy przekazać jako body żądania POST wywoływanego za pomocą fetch. Odpowiedź jest obiektem Promise, którego można użyć z await.

async function upload(data) {
  const response = await fetch('/api/upload', {
    method: 'POST',
    body: data
  });
  console.log(response.status);
}

Nie ustawiaj Content-Type

Częsty błąd polega na ręcznym ustawianiu nagłówka Content-Type. Należy pozwolić przeglądarce ustawić go samodzielnie, ponieważ musi on zawierać ciąg boundary oddzielający części danych multipart. Ręczne ustawienie tego nagłówka powoduje nieprawidłowe działanie przesyłania.

const response = await fetch('/api/upload', {
  method: 'POST',
  body: formData
});

console.log('browser added the boundary automatically');

Odczytywanie odpowiedzi

Po pomyślnym przesłaniu należy sprawdzić response.ok i przeanalizować treść odpowiedzi, często w formacie JSON.

async function upload(data) {
  const response = await fetch('/api/upload', { method: 'POST', body: data });
  if (!response.ok) {
    throw new Error('upload failed: ' + response.status);
  }
  const result = await response.json();
  console.log(result);
}

Obsługa błędów

Wywołanie należy umieścić w bloku try/catch. Należy pamiętać, że fetch odrzuca Promise tylko w przypadku błędów sieci, dlatego w przypadku błędów HTTP trzeba sprawdzać response.ok.

async function upload(data) {
  try {
    const res = await fetch('/api/upload', { method: 'POST', body: data });
    if (!res.ok) throw new Error('HTTP ' + res.status);
    console.log('uploaded');
  } catch (err) {
    console.log('error:', err.message);
  }
}

Przesyłanie wielu plików

Można dodać kilka plików pod tym samym kluczem za pomocą append albo przejść pętlą po liście plików i dodać je wszystkie.

const files = document.querySelector('#picker').files;
const data = new FormData();
for (const file of files) {
  data.append('photos', file);
}

console.log(data.getAll('photos').length + ' files queued');

Dodawanie nagłówków, takich jak Auth

Można dodawać nagłówki, takie jak Authorization, ale nie Content-Type. Treścią żądania nadal pozostaje obiekt FormData.

const response = await fetch('/api/upload', {
  method: 'POST',
  headers: { Authorization: 'Bearer token123' },
  body: formData
});

console.log(response.status);

Wysyłanie wygenerowanego obiektu Blob

Można przesyłać dane utworzone w przeglądarce, a nie tylko wybrane pliki. Należy dodać obiekt Blob wraz z nazwą pliku, aby wysłać wygenerowany dokument.

const blob = new Blob([JSON.stringify({ ok: true })], {
  type: 'application/json'
});
const data = new FormData();
data.append('report', blob, 'report.json');

await fetch('/api/upload', { method: 'POST', body: data });
console.log('generated file sent');

Anulowanie przesyłania

Należy użyć obiektu AbortController, aby anulować powolne przesyłanie, na przykład gdy użytkownik opuszcza stronę.

const controller = new AbortController();
fetch('/api/upload', {
  method: 'POST',
  body: formData,
  signal: controller.signal
}).catch(e => console.log(e.name));

controller.abort();

Dlaczego ma to znaczenie

Połączenie FormData z fetch to nowoczesny, standardowy sposób przesyłania plików: należy dodać pola i pliki, wysłać FormData metodą POST i pozwolić przeglądarce zakodować dane multipart z właściwym ciągiem boundary. Należy unikać ustawiania Content-Type, zawsze sprawdzać response.ok i zwalniać używane zasoby.

async function submitForm(formEl) {
  const data = new FormData(formEl);
  const res = await fetch('/submit', { method: 'POST', body: data });
  console.log('status', res.status);
}

Szybkie sprawdzenie

Dlaczego podczas wysyłania obiektu FormData za pomocą fetch nie należy ręcznie ustawiać nagłówka Content-Type?

Podsumowanie: przesyłanie plików za pomocą fetch

Dowiedzieli się Państwo, jak wysyłać pliki na serwer:

Należy dodać pliki i pola do obiektu FormData, a następnie przekazać go jako body wywołania fetch.
Nigdy nie należy ręcznie ustawiać Content-Type; przeglądarka dodaje granicę multipart.
Należy sprawdzać response.ok, ponieważ fetch odrzuca Promise tylko w przypadku błędów sieci.
Można wysyłać wiele plików i wygenerowane obiekty Blob, a także anulować przesyłanie za pomocą AbortController.

Często zadawane pytania

Czy lekcja „Przesyłanie plików za pomocą Fetch” jest bezpłatna?

Tak — pełny tekst „Przesyłanie plików za pomocą Fetch” 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 „Przesyłanie plików za pomocą Fetch”?

Proszę wysyłać pliki na serwer za pomocą FormData. Ć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 4 z 4.

Ile czasu zajmuje lekcja „Przesyłanie plików za pomocą Fetch”?

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

Obiekt FormData
Odczytywanie plików za pomocą FileReader
Bloby i adresy URL obiektów
Przesyłanie plików za pomocą Fetch

← Powrót do JavaScript Academy