¿Qué es SockJS?

SockJS es una biblioteca JavaScript de código abierto que proporciona una API similar a WebSocket con respaldo transparente a transportes alternativos cuando WebSocket no está disponible. Fue diseñada para entornos donde las conexiones WebSocket están bloqueadas — por ejemplo, por firewalls corporativos, navegadores antiguos o equilibradores de carga que no admiten actualizaciones de conexión. SockJS negocia automáticamente el mejor transporte disponible, eligiendo entre WebSocket, transmisión HTTP, sondeo HTTP largo y varios otros mecanismos.

SockJS requiere una biblioteca compatible del lado del servidor (como SockJS-Node o el soporte de SockJS de Spring) y utiliza su propio subprotocolo, por lo que no puede conectarse a un endpoint WebSocket simple.

Descripción de la herramienta

Esta herramienta proporciona un cliente SockJS basado en navegador. Ingresa la URL de un endpoint de servidor SockJS, conéctate, redacta mensajes de texto y observa todo el tráfico en un registro de mensajes con marca de tiempo. El nombre del transporte activo (por ejemplo, websocket, xhr-streaming, xhr-polling) se muestra en tiempo real para que puedas ver qué mecanismo de respaldo seleccionó la biblioteca.

Características

  • Negociación automática de transporte — se conecta con el mejor transporte disponible y muestra cuál fue seleccionado.
  • Registro de mensajes en vivo — todos los mensajes entrantes y eventos de conexión se capturan con marcas de tiempo para una inspección fácil.
  • Modos de texto y JSON — escribe cargas útiles como texto sin formato o JSON estructurado con resaltado de sintaxis y validación.

Opciones explicadas

URL del servidor — la URL HTTP(S) del endpoint de SockJS (por ejemplo, https://example.com/sockjs). No añadas /websocket ni ningún sufijo de transporte; SockJS maneja la negociación de rutas internamente.

Transporte — se muestra en el área de salida después de que se abre la conexión. Los valores comunes incluyen websocket (actualización directa exitosa), xhr-streaming (transmisión sobre XHR) y xhr-polling (sondeo largo tradicional). Este campo permanece en blanco hasta que se establece la conexión.

Tipo de datos — cambia entre los modos de composición Texto y JSON. El modo JSON valida la carga útil antes de enviarla.

Desplazamiento automático — mantiene el registro de mensajes fijado a la entrada más reciente.

Cómo funciona

El cliente utiliza la biblioteca JavaScript de SockJS para abrir una conexión al servidor de destino. SockJS realiza una solicitud de información al servidor para descubrir qué transportes son compatibles, luego negocia la mejor opción. Una vez conectado, la herramienta retransmite todos los mensajes salientes a través del método send de SockJS y registra cada evento onmessage devuelto por el servidor.

Consejos

  • Los servidores SockJS generalmente exponen su endpoint en una ruta como /sockjs o /ws. Consulta la documentación del servidor para obtener la URL base correcta.
  • Si el transporte muestra xhr-polling en lugar de websocket, el servidor o proxy puede estar bloqueando las actualizaciones de WebSocket.
  • SockJS no es compatible con endpoints WebSocket simples. Utiliza el Cliente de Prueba de WebSocket para servidores WebSocket estándar.