FileReader.result

A propriedade result de FileReader devolve os conteúdo do ficheiro. Esta propriedade só é válida após a operação de leitura estar concluída, e o formato dos dados depende de qual método foi utilizado para iniciar a operação de leitura.

Sintaxe

var file = instanceOfFileReader.result

Valor

Uma string ou ArrayBuffer apropriado com base em qual dos métodos de leitura foi utilizado para iniciar a operação de leitura. O valor é null se a leitura ainda não estiver completa ou não foi bem sucedida.

Os resultados são descritos abaixo.

Método Descrição
readAsArrayBuffer() O result é um ArrayBuffer de JavaScript que contem dados binários.
readAsBinaryString() O result contém os dados binários brutos do ficheiro numa string.
readAsDataURL() O result é uma string com uma data: URL que representa os dados do ficheiro.
readAsText() O result ié texto numa string.

Exemplo

Este exemplo apresenta uma função, read(), que lê um ficheiro a partir de uma entrada de ficheiro. Funciona criando um objecto FileReader e criando um ouvinte para eventos load, de modo que quando o ficheiro é lido, o result é obtido e passado para a função callback fornecida para read().

O conteúdo é tratado como dados de texto brutos.

var fileInput = document.querySelector('input[type="file"]');

function read(callback) {
  var file = fileInput.files.item(0);
  var reader = new FileReader();

  reader.onload = function() {
    callback(reader.result);
  }

  reader.readAsText(file);
}

Especificações

Especificação Estado Comentário
File API
The definition of 'result' in that specification.
Working Draft Definição inicial

Compatibilidade

BCD tables only load in the browser

Ver também