Przejdź do głównej zawartości

WebSocket (widok dewelopera)

Pełnodupleksowe połączenie długotrwałe. W odróżnieniu od HTTP (jedna wysyłka — jeden odbiór) WS najpierw nawiązuje połączenie, potem w dowolnym momencie wysyła / odbiera ramki, a na końcu zamyka sesję.

Jak używać w UI​

  1. Utwórz żądanie WebSocket: adres URL przyjmuje pełny adres (ws://…/ws/echo albo wss://…/path); nagłówki handshake trafiają do nagłówków żądania.
  2. Stuknij Połącz, aby ustanowić sesję.
  3. Pisz w sesji i wyślij; odbierane ramki pojawiają się w czasie rzeczywistym.
  4. Po zakończeniu zamknij sesję (sesje mają limit; bezczynne są odbierane automatycznie).

Zwykłe czy szyfrowane​

  • ws:// to połączenie jawne; wss:// używa TLS.
  • Jeśli przechodzisz przez WS Pre-URL środowiska, ten adres bazowy musi być zapisany jako ws:///wss:// — https:// zostałby potraktowany jako HTTP (zobacz concepts).

Zweryfikowane zachowanie​

Ramki tekstowe wracają z nienaruszonym UTF-8 (hello-ws-世界 wysłane i odebrane identycznie). /ws/headers odsyła nagłówki wysłane podczas handshake, co ułatwia sprawdzenie, że zadziałały. Subprotokoły, kompresja i heartbeat są pokryte w zautomatyzowanych przypadkach testowych.

Na co zwrócić uwagę​

  • Brak echo: upewnij się, że serwer faktycznie odpowiada; „wyślij” na połączeniu długotrwałym tylko emituje — odpowiedź przyjdzie później jako odebrana ramka.
  • Chcesz tylko obserwować, bez wysyłania: po nawiązaniu połączenia możesz oglądać przychodzące ramki (np. wysyłki serwera).
  • Limit sesji jest ograniczony, a bezczynne sesje zamykają się po ~5 minutach; przy debugowaniu wsadowo zamykaj stare sesje na bieżąco.

Powiązane: konfiguracja UI połączenia/wysyłki w concepts.