FileReader

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 2015⁩.

O objetoFileReader permite que aplicativos da web leiam de forma assíncrona o conteúdo de arquivos (ou buffers de dados brutos) armazenados no computador do usuário, usandoFile ouBlob objetos para especificar o arquivo ou dados a serem lidos.

Objetos de arquivo podem ser obtidos de um objetoFileList retornado como resultado de um usuário selecionar arquivos usando o elemento<input> ou de uma operação de arrastar e soltarDataTransfer objeto.

OFileReader só pode acessar o conteúdo dos arquivos que o usuário selecionou explicitamente, usando um elemento HTML<input type="file"> ou arrastando e soltando. Ele não pode ser usado para ler um arquivo por nome de caminho do sistema de arquivos do usuário. Para ler arquivos no sistema de arquivos do cliente por nome de caminho, use aAPI de acesso ao sistema de arquivos. Para ler arquivos do lado do servidor, use soluções Ajax padrão, com permissão CORS se estiver lendo entre domínios.

Nota: This feature is available inWeb Workers.

Construtor

FileReader(): Retorna umFileReader recém-construído.

ConsulteUsando arquivos de aplicativos da Web para obter detalhes e exemplos.

Propriedades da instância

FileReader.errorSomente leitura

UmDOMException representando o erro que ocorreu durante a leitura do arquivo.

FileReader.readyStateSomente leitura

Um número que indica o estado doFileReader. Este é um dos seguintes:

Nome	Valor	Descrição
`EMPTY`	`0`	Nenhum dado foi carregado ainda.
`LOADING`	`1`	Os dados estão sendo carregados no momento.
'DONE'	`2`	Toda a solicitação de leitura foi concluída.

FileReader.resultSomente leitura

o conteúdo do arquivo. Esta propriedade só é válida após a conclusão da operação de leitura, e o formato dos dados depende de qual dos métodos foi utilizado para iniciar a operação de leitura.

Métodos de instância

FileReader.abort(): Aborta a operação de leitura. Ao retornar, oreadyState seráDONE.
FileReader.readAsArrayBuffer(): Inicia a leitura do conteúdo doBlob especificado, uma vez finalizado, o atributoresult contém umArrayBuffer representando os dados do arquivo.
FileReader.readAsBinaryString(): Inicia a leitura do conteúdo doBlob especificado, uma vez concluído, o atributoresult contém os dados binários brutos do arquivo como uma string.
FileReader.readAsDataURL(): Inicia a leitura do conteúdo doBlob especificado, uma vez finalizado, o atributoresult contém uma URLdata: representando os dados do arquivo.
FileReader.readAsText(): Inicia a leitura do conteúdo doBlob especificado, uma vez terminado, o atributoresult contém o conteúdo do arquivo como uma string de texto. Um nome de codificação opcional pode ser especificado.

Eventos

Ouça esses eventos usandoaddEventListener() ou atribuindo um ouvinte de eventos à propriedadeoneventname desta interface. Remova os ouvintes de eventos comremoveEventListener(), uma vez queFileReader não seja mais usado, para evitar vazamentos de memória.

abort: Acionado quando uma leitura foi abortada, por exemplo, porque o programa chamouFileReader.abort().
error: Acionado quando a leitura falhou devido a um erro.
load: Disparado quando uma leitura foi concluída com sucesso.
loadend: Acionado quando uma leitura foi concluída, com sucesso ou não.
loadstart: Disparado quando uma leitura é iniciada.
progress: Acionado periodicamente à medida que os dados são lidos.