From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/pt-br/web/api/filereader/index.html | 162 ++++++++++++++++++++++++++++++ 1 file changed, 162 insertions(+) create mode 100644 files/pt-br/web/api/filereader/index.html (limited to 'files/pt-br/web/api/filereader/index.html') diff --git a/files/pt-br/web/api/filereader/index.html b/files/pt-br/web/api/filereader/index.html new file mode 100644 index 0000000000..772159fd36 --- /dev/null +++ b/files/pt-br/web/api/filereader/index.html @@ -0,0 +1,162 @@ +--- +title: FileReader +slug: Web/API/FileReader +translation_of: Web/API/FileReader +--- +

{{ APIRef("File API")}}

+ +

Resumo

+ +

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 {{ domxref("File") }} ou {{ domxref("Blob") }} para especificar o arquivo ou os dados a serem lidos.

+ +

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

+ +

Construtor

+ +
FileReader FileReader();
+ +

Veja Using files from web applications para detalhes e exemplos.

+ +

Propriedades

+ +
+
{{domxref("FileReader.error")}} {{readonlyinline}}
+
Um {{domxref("DOMError")}} representa o erro que ocorreu durante a leitura do arquivo.
+
{{domxref("FileReader.readyState")}} {{readonlyinline}}
+
Um número indicando o estado do FileReader. Este poderá ser um dos seguintes estados {{ anch("State constants") }}.
+
{{domxref("FileReader.result")}} {{readonlyinline}}
+
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.
+
+ +

Manipuladores de eventos

+ +
+
{{domxref("FileReader.onabort")}}
+
Um manipulador para o evento {{event("abort")}}. Este evento é chamado cada vez que a operação de leitura é abortada.
+
{{domxref("FileReader.onerror")}}
+
Um manipulador para o evento {{event("error")}}. Este evento é chamado cada vez que a operação de leitura encontra um erro.
+
{{domxref("FileReader.onload")}}
+
Um manipulador para o evento {{event("load")}}. Este evento é chamado cada vez que a operação de leitura é completada com sucesso.
+
{{domxref("FileReader.onloadstart")}}
+
Um manipulador para o evento {{event("loadstart")}}. Este evento é chamado cada vez que a leitura começa.
+
{{domxref("FileReader.onloadend")}}
+
Um manipulador para o evento {{event("loadend")}}. Este evento é chamado cada vez que a operação de leitura é completada (tanto em caso de sucesso quanto de erro).
+
{{domxref("FileReader.onprogress")}}
+
Um manipulador para o evento {{event("progress")}}. Este evento é chamado durante a leitura do conteúdo de {{domxref("Blob")}}.
+
+ +
+

Nota: O FileReader herda de {{domxref("EventTarget")}}, todos estes eventos podem ser listados usando o método {{domxref("EventTarget.addEventListener()","addEventListener")}}.

+
+ +

Constantes de estado

+ + + +

Métodos

+ +
+
{{domxref("FileReader.abort()")}}
+
Aborta a operação de leitura. O retorno, no readyState será DONE.
+
{{domxref("FileReader.readAsArrayBuffer()")}} {{ gecko_minversion_inline("7.0") }}
+
Inicia a leitura do conteúdo do {{ domxref("Blob") }} espeficado, uma vez finalizado, o atributo result conterá um {{domxref("ArrayBuffer")}} representando os dados do arquivo.
+
{{domxref("FileReader.readAsBinaryString()")}}
+
Inicia a leitura do conteúdo do {{ domxref("Blob") }} especificado, uma vez finalizado, o atributo result conterá os dados raw binários do arquivo como  string.
+
{{domxref("FileReader.readAsDataURL()")}}
+
Inicia a leitura do conteúdo do {{ domxref("Blob") }} especificado, uma vez finalizado, o atributo result conterá um data: URL representando os dados do arquivo.
+
{{domxref("FileReader.readAsText()")}}
+
Inicia a leitura do conteúdo do {{ domxref("Blob") }} especificado, uma vez finalizado, o atributo result conterá o conteúdo do arquivo como string de  texto.
+
+ +

Especificações

+ + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('File API','#FileReader-interface','FileReader')}}{{Spec2('File API')}}Definição inicial.
+ +

Compatibilidade

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureFirefox (Gecko)ChromeInternet Explorer*Opera*Safari
Basic support{{ CompatGeckoDesktop("1.9.2") }}71012.026.0.2
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureFirefox Mobile (Gecko)AndroidIE MobileOpera MobileSafari Mobile
Basic support3231011.56.1
+
+ +

Notas de implementações

+ + + +

Notas específicas para Gecko

+ + + +

Veja também

+ + -- cgit v1.2.3-54-g00ecf