После сна вкладка может показывать `OPEN`, хотя сетевой маршрут, NAT-состояние или серверная сессия уже исчезли. Таймеры в браузере на паузе, поэтому привычный ping не успевает сообщить об ошибке. В итоге интерфейс выглядит подключённым, но новых данных нет.

Исправление начинается не с бесконечного `setInterval`, а с правила: соединение считается живым только после недавнего подтверждённого обмена. После пробуждения приложение закрывает сомнительный канал, создаёт новый и запрашивает изменения, пропущенные во время сна.

Воспроизведите именно сон, а не потерю Wi‑Fi

  1. Откройте страницу и дождитесь подтверждённого realtime-события.
  2. Зафиксируйте connection id, sequence последнего события и время heartbeat.
  3. Переведите компьютер в сон дольше серверного idle timeout.
  4. После пробуждения отправьте контрольное событие с другого клиента.
  5. Сравните состояние UI, readyState, журнал reconnect и серверный список соединений.

Этот тест нельзя полностью заменить переключением airplane mode: при сне браузер может заморозить задачи и не вызвать обработчики в том порядке, который вы видите при обычном offline.

Сигналы пробуждения — повод проверить канал

Полезны события `visibilitychange`, `pageshow`, `online` и, где доступно, `resume`. Ни одно из них по отдельности не доказывает наличие интернета. Используйте их как триггер для проверки возраста последнего pong или короткого прикладного запроса.

if (Date.now() - lastConfirmedAt > staleAfterMs) {
  reconnect({ reason: 'stale-after-resume' });
}

Задержку выбирают относительно heartbeat и серверных таймаутов. Слишком короткий порог создаст шторм переподключений при краткой паузе, слишком длинный оставит пользователя с зависшим экраном.

Reconnect без восстановления данных недостаточен

СлойПосле сна нужно
TransportЗакрыть старый канал и установить новый
AuthenticationОбновить истёкший access token безопасным способом
SubscriptionsПовторно подписаться один раз на нужные темы
DataЗапросить изменения после последнего sequence или сделать snapshot

Если сервер не хранит sequence или cursor, самый надёжный вариант после долгого разрыва — получить свежий снимок. Иначе приложение может успешно переподключиться, но навсегда пропустить событие, отправленное во время сна.

Как не получить дубли после пробуждения

Reconnect может сработать одновременно из `online`, `visibilitychange` и watchdog. Объедините их через один state machine и один promise текущего подключения. Повторная подписка должна заменять старую либо иметь стабильный subscription ID.

  • Добавьте jitter к повторным попыткам, чтобы много вкладок не пошли на сервер одновременно.
  • Отменяйте устаревшую попытку, если уже создано новое соединение.
  • Игнорируйте событие с sequence, которое уже применено.
  • Показывайте пользователю состояние «восстанавливаем данные», а не ложное «онлайн».

Критерий готовности исправления

После нескольких циклов сна интерфейс должен получить все контрольные изменения один раз и перейти в актуальное состояние без ручной перезагрузки. В метриках отслеживайте время от resume до первого подтверждённого события и причины reconnect.

Для разбора полезны клиентский timeline, серверные connection IDs и настройки idle timeout. Содержимое пользовательских сообщений для этого не требуется.

Проверенные источники