Разработка надёжных PWA-приложений: Manifest, Service Worker и оффлайн-режим
Агрессивный Cache-First для HTML в Service Worker заставляет пользователей неделями видеть старую версию сайта после релиза. Правильная политика кэша даёт скорость нативного приложения без сбоев.
Дмитрий К., Technical SEO Lead · SEO Space
Ориентиры корректной индексации
- Манифест
- Иконки 192px/512px maskable + scope
- Политика HTML
- Network-First с оффлайн-страницей
Почему неправильный Service Worker ломает обновления после деплоя
Если Service Worker отдаёт HTML-страницы из локального кэша раньше сетевого запроса, браузер открывает вчерашнюю разметку со ссылками на уже удалённые JS-чанки. Пользователь видит белый экран.
Комбинация Network-First для навигации и вечного кэширования хэшированных файлов статики решает проблему полностью.
- Для HTML-навигации всегда используйте Network-First с фолбэком на оффлайн-экран при потере сети.
- Заполните manifest.webmanifest: name, short_name, start_url, display: standalone и иконки 192/512.
- Регистрируйте Service Worker строго после события load, не замедляя первый рендер.
Безопасный обработчик навигации в Service Worker
Всегда пробуйте свежую сеть для HTML и возвращайте кэш только оффлайн.
self.addEventListener('fetch', (event) => {
if (event.request.mode === 'navigate') {
event.respondWith(
fetch(event.request).catch(() => caches.match('/offline/'))
);
}
}); Матрица кэширования по типам ресурсов
Разделяйте правила по частоте обновления файлов.
| Тип ресурса | Стратегия SW | Эффект |
|---|---|---|
| HTML-документы | Network-First + оффлайн-заглушка | Свежие цены и релизы при наличии сети |
| Хэшированные CSS/JS | Cache-First (immutable) | Мгновенная загрузка при повторных визитах |
| Приватные API-запросы | Network-Only | Исключение утечек чужих сессий в кэш |
Изоляция Service Worker от поискового обхода
Следите, чтобы кэш Service Worker не отдавал роботам устаревшие HTML-шаблоны и не перехватывал служебные маршруты вроде `/sitemap.xml` и `/robots.txt`.
Нужно проверить индексацию вашего проекта?
Пришлите домен: вручную проверим исходный HTML, логи обхода, дубли фильтров, canonical и карту сайта в течение 24 часов.