0Pricing
React Academy · Lektion

Dateien an eine Backend-API hochladen

Verwenden Sie FormData und fetch, um Dateien per POST zu senden und den Upload-Fortschritt zu verfolgen.

Dateien an eine Backend-API hochladen ist eine kostenlose React Academy-Lektion auf CoddyKit. Dies ist Lektion 4 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des React Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der React Academy-Kurs umfasst insgesamt 4 Lektionen.

Willkommen

In dieser Lektion verwenden Sie die FormData API und fetch, um Dateien an ein Backend zu übertragen, den Upload-Fortschritt mit XMLHttpRequest zu verfolgen und den Upload-Status in React anzuzeigen.

FormData API

FormData ist eine Browser-API, die Anfragerümpfe im Format multipart/form-data erstellt — dem Format, das Server für Datei-Uploads erwarten. Fügen Sie die Datei und alle Metadatenfelder einem FormData-Objekt hinzu.
const formData = new FormData();
formData.append('file', selectedFile);
formData.append('description', 'Profile photo');

Mit fetch hochladen

Übergeben Sie das FormData-Objekt als Body von fetch. Setzen Sie Content-Type NICHT manuell — der Browser legt automatisch die korrekte multipart-Grenze fest.
const response = await fetch('/api/upload', {
  method: 'POST',
  body: formData,
  // Do not set Content-Type header here!
});

Upload-Status verwalten

Verfolgen Sie den Upload-Status mit drei Statusvariablen: `uploading` (boolesch), `progress` (0–100) und `error` (String oder null). Zeigen Sie abhängig davon Ladeindikatoren, Fortschrittsbalken und Fehlermeldungen an.
const [uploading, setUploading] = useState(false);
const [progress, setProgress] = useState(0);
const [error, setError] = useState(null);

Upload-Fortschritt mit XMLHttpRequest

Die fetch API unterstützt keine Ereignisse für den Upload-Fortschritt. Verwenden Sie das Ereignis `upload.onprogress` von XMLHttpRequest, um prozentuale Aktualisierungen zu erhalten.
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);

XHR in ein Promise einschließen

Schließen Sie den XMLHttpRequest-Aufruf in ein Promise ein, damit Sie ihn mit await verwenden und die Fehlerbehandlung von async/await nutzen können.
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); })());
  });
}

Serverantwort verarbeiten

Verarbeiten Sie nach einem erfolgreichen Upload die JSON-Antwort des Servers. Aktualisieren Sie den UI-Status mit der zurückgegebenen URL oder ID.
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);

Fehlerbehandlung

Fangen Sie Netzwerk- und Serverfehler immer ab. Zeigen Sie eine verständliche Fehlermeldung an und ermöglichen Sie einen erneuten Versuch. Setzen Sie den Fortschritts- und Upload-Status im catch-Block zurück.
try {
  setUploading(true);
  await uploadToServer(file);
} catch (err) {
  setError(err.message);
} finally {
  setUploading(false);
}

Upload abbrechen

Verwenden Sie mit fetch einen AbortController, um einen laufenden Upload abzubrechen. Speichern Sie den Controller in einem Ref, damit Sie von einer Abbrechen-Schaltfläche aus abort() aufrufen können.
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();

Mehrere Dateien hochladen

Laden Sie mehrere Dateien mit Promise.all parallel oder mit einer for-of-Schleife nacheinander hoch. Verfolgen Sie den individuellen Fortschritt jeder Datei in einem nach Dateinamen indizierten Objekt.

Kurze Überprüfung

Warum sollten Sie den Content-Type-Header bei der Verwendung von fetch mit FormData NICHT manuell setzen?

Zusammenfassung

Verwenden Sie FormData, um Upload-Daten zusammenzustellen. Verwenden Sie fetch ohne Content-Type, damit die Grenze automatisch gesetzt wird. Nutzen Sie upload.onprogress von XMLHttpRequest, um den Fortschritt zu verfolgen. Behandeln Sie Fehler angemessen und unterstützen Sie das Abbrechen mit AbortController.

Kurs abgeschlossen

Herzlichen Glückwunsch! Sie haben **Unkontrollierte Komponenten und Datei-Uploads** abgeschlossen. Sie können jetzt unkontrollierte Eingaben, die Dateiauswahl, Drag-and-drop und Multipart-Uploads mit Fortschrittsverfolgung verarbeiten.

Häufig gestellte Fragen

Ist die Lektion „Dateien an eine Backend-API hochladen“ kostenlos?

Ja — der vollständige Text von „Dateien an eine Backend-API hochladen“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des React Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der React Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Dateien an eine Backend-API hochladen“?

Verwenden Sie FormData und fetch, um Dateien per POST zu senden und den Upload-Fortschritt zu verfolgen. Du übst React Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um React Academy zu starten?

Keine Vorkenntnisse erforderlich. React Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 4 von 4.

Wie lange dauert die Lektion „Dateien an eine Backend-API hochladen“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser React Academy-Lektion Code schreiben und ausführen?

Ja. Jede React Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

  1. Unkontrollierte Eingaben mit useRef
  2. Dateieingabe und Dateidaten auslesen
  3. Benutzeroberfläche für Drag-and-drop-Datei-Uploads
  4. Dateien an eine Backend-API hochladen
← Zurück zu React Academy