{"canonical_url":"https://engineer.company/uk/glossary/service-worker/","content_markdown":"# Service worker\n\n## Що це таке\n\nService worker — це скрипт, який сайт реєструє в браузері і який браузер далі\nвиконує окремо від будь-якої сторінки; мережеві запити сторінок, якими він\nкерує, проходять через нього. Service workers — різновид web worker: кожен\nпрацює у власному потоці, без документа й без вікна. Браузер запускає його, коли\nє що обробити, і може зупинити, щойно роботи не лишилося, тож усе, що він тримає\nв змінній, до наступної події може зникнути.\n\nСторінка встановлює його одним викликом, і специфікація ставить до цього три\nумови. Сторінка мусить бути безпечним контекстом, що на практиці означає HTTPS,\nа для розробки дозволено `localhost` та адреси loopback. Скрипт мусить мати те\nсаме походження (origin), що й сторінка, тож лежати на CDN він не може, хоча\nімпортувати звідти код йому дозволено. І реєстрація охоплює певну область,\nscope: усталено це тека, у якій лежить скрипт, і нічого ширшого, хіба що сервер\nнадішле разом зі скриптом заголовок `Service-Worker-Allowed`.\n\n```js\n// на сторінці\nnavigator.serviceWorker.register(\"/sw.js\");\n\n// у /sw.js\nasync function answer(request) {\n    const copy = await caches.match(request);\n    return copy ?? fetch(request);\n}\n\nself.addEventListener(\"fetch\", (event) =\u003e {\n    event.respondWith(answer(event.request));\n});\n```\n\nТакий service worker відповідає на кожен запит власною копією, якщо вона в нього\nє, а якщо ні — даними з мережі. Покласти туди копії — завдання життєвого циклу.\nЩойно скрипт завантажено, браузер надсилає подію `install`, слушну мить, щоб\nзавантажити й зберегти все потрібне; якщо проміс, переданий у\n`event.waitUntil()`, буде відхилено, усе встановлення зазнає невдачі. Потім\nнастає `activate`, час прибрати те, що лишила старша версія, і лише після цього\nservice worker отримує події `fetch`. Сторінку прив'язують до її service worker\nпід час завантаження, тож сторінка, яка зареєструвала найперший, працює без\nнього, доки її не перезавантажать, хіба що він викличе `clients.claim()`.\n\nКопії зберігаються в Cache Storage, яке визначає та сама специфікація: це\nіменовані кеші з пар запитів і відповідей, які service worker сам наповнює,\nчитає й видаляє. Вони відокремлені від HTTP-кешу браузера. Запис не має терміну\nдії, сам ніколи не оновлюється й переживає оновлення скрипту, тож лишається,\nдоки його не видалить сам service worker або браузер не очистить сховище сайту.\n\n## Чому це важливо\n\nService workers дають сайту змогу явно керувати своєю роботою зовсім без мережі.\nService worker вирішує для кожного запиту окремо, у коді, який написав сам сайт,\nзвідки брати відповідь: із мережі, із власних копій чи з обох, і саме це робить\nвстановлений вебзастосунок придатним до роботи на кораблі чи в підвалі. До нього\nтакож доходять push-повідомлення, коли жодної сторінки сайту не відкрито.\n\nБільшість таких скриптів зводиться до вибору стратегії для кожного виду запитів,\nі Workbox, бібліотека для їх написання, називає п'ять. «Спершу кеш» відповідає з\nкопії й іде в мережу, лише коли копії немає, і пасує файлам, які ніколи не\nзмінюються під тією самою назвою. «Спершу мережа» питає мережу й повертається до\nкопії, коли мережа підводить, і пасує сторінкам. Stale-while-revalidate\nвідповідає з копії та оновлює її у фоні. «Лише мережа» і «лише кеш» — дві\nкрайності.\n\nВодночас це код, що стоїть між кожною сторінкою свого scope і мережею, на\nпристрої читача, і він переживає відвідування: помилка в ньому лишається, доки\nна зміну не прийде виправлений скрипт. Специфікацію збудовано навколо цього\nризику. Кожна навігація змушує браузер перевірити, чи є новий скрипт, а інші\nподії роблять це, коли від останньої перевірки минула доба. Усталено основний\nскрипт браузер звіряє із сервером, а не бере з HTTP-кешу, тож довгий `max-age`\nна файлі скрипту не втримає зламану версію; імпортовані скрипти перевіряють так само, коли минула доба, або завжди, коли `updateViaCache` має значення\n`none`. Браузер порівнює завантажений скрипт зі встановленим байт за байтом, і\nлише різниця запускає оновлення. Shift-reload оминає service worker для цієї\nоднієї навігації, і через це помилка на машині розробника може здаватися\nвиправленою.\n\nПравило очікування — друга половина цього задуму. Нова версія встановлюється\nпоруч зі старою і потім чекає, невикористана, доки жодна відкрита сторінка\nбільше не залежить від старої, тож дві версії ніколи не обслуговують одну\nсторінку на двох. Виклик `skipWaiting()` дає їй змогу перейняти керування\nвідразу, ціною того, що новий код працюватиме під сторінками, які завантажила\nстара.\n\nСховище — остання ціна. Cache Storage займає частину місця, яке сайт має на\nпристрої читача, а за Storage Standard це місце усталено працює в режимі\nbest-effort: браузер може очистити його, коли на пристрої бракує місця, якщо\nтільки сайт не попросив постійного сховища й не отримав його.\n\n## Як це виглядає на практиці\n\nПотреба в ньому найпомітніша там, де мережа найслабша.\n[Прогресивний вебзастосунок для моряків і польового персоналу](/uk/portfolio/delivered-full-progressive-web-app-support/)\nобслуговує людей, які часто офлайн або на поганому з'єднанні. Його service\nworker налаштовано через плагін next-pwa, а кешування Workbox під час виконання\nзастосовує «спершу кеш» до того, що не змінюється від запиту до запиту: шрифтів,\nзображень, аудіо, відео й ресурсів із CDN, поряд із заголовками HTTP\ncache-control. Оскільки service workers по-справжньому працюють лише через\nHTTPS, поведінку офлайн і встановлення перевіряли через HTTPS на справжніх\nпристроях, а повторні завантаження надходять із кешу, а не з мережі.\n\nЦей сайт робить протилежний вибір і прямо про це каже. [Сторінка про файли\ncookie](/uk/cookies/) повідомляє, що на сайті немає ні service worker, ні IndexedDB, ні\nCache Storage: ніщо із сайту не працює у фоні браузера до його відкриття чи після\nзакриття. Сторінки не постачають виконуваного JavaScript. Код пошуку збережено, але\nвимкнено, і він не реєструє worker.\n\n[Сторінка встановлення](/uk/install/) робить із цього висновок для всіх, хто\nдодає сайт на домашній екран: встановлення дає сайту власне вікно, але не\nстворює керованої офлайн-копії. Цей сайт не постачає service worker чи кероване\nскриптами сховище для роботи офлайн, тож встановленому застосунку потрібне\nз'єднання для звичайного використання.\n\nWorker реєструється з виконуваного скрипту, а поточна Content-Security-Policy цього\nсайту забороняє це через `script-src 'none'` на кожній сторінці. JSON-LD залишається\nневиконуваними даними. Колишній коментар у шаблоні head описував збірку, де 550 із 793\nдокументів мали `'none'`, а 243 — `'self'`, відповідно до сторінок, що тоді містили\nфільтр списку. Ці числа стосуються попередньої збірки зі скриптом, а не поточної\nполітики.\n\n## Де виникають проблеми\n\n**Після розгортання й далі працює стара версія.** Новий service worker\nвстановлюється й чекає, поки хоч одна відкрита вкладка ще користується старим,\nтож читач, який ніколи не закриває ту вкладку, і далі виконує старий код.\nВикликайте `skipWaiting()`, коли нова версія безпечна під сторінками, які\nзавантажила стара, або покажіть повідомлення про готове оновлення й нехай\nсторінка попросить service worker, що чекає, викликати цей метод.\n\n**Сторінки тижнями лишаються в старій версії.** Стратегія «спершу кеш»,\nзастосована до HTML, відповідає на кожну навігацію з Cache Storage, записи якого\nне мають терміну дії й не зважають на заголовки кешування від сервера. Лишайте\n«спершу кеш» для файлів, назви яких змінюються разом із вмістом, а для сторінок\nберіть «спершу мережа».\n\n**Встановлення зривається, і лишається старий service worker.** Одна адреса зі\nсписку кроку встановлення відповідає помилкою, тож `cache.addAll()` відхиляє\nсвій проміс, проміс, переданий у `waitUntil()`, відхиляється разом із ним, а\nнову версію відкидають. Складайте список із файлів, які справді існують, а\nнеобов'язкові файли завантажуйте пізніше, а не під час встановлення.\n\n**Service worker оминає більшу частину сайту.** Скрипт, що віддається з\n`/js/sw.js`, має `/js/` і як усталений, і як найширший scope, тож сторінки поза\nцією текою завантажуються без нього. Віддавайте скрипт із кореня сайту або\nнадсилайте разом із ним `Service-Worker-Allowed: /`.\n\n**Сховище на пристрої росте з кожним випуском.** Кеші переживають оновлення\nскрипту, тож кожна версія, яка відкриває кеш під новою назвою, лишає попередній.\nДодавайте версію до назви кожного кешу, а в обробнику `activate` видаляйте всі\nкеші, якими поточна версія не користується.\n\n## Що почитати далі\n\n- [Service Workers](https://www.w3.org/TR/service-workers/) — реєстрація, scope,\n  перевірка оновлень, життєвий цикл і Cache Storage.\n- [Secure Contexts](https://www.w3.org/TR/secure-contexts/) — які походження\n  вважаються потенційно надійними, зокрема `localhost` та адреси loopback.\n- [Fetch Standard](https://fetch.spec.whatwg.org/) — об'єкти `Request` і\n  `Response`, які обробник `fetch` отримує й повертає, і те, як запит\n  передається до service worker.\n- [Storage Standard](https://storage.spec.whatwg.org/) — сховища (storage\n  buckets), у яких живе Cache Storage, оцінки квоти та те, як сайт просить\n  постійного сховища.\n- [Workbox: workbox-strategies](https://developer.chrome.com/docs/workbox/modules/workbox-strategies)\n  — п'ять стратегій кешування і те, яким запитам пасує кожна.\n\n\u003chttps://engineer.company/uk/glossary/service-worker/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як service worker стає між сайтом і мережею, чому нова версія чекає, перш ніж перебрати керування, і де застарівають його кеші.","formats":{"gemtext":"https://engineer.company/uk/glossary/service-worker/index.gmi","gopher":"https://engineer.company/uk/glossary/service-worker/gophermap","html":"https://engineer.company/uk/glossary/service-worker/","json":"https://engineer.company/uk/glossary/service-worker/index.json","markdown":"https://engineer.company/uk/glossary/service-worker/index.md","pdf":"https://engineer.company/uk/glossary/service-worker/index.pdf"},"kind":"page","language":"uk","title":"Що таке service worker?","url":"https://engineer.company/uk/glossary/service-worker/","version":1}