用戶選好檔案再按上傳,結果傳到一半才發現檔案幾百 MB,或者類型根本不對——這種體驗放在今天已經很難被接受。HTML5 帶來的 File API,讓我們可以在瀏覽器端就完成這類校驗,不必等請求打到伺服器才報錯。
支援 HTML5 的瀏覽器都實作了 W3C 的文件 API 標準。當用戶透過 file 類型的輸入框選檔之後,input 元素的 files 屬性會是一個 FileList 集合,每個 File 物件都自帶這些資訊:
name 是檔名,size 是檔案大小(單位為位元組),type 是 MIME 類型,lastModifiedDate 是最後修改時間。有了 size 與 type,大小與格式的判斷就變成純粹的條件判斷而已。
我喜歡把限制條件直接寫成自訂屬性,這樣規則和輸入框綁在一起,後續維護不用來回翻 JavaScript:
<input type="file" data-file_type="zip|png" data-max_size="1000000">
data-file_type 用竖線分隔允許的副檔名,data-max_size 則是上限位元組數,這裡的 1000000 約等於 1MB。
File 物件給的是 MIME 類型(例如 image/png),但我們在標籤上寫的是副檔名,中間需要一張對照表:
var mime_types = {
"gif": "image/gif",
"jpeg": ["image/jpeg", "image/pjpeg"],
"jpg": ["image/jpeg", "image/pjpeg"],
"png": ["image/png", "image/x-png"]
};
注意有些類型對應多個 MIME 寫法,所以值設計成陣列。轉換函數就是把傳入的副檔名逐一查表,把結果彙整成一個陣列:
function get_mimes(extensions){
var mimes = [];
for (var i in extensions){
var ext = extensions[i];
if (ext in mime_types){
var mime = mime_types[ext];
$.isArray(mime) ? jQuery.merge(mimes, mime) : mimes.push(mime);
}
}
return mimes;
}
核心邏輯是這樣的:先比對類型,再比對大小,任何一關沒過就清空輸入框並提示,全部通過就把檔案資訊顯示出來作為回饋。
$('input[type=file]').each(function(){
var $this = $(this);
var mimes = get_mimes($this.attr('data-file_type').split('|'));
var max_size = parseInt($this.attr('data-max_size'));
$this.change(function(evt){
var files = evt.target.files;
for (var i = 0, f; f = files[i]; i++){
if (jQuery.inArray(f.type, mimes) === -1){
alert('不允許的檔案類型:' + f.type);
$(this).val('');
continue;
} else if (f.size > max_size){
alert('檔案大小上限為 ' + max_size + ' 位元組。');
$(this).val('');
} else {
console.log(f.name, f.type, f.size, f.lastModifiedDate);
}
}
});
});
這裡有幾個實務上值得留意的點。第一,把 $(this).val('') 清空是必要的,否則用戶改了檔案,change 事件不會再次觸發。第二,MIME 類型可以偽造,客戶端校驗只是為了「早點告知用戶」,絕不能當成安全措施,伺服器端一定要再驗一次。第三,type 在某些系統上會是空字串,遇到這種情況通常得退回用副檔名判斷。
想深入了解 File API 的完整定義,可以參考 W3C 的文件:
https://www.w3.org/TR/file-upload/
總的來說,客戶端校驗的定位應該是「體驗優化」而非「安全防線」。把明顯的錯誤擋在傳輸之前,用戶和伺服器都輕)=(pdf、mp3、mp4 之類的媒體檔案直接丟給瀏覽器內建播放器處理),結果用戶明明只想把檔案存到本機,卻被導航走了。這時候 download 屬性就派上用場。
寫法非常簡單,在 a 標籤上加一個 download 屬性即可,屬性值就是存檔時要用的檔名:
<a href="downloadpdf.php" download="download.pdf">點擊直接下載並存成 download.pdf</a>
這個屬性有兩個作用:一是強制下載而不是開啟,二是重新命名。第二點在實務上特別實用——伺服器自動產生的檔案往往叫 acme-doc-2.0.1.txt 這種名字,透過 download 就能讓用戶存成 Acme Documentation (ver. 2.0.1).txt 這種看得懂的檔名(記得保留副檔名)。屬性值也可以用 JavaScript 動態改寫。

官方範例:https://tutsplus.github.io/download-attribute/index.html
基於安全考量,各瀏覽器對這個屬性的態度並不一致。Firefox 要求被下載的檔案必須來自同一個伺服器或網域,否則會忽略屬性、直接在瀏覽器開啟。Chrome 與 Opera 的規則更嚴格:如果是跨網域資源,屬性會被直接忽略,連檔名也不會改。
也就是說,download 屬性只對同源資源可靠生效。如果你的檔案放在 CDN 上,靠這個屬性改名的想法基本行不通。
寫這篇文章時,Safari 與 IE 尚未實作 download 屬性。既然不能強迫下載,至少可以引導用戶手動操作。做法是用 Modernizr 檢測支援情況,不支援時在連結後插入一段提示文字:

if (!Modernizr.adownload) {
var $link = $('a');
$link.each(function(){
var $download = $(this).attr('download');
if (typeof $download !== typeof undefined && $download !== false){
var $el = $('<div>').addClass('download-instruction')
.text('請按右鍵選擇「連結檔案另存新檔」');
$el.insertAfter($(this));
}
});
}

腳本邏輯很直白:逐一檢查頁面上帶有 download 屬性的連結,若瀏覽器不支援,就在連結下方補一段操作指引。

這類「新屬性 + 降級提示」的組合,是處理 HTML5 新特性時相當實用的通用套路:先給支援的瀏覽器更好的體驗,再為其餘的預留一條走得通的路。