diff --git a/docs/operations/browser-file-storage-recovery.md b/docs/operations/browser-file-storage-recovery.md index 257f0c83..8a3191d2 100644 --- a/docs/operations/browser-file-storage-recovery.md +++ b/docs/operations/browser-file-storage-recovery.md @@ -534,9 +534,13 @@ Service Worker를 별도 선택한 조합에서만 추가. 워커의 fetch 가 - 이 경로가 동작하려면 `service-worker.js`를 `Cache-Control: no-cache`로 서빙해야 한다. `verify:hosting-headers`는 파일이 있는지만 보고 이 헤더는 보지 않는다 (`scripts/lib/hosting-probe.ts` `checkPublicServiceWorkers`). -- 새 워커는 install에서 `skipWaiting()`하지 않는다(`service-worker-entry.ts`). - 활성화는 페이지의 `requestActivation()`으로만 일어나므로, 새 worker 활성화를 - 멈추려고 따로 할 일은 없다. +- 새 워커는 install에서 `skipWaiting()`하지 않고 waiting에 머문다 + (`service-worker-entry.ts`). 활성화는 두 경로로 일어난다: 페이지의 + `requestActivation()`이 성공하거나, 그 scope의 탭이 모두 닫힌다(브라우저 기본 + 동작). 새로고침만으로는 활성화되지 않는다. 템플릿에는 `requestActivation()`을 + 부르는 화면이 없으므로 기본 경로는 뒤쪽이다. 따라서 결함 있는 워커가 waiting에 + 있으면 탭을 모두 닫았다 다시 연 사용자부터 그 워커를 쓴다. 기다리지 말고 다음 + release로 교체하거나 `REMOVE_REGISTRATION` release를 배포한다. - 제거는 `ACTIVE → REMOVE_REGISTRATION → PURGE_OWNED_RESOURCES → null` 순서로 release를 나눈다(`src/contracts/service-worker.ts` `InstalledServiceWorkerSelection`). 소유 캐시는 `PURGE_OWNED_RESOURCES` release의