DIV CSS 佈局教程網

AjaxDownloader.js:把檔案下載交給 JavaScript 處理
編輯:AJAX基礎知識     

AjaxDownloader.js 是一支專門處理「瀏覽器端觸發檔案下載」的輕量腳本。傳統做法是把下載連結直接丟給使用者,按下之後瀏覽器跳走或開新視窗,原頁面的狀態就此中斷;改用這支腳本之後,下載流程可以留在背景執行,頁面不必離開,也能在使用者等待時給出進度或完成提示。

它解決的問題

下載看似簡單,實際上有幾個惱人的細節:

  • 伺服器若沒正確送出 Content-Disposition: attachment,瀏覽器會把檔案當成頁面開啟,使用者看到的是一堆亂碼。
  • 檔名若是中文,標頭編碼沒處理好就會變成看不懂的名稱。
  • 使用者按了兩次,伺服器就被要求產生兩份同樣的檔——需要前端在請求進行中鎖住按鈕。
  • 下載失敗(逾時、500、檔案不存在)時,使用者完全不知道發生了什麼事。

把這些邏輯收攏到一支腳本裡,呼叫端就只需要一行:給它網址與選項,剩下的交給它。

大致的使用方式

// 引入腳本後,建立實例並指定要下載的資源
var downloader = new AjaxDownloader();
downloader.download('/api/export?type=csv', '報表.csv');

多數這類元件都會提供完成與失敗的回呼,方便你在同一頁上更新狀態文字,而不是讓使用者盯著毫無反應的畫面。

今天該怎麼做

值得補充的是:如果伺服器已經能正確設定 Content-Disposition,其實不需要額外套件——用一個普通的 <a href download> 就能觸發下載,而且不會中斷頁面。真正需要 JavaScript 介入的情境是「要先跟伺服器協商再決定下載什麼」,例如先 POST 查詢條件、拿到一次性下載網址後再跳轉。

若要在不離開頁面的前提下顯示進度,可以搭配 fetch() 讀取 ReadableStream 並比對 Content-Length 自行計算百分比,再組出 Blob 觸發下載。這條路比早期的 ActiveX 或 Flash 方案乾淨得多,也不再受瀏覽器外掛限制。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved