Network First сначала ждёт сеть и обращается к кешу после ошибки. При «подключённом», но почти не передающем данные интернете ошибка может наступить слишком поздно, поэтому пользователь видит бесконечный spinner. В Workbox задайте `networkTimeoutSeconds`, но сначала убедитесь, что для этого URL действительно есть пригодная кешированная версия.
Timeout не создаёт offline-ответ из воздуха. При первом визите и пустом кеше стратегия завершится ошибкой. Для навигации подготовьте offline page или прогрейте ключевой маршрут; для персональных API-ответов решите, допустимо ли вообще показывать устаревшие данные другому состоянию авторизации.
Разделите три режима одной навигации
| Условие | Ответ пользователю | Что проверить |
|---|---|---|
| Сеть быстрая | Свежий network response | Ответ кешируется только при допустимом статусе |
| Сеть медленная, cache hit | Кеш после timeout | Понятна давность данных и сеть не блокирует UI |
| Сеть недоступна, cache hit | Кеш после network failure | Страница не требует отсутствующих API для первого рендера |
| Сеть медленная, cache miss | Контролируемый fallback или error | Не остаётся бесконечный spinner |
| Сервер вернул 500 | Ошибка либо прежний кеш по явной политике | 5xx случайно не записывается как полезный ответ |
Не применяйте одну стратегию ко всем запросам. HTML-навигация, versioned JS, изображения и операции записи имеют разные требования. POST не должен превращаться в кешированное чтение; персональный JSON требует ключа, учитывающего пользователя, либо вообще исключается из runtime cache.
Workbox настраивается на конкретный маршрут
import {registerRoute} from 'workbox-routing';
import {NetworkFirst} from 'workbox-strategies';
import {CacheableResponsePlugin} from 'workbox-cacheable-response';
registerRoute(
({request, url}) =>
request.mode === 'navigate' && url.origin === self.location.origin,
new NetworkFirst({
cacheName: 'pages-v3',
networkTimeoutSeconds: 3,
plugins: [new CacheableResponsePlugin({statuses: [200]})],
})
);Три секунды здесь — пример из page cache recipe Workbox, а не универсальный SLA. Измерьте свою аудиторию и вес страницы. Слишком короткий timeout часто покажет старый контент при нормальной мобильной сети; слишком длинный вернёт исходную проблему.
Кеш должен иметь правила свежести и очистки
Имя `pages-v3` помогает отделить схему кеша после релиза. Удаляйте старые версии в activate или используйте управляемый expiration plugin. Без ограничения runtime cache растёт, а пользователь может получать страницу, несовместимую с новыми assets.
- Кешируйте только ответы с ожидаемым статусом и origin.
- Не сохраняйте login redirect как страницу приложения.
- Показывайте признак офлайн- или устаревшего режима, если данные могут измениться.
- Версионируйте assets по содержимому и не смешивайте их с HTML runtime cache.
- Обрабатывайте ошибку стратегии в catch handler, если cache miss допустим.
Старый service worker может скрыть исправление
После деплоя откройте Application → Service Workers и убедитесь, что активна нужная версия. Новый worker может ждать закрытия старых вкладок. Кнопка Skip waiting полезна только при продуманном обновлении: принудительная активация способна смешать открытый UI и новый протокол кеша.
В Network панели пометьте, какой ответ пришёл from ServiceWorker, а в Cache Storage найдите точный request URL. Наличие похожего URL с другим query или trailing slash не является cache hit. Проверьте также `Vary` и то, не меняет ли роутер адрес после redirect.
Контрольная матрица на четырёх прогонах
Сначала загрузите страницу онлайн и подтвердите запись. Затем проверьте Fast network, Slow 3G, Offline и первый визит в чистом профиле Offline. Запишите time to first content и источник ответа. Исправление принято, если медленная сеть возвращает допустимый кеш за выбранный предел, а cache miss показывает понятный fallback вместо вечного ожидания.
Для разбора подготовьте service worker, правила registerRoute, список Cache Storage и HAR без cookies и токенов. Одного скриншота spinner недостаточно: нужен timing проблемного request и состояние кеша.