0Pricing
React Academy · บทเรียน

การอัปโหลดไฟล์ไปยังแบ็กเอนด์ API

ใช้ FormData และ fetch เพื่อส่งไฟล์ด้วย POST และติดตามความคืบหน้าการอัปโหลด

การอัปโหลดไฟล์ไปยังแบ็กเอนด์ API เป็นบทเรียน React Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 4 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน React Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส React Academy มีบทเรียนทั้งหมด 4 บทเรียน

ยินดีต้อนรับ

ในบทเรียนนี้ คุณจะใช้ FormData API และฟังก์ชันดึงข้อมูลเพื่อ POST ไฟล์ไปยังเซิร์ฟเวอร์ฝั่งหลังบ้าน ติดตามความคืบหน้าการอัปโหลดด้วย XMLHttpRequest และแสดงสถานะการอัปโหลดใน React

API ของ FormData

FormData เป็น API ของเบราว์เซอร์ที่สร้างเนื้อหาคำขอแบบ multipart/form-data ซึ่งเป็นรูปแบบที่เซิร์ฟเวอร์คาดหวังสำหรับการอัปโหลดไฟล์ ให้เพิ่มไฟล์และฟิลด์ข้อมูลกำกับที่ต้องการลงในออบเจ็กต์ 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
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 ติดตามความคืบหน้าของแต่ละไฟล์ด้วยออบเจ็กต์ที่ใช้ชื่อไฟล์เป็นคีย์

ตรวจสอบอย่างรวดเร็ว

เหตุใดจึงไม่ควรกำหนดส่วนหัว Content-Type ด้วยตนเองเมื่อใช้ fetch กับ FormData

สรุปทบทวน

ใช้ FormData เพื่อสร้างข้อมูลสำหรับการอัปโหลด เรียกใช้ fetch โดยไม่กำหนด Content-Type เพื่อให้สร้างขอบเขตโดยอัตโนมัติ ใช้เหตุการณ์ upload.onprogress ของ XMLHttpRequest เพื่อติดตามความคืบหน้า จัดการข้อผิดพลาดอย่างเหมาะสมและรองรับการยกเลิกด้วย AbortController

จบหลักสูตร

ขอแสดงความยินดี! คุณเรียนจบ **องค์ประกอบแบบไม่ควบคุมและการอัปโหลดไฟล์** แล้ว ขณะนี้คุณสามารถจัดการช่องป้อนแบบไม่ควบคุม การเลือกไฟล์ การลากแล้ววาง และการอัปโหลดแบบหลายส่วนพร้อมติดตามความคืบหน้าได้

คำถามที่พบบ่อย

บทเรียน “การอัปโหลดไฟล์ไปยังแบ็กเอนด์ API” ฟรีหรือไม่

ใช่ — ข้อความเต็มของ “การอัปโหลดไฟล์ไปยังแบ็กเอนด์ API” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส React Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส React Academy มีบทเรียนทั้งหมด 4 บทเรียน

คุณจะเรียนรู้อะไรในบทเรียน “การอัปโหลดไฟล์ไปยังแบ็กเอนด์ API”

ใช้ FormData และ fetch เพื่อส่งไฟล์ด้วย POST และติดตามความคืบหน้าการอัปโหลด คุณปฏิบัติ React Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 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