FileReader

藉由 FileReader 物件，Web 應用程式能以非同步（asynchronously）方式讀取儲存在用戶端的檔案（或原始資料暫存）內容，可以使用 File 或 Blob 物件指定要讀取的資料。

File 物件可以從使用者於 <input> 元素選擇之檔案所回傳的 FileList 物件當中取得，或是來自 拖放操作 所產生的 DataTransfer 物件之中，也能由 HTMLCanvasElement 物件（元素物件）執行 mozGetAsFile() 方法後回傳。

備註： 此功能可在 Web Worker 中使用

FileReader() (en-US)

建立新的 FileReader 物件。

請參考 在網頁應用程式中使用本地檔案 的更多細節與範例。

屬性

FileReader.error Read only

此 DOMException (en-US) 類型的物件記錄了讀取資料時發生的錯誤資訊。

FileReader.readyState Read only

表示目前 FileReader 狀態的數字，其代表的意義為：

EMPTY 尚未讀入任何資料。 LOADING 正在讀入資料。 完成資料讀取。
FileReader.onloadend

loadend (en-US) 事件處理器，於每一次讀取結束之後觸發（不論成功或失敗），會於 onload 或 onerror 事件處理器之後才執行。

FileReader.onprogress

progress (en-US) 事件處理器，於讀取 Blob 內容時觸發。

備註： FileReader 物件繼承自 EventTarget ，其所有的事件也都能夠透過 addEventListener 方法來註冊事件監聽器。

FileReader.abort() (en-US)

中斷目前的讀取，此方法回傳後屬性 readyState 將會是 DONE 。

FileReader.readAsArrayBuffer() (en-US)

開始讀取指定的 Blob ，讀取完成後屬性 result 將以 ArrayBuffer 物件來表示讀入的資料內容。

FileReader.readAsBinaryString() (en-US)

開始讀取指定的 Blob ，讀取完成後屬性 result 將以字串型式來表示讀入的原始二進位資料（raw binary data）。

FileReader.readAsDataURL() (en-US)

開始讀取指定的 Blob ，讀取完成後屬性 result 將以 data: URL 格式（base64 編碼）的字串來表示讀入的資料內容。

FileReader.readAsText() (en-US)

開始讀取指定的 Blob ，讀取完成後屬性 result 將以文字字串型式來表示讀入的資料內容。