files/pt-pt/web/api/file/getasbinary/index.html


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

---
title: File.getAsBinary()
slug: Web/API/File/getAsBinary
tags:
  - API
  - Ficheiros
  - File API
  - Non-standard
  - Obsoleto
  - Referencia
  - metodo
translation_of: Web/API/File/getAsBinary
---
<p>{{APIRef("File API")}}</p>

<p>{{non-standard_header}}</p>

<p>{{obsolete_header(7.0)}}</p>

<h2 id="Sumário">Sumário</h2>

<p>O método <code>getAsBinary</code> permite aceder aos dados de um ficheiro num formato <em>raw</em> binário.</p>

<div class="note">
<p><strong>Nota:</strong> Este método é obsoleto; use antes o método {{domxref("FileReader.readAsBinaryString()","readAsBinaryString()")}} ou {{domxref("FileReader.readAsArrayBuffer()","readAsArrayBuffer()")}} de {{domxref("FileReader")}}.</p>
</div>

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

<pre class="notranslate">var binary = <em>instanceOfFile</em>.getAsBinary();</pre>

<h3 id="Retorna">Retorna</h3>

<p>Uma <em>string</em>.</p>

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

<pre class="brush:js; notranslate">// fileInput é um HTMLInputElement: &lt;input type="file" id="myfileinput" multiple&gt;
var fileInput = document.getElementById("myfileinput");

// files é um objeto de FileList (parecido ao NodeList)
var files = fileInput.files;

// objeto com os tipos de media permitidos
var accept = {
  binary : ["image/png", "image/jpeg"],
  text   : ["text/plain", "text/css", "application/xml", "text/html"]
};

var file;

for (var i = 0; i &lt; files.length; i++) {
  file = files[i];

  // se o ficheiro pode ser detetado
  if (file !== null) {
    if (accept.binary.indexOf(file.type) &gt; -1) {
      // file contem dados binarios, num formato permitido
      var data = file.getAsBinary();
    } else if (accept.text.indexOf(file.type) &gt; -1) {
      // file contem texto, num formato permitido
      var data = file.getAsText();
      // modificar dados com métodos de string
    }
  }
}</pre>

<h2 id="Specification" name="Specification">Especificação</h2>

<p>Não pertence a nenhuma especificação.</p>

<h2 id="Ver_também">Ver também</h2>

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