Passa al contenuto principale

WebSocket (vista sviluppatore)

Una connessione lunga full-duplex. A differenza dell'HTTP (un invio, una ricezione), WS prima stabilisce una connessione, poi invia / riceve frame in qualunque momento, e infine chiude.

Come si usa nella UI​

  1. Crea una richiesta WebSocket: l'URL prende l'indirizzo completo (ws://…/ws/echo o wss://…/path); gli header di handshake vanno negli header della richiesta.
  2. Tocca Connetti per stabilire la sessione.
  3. Scrivi nella sessione e invia; i frame ricevuti compaiono in tempo reale.
  4. Chiudi la sessione quando hai finito (le sessioni hanno una quota; quelle inattive vengono recuperate automaticamente).

Chiaro o cifrato​

  • ws:// è testo in chiaro; wss:// usa TLS.
  • Se passi dal Pre-URL WS dell'ambiente, quell'indirizzo base deve essere scritto come ws:///wss:// — https:// verrebbe trattato come HTTP (vedi concepts).

Comportamento verificato​

I frame di testo fanno il round-trip con UTF-8 intatto (hello-ws-世界 inviato e ricevuto identico). /ws/headers restituisce in eco gli header inviati durante l'handshake, così è facile verificare che abbiano effetto. Sottoprotocolli, compressione e heartbeat sono coperti dai casi di test automatici.

Punti di attenzione​

  • Nessuna eco ricevuta: verifica che il server risponda davvero; «invia» su una connessione lunga emette soltanto — la risposta arriva dopo come frame ricevuto.
  • Vuoi solo osservare senza inviare: dopo la connessione puoi guardare i frame in arrivo (es. push del server).
  • La quota sessione è limitata e le sessioni inattive si chiudono dopo ~5 minuti; chiudi tempestivamente le sessioni vecchie quando fai debug in batch.

Correlati: configurazione UI di connessione/invio in concepts.