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
- Crea una richiesta WebSocket: l'URL prende l'indirizzo completo (
ws://…/ws/echoowss://…/path); gli header di handshake vanno negli header della richiesta. - Tocca Connetti per stabilire la sessione.
- Scrivi nella sessione e invia; i frame ricevuti compaiono in tempo reale.
- 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.