Разработка сайтов и приложений Технический аудит Обновлено 2026-11-16 3 мин PWA · Service Workers · Web App Manifest

Разработка надёжных 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 часов.