Traducción en curso

Un CloseEvent se envia a los clientes usando WebSockets cuando la conexion esta cerrada. Esto se entrega al que escucha indicado por el atributo onclose del objeto WebSocket.

Constructor

CloseEvent()
Crear un nuevo CloseEvent.

Propiedades

Esta interface tambien hereda propiedades de su padre, Event.

CloseEvent.code Read only
Devuelve un unsigned short que contienen el codigo de cierr enviado por el servidor. Los siguientes valores son los codigos de estado permitidos. Las siguientes definiciones vienen del sitio web de IANA [Ref].
Status code Name Description
0999   Reserved and not used.
1000 Cierre Normal Cierre normal; La conexion se completo con exito cualquiera sea el proposito para el cual fue creado.
1001 Going Away 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.
1002 Error de Protocolo El punto final esta terminando la conexion debido a un error en el protocolo. 
1003 Datos no soportadors 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).
1004   Reservado. Un signinficado se podria definir en un futuro.
1005 Estado no recibido.  Reservado.  Indica que no se proporciono ningún código de estado aunque se esperaba uno.
1006 Cierre anormal Reservado. 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.
1007 Invalid frame payload data 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).
1008 Violación de politica 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.
1009 Mensaje muy grande The endpoint is terminating the connection because a data frame was received that is too large.
1010 Extensión faltante. The client is terminating the connection because it expected the server to negotiate one or more extension, but the server didn't.
1011 Error interno The server is terminating the connection because it encountered an unexpected condition that prevented it from fulfilling the request.
1012 Reinicio de servicio El servidor esta terminado la conexion porque esta reiniciando. [Ref]
1013 Trate mas tarde nuevamente The server is terminating the connection due to a temporary condition, e.g. it is overloaded and is casting off some of its clients. [Ref]
1014 Bad Gateway 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.
1015 TLS Saludo Reserved. Indicates that the connection was closed due to a failure to perform a TLS handshake (e.g., the server certificate can't be verified).
10161999   Reservado para futuro uso del estandar WebSocket.
20002999   Reservado para uso de extensiones WebSocket .
30003999   Available for use by libraries and frameworks. May not be used by applications. Available for registration at the IANA via first-come, first-serve.
40004999   Disponible para uso de aplicaciones.
CloseEvent.reason Read only
Retorna un DOMString indicando la razon por que el servidor cerro la conexión. Esto es especifico para el servidor  y sub-protocolo en particular. 
CloseEvent.wasClean Read only
Retorna un Boolean que indica si o no la conexion fue cerrada limpiamente.

Metodos

Esta interface tambien hereda metodos de su padre, Event.

CloseEvent.initCloseEvent()
Inicializa el valor de un CloseEvent creado. Si el evento ya ha sido enviado, este método no funciona. No use más este método, use el CloseEvent() constructor en su lugar.

Compatibilidad entre Navegadores 

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support ? (Yes) 8.0 (8.0)[1]
12.0 (12.0)[2]
10 ? ?
initCloseEvent() Sin soporte (Yes) 8.0 (8.0)
Sin soporte 41.0
Sin soporte Sin soporte Sin soporte
Feature Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? (Yes) 8.0 (8.0) ? ? ?
initCloseEvent() Sin soporte (Yes) 8.0 (8.0)
Sin soporte 41.0
Sin soporte Sin soporte Sin soporte

[1] Prior to Gecko 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5), Gecko sent the WebSocket close event to the listener as a simple event. Support for CloseEvent was implemented in Gecko 8.0.

[2] Prior to Gecko 12.0 (Firefox 12.0 / Thunderbird 12.0 / SeaMonkey 2.9), Gecko reported the close code CLOSE_NORMAL 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 CLOSE_GOING_AWAY is reported instead.

Ver tambien

Etiquetas y colaboradores del documento

 Colaboradores en esta página: jpmontoya182
 Última actualización por: jpmontoya182,