0Pricing
React Academy · Lekcja

Przesyłanie plików do backendowego API

Używanie FormData i fetch do wysyłania plików metodą POST oraz śledzenia postępu przesyłania.

Przesyłanie plików do backendowego API to bezpłatna lekcja React 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 React Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs React Academy zawiera 4 lekcji w sumie.

Witamy

W tej lekcji pozna Pani/Pan API FormData i fetch, aby wysyłać pliki do backendu metodą POST, śledzić postęp przesyłania za pomocą XMLHttpRequest oraz wyświetlać stan przesyłania w React.

API FormData

FormData to przeglądarkowe API, które tworzy treści żądań multipart/form-data — format oczekiwany przez serwery podczas przesyłania plików. Należy dodać plik oraz wszystkie pola metadanych do obiektu FormData.
const formData = new FormData();
formData.append('file', selectedFile);
formData.append('description', 'Profile photo');

Przesyłanie za pomocą fetch

Należy przekazać obiekt FormData jako treść żądania fetch. NIE należy ręcznie ustawiać Content-Type — przeglądarka automatycznie ustawi prawidłową granicę multipart.
const response = await fetch('/api/upload', {
  method: 'POST',
  body: formData,
  // Do not set Content-Type header here!
});

Zarządzanie stanem przesyłania

Należy śledzić stan przesyłania za pomocą trzech zmiennych stanu: `uploading` (boolean), `progress` (0–100) oraz `error` (string lub null). Na ich podstawie należy wyświetlać animacje ładowania, paski postępu i komunikaty o błędach.
const [uploading, setUploading] = useState(false);
const [progress, setProgress] = useState(0);
const [error, setError] = useState(null);

Postęp przesyłania za pomocą XMLHttpRequest

API fetch nie obsługuje zdarzeń informujących o postępie przesyłania. Należy użyć zdarzenia `upload.onprogress` obiektu XMLHttpRequest, aby otrzymywać aktualizacje wartości procentowej.
const xhr = new XMLHttpRequest();
xhr.upload.onprogress = (e) => {
  if (e.lengthComputable) {
    setProgress(Math.round((e.loaded / e.total) * 100));
  }
};
xhr.open('POST', '/api/upload');
xhr.send(formData);

Opakowywanie XHR w Promise

Należy opakować wywołanie XMLHttpRequest w Promise, aby można było używać await oraz obsługi błędów za pomocą async/await.
function uploadFile(file) {
  return new Promise((resolve, reject) => {
    const xhr = new XMLHttpRequest();
    xhr.onload = () => resolve(xhr.response);
    xhr.onerror = () => reject(new Error('Upload failed'));
    xhr.upload.onprogress = (e) => setProgress(Math.round(e.loaded / e.total * 100));
    xhr.open('POST', '/api/upload');
    xhr.send(new FormData().set && (() => { const f = new FormData(); f.append('file', file); xhr.send(f); })());
  });
}

Obsługa odpowiedzi serwera

Po pomyślnym przesłaniu należy przeanalizować odpowiedź serwera w formacie JSON. Następnie należy zaktualizować stan interfejsu za pomocą zwróconego adresu URL lub identyfikatora.
const res = await fetch('/api/upload', { method: 'POST', body: fd });
if (!res.ok) throw new Error('Upload failed');
const { url } = await res.json();
setUploadedUrl(url);

Obsługa błędów

Zawsze należy przechwytywać błędy sieciowe i błędy serwera. Należy wyświetlać zrozumiały dla użytkownika komunikat o błędzie i umożliwiać ponowienie próby. W bloku catch należy zresetować stan postępu oraz stan uploading.
try {
  setUploading(true);
  await uploadToServer(file);
} catch (err) {
  setError(err.message);
} finally {
  setUploading(false);
}

Anulowanie przesyłania

Za pomocą AbortController i fetch można anulować przesyłanie, które jest w toku. Należy przechowywać kontroler w ref, aby można było wywołać abort() z przycisku anulowania.
const abortRef = useRef();

const start = async () => {
  abortRef.current = new AbortController();
  await fetch('/api/upload', { body: fd, signal: abortRef.current.signal });
};
const cancel = () => abortRef.current?.abort();

Przesyłanie wielu plików

Wiele plików można przesyłać równolegle za pomocą Promise.all lub sekwencyjnie w pętli for-of. Należy śledzić postęp każdego pliku osobno, używając obiektu indeksowanego nazwą pliku.

Szybkie sprawdzenie

Dlaczego podczas używania fetch z FormData NIE należy ręcznie ustawiać nagłówka Content-Type?

Podsumowanie

Należy używać FormData do tworzenia danych do przesłania. W przypadku fetch nie należy ustawiać Content-Type, aby przeglądarka automatycznie utworzyła granicę. Do śledzenia postępu należy używać upload.onprogress w XMLHttpRequest. Należy prawidłowo obsługiwać błędy i umożliwić anulowanie za pomocą AbortController.

Kurs ukończony

Gratulacje! Ukończyła Pani/Ukończył Pan kurs **Komponenty niekontrolowane i przesyłanie plików**. Potrafi już Pani/Pan obsługiwać niekontrolowane inputy, wybieranie plików, przeciąganie i upuszczanie oraz przesyłanie danych multipart ze śledzeniem postępu.

Często zadawane pytania

Czy lekcja „Przesyłanie plików do backendowego API” jest bezpłatna?

Tak — pełny tekst „Przesyłanie plików do backendowego API” 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 React Academy, przejdź na CoddyKit PRO. Kurs React Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Przesyłanie plików do backendowego API”?

Używanie FormData i fetch do wysyłania plików metodą POST oraz śledzenia postępu przesyłania. Ćwiczysz React 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ąć React Academy?

Nie wymagamy żadnego doświadczenia. React 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 do backendowego API”?

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 React Academy?

Tak. Każda lekcja React 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

  1. Niekontrolowane pola wejściowe z useRef
  2. Pole wyboru pliku i odczytywanie danych pliku
  3. Interfejs przesyłania plików metodą przeciągnij i upuść
  4. Przesyłanie plików do backendowego API
← Powrót do React Academy