Probador de WebSocket
Conéctate a un servidor WebSocket desde tu navegador, envía mensajes de texto, JSON o binarios y observa cada trama en un registro en vivo con marcas de tiempo y tamaños. La reconexión automática y el mensaje repetido mantienen activas las pruebas de larga duración.
Última actualización:
Cómo usar Probador de WebSocket
- Introduce la URL del servidor, por ejemplo wss://echo.websocket.org, y opcionalmente un subprotocolo.
- Haz clic en Conectar. El estado se pone en verde cuando la conexión está abierta, y los primeros mensajes del servidor aparecen en el registro.
- Escribe un mensaje y haz clic en Enviar (o pulsa Ctrl+Intro). Elige Texto, JSON o Binario (hex) como formato.
- Observa el registro: los mensajes enviados llevan una flecha hacia arriba, los recibidos una flecha hacia abajo y los eventos de conexión aparecen en gris. Fíltralo o expórtalo en cualquier momento.
- Activa la reconexión automática para volver a conectar cuando el servidor cierre la conexión, y Repetir para enviar un mensaje con un temporizador.
Códigos de cierre de WebSocket
Cuando una conexión termina, el registro muestra el código de cierre enviado por el servidor (o fijado por el navegador). Los más comunes, según el RFC 6455 y el registro de IANA:
| Código | Nombre | Qué suele significar |
|---|---|---|
| 1000 | Normal Closure (cierre normal) | Uno de los dos lados cerró la conexión a propósito. |
| 1001 | Going Away (desconexión) | El servidor se está apagando o reiniciando, o se cerró la pestaña del navegador. |
| 1002 | Protocol Error (error de protocolo) | Una trama incumplió el protocolo WebSocket. |
| 1003 | Unsupported Data (datos no admitidos) | El servidor no acepta este tipo de mensaje, por ejemplo binario cuando espera texto. |
| 1005 | No Status Received (sin estado) | La trama de cierre no tenía código. Lo fija el navegador, nunca se envía por la red. |
| 1006 | Abnormal Closure (cierre anómalo) | La conexión se cortó o nunca se abrió: URL incorrecta, conexión rechazada, problema de TLS o de proxy. Lo fija el navegador. |
| 1007 | Invalid Payload (datos no válidos) | Un mensaje de texto no era UTF-8 válido o los datos no coincidían con lo que espera el servidor. |
| 1008 | Policy Violation (infracción de política) | El servidor rechazó el mensaje o el cliente, a menudo por una comprobación de autenticación u origen. |
| 1009 | Message Too Big (mensaje demasiado grande) | El mensaje supera el tamaño que permite el servidor. |
| 1011 | Internal Error (error interno) | El servidor sufrió un error inesperado. |
| 1012 / 1013 | Service Restart / Try Again Later (reinicio / reintentar más tarde) | Temporal: vuelve a conectar tras una breve espera (la reconexión automática lo hace por ti). |
| 4000–4999 | Códigos de aplicación | Definidos por la app o la biblioteca con la que te comunicas; consulta su documentación. |
Depurar una conexión WebSocket
- Prueba primero con un servidor de eco. Si wss://echo.websocket.org funciona pero tu servidor no, el problema está en el servidor o en la URL.
- Comprueba la ruta y el puerto. Muchos servidores escuchan en una ruta concreta como
/wso/socket; la ruta raíz suele devolver un error. - Comprobaciones de origen. Los servidores pueden rechazar handshakes de orígenes desconocidos con HTTP 403, que el navegador muestra como código de cierre 1006.
- Autenticación. Los navegadores no pueden añadir cabeceras personalizadas al handshake, así que pasa un token en la cadena de consulta, una cookie o el primer mensaje.
- Keep-alive. Los proxies y balanceadores de carga suelen cerrar las conexiones inactivas tras 30 a 120 segundos. Usa Repetir mensaje para enviar un pequeño ping y mantener la conexión abierta.
Preguntas frecuentes
¿Qué es un WebSocket?
Un WebSocket es una conexión bidireccional de larga duración entre un navegador y un servidor, abierta con una solicitud HTTP Upgrade y definida en el RFC 6455. A diferencia de las solicitudes HTTP normales, ambos lados pueden enviar mensajes en cualquier momento, lo que hace que los WebSockets sean ideales para chats, paneles en vivo, juegos y notificaciones.
¿Qué diferencia hay entre ws:// y wss://?
wss:// es WebSocket sobre TLS, el equivalente cifrado de https://. ws:// no está cifrado. Las páginas servidas por HTTPS, como esta, solo pueden abrir conexiones wss://, salvo a localhost, que los navegadores suelen permitir para desarrollo.
¿Por qué falla la conexión con el código 1006?
1006 significa que la conexión se cerró de forma anómala sin trama de cierre, y los navegadores no revelan el motivo. Las causas habituales son una URL o un puerto incorrectos, que el servidor rechace la cabecera Origin, un certificado TLS no válido, un proxy o cortafuegos que bloquee los WebSockets, o que el servidor esté caído.
¿Puedo añadir cabeceras personalizadas como Authorization?
No. La API WebSocket del navegador no permite cabeceras personalizadas. Los servidores suelen aceptar un token en la cadena de consulta de la URL (por ejemplo ?token=...), en una cookie o en el primer mensaje tras conectar. A veces también se usa el campo de subprotocolo para esto.
¿Esta herramienta admite Socket.IO o STOMP?
Trabaja con tramas WebSocket sin procesar. Socket.IO y STOMP añaden su propio formato de mensaje por encima, así que puedes comunicarte con ellos enviando tú mismo mensajes con el formato correcto, pero esta herramienta no implementa esos protocolos automáticamente.
¿Mi tráfico pasa por FreeToolCabin?
No. Tu navegador se conecta directamente al servidor WebSocket que introduces. Los mensajes y registros se quedan en esta pestaña; solo la URL y los mensajes recientes se guardan en el almacenamiento local de tu navegador por comodidad.
¿Se prueban todas las herramientas de FreeToolCabin para comprobar su calidad y precisión?
Sí. Cada herramienta del sitio pasa pruebas automáticas en navegadores reales para comprobar que el resultado es correcto y que no hay errores. Si encuentras un fallo o tienes una sugerencia, escríbenos a [email protected] y lo revisaremos.