0Pricing
React Academy · レッスン

バックエンドAPIへのファイルアップロード

FormDataとfetchを使ってファイルをPOSTし、アップロードの進捗を追跡します。

「バックエンドAPIへのファイルアップロード」はCoddyKit上の無料React Academyレッスンです。 これはレッスン4/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはReact Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 React Academyコースには全4レッスンが含まれています。

ようこそ

このレッスンでは、FormData API と fetch を使ってバックエンドにファイルを POST し、XMLHttpRequest でアップロードの進行状況を追跡し、React にアップロード状態を表示します。

FormData API

FormData は multipart/form-data 形式のリクエストボディを作成するブラウザー API です。この形式は、ファイルアップロードでサーバーが想定する形式です。ファイルとその他のメタデータフィールドを FormData オブジェクトに追加します。
const formData = new FormData();
formData.append('file', selectedFile);
formData.append('description', 'Profile photo');

fetch によるアップロード

FormData オブジェクトを fetch の body として渡します。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)の 3 つの state 変数で管理します。これらの値に応じて、スピナー、進行状況バー、エラーメッセージを表示します。
const [uploading, setUploading] = useState(false);
const [progress, setProgress] = useState(0);
const [error, setError] = useState(null);

XMLHttpRequest によるアップロード進行状況の取得

fetch API はアップロードの進行状況イベントに対応していません。割合の更新を取得するには、XMLHttpRequest の `upload.onprogress` イベントを使います。
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 で UI の state を更新します。
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 します。ユーザーに分かりやすいエラーメッセージを表示し、再試行できるようにします。catch ブロックで progress と uploading の state をリセットします。
try {
  setUploading(true);
  await uploadToServer(file);
} catch (err) {
  setError(err.message);
} finally {
  setUploading(false);
}

アップロードのキャンセル

fetch で AbortController を使うと、進行中のアップロードをキャンセルできます。controller を 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 ループを使って順番にアップロードします。ファイル名をキーとするオブジェクトで、ファイルごとの進行状況を管理します。

理解度チェック

FormData と fetch を使うとき、Content-Type ヘッダーを手動で設定してはいけないのはなぜでしょうか?

まとめ

FormData でアップロード用のペイロードを作成します。Content-Type を指定せずに fetch を使い、境界文字列を自動設定させます。進行状況の追跡には XMLHttpRequest の upload.onprogress を使います。エラーを適切に処理し、AbortController でキャンセルにも対応します。

コース完了

おめでとうございます! **Uncontrolled Components & File Uploads** を修了しました。これで、非制御入力、ファイル選択、ドラッグ&ドロップ、進行状況を追跡する multipart アップロードを扱えるようになりました。

よくある質問

「バックエンドAPIへのファイルアップロード」レッスンは無料ですか?

はい。「バックエンドAPIへのファイルアップロード」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し(組み込みコードエディタと24時間対応のAIチューター)、React Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 React Academyコースには全4レッスンが含まれています。

「バックエンドAPIへのファイルアップロード」で何を学びますか?

FormDataとfetchを使ってファイルをPOSTし、アップロードの進捗を追跡します。 ブラウザで直接実行するハンズオンコードでReact Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

React Academyを始めるのに経験は必要ですか?

事前経験は必要ありません。CoddyKitのReact Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン4/4です。

「バックエンドAPIへのファイルアップロード」レッスンにはどのくらい時間がかかりますか?

ほとんどのCoddyKitレッスンは約5~10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このReact Academyレッスンでコードを書いて実行できますか?

はい。すべてのReact Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. useRefによる非制御入力
  2. ファイル入力とファイルデータの読み取り
  3. ドラッグ&ドロップによるファイルアップロードUI
  4. バックエンドAPIへのファイルアップロード
← React Academyに戻る