0Pricing
React Academy · Урок

Загрузка файлов в серверный API

Используйте FormData и fetch, чтобы отправлять файлы методом POST и отслеживать ход загрузки.

«Загрузка файлов в серверный API» — бесплатный урок React Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения React Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс React Academy содержит 4 уроков всего.

Добро пожаловать

В этом уроке Вы будете использовать API FormData и fetch, чтобы отправлять файлы на серверную часть, отслеживать ход загрузки с помощью XMLHttpRequest и отображать состояние загрузки в React.

API FormData

FormData — это браузерный API, который формирует тела запросов multipart/form-data — формат, ожидаемый серверами при загрузке файлов. Вызовите append, чтобы добавить файл и любые поля метаданных в объект FormData.
const formData = new FormData();
formData.append('file', selectedFile);
formData.append('description', 'Profile photo');

Загрузка с помощью fetch

Передайте объект FormData в качестве тела запроса fetch. НЕ устанавливайте заголовок Content-Type вручную — браузер автоматически задаст правильную границу multipart.
const response = await fetch('/api/upload', {
  method: 'POST',
  body: formData,
  // Do not set Content-Type header here!
});

Управление состоянием загрузки

Отслеживайте состояние загрузки с помощью трёх переменных состояния: `uploading` (логическое значение), `progress` (0–100) и `error` (строка или null). На их основе отображайте индикаторы загрузки, полосы прогресса и сообщения об ошибках.
const [uploading, setUploading] = useState(false);
const [progress, setProgress] = useState(0);
const [error, setError] = useState(null);

Отслеживание хода загрузки с помощью XMLHttpRequest

API fetch не поддерживает события хода загрузки. Используйте событие `upload.onprogress` объекта XMLHttpRequest, чтобы получать обновления в процентах.
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 в Promise

Оберните вызов XMLHttpRequest в Promise, чтобы можно было использовать await и обработку ошибок с помощью 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); })());
  });
}

Обработка ответа сервера

Разберите JSON-ответ сервера после успешной загрузки. Обновите состояние интерфейса возвращённым URL или 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);

Обработка ошибок

Всегда перехватывайте сетевые ошибки и ошибки сервера. Отображайте понятное пользователю сообщение об ошибке и разрешайте повторить попытку. В блоке catch сбрасывайте состояние progress и uploading.
try {
  setUploading(true);
  await uploadToServer(file);
} catch (err) {
  setError(err.message);
} finally {
  setUploading(false);
}

Отмена загрузки

Используйте AbortController вместе с fetch, чтобы отменить загрузку, которая ещё выполняется. Сохраните контроллер в ref, чтобы можно было вызвать abort() из кнопки отмены.
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();

Загрузка нескольких файлов

Загружайте несколько файлов параллельно с помощью Promise.all или последовательно с помощью цикла for-of. Отслеживайте отдельный прогресс каждого файла в объекте, ключами которого служат имена файлов.

Быстрая проверка

Почему при использовании fetch с FormData не следует вручную устанавливать заголовок Content-Type?

Итоги

Используйте FormData для формирования данных загрузки. Вызывайте fetch без Content-Type, чтобы граница добавлялась автоматически. Используйте upload.onprogress объекта XMLHttpRequest для отслеживания хода загрузки. Корректно обрабатывайте ошибки и поддерживайте отмену с помощью AbortController.

Курс завершён

Поздравляем! Вы завершили курс **Неконтролируемые компоненты и загрузка файлов**. Теперь Вы умеете работать с неконтролируемыми полями ввода, выбором файлов, перетаскиванием и многокомпонентной загрузкой с отслеживанием хода выполнения.

Часто задаваемые вопросы

Урок «Загрузка файлов в серверный API» бесплатный?

Да — полный текст урока «Загрузка файлов в серверный API» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс React Academy, подпишись на CoddyKit PRO. Курс React Academy содержит 4 уроков всего.

Чему я научусь в уроке «Загрузка файлов в серверный API»?

Используйте FormData и fetch, чтобы отправлять файлы методом POST и отслеживать ход загрузки. Ты практикуешь React Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать React Academy?

Предыдущий опыт не требуется. React Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.

Сколько времени занимает урок «Загрузка файлов в серверный API»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке React Academy?

Да. Каждый урок React Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Неконтролируемые поля ввода с useRef
  2. Поле выбора файла и чтение данных файла
  3. Интерфейс загрузки файлов перетаскиванием
  4. Загрузка файлов в серверный API
← Назад к React Academy