Что такое…

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

Иллюстрация: консьерж между окном браузера и сетью — часть писем отдаёт из своей тумбочки

Вот сценарий, который однажды выносит мозг каждому: ты выкатил новую версию сайта, открыл — всё на месте. А человек пишет: «у меня по-старому». Он жмёт F5 — по-старому. Чистит кэш — иногда помогает, иногда нет.

Неожиданная часть: виноват может быть не кэш браузера, а твой собственный скрипт, который ты (или шаблон, из которого ты собрал сайт) поставил между страницей и интернетом. Он называется service worker, и он специально устроен так, чтобы не меняться на лету.

Что это такое в одной фразе

Service worker — это скрипт, который браузер держит отдельно от страницы и пропускает через него сетевые запросы сайта.

Представь консьержа в подъезде. Раньше почту приносили тебе напрямую с почты. Теперь всё идёт через него: он смотрит на конверт и решает — сбегать на почту или отдать копию из своей тумбочки. Быстро, работает даже когда почта закрыта. Но пока в тумбочке лежат старые газеты, ты будешь читать именно их.

Ключевое отличие от обычного JavaScript: обычный код живёт внутри вкладки и умирает вместе с ней. Service worker живёт рядом с сайтом, может проснуться без открытой вкладки и остаётся установленным после того, как ты закрыл браузер.

Что он умеет

  • Работать офлайн. Он держит копии файлов и отдаёт их, когда сети нет. Отсюда сайты, которые открываются в метро.
  • Ускорять загрузку. Отдать картинку из своей тумбочки быстрее, чем идти за ней в сеть.
  • Показывать пуш-уведомления. Их принимает именно он — вкладка для этого не нужна.
  • Досылать данные позже. Отправил форму без сети — он подержит и отправит, когда связь вернётся.

Именно эта связка превращает обычный сайт в «приложение»: иконка на экране, запуск без адресной строки, работа без сети.

Почему пользователь видит старую версию

А теперь самое важное — жизненный цикл. Он объясняет ту самую боль.

  1. Install. Браузер скачивает новый файл воркера и устанавливает его. Здесь он обычно складывает свежие файлы в кэш.
  2. Waiting. Дальше начинается неочевидное: новый воркер не заступает на смену сразу. Он ждёт.
  3. 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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →