對 Web 開發者而言,網頁上的檔案上傳一直是件麻煩事。過去我們無法拖曳上傳,沒有成熟的 Ajax 上傳方案,也少有機會處理多檔批次上傳,更拿不到上傳過程中的資訊——除非等它傳完再由伺服器回報。往往等到上傳完畢,才發現檔案根本不合規。
HTML5 的普及、現代瀏覽器的支援與 JavaScript 的演進,讓我們得以用 JavaScript 搭配 input[type=file] 在傳輸前就掌握檔案資訊。
使用 files 屬性即可拿到 FileList:
// Assuming <input type="file" id="upload" multiple>
var uploadInput = document.getElementById('upload');
uploadInput.addEventListener('change', function() {
console.log(uploadInput.files) // File listing!
});
要注意 FileList 並沒有 forEach 方法,只能用傳統迴圈走訪:
for (var i = 0, fileCount = uploadInput.files.length; i < fileCount; i++) {
console.log(files[i]);
}
/FileList/ 上唯一確定可用的屬性是 length。
FileList 中的每個 File 物件都帶有大量資訊,包含大小、MIME 類型、最後修改時間與檔名:
{
lastModified: 1428005315000,
lastModifiedDate: Thu Apr 02 2015 15:08:35 GMT-0500 (CDT),
name: "profile.pdf",
size: 135568,
type: "application/pdf",
webkitRelativePath: ""
}
這些資訊最大的用處,就是在上傳前先驗證。例如同時檢查總容量與檔案類型:
var maxAllowedSize = 500000;
for (var i = 0, fileCount = uploadInput.files.length, totalSize = 0; i < fileCount; i++) {
totalSize += files[i].size;
if(totalSize > maxAllowedSize) {
// 通知使用者檔案過大
}
if(files[i].type != 'application/pdf') {
// 通知該檔案類型不合法
}
}
體積超標或類型不符時,直接攔下上傳並給出明確原因,比讓使用者等個半分鐘才看到錯誤訊息友善得多。以上就是檔案上傳 API 的簡要介紹,希望對你的學習有所幫助。