Service Worker 등록과 수명 주기
Service Worker 스크립트를 등록하고, 설치·활성화·가져오기 수명 주기 이벤트를 이해하며, skipWaiting과 clients.claim을 사용합니다.
Service Worker 등록과 수명 주기은(는) CoddyKit의 무료 Frontend Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Frontend Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
서비스 워커란 무엇인가요
서비스 워커는 별도의 브라우저 워커(기본 스레드가 아님)에서 실행되며 출처에 대한 네트워크 요청을 가로채는 JavaScript 파일입니다. 오프라인 PWA, 푸시 알림, 백그라운드 동기화를 가능하게 하는 핵심 요소입니다.
서비스 워커 등록하기
기본 스크립트에서 등록하세요. 서비스 워커에는 HTTPS가 필요합니다(localhost는 예외).
if ('serviceWorker' in navigator) {
window.addEventListener('load', () => {
navigator.serviceWorker.register('/sw.js', { scope: '/' })
.then(reg => console.log('SW registered:', reg.scope))
.catch(err => console.error('SW registration failed:', err));
});
}scope
서비스 워커는 자신의 scope(제공되는 디렉터리) 안에 있는 요청을 제어합니다. 루트의 /sw.js는 모든 항목을 제어합니다. /app/sw.js에 있는 SW는 /app/*만 제어합니다.
수명 주기: 설치 → 활성화 → 가져오기
핵심 이벤트는 세 가지입니다. install(한 번만 실행되며 캐시 설정), activate(한 번만 실행되며 오래된 캐시 정리), fetch(모든 요청에서 캐시와 네트워크 중 선택)입니다.
// sw.js
self.addEventListener('install', (event) => {
console.log('SW installing');
event.waitUntil(
caches.open('v1').then(cache =>
cache.addAll(['/', '/index.html', '/styles.css', '/app.js'])
)
);
});
self.addEventListener('activate', (event) => {
console.log('SW active');
event.waitUntil(
caches.keys().then(keys =>
Promise.all(keys.filter(k => k !== 'v1').map(k => caches.delete(k)))
)
);
});
self.addEventListener('fetch', (event) => {
event.respondWith(
caches.match(event.request).then(res => res || fetch(event.request))
);
});skipWaiting()
기본적으로 업데이트된 SW는 모든 탭이 닫힐 때까지 활성화를 기다립니다. 설치 처리기에서 self.skipWaiting()을 호출하면 즉시 활성화되므로 업데이트는 빨라지지만 이전 자산과 새 자산이 섞일 위험이 있습니다.
self.addEventListener('install', (event) => {
self.skipWaiting(); // activate immediately on next reload
// ... cache setup
});clients.claim()
활성화된 후에도 새 SW는 자신보다 먼저 로드된 페이지를 제어하지 않습니다. 활성화 처리기에서 self.clients.claim()을 호출하면 즉시 제어를 시작합니다.
self.addEventListener('activate', (event) => {
event.waitUntil(self.clients.claim());
});서비스 워커 업데이트하기
브라우저는 탐색할 때마다 새 sw.js를 확인합니다(최대 수명 24시간). 파일 내용이 변경되면(바이트 단위로 다르면) 새 SW로 설치되고 활성화를 기다립니다. 활성화를 시작하려면 새로고침하세요.
앱에서 업데이트 감지하기
updatefound를 수신하여 업데이트 프롬프트를 표시하세요.
navigator.serviceWorker.register('/sw.js').then(reg => {
reg.addEventListener('updatefound', () => {
const newSW = reg.installing;
newSW.addEventListener('statechange', () => {
if (newSW.state === 'installed' && navigator.serviceWorker.controller) {
// New version ready
showUpdateBanner(() => {
newSW.postMessage('SKIP_WAITING');
window.location.reload();
});
}
});
});
});등록 해제하기
서비스 워커가 개발 중 잘못된 설정으로 계속 실행되는 경우 이를 중지하려면 등록을 해제하세요.
navigator.serviceWorker.getRegistrations().then(regs => {
for (const reg of regs) reg.unregister();
});브라우저 DevTools
Chrome DevTools → 애플리케이션 → 서비스 워커에서 등록된 SW를 확인하고, 등록을 해제하며, 새로고침 시 업데이트를 시뮬레이션하고, 수명 주기 이벤트를 단계별로 살펴볼 수 있습니다.
일반적인 함정
1) SW 파일은 루트 범위 또는 그보다 상위 범위에 있어야 합니다. 2) HTTPS가 필요합니다. 3) 개발 중 SW를 변경한 경우 강제 새로고침이 필요합니다. 4) 캐시는 한 번 저장하고 무한히 늘리지 말고 버전 관리로 업데이트하세요. 5) POST 요청은 캐시하지 마세요(지원되지 않습니다).
Workbox — 생산성 라이브러리
Google의 Workbox는 수명 주기를 추상화하고 바로 사용할 수 있는 캐싱 전략을 제공합니다. 대부분의 프로덕션 PWA는 직접 작성한 SW 코드보다 Workbox를 사용합니다.
빠른 확인
서비스 워커의 install 처리기 안에서 self.skipWaiting()은 어떤 작업을 하나요?
복습: 서비스 워커 수명 주기
출처에 대한 네트워크 요청을 가로채는 JavaScript 워커입니다. navigator.serviceWorker.register로 등록합니다. 수명 주기는 install(캐시 설정), activate(정리), fetch(요청 가로채기)로 구성됩니다. 즉시 업데이트하려면 skipWaiting과 clients.claim을 사용하세요. updatefound를 수신하여 사용자에게 업데이트를 제안하세요. Workbox가 반복적인 기본 코드를 추상화합니다. HTTPS가 필요합니다(localhost는 예외).
자주 묻는 질문
“Service Worker 등록과 수명 주기” 강의는 무료인가요?
네 — “Service Worker 등록과 수명 주기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Frontend Academy 강의 전체를 잠금 해제할 수 있습니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“Service Worker 등록과 수명 주기”에서 뭘 배우나요?
Service Worker 스크립트를 등록하고, 설치·활성화·가져오기 수명 주기 이벤트를 이해하며, skipWaiting과 clients.claim을 사용합니다. 브라우저에서 직접 실행하는 실습 코드로 Frontend Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Frontend Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Frontend Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“Service Worker 등록과 수명 주기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Frontend Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Frontend Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 웹 앱 매니페스트
- Service Worker 등록과 수명 주기
- 오프라인 캐싱 전략: CacheFirst와 NetworkFirst
- 푸시 알림