Como testar um endpoint WebSocket pelo navegador

Digite um endereço ws:// ou wss://, clique em Conectar WebSocket e o registro abaixo mostra cada passo: o endereço aberto, o momento em que a conexão fica pronta, tudo o que você envia e cada quadro que o servidor devolve. O navegador conecta do seu dispositivo direto ao endpoint; voritools.com é apenas a página que você está vendo.

O botão Exemplo preenche o campo com wss://echo.websocket.org, um serviço de eco público que devolve cada mensagem, para conferir todo o trajeto sem montar um servidor próprio.

  1. Cole o endereço do endpoint. Ele precisa começar com ws:// ou wss://; um endereço http:// ou https:// é convertido automaticamente, e um endereço sem esquema é recusado com um aviso em vez de ser resolvido em silêncio contra esta página.
  2. Clique em Conectar WebSocket. Como esta página é servida por HTTPS, o navegador só permite ws:// sem criptografia para localhost ou 127.0.0.1; servidores remotos exigem wss://. Se o handshake falhar, o código de encerramento é informado.
  3. Digite uma mensagem e clique em Enviar mensagem, ou pressione Enter no campo. As marcas de tempo mostram quando ela saiu e quando a resposta chegou. Desconectar fecha o socket; Limpar zera o endereço, a mensagem e o registro sem mexer na conexão.

O que o registro informa

Códigos de encerramento e conexões recusadas

Um encerramento normal informa o código 1000. O código 1006 significa que o handshake não foi concluído: porta fechada, host inacessível, certificado TLS recusado ou origem do navegador não aceita pelo servidor. O registro mostra esse código em vez de deixar uma linha de erro vazia.

Os navegadores não expõem o motivo de um handshake malsucedido, então o código é o sinal mais preciso que a página consegue obter. Com um servidor na sua máquina, confirme que ele está mesmo ouvindo na porta digitada.

Origem, wss:// e localhost

Conexões WebSocket não passam por CORS, mas o servidor pode inspecionar o cabeçalho Origin, e esta página envia https://voritools.com. Um servidor com lista de origens permitidas recusa o handshake e o navegador informa o código 1006.

Como a página é HTTPS, ws:// sem criptografia só é aceito para localhost e 127.0.0.1. Todo o resto precisa ser wss://; caso contrário o navegador bloqueia a conexão antes de começar e a página avisa.

O que o registro mostra exatamente

Os quadros são impressos como texto escapado: se um servidor devolver HTML, as tags aparecem literalmente em vez de serem renderizadas na página, e o mesmo vale para as mensagens enviadas.

O registro é uma transcrição contínua, não um terminal: mostra quadros de texto, não guarda nada depois de recarregar e Limpar o apaga.

Ferramentas recentes: