files/pt-pt/web/api/file/getastext/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
78
79
80
81
82
83

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

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

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

<p>O método <code>getAsText</code> oferece os dados do ficheiro num formato de texto de acordo com uma codificação.</p>

<div class="note">
<p><strong>Note:</strong> Este método está obsoleto; use antes o método {{domxref("FileReader.readAsText()","readAsText()")}} de {{domxref("FileReader")}}.</p>
</div>

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

<pre class="notranslate">var <var>str</var> = <var>instanceOfFile</var>.getAsText(<var>encoding</var>);</pre>

<h3 id="Parâmetros">Parâmetros</h3>

<dl>
 <dt><var>encoding</var></dt>
 <dd>Uma <em>string</em> a indicar qual a codificação para usar nos dados devolvidos. Se o <em>string</em> estiver vazio, é utilizado UTF-8.</dd>
</dl>

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

<p>A string que contem os dados do ficheiro num formato de texto especificado pelo <code>encoding</code>.</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;

// object com os formatos de media validos
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 formato do ficheiro foi detetado
  if (file !== null) {
    if (accept.text.indexOf(file.mediaType) &gt; -1) {
      // file contem texto, num formato permitido
      // make sure it's encoded as utf-8
      var data = file.getAsText("utf-8");
      // modificar dados com métodos de string

    } else if (accept.binary.indexOf(file.mediaType) &gt; -1) {
      // binario
    }
  }
}</pre>

<h2 id="Especificação">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>