Какие события WebSocket существуют?

WebSocket — это протокол для двусторонней связи между клиентом и сервером поверх одного TCP-соединения. В браузерном API объект WebSocket генерирует события, которые описывают все ключевые этапы работы соединения: от установки до закрытия. Понимание этих событий критично для построения надёжных real-time приложений — чатов, биржевых котировок, онлайн-игр.

Основные события

• open — соединение успешно установлено, можно отправлять данные.
• message — получено сообщение от сервера; данные лежат в event.data.
• error — произошла ошибка соединения (сеть, отказ сервера и т.п.).
• close — соединение закрыто; в событии есть code и reason.

Пример обработки

const ws = new WebSocket('wss://example.com/chat');

ws.onopen = () => {
  console.log('Соединение открыто');
  ws.send(JSON.stringify({ type: 'join', user: 'Alice' }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Получено:', data);
};

ws.onerror = (err) => {
  console.error('Ошибка WebSocket', err);
};

ws.onclose = (event) => {
  console.log(`Закрыто: код=${event.code}, причина=${event.reason}`);
};

Практические нюансы

• Событие error не содержит деталей — обычно просто сигнал о проблеме.
• После close объект WebSocket нельзя переиспользовать, нужно создавать новый.
• Для переподключения используют экспоненциальную задержку в обработчике onclose.
• События можно слушать и через addEventListener('message', handler).

Итог: события WebSocket дают полный контроль над соединением — их обработка обязательна для стабильной работы real-time функциональности, особенно при разрывах сети и необходимости автопереподключения.