Guia prático

Testador WebSocket — Guia de uso e princípios técnicos

Console WebSocket no navegador para conectar-se a endpoints ws/wss, analisar códigos de fechamento, reproduzir logs e testar reconexão automática.

Abrir ferramenta

Visão geral

Garante que o canal bidirecional da RFC 6455 continue confiável perante autenticação, proxies e limitações de largura de banda, evitando quedas silenciosas em chats, dashboards ou IoT.

Conceitos principais

Upgrade HTTP

Um WebSocket começa como requisição HTTP com Sec-WebSocket-Key. O servidor responde com Sec-WebSocket-Accept, confirmando a RFC 6455 e abrindo um túnel TCP persistente.

Anatomia do quadro

Cada quadro possui opcode, comprimento e bits de máscara. O navegador mascara os quadros enviados e o servidor devolve bytes sem máscara, garantindo dúplex completo em uma única conexão.

Códigos de diagnóstico

Códigos 1000, 1006 ou 1011 mostram por que o túnel foi encerrado. Registrar esses códigos com horário ajuda a detectar proxies, TLS ou limites de cota.

Recursos

Visão do handshake

Valide URLs ws/wss e veja readyState e códigos de fechamento em tempo real.

Registro estruturado

Fluxo colorido que separa eventos do sistema, quadros enviados, recebidos e erros.

Auto reconexão

Loop opcional tenta reconectar a cada 1,5 s e registra cada tentativa.

Console de envio

Monte cargas JSON ou texto, reutilize rascunhos e acompanhe a resposta.

Perguntas frequentes

Por que o upgrade falha imediatamente?

Normalmente porque ainda se usa http/https, a porta está bloqueada ou um proxy remove os cabeçalhos Upgrade. Use wss://443 e confirme o retorno Sec-WebSocket-Accept.

O que significa o código 1006?

Indica que o socket fechou sem um quadro Fechar. Revise os logs do servidor e verifique se algum intermediário derruba conexões ociosas.

Posso enviar quadros binários?

Esta consola envia quadros texto UTF-8. Para binários, converta para Base64 ou use um cliente nativo com suporte a arquivos.

Documentação relacionada

Testador WebSocket

Abra a ferramenta para experimentar estes recursos.

Abrir ferramenta