docs(operations): SW 활성화 조건에 탭을 모두 닫는 경로를 적는다 (06-02)
문제: 운영 문서(browser-file-storage-recovery.md 8절)는 "활성화는 페이지의 requestActivation()으로만 일어나므로 새 worker 활성화를 멈추려고 따로 할 일은 없다"고 적는다. 브라우저는 scope의 탭이 모두 닫히면 waiting 워커를 스스로 활성화한다. 운영자가 이 문장을 믿고 결함 있는 waiting 워커를 두면, 탭을 닫았다 연 사용자부터 그 워커를 쓰고 대응(REMOVE_REGISTRATION)이 늦어진다. RED(문서-코드 대조): install은 skipWaiting()을 부르지 않는다 (service-worker-entry.ts). requestActivation()은 src에서 정의 (service-worker-page-controller.ts, contracts/service-worker.ts)만 있고 부르는 곳이 없다. 저장소 e2e 주석(service-worker-update.spec.ts)과 리뷰 실험 8(chromium·webkit)은 탭을 모두 닫으면 B가 활성화되고 reload만으로는 waiting에 남는 것을 보였다. 같은 저장소의 release-cache-rollback.md는 이미 "every tab of the scope closes or a page calls requestActivation()"으로 맞게 적는다. 고른 방법: 문장을 두 활성화 경로(requestActivation 성공, scope의 탭이 모두 닫힘)와 reload만으로는 활성화되지 않는다는 점, 템플릿의 기본 경로, 결함 있는 waiting 워커에 대한 조치(다음 release로 교체 또는 REMOVE_REGISTRATION)로 고친다. 코드는 바꾸지 않는다. 버린 대안: 없음. 리뷰가 문서 정정 하나만 제시했다. 위험·한계: 이번에 브라우저 실험을 다시 하지 않았다. 근거는 표준 SW 수명주기, 저장소 e2e 주석, 리뷰 실험 8이다. firefox는 Playwright에서 페이지가 제어되지 않아 확인 범위 밖이다. 검증: - `node scripts/verify-documentation-readiness.ts` -> PASS_SCOPED. - `grep -rln requestActivation src tests` -> src는 정의 2파일뿐. Refs: docs/reviews/2026-11-01-maturity-review/06-adapters-service-worker-push.md 06-02, 7.2절
This commit is contained in:
@@ -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의
|
||||
|
||||
Reference in New Issue
Block a user