diff options
Diffstat (limited to 'files/es/web/api/closeevent/index.html')
-rw-r--r-- | files/es/web/api/closeevent/index.html | 237 |
1 files changed, 237 insertions, 0 deletions
diff --git a/files/es/web/api/closeevent/index.html b/files/es/web/api/closeevent/index.html new file mode 100644 index 0000000000..f92dd84d16 --- /dev/null +++ b/files/es/web/api/closeevent/index.html @@ -0,0 +1,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> |