FileReader

FileReader オブジェクトを使うと、ユーザーのコンピューター内にあるファイル (もしくはバッファ上の生データ) をウェブアプリケーションから非同期的に読み込むことが出来ます。読み込むファイルやデータは File ないし Blob オブジェクトとして指定します。

File オブジェクトを取得するには、ユーザーが <input> 要素でファイルを選択した際に得られる FileList オブジェクト、またはドラッグ＆ドロップによる DataTransfer オブジェクト、他には HTMLCanvasElement の mozGetAsFile() API を用いると良いでしょう。

コンストラクター

FileReader()

新しく作成された FileReader を返します。

詳細や例については ウェブアプリケーションからファイルを扱う を参照してください。

プロパティ

FileReader.error 読取専用

ファイルの読込中に生じたエラーを示す DOMError です。

FileReader.readyState 読取専用

FileReader の状態を表す数値です。次のうちの一つが入ります:

EMPTY	0	まだデータは何も読み込まれていません。
LOADING	1	データの読み込み中です。
DONE	2	読込処理がすべて終了しました。

FileReader.result 読取専用

読み込んだファイルの内容です。このプロパティは読み込みが終了した後に有効になり、プロパティのデータ型は読込処理を行うメソッドによって変わります。

イベントハンドラー

FileReader.onabort

abort イベントのハンドラーです。読込処理が中断されたときにイベントが発生します。

FileReader.onerror

error イベントのハンドラーです。読込中にエラーが生じたときにイベントが発生します。

FileReader.onload

load イベントのハンドラーです。読込が成功したときにイベントが発生します。

FileReader.onloadstart

loadstart イベントのハンドラーです。読込が開始されたときにイベントが発生します。

FileReader.onloadend

loadend イベントのハンドラーです。読込が（成功・失敗によらず）終了したときにイベントが発生します。

FileReader.onprogress

progress イベントのハンドラーです。Blob コンテンツの読込中にイベントが発生します。

メソッド

FileReader.abort()

読込処理を中断します。結果として readyState は DONE に変わります。

FileReader.readAsArrayBuffer()

指定された Blob オブジェクトを読み込みます。終了後の result プロパティには、ファイルのデータを示す ArrayBuffer が格納されます。

FileReader.readAsBinaryString()

指定された Blob オブジェクトを読み込みます。終了後の result プロパティには、生のバイナリデータが文字列として格納されます。

FileReader.readAsDataURL()

指定された Blob オブジェクトを読み込みます。終了後の result プロパティには、ファイルのデータを示す data: URL が格納されます。

FileReader.readAsText()

指定された Blob オブジェクトを読み込みます。終了後の result プロパティには、ファイルの内容をテキストとして読み取った文字列が格納されます。

イベント

addEventListener() を使用するか、このインターフェイスの onイベント名 プロパティにイベントリスナーを代入するかして、これらのイベントを待ち受けします。

abort

プログラムが FileReader.abort() を呼び出したなどの原因で、読み取り操作が中断されたときに発生します。
onabort プロパティ経由でも利用できます。

error

エラーのために読み取りが失敗したときに発生します。
onerror プロパティ経由でも利用できます。

load

読み取りが正常に完了したときに発生します。
onload プロパティ経由でも利用できます。

loadend

正常かどうかにかかわらず、読み取りが完了したときに発生します。
onloadend プロパティ経由でも利用できます。

loadstart

読み取りが開始されたときに発生します。
onloadstart プロパティ経由でも利用できます。

progress

データの読み取り時に定期的に発生します。
onprogress プロパティ経由でも利用できます。

仕様書

ブラウザーの対応

関連情報

• ウェブアプリケーションからのファイルの扱い
• File
• Blob