Testador WebSocket

Visao geral da ferramenta: Testador WebSocket

O testador WebSocket é um cliente baseado no navegador para validar serviços em tempo real diretamente no ToolMi. Informe um endpoint, conecte-se na hora e inspecione cada frame com carimbo de data/hora, estado e direção da mensagem.

O que é Testador WebSocket?

Testador WebSocket testa regras ou conexões rapidamente para localizar problemas.

Como usar

1. Insira regras ou parâmetros.
2. Forneça um exemplo ou endereço.
3. Revise os resultados e ajuste.

Casos de uso comuns

• Verificações antes de produção
• Validar regras e casos extremos
• Confirmação rápida na integração

❓ Perguntas frequentes

P1: Por que o resultado está incorreto?
R: Verifique o formato de entrada e as opções, e teste o exemplo se houver.

P2: E se a entrada for muito grande?
R: Divida os dados em partes menores para obter resultados mais estáveis.

P3: Como salvo a saída?
R: Use os botões de copiar ou baixar se a ferramenta oferecer.

✨ Recursos em destaque

• 🔄 Monitor de conexão ao vivo: acompanhe o progresso do handshake, as mudanças de readyState e os códigos/motivos de fechamento.
• 🧾 Log estruturado de mensagens: cada frame fica registrado com horário, direção e conteúdo, com as entradas mais recentes no topo.
• 🧩 Detecção de frames binários: identifica automaticamente mensagens binárias para que você baixe os bytes nas DevTools do navegador.
• ⚙️ Editor flexível: alterne entre auto scroll e limpar após enviar conforme o fluxo de testes que você precisa.
• 🌐 Ajuda multilíngue: a documentação acompanha o idioma ativo para manter toda a equipe alinhada.

🚀 Guia rápido

1. Cole o endpoint ws:// ou wss:// desejado em Endpoint do servidor.
2. Use o botão Alternar para ws:///wss:// para trocar o esquema sem reescrever o endereço.
3. (Opcional) Informe subprotocolos separados por vírgula quando o backend exigir negociação.
4. Clique em Conectar e observe o indicador de status para confirmar o handshake.
5. Escreva o payload no campo de mensagem e pressione Enviar mensagem para transmitir um frame.
6. Acompanhe os logs de Enviado e Recebido no topo do painel, desativando o auto scroll para analisar o histórico.

📖 Exemplos de uso

Teste com servidor de eco

Endpoint: wss://echo.websocket.events
Mensagem: {"action":"ping","source":"toolmi"}

O servidor responde com o mesmo conteúdo. Você verá um log Enviado seguido de um Recebido com a mesma carga útil.

Negociação de subprotocolos

Endpoint: wss://example.com/chat
Subprotocolos: chat.v2, json
Mensagem: {"type":"join","room":"support"}

Se o servidor aceitar chat.v2, a sessão continua nesse protocolo e você pode seguir trocando mensagens normalmente.

Ajuste iterativo de payloads

1. Desmarque Limpar mensagem após o envio.
2. Envie um JSON inicial.
3. Modifique apenas os campos necessários e envie novamente.
4. Compare as respostas mais recentes na parte superior do log.

🎯 Cenários comuns

1. Depuração de APIs em tempo real

Valide autenticação, assinatura de canais e formato das mensagens antes de integrar a API WebSocket ao seu sistema.

2. Demonstrações ao vivo

Apresente recursos de streaming para o time ou clientes conectando-se a ambientes de teste diretamente pelo navegador.

3. Treinamentos sobre protocolo

Mostre na prática como se comportam códigos de fechamento, frames binários e subprotocolos em uma sessão WebSocket.

📘 Legenda do log

• Info – eventos do ciclo de vida: tentativa de conexão, handshake bem-sucedido, desligamento manual e motivos de fechamento.
• Enviado – frames enviados do editor para o servidor.
• Recebido – frames recebidos do servidor; payloads de texto são exibidos como foram recebidos.
• Erro – problemas detectados pelo navegador, como URL inválida, falha TLS ou perda de rede.

🛠️ Solução de problemas

• Navegadores não permitem cabeçalhos personalizados no handshake. Teste a partir da mesma origem ou utilize um cliente desktop quando for necessário.
• O código de fechamento 1006 geralmente indica interrupção durante o handshake; verifique proxies, firewalls ou certificados.
• Se o servidor recusar a conexão, remova subprotocolos desconhecidos ou confirme qual valor ele espera.
• Para baixar frames binários, abra a aba Network nas DevTools e exporte os bytes por lá.

💡 Dicas extras

• Combine o testador com o formatador JSON ou o decodificador JWT para criar payloads rapidamente.
• Mantenha o auto scroll ligado em cenários com muitas mensagens e desligue-o para tirar capturas estáticas.
• Compartilhe o endpoint e o payload com colegas para que reproduzam a mesma sessão de testes.