メインコンテンツまでスキップ

WebSocket(開発者ビュー)

全二重の長時間接続です。HTTPの1送信1受信と違い、WSはまず接続を確立し、その後いつでもフレームを送受信し、最後に切断します。

UIでの使い方​

  1. WebSocketリクエストを作成:URLは完全なアドレスを取ります(ws://…/ws/echo または wss://…/path)。ハンドシェイクヘッダーはリクエストヘッダーに入れます。
  2. 接続をタップしてセッションを確立します。
  3. セッションに入力して送信。受信フレームはリアルタイム表示されます。
  4. 終わったらセッションを切断します(セッションにはクォータがあり、アイドルのものは自動回収されます)。

平文と暗号化​

  • ws:// は平文、wss:// はTLSを使用します。
  • 環境のWS Pre-URLを経由する場合、そのベースアドレスは必ず ws:///wss:// と書く必要があります — https:// はHTTPとして扱われます(concepts 参照)。

検証済みの動作​

テキストフレームはUTF-8無傷で往復します(hello-ws-世界 をそのまま送受信)。/ws/headers はハンドシェイク時に送ったヘッダーをエコーバックするので、ヘッダーが効いているか簡単に確認できます。サブプロトコル、圧縮、ハートビートは自動テストケースでカバー。

注意点​

  • エコーが届かない:サーバーが実際に返信するか確認します。長時間接続の「送信」は送り出すだけ — 返信は後から受信フレームとして届きます。
  • 送らずに観察したいだけ:接続後は入ってくるフレーム(サーバープッシュなど)を見られます。
  • セッションクォータには上限があり、アイドルセッションは約5分で閉じられます。連続デバッグ時は古いセッションを速やかに閉じてください。

関連:接続/送信のUI設定は concepts。