aboutsummaryrefslogtreecommitdiff
path: root/files/es/web/api/closeevent/index.html
blob: f92dd84d16e2aeae726b3687d3eb6daed07b4cff (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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
---
title: CloseEvent
slug: Web/API/CloseEvent
translation_of: Web/API/CloseEvent
---
<p>{{APIRef("Websockets API")}}</p>

<p>Un <code>CloseEvent</code> se envia a los clientes usando {{Glossary("WebSockets")}} cuando la conexión esta cerrada. Esto se entrega al que escucha indicado por el atributo <code>onclose</code> del objeto <code>WebSocket.</code></p>

<h2 id="Constructor">Constructor</h2>

<dl>
 <dt>{{domxref("CloseEvent.CloseEvent", "CloseEvent()")}}</dt>
 <dd>Crear un nuevo <code>CloseEvent</code>.</dd>
</dl>

<h2 id="Propiedades">Propiedades</h2>

<p><em>Esta interface tambien hereda propiedades de su padre, {{domxref("Event")}}.</em></p>

<dl>
 <dt>{{domxref("CloseEvent.code")}} {{readOnlyInline}}</dt>
 <dd>Devuelve un <code>unsigned short</code> que contienen el código de cierre enviado por el servidor. Los siguientes valores son los codigos de estado permitidos. Las siguientes definiciones vienen del sitio web de IANA [<a href="https://www.iana.org/assignments/websocket/websocket.xml#close-code-number">Ref</a>].
 <table class="standard-table" id="Status_codes">
  <tbody>
   <tr>
    <td class="header">Status code</td>
    <td class="header">Name</td>
    <td class="header">Description</td>
   </tr>
   <tr>
    <td><code>0</code><code>999</code></td>
    <td></td>
    <td><strong>Reserved and not used.</strong></td>
   </tr>
   <tr>
    <td><code>1000</code></td>
    <td>Cierre Normal</td>
    <td>Cierre normal; La conexion se completo con exito cualquiera sea el proposito para el cual fue creado.</td>
   </tr>
   <tr>
    <td><code>1001</code></td>
    <td>Going Away</td>
    <td>El punto final se fue(desaparecio), ya sea por una falla en el servidor o por que el navegador esta navegando fuera de la página que abrio la conexión.</td>
   </tr>
   <tr>
    <td><code>1002</code></td>
    <td>Error de Protocolo</td>
    <td>El punto final esta terminando la conexion debido a un error en el protocolo. </td>
   </tr>
   <tr>
    <td><code>1003</code></td>
    <td>Datos no soportadors</td>
    <td>La conexión esta siendo terminada  por que el punto final recibio daros de un tipo que acepta o soportar (por ejemplo, está esperando un solo texto y el punto final recibio datos binarios).</td>
   </tr>
   <tr>
    <td><code>1004</code></td>
    <td></td>
    <td><strong>Reservado.</strong> Un signinficado se podria definir en un futuro.</td>
   </tr>
   <tr>
    <td><code>1005</code></td>
    <td>Estado no recibido. </td>
    <td><strong>Reservado.</strong>  Indica que no se proporciono ningún código de estado aunque se esperaba uno.</td>
   </tr>
   <tr>
    <td><code>1006</code></td>
    <td>Cierre anormal</td>
    <td><strong>Reservado.</strong> Se usa para indicar que una conexion fue cerrada de forma anormal (es decir, sin que se envie un frame cerrado with no close frame being sent) when a status code is expected.</td>
   </tr>
   <tr>
    <td><code>1007</code></td>
    <td>Invalid frame payload data</td>
    <td>The endpoint is terminating the connection because a message was received that contained inconsistent data (e.g., non-UTF-8 data within a text message).</td>
   </tr>
   <tr>
    <td><code>1008</code></td>
    <td>Violación de politica</td>
    <td>The endpoint is terminating the connection because it received a message that violates its policy. This is a generic status code, used when codes 1003 and 1009 are not suitable.</td>
   </tr>
   <tr>
    <td><code>1009</code></td>
    <td>Mensaje muy grande</td>
    <td>The endpoint is terminating the connection because a data frame was received that is too large.</td>
   </tr>
   <tr>
    <td><code>1010</code></td>
    <td>Extensión faltante.</td>
    <td>The client is terminating the connection because it expected the server to negotiate one or more extension, but the server didn't.</td>
   </tr>
   <tr>
    <td><code>1011</code></td>
    <td>Error interno</td>
    <td>The server is terminating the connection because it encountered an unexpected condition that prevented it from fulfilling the request.</td>
   </tr>
   <tr>
    <td><code>1012</code></td>
    <td>Reinicio de servicio</td>
    <td>El servidor esta terminado la conexion porque esta reiniciando. [<a href="https://www.ietf.org/mail-archive/web/hybi/current/msg09670.html">Ref</a>]</td>
   </tr>
   <tr>
    <td><code>1013</code></td>
    <td>Trate mas tarde nuevamente</td>
    <td>The server is terminating the connection due to a temporary condition, e.g. it is overloaded and is casting off some of its clients. [<a href="https://www.ietf.org/mail-archive/web/hybi/current/msg09670.html">Ref</a>]</td>
   </tr>
   <tr>
    <td><code>1014</code></td>
    <td>Bad Gateway</td>
    <td>The server was acting as a gateway or proxy and received an invalid response from the upstream server. This is similar to 502 HTTP Status Code.</td>
   </tr>
   <tr>
    <td><code>1015</code></td>
    <td>TLS Saludo</td>
    <td><strong>Reserved.</strong> Indicates that the connection was closed due to a failure to perform a TLS handshake (e.g., the server certificate can't be verified).</td>
   </tr>
   <tr>
    <td><code>1016</code><code>1999</code></td>
    <td></td>
    <td><strong>Reservado para futuro uso del estandar WebSocket.</strong></td>
   </tr>
   <tr>
    <td><code>2000</code><code>2999</code></td>
    <td></td>
    <td><strong>Reservado para uso de extensiones WebSocket .</strong></td>
   </tr>
   <tr>
    <td><code>3000</code><code>3999</code></td>
    <td></td>
    <td>Available for use by libraries and frameworks. <strong>May not</strong> be used by applications. Available for registration at the IANA via first-come, first-serve.</td>
   </tr>
   <tr>
    <td><code>4000</code><code>4999</code></td>
    <td></td>
    <td>Disponible para uso de aplicaciones.</td>
   </tr>
  </tbody>
 </table>
 </dd>
 <dt>{{domxref("CloseEvent.reason")}} {{readOnlyInline}}</dt>
 <dd>Retorna un {{domxref("DOMString")}} indicando la razon por que el servidor cerro la conexión. Esto es especifico para el servidor  y sub-protocolo en particular. </dd>
 <dt>{{domxref("CloseEvent.wasClean")}} {{readOnlyInline}}</dt>
 <dd>Retorna un {{jsxref("Boolean")}} que indica si o no la conexion fue cerrada limpiamente.</dd>
</dl>

<h2 id="Metodos">Metodos</h2>

<p><em>Esta interface tambien hereda metodos de su padre, {{domxref("Event")}}.</em></p>

<dl>
 <dt>{{domxref("CloseEvent.initCloseEvent()")}} {{Non-standard_inline}} {{Obsolete_inline}}</dt>
 <dd>Inicializa el valor de un <code>CloseEvent</code> creado. Si el evento ya ha sido enviado, este método no funciona. No use más este método, use el {{domxref("CloseEvent.CloseEvent", "CloseEvent()")}} constructor en su lugar.</dd>
</dl>

<h2 id="Compatibilidad_entre_Navegadores">Compatibilidad entre Navegadores </h2>

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

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Edge</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoDesktop("8.0")}}<sup>[1]</sup><br>
    {{CompatGeckoDesktop("12.0")}}<sup>[2]</sup></td>
   <td>10</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>initCloseEvent</code><code>()</code> {{Non-standard_inline}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoDesktop("8.0")}}<br>
    {{CompatNo}} 41.0</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Edge</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoMobile("8.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>initCloseEvent</code><code>()</code> {{Non-standard_inline}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoMobile("8.0")}}<br>
    {{CompatNo}} 41.0</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Prior to Gecko 8.0 {{geckoRelease("8.0")}}, Gecko sent the WebSocket {{event("close")}} event to the listener as a simple event. Support for <code>CloseEvent</code> was implemented in Gecko 8.0.</p>

<p>[2] Prior to Gecko 12.0 {{geckoRelease("12.0")}}, Gecko reported the close code <code>CLOSE_NORMAL</code> when the channel was closed due to an unexpected error, or if it was closed due to an error condition that the specification doesn't cover. Now <code>CLOSE_GOING_AWAY</code> is reported instead.</p>

<h2 id="Ver_tambien">Ver tambien</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/WebSocket"><code>WebSocket</code></a></li>
</ul>