FileReader

翻譯不完整。請協助 翻譯此英文文件

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

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

註: This feature is available in Web Workers.

建構式

FileReader()
建立新的 FileReader 物件。

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

屬性

FileReader.error Read only
DOMError 類型的物件記錄了讀取資料時發生的錯誤資訊。
FileReader.readyState Read only
表示目前 FileReader 的狀態,其代表的意義為:
常數 說明
EMPTY Read only 0 沒有讀入任何資料。
LOADING Read only 1 正在讀入資料。
DONE Read only 2 完成資料讀取。
FileReader.result Read only
讀入的資料內容。只有在讀取完成之後此屬性才有效,而資料的格式則取決於是由哪一個方法進行讀取。

事件處理器

FileReader.onabort
abort 事件處理器,於讀取被中斷時觸發。
FileReader.onerror
error 事件處理器,於讀取發生錯誤時觸發。
FileReader.onload
load 事件處理器,於讀取完成時觸發。
FileReader.onloadstart
loadstart 事件處理器,於讀取開始時觸發。
FileReader.onloadend
loadend 事件處理器,於每一次讀取結束之後觸發(不論成功或失敗),會於 onload 或 onerror 事件處理器之後才執行。
FileReader.onprogress
progress 事件處理器,於讀取 Blob 內容時觸發。

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

方法

FileReader.abort()
中斷目前的讀取,此方法回傳後屬性 readyState 將會是 DONE。
FileReader.readAsArrayBuffer()
開始讀取指定的 Blob,讀取完成後屬性 result 將以 ArrayBuffer 物件來表示讀入的資料內容。
FileReader.readAsBinaryString()
開始讀取指定的 Blob,讀取完成後屬性 result 將以字串型式來表示讀入的原始二進位資料(raw binary data)。
FileReader.readAsDataURL()
開始讀取指定的 Blob,讀取完成後屬性 result 將以 data: URL 格式(base64 編碼)的字串來表示讀入的資料內容。
FileReader.readAsText()
開始讀取指定的 Blob,讀取完成後屬性 result 將以文字字串型式來表示讀入的資料內容。

規範

Specification Status Comment
File API
The definition of 'FileReader' in that specification.
Working Draft Initial definition

瀏覽器相容性

Feature Firefox (Gecko) Chrome Edge Internet Explorer Opera Safari
Basic support 3.6 (1.9.2)[1] 7 (Yes) 10[2] 12.02[3] 6.0
Support in Web Workers 46 (46) (Yes) (Yes) No support (Yes) No support
Feature Firefox Mobile (Gecko) Android Edge IE Mobile Opera Mobile Safari Mobile
Basic support 32 3 (Yes) 10 11.5 6.1
Support in Web Workers 46 (46) (Yes) (Yes) No support (Yes) No support

[1] Prior to Gecko 2.0 beta 7 (Firefox 4.0 beta 7), all Blob parameters below were File parameters; this has since been updated to match the specification correctly. Prior to Gecko 13.0 (Firefox 13.0 / Thunderbird 13.0 / SeaMonkey 2.10) the FileReader.error property returned a FileError object. This interface has been removed and FileReader.error is now returning the DOMError object as defined in the latest FileAPI draft.

[2] IE9 has a File API Lab.

[3] Opera has partial support in 11.1.

參見

文件標籤與貢獻者

 此頁面的貢獻者: jackblackevo
 最近更新: jackblackevo,