Перейти к основному содержимому

WebSocket (глазами разработчика)

Полнодуплексное долгоживущее соединение. В отличие от HTTP «одна отправка — один прием», WS сначала устанавливает соединение, затем отправляет / принимает фреймы в любой момент и, наконец, закрывается.

Как использовать в UI​

  1. Создайте WebSocket-запрос: URL принимает полный адрес (ws://…/ws/echo или wss://…/path); заголовки handshake идут в заголовки запроса.
  2. Нажмите Подключить, чтобы установить сессию.
  3. Набирайте текст в сессии и отправляйте; полученные фреймы отображаются в реальном времени.
  4. Закройте сессию, когда закончите (у сессий есть квота; простаивающие освобождаются автоматически).

Открытое vs шифрованное​

  • ws:// — открытый текст; wss:// использует TLS.
  • Если вы идете через WS Pre-URL окружения, этот базовый адрес должен быть записан как ws:///wss:// — https:// будет трактован как HTTP (см. concepts).

Проверенное поведение​

Текстовые фреймы проходят круг с сохранением UTF-8 (hello-ws-世界 отправлен и получен идентично). /ws/headers эхом возвращает заголовки, отправленные при handshake, — легко проверить, что они сработали. Субпротоколы, сжатие и heartbeats покрыты автоматизированными тест-кейсами.

Важные нюансы​

  • Эхо не получено: убедитесь, что сервер действительно отвечает; «отправка» по долгому соединению только излучает — ответ придет позже как полученный фрейм.
  • Хотите только наблюдать без отправки: после подключения можно смотреть входящие фреймы (например, пуши сервера).
  • Квота сессий ограничена, простаивающие сессии закрываются через ~5 минут; при отладке партиями своевременно закрывайте старые сессии.

Связанное: настройка UI подключения/отправки в concepts.