用 a 標籤連到檔案網址,瀏覽器不一定會下載,可能直接在頁面上開啟。若不想把使用者導離目前頁面,可以把請求交給一個隱藏的 iframe。
<script>
function download() {
// 要下載的檔案網址
var url = "https://music.baidu.com/data/music/file?link=https://zhangmenshiting.baidu.com/data2/music/13618994/13618995183600128.mp3?xcode=48d4a720fcd9a974586066d0145f7207";
document.getElementById("ifile").src = url;
}
</script>
<a href="#" onclick="download()">download</a>
<iframe id="ifile" style="display:none"></iframe>
把 iframe 的 src 設成檔案網址,請求就在那個隱藏的框架裡進行。伺服器回應時若帶有 Content-Disposition: attachment 標頭,瀏覽器就會跳出下載對話框;而因為一切都發生在隱藏 iframe 中,主頁面的內容與捲動位置完全不受影響。
HTML5 的 download 屬性可以直接指定下載行為,同源的情況下甚至能自訂檔名:
<a href="/files/report.pdf" download="季度報告.pdf">下載報告</a>
用 JavaScript 動態觸發:
function downloadFile(url, filename) {
var a = document.createElement('a');
a.href = url;
a.download = filename || '';
document.body.appendChild(a);
a.click();
a.remove();
}
download 屬性對跨來源的資源會被忽略,此時必須由伺服器端下 Content-Disposition 標頭:
Content-Disposition: attachment; filename="report.pdf"
若無法控制對方伺服器,可以改用 fetch 抓成 Blob 再觸發下載,但這會受 CORS 限制:
async function downloadBlob(url, filename) {
const res = await fetch(url);
const blob = await res.blob();
const objectUrl = URL.createObjectURL(blob);
var a = document.createElement('a');
a.href = objectUrl;
a.download = filename;
a.click();
URL.revokeObjectURL(objectUrl); // 記得釋放,否則記憶體不會回收
}
它無法掌握下載進度與錯誤。伺服器回 404 時,使用者只會看到一個安靜失敗的 iframe,什麼提示都沒有。此外,若檔案是 PDF 或圖片而伺服器沒設 Content-Disposition,瀏覽器會在隱藏 iframe 中默默載入,使用者完全不知道發生了什麼事。所以除非要維護舊系統,優先選 download 屬性搭配伺服器標頭。