FileReader

요약

FileReader 객체는  웹 애플리케이션이 비동기적으로 파일을 구체화하거나 데이터를 읽기 위하여 File 혹은 Blob 객체를 이용해 파일의 내용을(혹은 raw data버퍼로) 읽고 사용자의 컴퓨터에 저장하는 것을 가능하게 해줍니다.

File 객체는 <input> 태그를 이용하여 유저가 선택한 파일들의 결과로서 반환된 FileList 객체, 드래그 앤 드랍으로 반환된 DataTransfer 객체 혹은 HTMLCanvasElement의 mozGetAsFile() API로 부터 얻는다.

생성자

FileReader FileReader();

파일들을 사용한 웹 애플리케이션의 사용 예제보기.

속성

FileReader.error Read only

DOMError  파일을 읽는 도중에 발생한 에러를 나타냅니다.

FileReader.readyState Read only

FileReader의 상태를 나타내는 숫자입니다.  이것은 State constants의 일종입니다.

FileReader.result Read only

파일의 컨텐츠입니다. 이 속성은 읽기 작업이 완료되고 읽기 작업의 초기화에 사용한 방식으로 결정된 데이터의 포맷이 정해진 후에 유효합니다.

이벤트 핸들러

FileReader.onabort

abort 이벤트 핸들러. 이 이벤트는 읽기 동작이 중단 될 때 마다 발생합니다.

FileReader.onerror

error 이벤트 핸들러. 이 이벤트는 읽기 동작이 에러를 마주할 때 마다 발생합니다.

FileReader.onload

load 이벤트 핸들러. 이 이벤트는 읽기 동작이 성공적으로 완료 되었을 때 마다 발생합니다.

FileReader.onloadstart

loadstart 이벤트 핸들러. 이 이벤트는 읽기 동작이 실행 될 때 마다 발생합니다.

FileReader.onloadend

loadend 이벤트 핸들러. 이 이벤트는 읽기 동작이 끝났을 때 마다 발생합니다. (읽기의 성공이나 실패 여부는 상관 않습니다.)

FileReader.onprogress

progress 이벤트 핸들러. 이 이벤트는 Blob 컨텐트를 읽는 동안 호출됩니다.

상태 값들

• EMPTY   : 0 : 아직 데이터가 로드 되지 않았음.
• LOADING : 1 : 데이터가 로딩 중.
• DONE    : 2 : 모든 읽기 요청이 완료됨.

메소드

FileReader.abort()

읽기 요청을 중단 시킨다.  정상 리턴이 되며 readyState 는 DONE이 된다.

FileReader.readAsArrayBuffer()

Starts reading the contents of the specified Blob, once finished, the result attribute contains an ArrayBuffer representing the file's data.

FileReader.readAsBinaryString()

Starts reading the contents of the specified Blob, once finished, the result attribute contains the raw binary data from the file as a string.

FileReader.readAsDataURL()

Starts reading the contents of the specified Blob, once finished, the result attribute contains a data: URL representing the file's data.

FileReader.readAsText()

Starts reading the contents of the specified Blob, once finished, the result attribute contains the contents of the file as a text string.

Specifications

Browser compatibility

Implementation notes

• IE9 has a File API Lab.
• Opera has partial support in 11.1.

Gecko-specific notes

• 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.

See also

• Using files from web applications
• File
• Blob
• nsIDOMFileReader [en-US] - For addons/privelaged scope