Webの定期的なバックグラウンド同期

7.1. 定期同期登録の処理

1. 次の処理を繰り返します:

   1. minimum periodic sync interval across origins を待ちます。

   2. firedPeriodicSync を false にします。

   3. firedPeriodicSync が false の間:

      1. ユーザーエージェントが定義する一定時間を待ちます。

         注: これは異なる periodic sync registrations の同期を単一のデバイス起動にまとめるために使えます。

      2. online になるまで待ちます。

      3. 未だunregisteredでない各service worker registration registrationについて、 以下の手順をキューに追加し、registrationのperiodic sync 処理キューに追加する:

         1. origin を origin とします。これは periodicSyncRegistration の service worker registration に関連付けられています。

         2. time of last fire[origin] + effective minimum sync interval for origin(origin) が現在時刻より大きい場合、continue します。

         3. registration の active periodic sync registrations にある各 periodic sync registration periodicSyncRegistration について:

            1. state が "pending" でない場合、continue します。

            2. periodicSyncRegistration の anchor time + periodicSyncRegistration の minimum interval が現在時刻より大きい場合、continue します。

            3. firedPeriodicSync を true に設定します。

            4. periodicsync event を発火 します（対象: periodicSyncRegistration）。

7.2. 権限取り消しへの対応

name "periodic-background-sync" の権限が origin origin に対して取り消された場合、ユーザーエージェントは次の手順を periodic sync processing queue にエンキューしなければなりません:

1. active periodic sync registrations に含まれる各 periodic sync registration registration について、その service worker registration が origin と同じ origin に関連付けられているものを対象とします:

   1. active periodic sync registrations から registration を削除します。

メソッド register(tag, options) が呼び出されたとき、必ず新しい Promise promise を返し、次の手順を periodic sync processing queue にエンキューします:

1. serviceWorkerRegistration を、コンテキストオブジェクトに関連付けられた service worker registration とします。

2. serviceWorkerRegistration の active worker が null の場合、reject して promise を InvalidStateError で拒否し、手順を中止します。

3. PermissionState が PermissionDescriptor の name "periodic-background-sync" に対して granted でない場合、reject して promise を NotAllowedError で拒否し、手順を中止します。

4. ブール値 isBackground を true にします。

5. serviceWorkerRegistration の service worker clients の各 client について:

   1. client の frame type が "top-level" または "auxiliary" の場合、isBackground を false に設定します。

6. isBackground が true の場合、reject して promise を InvalidAccessError で拒否し、手順を中止します。

7. currentRegistration を、serviceWorkerRegistration の active periodic sync registrations にある、periodic sync registration の中で tag が tag と等しいものがあればそれに設定し、なければ null とします。

8. currentRegistration が null の場合:

   1. 新しい periodic sync registration を newRegistration として作成します。

   2. newRegistration の tag を tag に設定します。

   3. newRegistration の minimum interval を options の minInterval メンバに設定します。

   4. newRegistration の state を "pending" に設定します。

   5. newRegistration の service worker registration を serviceWorkerRegistration に設定します。

   6. newRegistration の anchor time を現在時刻を表すタイムスタンプに設定します。

   7. newRegistration を serviceWorkerRegistration の active periodic sync registrations に追加します。

   8. Resolve して promise を完了させます。

9. そうでない場合（既存の登録がある場合）:

   1. currentRegistration の minimum interval が options の minInterval と異なる場合:

      1. currentRegistration の minimum interval を options の minInterval に設定します。

   2. それ以外で、もし currentRegistration の state が "firing" の場合、serviceWorkerRegistration の state を "reregistered-while-firing" に設定します。

   3. Resolve して promise を完了させます。

メソッド getTags() が呼び出されたとき、必ず新しい Promise promise を返し、次の手順を periodic sync processing queue にエンキューします:

1. serviceWorkerRegistration を、コンテキストオブジェクトに関連付けられた service worker registration とします。

2. currentTags を新しい list とします。

3. serviceWorkerRegistration の active periodic sync registrations の各 registration について、append を使って registration の tag を currentTags に追加します。

4. Resolve して promise を currentTags で完了させます。

メソッド unregister(tag) が呼び出されたとき、必ず新しい Promise promise を返し、次の手順を periodic sync processing queue にエンキューします:

1. serviceWorkerRegistration を、サービスワーカー登録であり、コンテキストオブジェクトの PeriodicSyncManager に関連付けられているものとする。

   1. currentRegistration を、serviceWorkerRegistration の 有効な periodic sync 登録の中から、その tag が tag と等しい periodic sync 登録（存在しない場合は null）とする。

   2. もし currentRegistration が null でなければ、currentRegistration を serviceWorkerRegistration の 有効な periodic sync 登録 から削除する。

   3. promise を解決する。

1. serviceWorkerRegistration を registration の service worker registration とします。

2. もし registration が serviceWorkerRegistration の 有効な periodic sync registration に含まれていなければ、これらの手順を中止します。

3. Assert: registration の state は "pending" です。

4. retryCount を 0 にします。

5. registration の state を "firing" に設定します。

6. 次の間、繰り返します:

   1. continue を false にします。

   2. success を false にします。

   3. ファンクショナルイベント "periodicsync" を PeriodicSyncEvent を用いて serviceWorkerRegistration 上で、tag に registration の tag を設定して発火します。dispatchedEvent（ExtendableEvent）を発火した periodicsync イベント とし、dispatchedEvent で以下の手順を実行します:

   4. waitUntilPromise を、すべてを待機 した dispatchedEvent の ライフタイム延長プロミス の結果とします。

   5. waitUntilPromise の 成功時 には以下を実行:

      1. success を true にします。

      2. continue を true にします。

   6. waitUntilPromise の 失敗時 には以下を実行:

      1. continue を true にします。

   7. 並列で:

      1. continue が true になるまで待機します。

      2. origin を registration の origin とします。

      3. もし success が true ならば、キー origin に対する 前回発火時刻 を現在時刻に更新します。

      4. success が true、または retryCount が 最大リトライ回数 を超えた場合、または registration の state が "reregistered-while-firing" なら、以下を実行します:

         1. registration の state を "pending" に設定します。

         2. registration の アンカータイム を現在時刻のタイムスタンプに設定します。

         3. これらの手順を中止します。

   8. retryCount をインクリメントします。

   9. retryCount に基づいた短いバックオフ時間待機します。