Akademi JavaScript · Pelajaran

Memuat Naik Fail dengan Fetch

Hantar fail ke pelayan dengan FormData.

Pelajaran 4 daripada 413 langkah

Memuat Naik Fail dengan Fetch ialah pelajaran Akademi JavaScript percuma di CoddyKit. Ini ialah pelajaran 4 daripada 4. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Akademi JavaScript, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Akademi JavaScript merangkumi sejumlah 4 pelajaran.

Memuat Naik dengan fetch

Untuk menghantar fail kepada pelayan, lakukan POST dengan badan FormData menggunakan fetch. Pelayar mengendalikan pengekodan multipart/form-data untuk anda, termasuk kandungan fail.

Membina FormData

Kumpulkan fail daripada masukan dan tambahkan fail itu, bersama-sama medan lain, kepada objek FormData.

const file = document.querySelector('#picker').files[0];
const data = new FormData();
data.append('avatar', file);
data.append('userId', '42');

console.log(data.has('avatar'));

POST Asas

Luluskan FormData sebagai body bagi fetch POST. Responsnya ialah Promise yang boleh anda tunggu dengan await.

async function upload(data) {
  const response = await fetch('/api/upload', {
    method: 'POST',
    body: data
  });
  console.log(response.status);
}

Jangan Tetapkan Content-Type

Kesilapan biasa: menetapkan Content-Type secara manual. Biarkan pelayar menetapkannya kerana ia mesti menyertakan rentetan sempadan multipart. Menetapkannya sendiri akan merosakkan muat naik.

const response = await fetch('/api/upload', {
  method: 'POST',
  body: formData
});

console.log('browser added the boundary automatically');

Membaca Respons

Semak response.ok dan huraikan badan, lazimnya JSON, selepas muat naik berjaya.

async function upload(data) {
  const response = await fetch('/api/upload', { method: 'POST', body: data });
  if (!response.ok) {
    throw new Error('upload failed: ' + response.status);
  }
  const result = await response.json();
  console.log(result);
}

Mengendalikan Ralat

Bungkus panggilan dalam try/catch. Perhatikan bahawa fetch hanya menolak apabila berlaku kegagalan rangkaian, jadi anda mesti menyemak response.ok untuk status ralat HTTP.

async function upload(data) {
  try {
    const res = await fetch('/api/upload', { method: 'POST', body: data });
    if (!res.ok) throw new Error('HTTP ' + res.status);
    console.log('uploaded');
  } catch (err) {
    console.log('error:', err.message);
  }
}

Memuat Naik Berbilang Fail

Tambahkan beberapa fail di bawah kunci yang sama dengan append, atau ulangi senarai fail untuk menambahkan semuanya.

const files = document.querySelector('#picker').files;
const data = new FormData();
for (const file of files) {
  data.append('photos', file);
}

console.log(data.getAll('photos').length + ' files queued');

Menambahkan Pengepala seperti Pengesahan

Anda boleh menambahkan pengepala seperti Authorization, tetapi bukan Content-Type. Badan permintaan kekal sebagai FormData.

const response = await fetch('/api/upload', {
  method: 'POST',
  headers: { Authorization: 'Bearer token123' },
  body: formData
});

console.log(response.status);

Menghantar Gumpalan Data yang Dijana

Anda boleh memuat naik data yang dicipta dalam pelayar, bukan hanya fail yang dipilih. Tambahkan gumpalan data bersama nama fail untuk menghantar dokumen yang dijana.

const blob = new Blob([JSON.stringify({ ok: true })], {
  type: 'application/json'
});
const data = new FormData();
data.append('report', blob, 'report.json');

await fetch('/api/upload', { method: 'POST', body: data });
console.log('generated file sent');

Membatalkan Muat Naik

Gunakan AbortController untuk membatalkan muat naik yang perlahan, contohnya apabila pengguna beralih dari halaman tersebut.

const controller = new AbortController();
fetch('/api/upload', {
  method: 'POST',
  body: formData,
  signal: controller.signal
}).catch(e => console.log(e.name));

controller.abort();

Mengapa Ini Penting

Menggabungkan FormData dengan fetch ialah cara moden dan standard untuk memuat naik fail: tambahkan medan dan fail, lakukan POST terhadap FormData, kemudian biarkan pelayar mengekod data berbilang bahagian dengan sempadan yang betul. Elakkan menetapkan Content-Type, sentiasa semak response.ok dan bersihkan sumber.

async function submitForm(formEl) {
  const data = new FormData(formEl);
  const res = await fetch('/submit', { method: 'POST', body: data });
  console.log('status', res.status);
}

Semakan Ringkas

Mengapa anda NOT patut menetapkan pengepala Content-Type secara manual apabila melakukan POST terhadap FormData dengan fetch?

Jawab dalam pelajaran interaktif

Imbas Kembali: Memuat Naik Fail dengan fetch

Anda telah mempelajari cara menghantar fail kepada pelayan:

Tambahkan fail dan medan kepada FormData, kemudian luluskan objek itu sebagai body bagi fetch.
Jangan tetapkan Content-Type secara manual; pelayar menambahkan sempadan berbilang bahagian.
Semak response.ok kerana fetch hanya menolak apabila berlaku ralat rangkaian.
Anda boleh menghantar berbilang fail dan gumpalan data yang dijana, serta membatalkan muat naik dengan AbortController.

Percuma untuk bermula

Pelajari JavaScript dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 59
Pelajaran: 200

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Memuat Naik Fail dengan Fetch” percuma?

Ya — sebanyak 3 pelajaran dalam laluan pembelajaran Akademi JavaScript, termasuk “Memuat Naik Fail dengan Fetch”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus Akademi JavaScript merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Memuat Naik Fail dengan Fetch”?

Hantar fail ke pelayan dengan FormData. Anda berlatih Akademi JavaScript menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Akademi JavaScript?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Akademi JavaScript di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 4 daripada 4.

Berapa lamakah pelajaran “Memuat Naik Fail dengan Fetch” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Akademi JavaScript ini?

Ya. Setiap pelajaran Akademi JavaScript menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

← Kembali ke Akademi JavaScript