From b28e290965ea1e3f19ea22085b5ae63fb9ccb372 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 1 Nov 2026 22:15:37 +0900 Subject: [PATCH] =?UTF-8?q?docs(operations):=20SW=20=ED=99=9C=EC=84=B1?= =?UTF-8?q?=ED=99=94=20=EC=A1=B0=EA=B1=B4=EC=97=90=20=ED=83=AD=EC=9D=84=20?= =?UTF-8?q?=EB=AA=A8=EB=91=90=20=EB=8B=AB=EB=8A=94=20=EA=B2=BD=EB=A1=9C?= =?UTF-8?q?=EB=A5=BC=20=EC=A0=81=EB=8A=94=EB=8B=A4=20(06-02)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 운영 문서(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절 --- docs/operations/browser-file-storage-recovery.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) 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의