Pular para o conteúdo principal

WebSocket (visão do desenvolvedor)

Uma conexão full-duplex de longa duração. Diferente do HTTP de um-envio-uma-resposta, o WS primeiro estabelece uma conexão, depois envia / recebe quadros a qualquer momento e, por fim, fecha.

Como usar na UI​

  1. Crie uma requisição WebSocket: a URL recebe o endereço completo (ws://…/ws/echo ou wss://…/path); headers de handshake vão para os headers da requisição.
  2. Toque em Conectar para estabelecer a sessão.
  3. Digite na sessão e envie; os quadros recebidos aparecem em tempo real.
  4. Feche a sessão ao terminar (sessões têm cota; as ociosas são recuperadas automaticamente).

Texto puro vs. criptografado​

  • ws:// é texto puro; wss:// usa TLS.
  • Se você passar pelo Pre-URL WS do ambiente, esse endereço base deve ser escrito como ws:///wss:// — https:// seria tratado como HTTP (veja concepts).

Comportamento verificado​

Quadros de texto fazem a ida e volta com o UTF-8 intacto (hello-ws-世界 enviado e recebido idêntico). O /ws/headers ecoa de volta os headers que você enviou no handshake, o que facilita verificar que eles tiveram efeito. Subprotocolos, compressão e heartbeats são cobertos nos casos de teste automatizados.

Pontos de atenção​

  • Nenhum eco recebido: confirme que o servidor realmente responde; 'enviar' em uma conexão longa apenas emite — a resposta chega depois como um quadro recebido.
  • Quer apenas observar sem enviar: depois de conectar você pode acompanhar os quadros de entrada (ex.: pushes do servidor).
  • A cota de sessão é limitada e sessões ociosas fecham após ~5 minutos; feche sessões antigas prontamente ao depurar em lote.

Relacionado: configuração de UI de conexão/envio em concepts.