Enviar mensagem
Ctrl+Enter para enviar
Registo de mensagens
Ainda sem mensagens. Ligue-se e envie algo para ver a troca aqui.
Codificação e texto
Ferramenta de Teste WebSocket
Um WebSocket é uma ligação persistente entre o navegador e um servidor: depois do handshake bem-sucedido, as mensagens fluem nos dois sentidos sem novo pedido. Esta página é um cliente WebSocket no navegador: cole um URL ws:// ou wss://, ligue-se, escreva uma mensagem e leia a resposta — cada frame com a hora de chegada, numa história a partir da qual pode reenviar. Corre inteiramente no navegador, sem instalação, sem conta e sem servidor intermédio.
O que pode fazer
Ligue-se em segundos, sem instalar nada
Cole um URL ws:// ou wss:// e prima Conectar. Não há extensão para instalar, nem Node.js para configurar, nem conta para criar — a ligação vai direto do navegador para o seu servidor, por isso vê o mesmo handshake e os mesmos erros que veria na sua app. Se faltar o protocolo, o campo adiciona-o por si.
Envie JSON, texto simples ou binário
O compositor tem um separador Text, um separador JSON que formata o que escreve, e um separador Binary para bytes. As mensagens enviadas ficam no histórico com carimbo de data/hora e seta de direção, para copiar um payload exato, reenviar ou comparar o eco do servidor com o que enviou.
Cada resposta com hora e reproduzível
As mensagens recebidas entram no registo com a hora de chegada, marcadas como text ou binary. Filtre, copie uma entrada ou copie a sessão inteira como JSON. Quando o servidor responde com um objeto de erro JSON, o payload bruto está ali — sem precisar de vasculhar a consola.
Diagnósticos que apontam a causa real
Quando o handshake falha, a página mostra o texto de erro do próprio navegador e uma leitura em linguagem clara: um 404 significa caminho errado, um 200 significa que acertou num endpoint HTTP simples em vez de WebSocket, e um URL ws:// bloqueado significa mixed content. Aparece um aviso antes de ligar se a página for https e o URL for ws://.
Grátis, privado e sem estado
Sem registo, sem envio dos seus payloads e nada guardado num servidor — as mensagens vão do navegador para o servidor e de volta, e a mais lado nenhum. Pode limpar o registo quando quiser, e fechar o separador termina a sessão.
Como usar
- 01
Cole o endpoint e ligue-se. Escreva ou cole um URL como wss://echo.websocket.org ou ws://localhost:8080/ws na barra de endereço. Se omitir o protocolo, é adicionado ws://. Prima Conectar e veja a linha de estado passar a open.
- 02
Envie algo e observe a resposta. Escreva no compositor à esquerda — Text para uma string simples, JSON para um payload (é formatado à medida que escreve) ou Binary para bytes — e prima Enviar ou Ctrl+Enter. Cada mensagem que envia e cada resposta que recebe aparece no registo à direita com a hora de chegada e uma seta a indicar a direção.
- 03
Leia a falha e corrija. Se a ligação não abrir, a barra de diagnóstico explica o que significa o erro do navegador e as causas habituais. Com uma troca limpa, copie o payload exato do registo, ou a sessão inteira como JSON, e cole no seu teste ou relatório de bug.
Sobre testes WebSocket
O que é WebSocket e como funciona o handshake
Um WebSocket é um protocolo que atualiza uma ligação HTTP comum para um canal persistente e bidirecional. O cliente abre com um pedido HTTP Upgrade, o servidor responde com 101 Switching Protocols e, a partir daí, ambos os lados podem enviar mensagens a qualquer momento sem outro ciclo de pedido/resposta. Essa é a diferença face ao HTTP simples, em que o servidor só fala quando o cliente pergunta. Um WebSocket não traz fuso horário nem unidade própria — apenas move bytes, e cabe à aplicação decidir se um frame é JSON, texto simples ou protocol buffer. O esquema do URL faz parte do contrato: ws:// é a variante insegura, wss:// é o mesmo protocolo envolvido em TLS, e ambos se comportam de forma idêntica acima do handshake.
Como testar um endpoint WebSocket a partir do navegador
Testar um endpoint WebSocket resume-se a quatro pontos: o handshake tem sucesso, o payload sai intacto, a resposta do servidor volta e parece correta, e consegue distinguir os dois quando algo corre mal. Esta página cobre os quatro para uma ligação de cada vez, o que chega para a grande maioria do trabalho com APIs. Também ajuda saber o custo das alternativas. O Postman também faz WebSocket, mas exige instalação no desktop e uma conta antes de guardar um modelo de payload. O wscat é excelente e grátis, mas precisa de Node.js e de um terminal — o sítio errado quando o payload veio de um relatório de bug no navegador. O Chrome DevTools está sempre lá, mas o painel WebSocket é só uma vista — pode ver os frames passar, mas não guarda um histórico a partir do qual reenviar, e o painel tem de estar aberto antes de a ligação começar. Se quiser um servidor de rascunho em vez de um cliente, esta página não o dá: execute o seu próprio servidor, ou use um endpoint echo público como wss://echo.websocket.org, e aponte esta página para ele.
Ler um handshake falhado
Quando o handshake falha, o navegador reporta um erro e a ligação nunca abre. O texto que reconhecerá é "Error during WebSocket handshake: Unexpected response code: 400" — e o número é o estado HTTP que o servidor devolveu em vez de 101. Um 404 costuma significar caminho errado ou rota registada noutro prefixo. Um 401 ou 403 significa que o servidor quer credenciais que não enviou. Um 200 é um bom indício de que apontou para um endpoint HTTP simples, porque um servidor WebSocket responde ao upgrade com 101 e nada mais. Um 301 ou 302 significa que o servidor tentou redirecionar o pedido de upgrade, o que os navegadores não seguem. Um 502 ou 503 costuma apontar para um proxy ou gateway à frente do servidor, não para o seu código. Um reset a meio do handshake significa que algo fechou o socket antes de a negociação terminar. Separadamente, se a própria página for servida em https e o URL começar por ws://, o navegador bloqueia-o como mixed content antes de enviar um único byte — use wss://, ou sirva o front end em http durante o desenvolvimento local.
Como este cliente no navegador se compara
| Aspeto | 1Tools | Postman | wscat | Chrome DevTools |
|---|---|---|---|---|
| Instalação | Nenhuma — abra a página | App de desktop | Node.js + npm | Integrado no Chrome |
| Conta | Sem registo | Conta para guardar modelos | Nenhuma | Nenhuma |
| Histórico reproduzível | Sim — registo com hora a partir do qual pode reenviar | Pedidos guardados após configuração | Só scrollback do terminal | Só vista; o painel tem de estar aberto primeiro |
| Cabeçalhos personalizados | Não — limite do navegador | Sim | Sim | Não — limite do navegador |
| Ideal para | Verificações rápidas no navegador e relatórios de bug | Coleções guardadas e fluxos de equipa | Scripts CLI e CI | Observar frames numa página existente |
Grátis, privado e sem instalação
Sem instalação, sem conta
Abra a página e ligue-se. Não há extensão, Node.js, registo nem chave de API para configurar.
As mensagens ficam entre si e o seu servidor
Este site não tem backend para os seus payloads. Os frames vão do navegador para o endpoint que escreveu, e a mais lado nenhum.
Limpe o registo quando quiser
O histórico de mensagens vive na página. Limpe-o ou feche o separador e desaparece; nada é guardado.
Transparente quanto aos limites
Os navegadores não podem definir cabeçalhos personalizados nem enviar pings ao nível do protocolo. A página diz o que funciona e o que não funciona, em vez de fingir.
FAQ
Formatador e validador JSONJSON Diff e comparaçãoDiferença de texto e comparaçãoTodas as ferramentasVoltar ao início
Feedback
Encontrou um erro confuso, um diagnóstico em falta ou um formato de payload que esta página deveria tratar melhor? Diga-nos — relatórios reais moldam o próximo FAQ e os ajustes de UI.