FileReader

O objeto FileReader permite aplicações web ler assincronamente o conteúdo dos arquivos (ou buffers de dados puros) do computador do usuário, utilizando o objeto File ou Blob para especificar o arquivo ou os dados a serem lidos.

Objetos File podem ser obtidos a partir de um objeto FileList retornado como resultado da seleção de um usuário utilizando um elemento <input>, a partir de uma operação de drag and drop DataTransfer, ou a partir de um mozGetAsFile() da api HTMLCanvasElement.

FileReader FileReader();

Veja Using files from web applications para detalhes e exemplos.

FileReader.error (en-US) Somente leitura

Um DOMError (en-US) representa o erro que ocorreu durante a leitura do arquivo.

FileReader.readyState (en-US) Somente leitura

Um número indicando o estado do FileReader. Este poderá ser um dos seguintes estados State constants.

FileReader.result (en-US) Somente leitura

O conteúdo do arquivo. Esta propriedade é válida apenas após a operação de leitura estar completa, e o formato dos dados dependem de qual método foi usado para iniciar a operação de leitura.

FileReader.onabort (en-US)

Um manipulador para o evento abort (en-US). Este evento é chamado cada vez que a operação de leitura é abortada.

FileReader.onerror (en-US)

Um manipulador para o evento error (en-US). Este evento é chamado cada vez que a operação de leitura encontra um erro.

FileReader.onload

Um manipulador para o evento load (en-US). Este evento é chamado cada vez que a operação de leitura é completada com sucesso.

FileReader.onloadstart

Um manipulador para o evento loadstart (en-US). Este evento é chamado cada vez que a leitura começa.

FileReader.onloadend

Um manipulador para o evento loadend (en-US). Este evento é chamado cada vez que a operação de leitura é completada (tanto em caso de sucesso quanto de erro).

FileReader.onprogress

Um manipulador para o evento progress (en-US). Este evento é chamado durante a leitura do conteúdo de Blob.

• EMPTY   : 0 : Nenhum dado foi carregado ainda.
• LOADING : 1 : Os dados estão sendo carregados.
• DONE    : 2 : Toda a requisição de leitura foi completada.

FileReader.abort() (en-US)

Aborta a operação de leitura. O retorno, no readyState será DONE.

FileReader.readAsArrayBuffer()

Inicia a leitura do conteúdo do Blob espeficado, uma vez finalizado, o atributo result conterá um ArrayBuffer representando os dados do arquivo.

FileReader.readAsBinaryString()

Inicia a leitura do conteúdo do Blob especificado, uma vez finalizado, o atributo result conterá os dados raw binários do arquivo como  string.

FileReader.readAsDataURL()

Inicia a leitura do conteúdo do Blob especificado, uma vez finalizado, o atributo result conterá um data: URL representando os dados do arquivo.

FileReader.readAsText()

Inicia a leitura do conteúdo do Blob especificado, uma vez finalizado, o atributo result conterá o conteúdo do arquivo como string de  texto.

• IE9 possui uma File API Lab.
• Opera possui suporte parcial na versão 11.1.

Notas específicas para Gecko

• Em versões anteriores ao Gecko 2.0 beta 7 (Firefox 4.0 beta 7), todos os parâmetros Blob abaixo eram parâmetros File. Isto foi então atualizado para adequarem-se corretamente às especificações.
• Em versões anteriores ao Gecko 13.0 (Firefox 13.0 / Thunderbird 13.0 / SeaMonkey 2.10), a propriedade FileReader.error retornava um objeto FileError. Esta interface foi removida e a propriedade FileReader.error agora retorna o objeto DOMError (en-US), assim como está definido na última versão da FileAPI.

• Using files from web applications
• File
• Blob