aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/api/filereader/readasbinarystring/index.html
blob: 5f7c1fb57ec4ac4a9a9a224957d1c41b86705c00 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
---
title: FileReader.readAsBinaryString()
slug: Web/API/FileReader/readAsBinaryString
tags:
  - API
  - API Arquivos
  - Arquivos
  - File API
  - Métodos
  - Referencias(2)
translation_of: Web/API/FileReader/readAsBinaryString
---
<div>{{APIRef("File API")}} {{non-standard_header}}</div>

<p>O método <code>readAsBinaryString</code> é usado para iniciar a leitura do conteúdo de um {{domxref("Blob")}} especificado, ou {{domxref("File")}}. Quando a operação de leitura é finalizada, o {{domxref("FileReader.readyState","readyState")}} se torna "<code>DONE"</code>, e o evento {{event("loadend")}} é acionado. Neste momento, o atributo {{domxref("FileReader.result","result")}} contém o dado binário bruto do arquivo.</p>

<p>Note que este método se tornou obsoleto desde 12 de Julho de 2012 Working Draft do W3C.</p>

<h2 id="Sintaxe">Sintaxe</h2>

<pre class="syntaxbox"><em>instanciaDeFileReader</em>.readAsBinaryString(blob);</pre>

<h3 id="Parametros">Parametros</h3>

<dl>
 <dt><code>blob</code></dt>
 <dd>O {{domxref("Blob")}} ou {{domxref("File")}} que deseja ler.</dd>
</dl>

<h2 id="Exemplo">Exemplo</h2>

<pre class="brush: js">var canvas = document.createElement('canvas');
var height = 200;
var width  = 200;

canvas.width  = width;
canvas.height = height;

var ctx = canvas.getContext('2d');

ctx.strokeStyle = '#090';
ctx.beginPath();
ctx.arc(width/2, height/2, width/2 - width/10, 0, Math.PI*2);
ctx.stroke();

canvas.toBlob(function (blob) {
  var reader = new FileReader();

  reader.onloadend = function () {
    console.log(reader.result);
  }

  reader.readAsBinaryString(blob);
});</pre>

<h2 id="Especificações">Especificações</h2>

<p>Este método foi removido dos padrões FileAPI {{domxref("FileReader.readAsArrayBuffer()")}} deve ser usado no lugar dele.</p>

<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Firefox (Gecko)</th>
   <th>Chrome</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Suporte Básico</td>
   <td>{{CompatGeckoDesktop("1.9.2")}}<sup>[1]</sup></td>
   <td>7</td>
   <td>{{CompatNo}}</td>
   <td>12.02<sup>[3]</sup></td>
   <td>6.0</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Android</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Suporte Básico</td>
   <td>32</td>
   <td>3</td>
   <td>10</td>
   <td>11.5</td>
   <td>6.0</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Anteriormente ao Gecko 2.0 beta 7 (Firefox 4.0 beta 7), todos os parametros  {{domxref("Blob")}} inferiores eram parametros {{domxref("File")}}; Isso foi atualizado para combinar com as especifiações corretamente. Anteriormente ao Gecko 13.0 {{geckoRelease("13.0")}} a propriedade <code>FileReader.error</code> retornava um objeto {{domxref("FileError")}}. Essa interface foi removida e <code>FileReader.error</code> agora retorna o objeto domxref("DOMError")}} como foi definido no último draft do FileAPI.</p>

<p>[2] IE9 possui um <a href="http://html5labs.interoperabilitybridges.com/prototypes/fileapi/fileapi/info">File API Lab</a>.</p>

<p>[3] Opera possui <a href="http://www.opera.com/docs/specs/presto28/file/">partial support</a> in 11.1.</p>

<h2 id="Veja_Também">Veja Também</h2>

<ul>
 <li>{{domxref("FileReader")}}</li>
</ul>