FileReader接口文檔

原文地址 https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader

**FileReader** 對象允許 Web 應(yīng)用程序異步讀取存儲在用戶計算機上的文件(或原始數(shù)據(jù)緩沖區(qū))的內(nèi)容宗苍,使用 FileBlob 對象指定要讀取的文件或數(shù)據(jù)谎碍。

其中 File 對象可以是來自用戶在一個 <input>元素上選擇文件后返回的 FileList對象, 也可以來自拖放操作生成的 DataTransfer對象, 還可以是來自在一個 HTMLCanvasElement上執(zhí)行mozGetAsFile()方法后返回結(jié)果统求。

重要提示: FileReader 僅用于以安全的方式從用戶(遠(yuǎn)程)系統(tǒng)讀取文件內(nèi)容 它不能用于從文件系統(tǒng)中按路徑名簡單地讀取文件。 要在 JavaScript 中按路徑名讀取文件和措,應(yīng)使用標(biāo)準(zhǔn) Ajax 解決方案進(jìn)行服務(wù)器端文件讀取,如果讀取跨域悠夯,則使用 CORS 權(quán)限是晨。

Note: 此特性在 Web Worker 中可用。

構(gòu)造函數(shù)

FileReader()

返回一個新構(gòu)造的FileReader健蕊。

有關(guān)詳細(xì)信息和示例菱阵,請參閱如何在 web 應(yīng)用程序中使用文件

屬性

FileReader.error 只讀

一個 DOMException缩功,表示在讀取文件時發(fā)生的錯誤 晴及。

FileReader.readyState 只讀

表示FileReader狀態(tài)的數(shù)字。取值如下:

FileReader.result 只讀

文件的內(nèi)容嫡锌。該屬性僅在讀取操作完成后才有效虑稼,數(shù)據(jù)的格式取決于使用哪個方法來啟動讀取操作。

事件處理

FileReader.onabort

處理 [abort](/zh-CN/docs/Web/Reference/Events/abort "/zh-CN/docs/Web/Reference/Events/abort")事件势木。該事件在讀取操作被中斷時觸發(fā)蛛倦。

FileReader.onerror

處理 [error](/zh-CN/docs/Web/Reference/Events/error "/zh-CN/docs/Web/Reference/Events/error")事件。該事件在讀取操作發(fā)生錯誤時觸發(fā)跟压。

FileReader.onload

處理 [load](/zh-CN/docs/Web/Reference/Events/load "/zh-CN/docs/Web/Reference/Events/load")事件胰蝠。該事件在讀取操作完成時觸發(fā)。

FileReader.onloadstart

處理 [loadstart](/zh-CN/docs/Web/Reference/Events/loadstart "/zh-CN/docs/Web/Reference/Events/loadstart")事件。該事件在讀取操作開始時觸發(fā)茸塞。

FileReader.onloadend

處理 [loadend](/zh-CN/docs/Web/Reference/Events/loadend "/zh-CN/docs/Web/Reference/Events/loadend")事件躲庄。該事件在讀取操作結(jié)束時(要么成功,要么失敿嘏啊)觸發(fā)噪窘。

FileReader.onprogress

處理 [progress](/zh-CN/docs/Web/Reference/Events/progress "/zh-CN/docs/Web/Reference/Events/progress")事件。該事件在讀取 Blob時觸發(fā)效扫。

因為 FileReader 繼承自 EventTarget倔监,所以所有這些事件也可以通過 addEventListener方法使用。

方法

FileReader.abort()

中止讀取操作菌仁。在返回時浩习,readyState屬性為DONE

FileReader.readAsArrayBuffer()

開始讀取指定的 Blob中的內(nèi)容, 一旦完成, result 屬性中保存的將是被讀取文件的 ArrayBuffer 數(shù)據(jù)對象.

FileReader.readAsBinaryString()

開始讀取指定的 Blob中的內(nèi)容济丘。一旦完成谱秽,result屬性中將包含所讀取文件的原始二進(jìn)制數(shù)據(jù)。

FileReader.readAsDataURL()

開始讀取指定的 Blob中的內(nèi)容摹迷。一旦完成疟赊,result屬性中將包含一個data: URL 格式的 Base64 字符串以表示所讀取文件的內(nèi)容。

FileReader.readAsText()

開始讀取指定的 Blob中的內(nèi)容峡碉。一旦完成近哟,result屬性中將包含一個字符串以表示所讀取的文件內(nèi)容。

規(guī)范

Specification Status Comment
[File API
FileReader](https://w3c.github.io/FileAPI/#dfn-filereader) Working Draft Initial definition

瀏覽器兼容

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

  • Desktop
  • Mobile
3.6 (1.9.2)[1]

[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] Opera has partial support in 11.1.

相關(guān)鏈接

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末鲫寄,一起剝皮案震驚了整個濱河市吉执,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌塔拳,老刑警劉巖鼠证,帶你破解...
    沈念sama閱讀 216,692評論 6 501
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異靠抑,居然都是意外死亡量九,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,482評論 3 392
  • 文/潘曉璐 我一進(jìn)店門颂碧,熙熙樓的掌柜王于貴愁眉苦臉地迎上來荠列,“玉大人,你說我怎么就攤上這事载城〖∷疲” “怎么了?”我有些...
    開封第一講書人閱讀 162,995評論 0 353
  • 文/不壞的土叔 我叫張陵诉瓦,是天一觀的道長川队。 經(jīng)常有香客問我力细,道長,這世上最難降的妖魔是什么固额? 我笑而不...
    開封第一講書人閱讀 58,223評論 1 292
  • 正文 為了忘掉前任眠蚂,我火速辦了婚禮,結(jié)果婚禮上斗躏,老公的妹妹穿的比我還像新娘逝慧。我一直安慰自己,他們只是感情好啄糙,可當(dāng)我...
    茶點故事閱讀 67,245評論 6 388
  • 文/花漫 我一把揭開白布笛臣。 她就那樣靜靜地躺著,像睡著了一般隧饼。 火紅的嫁衣襯著肌膚如雪沈堡。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,208評論 1 299
  • 那天桑李,我揣著相機與錄音踱蛀,去河邊找鬼。 笑死贵白,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的崩泡。 我是一名探鬼主播禁荒,決...
    沈念sama閱讀 40,091評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼角撞!你這毒婦竟也來了呛伴?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 38,929評論 0 274
  • 序言:老撾萬榮一對情侶失蹤谒所,失蹤者是張志新(化名)和其女友劉穎热康,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體劣领,經(jīng)...
    沈念sama閱讀 45,346評論 1 311
  • 正文 獨居荒郊野嶺守林人離奇死亡姐军,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,570評論 2 333
  • 正文 我和宋清朗相戀三年垃喊,在試婚紗的時候發(fā)現(xiàn)自己被綠了糕殉。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,739評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡逞刷,死狀恐怖村生,靈堂內(nèi)的尸體忽然破棺而出惊暴,到底是詐尸還是另有隱情,我是刑警寧澤趁桃,帶...
    沈念sama閱讀 35,437評論 5 344
  • 正文 年R本政府宣布辽话,位于F島的核電站肄鸽,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏油啤。R本人自食惡果不足惜贴捡,卻給世界環(huán)境...
    茶點故事閱讀 41,037評論 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望村砂。 院中可真熱鬧烂斋,春花似錦、人聲如沸础废。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,677評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽评腺。三九已至帘瞭,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間蒿讥,已是汗流浹背蝶念。 一陣腳步聲響...
    開封第一講書人閱讀 32,833評論 1 269
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留芋绸,地道東北人媒殉。 一個月前我還...
    沈念sama閱讀 47,760評論 2 369
  • 正文 我出身青樓,卻偏偏與公主長得像摔敛,于是被迫代替她去往敵國和親廷蓉。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,647評論 2 354