Что такое service worker — и почему после деплоя люди видят старую версию

Вот сценарий, который однажды выносит мозг каждому: ты выкатил новую версию сайта, открыл — всё на месте. А человек пишет: «у меня по-старому». Он жмёт F5 — по-старому. Чистит кэш — иногда помогает, иногда нет.
Неожиданная часть: виноват может быть не кэш браузера, а твой собственный скрипт, который ты (или шаблон, из которого ты собрал сайт) поставил между страницей и интернетом. Он называется service worker, и он специально устроен так, чтобы не меняться на лету.
Что это такое в одной фразе
Service worker — это скрипт, который браузер держит отдельно от страницы и пропускает через него сетевые запросы сайта.
Представь консьержа в подъезде. Раньше почту приносили тебе напрямую с почты. Теперь всё идёт через него: он смотрит на конверт и решает — сбегать на почту или отдать копию из своей тумбочки. Быстро, работает даже когда почта закрыта. Но пока в тумбочке лежат старые газеты, ты будешь читать именно их.
Ключевое отличие от обычного JavaScript: обычный код живёт внутри вкладки и умирает вместе с ней. Service worker живёт рядом с сайтом, может проснуться без открытой вкладки и остаётся установленным после того, как ты закрыл браузер.
Что он умеет
- Работать офлайн. Он держит копии файлов и отдаёт их, когда сети нет. Отсюда сайты, которые открываются в метро.
- Ускорять загрузку. Отдать картинку из своей тумбочки быстрее, чем идти за ней в сеть.
- Показывать пуш-уведомления. Их принимает именно он — вкладка для этого не нужна.
- Досылать данные позже. Отправил форму без сети — он подержит и отправит, когда связь вернётся.
Именно эта связка превращает обычный сайт в «приложение»: иконка на экране, запуск без адресной строки, работа без сети.
Почему пользователь видит старую версию
А теперь самое важное — жизненный цикл. Он объясняет ту самую боль.
- Install. Браузер скачивает новый файл воркера и устанавливает его. Здесь он обычно складывает свежие файлы в кэш.
- Waiting. Дальше начинается неочевидное: новый воркер не заступает на смену сразу. Он ждёт.
- Activate. Он получает управление только когда закрыты все вкладки, которыми управлял старый.
И вот тут ловушка: обычная перезагрузка страницы (F5) не считается. При обновлении вкладка не исчезает — старая страница ещё жива, пока грузится новая, так что старый воркер не отпускает контроль. Человек может жать F5 хоть двадцать раз и видеть то же самое. Помогает буквально закрыть все вкладки с сайтом и открыть заново.
Сделано так намеренно: две версии воркера не должны работать одновременно, иначе кэши и логика начнут конфликтовать. Если тебе нужно обновление сразу, у воркера есть команда skipWaiting() — «заступай на смену, не жди», плюс clients.claim(), чтобы забрать уже открытые вкладки. Это одна строка, которую в шаблонах часто забывают.
Поэтому «у меня всё обновилось, а у людей нет» — это не мистика и не проблема деплоя. Скорее всего, у них просто не закрывалась вкладка.
Где он живёт и что ему нужно
Три вещи, которые полезно знать заранее:
- Только HTTPS. Скрипт, который перехватывает все запросы сайта, — слишком мощная штука, чтобы отдавать её по незащищённому соединению. Исключение — localhost: его браузер считает безопасным, чтобы можно было разрабатывать локально.
- Область действия зависит от места файла. Воркер, лежащий в корне, управляет всем сайтом; лежащий в
/blog/— только этой папкой. Поэтому его почти всегда кладут в корень. - Смотреть — в DevTools. Вкладка Application → Service Workers: там видно, какой установлен, кто в waiting, и есть кнопки Update on reload и Unregister. Это первое место, куда идти с жалобой «у меня старая версия».
Чем service worker отличается от обычного кэша браузера?
Обычный кэш — правила браузера, которыми управляет сервер через заголовки. Service worker — твой код: ты сам решаешь, что отдавать из копии, что тянуть из сети и что показать, когда сети нет вовсе. Больше власти — и больше способов выстрелить себе в ногу.
Нужен ли service worker моему сайту?
Обычному сайту-визитке — нет, только лишний источник странных багов. Он окупается, когда нужно одно из трёх: работа без сети, пуш-уведомления или запуск с иконки как приложение. Нет ни одного пункта — не ставь.
Как убрать его, если он уже мешает?
В DevTools → Application → Service Workers нажми Unregister и почисти Cache Storage — это чинит твою машину. Чтобы починить у пользователей, выкатывают новый воркер, который в activate удаляет старые кэши, а не просто удаляют файл с сервера: удалённый файл не отменяет уже установленный воркер.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





