После сна вкладка может показывать `OPEN`, хотя сетевой маршрут, NAT-состояние или серверная сессия уже исчезли. Таймеры в браузере на паузе, поэтому привычный ping не успевает сообщить об ошибке. В итоге интерфейс выглядит подключённым, но новых данных нет.
Исправление начинается не с бесконечного `setInterval`, а с правила: соединение считается живым только после недавнего подтверждённого обмена. После пробуждения приложение закрывает сомнительный канал, создаёт новый и запрашивает изменения, пропущенные во время сна.
Воспроизведите именно сон, а не потерю Wi‑Fi
- Откройте страницу и дождитесь подтверждённого realtime-события.
- Зафиксируйте connection id, sequence последнего события и время heartbeat.
- Переведите компьютер в сон дольше серверного idle timeout.
- После пробуждения отправьте контрольное событие с другого клиента.
- Сравните состояние 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. Содержимое пользовательских сообщений для этого не требуется.