aboutsummaryrefslogtreecommitdiff
path: root/files/pt-pt/web/api/filereader/readystate/index.html
blob: 1147e43f29a5ab5d2f3d9e2cff081dfa6b23e7af (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
---
title: FileReader.readyState
slug: Web/API/FileReader/readyState
tags:
  - API
  - Ficheiros
  - File API
  - Propriedade
  - Referencia
translation_of: Web/API/FileReader/readyState
---
<div>{{APIRef("File API")}}</div>

<p>A propriedade <strong><code>readyState</code></strong> de {{domxref("FileReader")}} fornece o estado actual da operação de leitura em que se encontra um <code>FileReader</code>.  Um <code>FileReader</code> existe num dos seguintes estados:</p>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Valor</th>
   <th scope="col">Estado</th>
   <th scope="col">Descrição</th>
  </tr>
  <tr>
   <td><code>0</code></td>
   <td><code>EMPTY</code></td>
   <td>Foi criado um leitor. Nenhum dos métodos de leitura foi ainda chamado.</td>
  </tr>
  <tr>
   <td><code>1</code></td>
   <td><code>LOADING</code></td>
   <td>Foi chamado um método de leitura.</td>
  </tr>
  <tr>
   <td><code>2</code></td>
   <td><code>DONE</code></td>
   <td>A operação está concluída.</td>
  </tr>
 </thead>
</table>

<dl>
 <dt><code>EMPTY</code></dt>
 <dd>O <code>FileReader</code> foi criado, mas ainda não foi chamado o método <code>readAs</code>.</dd>
 <dt><code>LOADING</code></dt>
 <dd>Foi invocado o método <code>readAs</code>. O {{domxref("File")}} ou {{domxref("Blob")}} está a ser lido, e ainda não ocorreu qualquer erro.</dd>
 <dt><code>DONE</code></dt>
 <dd>A operação lida está concluída. Isto pode significar que: todo o {{domxref("File")}} ou {{domxref("Blob")}} foi lido na memória, ocorreu um erro de leitura de ficheiro, ou {{domxref("FileReader.abort()", "abort()")}} foi chamado e a leitura foi cancelada.</dd>
</dl>

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

<pre class="brush: js notranslate">var reader = new FileReader();
console.log('EMPTY', reader.readyState); // readyState é 0

reader.readAsText(blob);
console.log('LOADING', reader.readyState); // readyState é 1

reader.onloadend = function () {
  console.log('DONE', reader.readyState); // readyState é 2
};
</pre>

<h2 id="Valor">Valor</h2>

<p>Um número que é uma das três constantes de estado possíveis definidas para o {{domxref("FileReader")}} API.</p>

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

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificação</th>
   <th scope="col">Estado</th>
   <th scope="col">Comentários</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName("File API", "#dom-filereader-readystate", "readyState")}}</td>
   <td>{{Spec2("File API")}}</td>
   <td>Definição inicial</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilidade">Compatibilidade</h2>



<p>{{Compat("api.FileReader.readyState")}}</p>

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

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