0Pricing
React Academy · Leçon

Téléverser des fichiers vers une API principale

Utilisez FormData et fetch pour envoyer des fichiers avec POST et suivre la progression du téléversement.

Téléverser des fichiers vers une API principale est une leçon React Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage React Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours React Academy comprend 4 leçons au total.

Bienvenue

Dans cette leçon, vous allez utiliser l’API FormData et fetch pour envoyer des fichiers vers un serveur principal avec POST, suivre la progression du téléversement avec XMLHttpRequest et afficher l’état du téléversement dans React.

API FormData

FormData est une API du navigateur qui construit le corps des requêtes multipart/form-data — le format attendu par les serveurs pour les téléversements de fichiers. Ajoutez le fichier et tous les champs de métadonnées à un objet FormData.
const formData = new FormData();
formData.append('file', selectedFile);
formData.append('description', 'Profile photo');

Téléverser avec fetch

Transmettez l’objet FormData comme corps de la requête fetch. Ne définissez PAS Content-Type manuellement : le navigateur définit automatiquement la limite multipart appropriée.
const response = await fetch('/api/upload', {
  method: 'POST',
  body: formData,
  // Do not set Content-Type header here!
});

Gestion de l’état du téléversement

Suivez l’état du téléversement avec trois variables d’état : `uploading` (booléen), `progress` (de 0 à 100) et `error` (chaîne ou valeur nulle). Affichez des indicateurs de chargement, des barres de progression et des messages d’erreur en fonction de ces valeurs.
const [uploading, setUploading] = useState(false);
const [progress, setProgress] = useState(0);
const [error, setError] = useState(null);

Progression du téléversement avec XMLHttpRequest

L’API fetch ne prend pas en charge les événements de progression du téléversement. Utilisez l’événement `upload.onprogress` de XMLHttpRequest pour obtenir des mises à jour en pourcentage.
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);

Encapsuler XHR dans une Promise

Encapsulez l’appel XMLHttpRequest dans une Promise afin de pouvoir l’attendre et utiliser la gestion des erreurs avec 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); })());
  });
}

Gérer la réponse du serveur

Analysez la réponse JSON du serveur après un téléversement réussi. Mettez à jour l’état de l’interface avec l’URL ou l’identifiant renvoyé.
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);

Gestion des erreurs

Interceptez toujours les erreurs réseau et serveur. Affichez un message d’erreur compréhensible pour l’utilisateur et permettez une nouvelle tentative. Réinitialisez la progression et l’état uploading dans le bloc catch.
try {
  setUploading(true);
  await uploadToServer(file);
} catch (err) {
  setError(err.message);
} finally {
  setUploading(false);
}

Annuler un téléversement

Utilisez un AbortController avec fetch pour annuler un téléversement en cours. Stockez le contrôleur dans une référence afin de pouvoir appeler abort() depuis un bouton d’annulation.
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();

Téléversements de plusieurs fichiers

Téléversez plusieurs fichiers en parallèle avec Promise.all, ou séquentiellement avec une boucle for-of. Suivez la progression de chaque fichier au moyen d’un objet indexé par le nom du fichier.

Vérification rapide

Pourquoi ne devez-vous PAS définir manuellement l’en-tête Content-Type lorsque vous utilisez fetch avec FormData ?

Récapitulatif

Utilisez FormData pour construire les données à téléverser. Utilisez fetch sans Content-Type pour laisser le navigateur créer automatiquement la limite. Utilisez upload.onprogress de XMLHttpRequest pour suivre la progression. Gérez les erreurs avec élégance et prenez en charge l’annulation avec AbortController.

Cours terminé

Félicitations ! Vous avez terminé **Composants non contrôlés et téléversements de fichiers**. Vous savez maintenant gérer les champs non contrôlés, la sélection de fichiers, le glisser-déposer et les téléversements multipart avec suivi de la progression.

Questions Fréquemment Posées

La leçon « Téléverser des fichiers vers une API principale » est-elle gratuite ?

Oui — le texte complet de « Téléverser des fichiers vers une API principale » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours React Academy, passe à CoddyKit PRO. Le cours React Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Téléverser des fichiers vers une API principale » ?

Utilisez FormData et fetch pour envoyer des fichiers avec POST et suivre la progression du téléversement. Tu pratiques React Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer React Academy ?

Aucune expérience préalable n'est requise. React Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Téléverser des fichiers vers une API principale » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon React Academy ?

Oui. Chaque leçon React Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Entrées non contrôlées avec useRef
  2. Entrée de fichier et lecture des données
  3. Interface de téléversement par glisser-déposer
  4. Téléverser des fichiers vers une API principale
← Retour à React Academy