웹 백그라운드 동기화

5.1. 권한

참고: Background sync는 기본적으로 활성화되어야 한다(SHOULD). 권한이 거부되는 것은 예외적인 경우로 간주된다.

5.2. 위치 추적

5.3. 방문 기록 누출

6.1. ServiceWorkerRegistration 인터페이스에 대한 확장

partial interface ServiceWorkerRegistration {
  readonly attribute SyncManager sync;
};

sync 속성은 SyncManager를 노출하며, 이는 해당 속성이 노출되는 ServiceWorkerRegistration로 표현되는 연관된 service worker registration을 가진다.

6.2. SyncManager 인터페이스

[Exposed=(Window,Worker)]
interface SyncManager {
  Promise<undefined> register(DOMString tag);
  Promise<sequence<DOMString>> getTags();
};

register(tag) 메서드는 호출되면 새 promise promise를 반환하고 다음 단계를 병렬로 실행해야 한다(MUST):

1. serviceWorkerRegistration을 SyncManager의 연관된 service worker registration으로 둔다.
2. serviceWorkerRegistration의 active worker가 null이면, promise를 InvalidStateError로 reject하고 이 단계들을 abort한다.
3. 사용자가 background sync를 비활성화했으면, promise를 NotAllowedError로 reject하고 이 단계들을 abort한다.
4. isBackground를 true로 둔다.
5. serviceWorkerRegistration의 origin에 대한 service worker clients의 각 client에 대해:
   1. client의 frame type이 top-level 또는 auxiliary이면, isBackground를 false로 설정한다.
6. isBackground가 true이면, promise를 InvalidAccessError로 reject하고 이 단계들을 abort한다.
7. currentRegistration을, 존재한다면 serviceWorkerRegistration의 sync registrations 목록에서 tag가 tag와 같은 registration으로 두고, 그렇지 않으면 null로 둔다.
8. currentRegistration이 null이 아니면:
   1. currentRegistration의 registration state가 waiting이면, currentRegistration의 registration state를 pending으로 설정한다.
   2. currentRegistration의 registration state가 firing이면, currentRegistration의 registration state를 reregisteredWhileFiring으로 설정한다.
   3. promise를 Resolve한다.
   4. 사용자 에이전트가 현재 online이고 currentRegistration의 registration state가 pending이면, currentRegistration에 대해 sync 이벤트를 발생시킨다.
9. 그렇지 않으면:
   1. newRegistration을 새 sync registration으로 둔다.
   2. newRegistration의 연관된 tag를 tag로 설정한다.
   3. newRegistration의 연관된 service worker registration을 serviceWorkerRegistration로 설정한다.
   4. newRegistration을 serviceWorkerRegistration의 sync registrations 목록에 추가한다.
   5. promise를 Resolve한다.
   6. 사용자 에이전트가 현재 online이면, newRegistration에 대해 sync 이벤트를 발생시킨다.

getTags() 메서드는 호출되면 새 promise promise를 반환하고 다음 단계를 병렬로 실행해야 한다(MUST):

1. serviceWorkerRegistration을 SyncManager의 연관된 service worker registration으로 둔다.
2. currentTags를 새 sequence로 둔다.
3. serviceWorkerRegistration의 sync registrations 목록의 각 registration에 대해, registration의 연관된 tag를 currentTags에 추가한다.
4. promise를 currentTags로 Resolve한다.

6.3. sync 이벤트

partial interface ServiceWorkerGlobalScope {
  attribute EventHandler onsync;
};

[Exposed=ServiceWorker]
interface SyncEvent : ExtendableEvent {
  constructor(DOMString type, SyncEventInit init);
  readonly attribute DOMString tag;
  readonly attribute boolean lastChance;
};

dictionary SyncEventInit : ExtendableEventInit {
  required DOMString tag;
  boolean lastChance = false;
};

참고: SyncEvent 인터페이스는 firing sync registration을 나타낸다. 이벤트를 등록한 page(또는 worker)가 실행 중이면, 사용자 에이전트는 network connectivity가 사용 가능해지는 즉시 sync 이벤트를 발생시킨다. 그렇지 않으면, 사용자 에이전트는 가능한 가장 빠른 편리한 시점에 이벤트를 실행해야 한다. sync 이벤트가 실패하면, 사용자 에이전트는 자신이 선택한 시점에 이를 재시도하기로 결정할 수 있다. lastChance 속성은 사용자 에이전트가 현재 시도 이후 이 sync를 더 이상 시도하지 않을 경우 true이다.

self.addEventListener('sync', event => {
  if (event.tag == 'important-thing') {
    event.waitUntil(
      doImportantThing().catch(err => {
        if (event.lastChance) {
          self.registration.showNotification("Important thing failed");
        }
        throw err;
      })
    );
  }
});

사용자 에이전트가 online으로 변경될 때마다, 사용자 에이전트는 registration state가 pending인 각 sync registration에 대해 sync 이벤트를 발생시켜야 한다(SHOULD). 이벤트들은 어떤 순서로든 발생할 수 있다.

sync registration registration에 대해 sync 이벤트를 발생시키려면, 사용자 에이전트는 다음 단계를 실행해야 한다(MUST):

1. Assert: registration의 registration state는 pending이다.
2. serviceWorkerRegistration을 registration과 연관된 service worker registration으로 둔다.
3. Assert: registration은 serviceWorkerRegistration과 연관된 sync registrations 목록에 존재한다.
4. registration의 registration state를 firing으로 설정한다.

5. serviceWorkerRegistration에서 다음 속성을 사용하여 SyncEvent로 "sync" Fire Functional Event한다:

   ⚠MDN

   SyncEvent/tag

   현재 엔진 하나에만 있음.

   Firefox없음Safari없음Chrome49+

   ---

   Opera?Edge79+

   ---

   Edge (Legacy)없음IE없음

   ---

   Android용 Firefox없음iOS Safari없음Android용 Chrome49+Android WebView없음Samsung Internet5.0+Opera Mobile?

   tag

   registration과 연관된 tag

   ⚠MDN

   SyncEvent/lastChance

   현재 엔진 하나에만 있음.

   Firefox없음Safari없음Chrome49+

   ---

   Opera?Edge79+

   ---

   Edge (Legacy)없음IE없음

   ---

   Android용 Firefox없음iOS Safari없음Android용 Chrome49+Android WebView없음Samsung Internet5.0+Opera Mobile?

   lastChance

   사용자 에이전트가 이 sync 이벤트가 실패하면 재시도할 경우 false, 또는 현재 시도 이후 더 이상의 시도가 이루어지지 않을 경우 true.

   그런 다음 dispatchedEvent로 다음 단계를 실행한다:

   1. waitUntilPromise를 dispatchedEvent의 extended lifetime promises 모두에 대해 waiting for all한 결과로 둔다.
   2. waitUntilPromise의 fulfillment 시, 다음 단계를 원자적으로 수행한다:
      1. registration의 state가 reregisteredWhileFiring이면:
         1. registration의 state를 pending으로 설정한다.
         2. 사용자 에이전트가 현재 online이면, registration에 대해 sync 이벤트를 발생시킨다.
         3. 이 단계들의 나머지를 abort한다.
      2. Assert: registration의 registration state는 firing이다.
      3. registration을 serviceWorkerRegistration의 sync registration 목록에서 제거한다.
   3. waitUntilPromise의 rejection 시, 또는 service worker의 termination으로 인해 script가 abort된 경우, 다음 단계를 원자적으로 수행한다:
      1. registration의 state가 reregisteredWhileFiring이면:
         1. registration의 state를 pending으로 설정한다.
         2. 사용자 에이전트가 현재 online이면, registration에 대해 sync 이벤트를 발생시킨다.
         3. 이 단계들의 나머지를 abort한다.
      2. dispatchedEvent의 lastChance 속성이 false이면, registration의 registration state를 waiting으로 설정하고, 다음 단계를 병렬로 수행한다:
         1. 사용자 에이전트가 정의한 시간 동안 기다린다.
         2. registration의 registration state가 waiting이 아니면, 이 하위 단계를 abort한다.
         3. registration의 registration state를 pending으로 설정한다.
         4. 사용자 에이전트가 현재 online이면, registration에 대해 sync 이벤트를 발생시킨다.
      3. 그렇지 않으면 registration을 serviceWorkerRegistration의 sync registrations 목록에서 제거한다.

사용자 에이전트는 SyncEvent의 lifetime extension 및 execution time에 대해 일반적인 ExtendableEvent에 부과되는 제한보다 더 엄격한 시간 제한을 부과할 수 있다(MAY). 특히 lastChance가 true인 이벤트는 상당히 단축된 시간 제한을 가질 수 있다(MAY).

사용자 에이전트는 사용자 에이전트가 정의한 어떤 heuristics에 따라 sync 이벤트를 재시도한다.