バックグラウンドフェッチ

1. swRegistration を bgFetch のサービスワーカー登録とします。

2. settledFetches を 0 とします。

3. immediateFailure を false とします。

4. failureReason を空文字列とします。

5. bgFetch のレコード内の各 record についてそれぞれ、次の手順を並列に実行します。

   1. bgFetch と record についてレコードを 完了する。

   2. result を record のレスポンスデータの結果とします。

   3. failureReason が空文字列でない場合:

      1. 表明: result は "redundant" ではない。

      2. failureReason を result に設定します。

   4. settledFetches を 1 増加させます。

   5. result が "download-total-exceeded" の場合、 immediateFailure を true に設定します。

6. settledFetches が bgFetch のレコードのサイズになるか、immediateFailure が true になるまで待機します。

7. immediateFailure が true の場合、bgFetch のすべて 中止フラグを設定します。

   注: レコードを完了するアルゴリズムはこのフラグを監視し、設定されたときにフェッチを終了します。

8. 次の手順を swRegistration のアクティブな バックグラウンドフェッチ編集キューにエンキューします。

   1. activeBgFetches を swRegistration のアクティブなバックグラウンド フェッチとします。

   2. id を bgFetch のid とします。

   3. activeBgFetches が bgFetch というバックグラウンドフェッチを含む場合、 activeBgFetches[id] を削除します。

   4. それ以外の場合、failureReason を "aborted" に設定します。

      注: これは、abort() が正常に呼び出されたのと同時にフェッチの 1 つが失敗する競合状態を処理します。abort() から true を返した場合、これにより関連する abort イベントが確実に発火されます。

   5. failureReason が空文字列でない場合:

      1. bgFetch の結果を "failure" に設定します。

      2. bgFetch の失敗理由を failureReason に設定します。

   6. それ以外の場合、bgFetch の結果を "success" に設定します。

   7. bgFetch についてバックグラウンドフェッチインスタンスを更新する。

   8. eventName を空文字列とします。

   9. eventConstructor を null とします。

   10. failureReason が "aborted" の場合:

       1. eventName を "backgroundfetchabort" に設定します。

       2. eventConstructor を BackgroundFetchEvent に設定します。

   11. それ以外で、failureReason が空文字列でない場合:

       1. eventName を "backgroundfetchfail" に設定します。

       2. eventConstructor を BackgroundFetchUpdateUIEvent に設定します。

   12. それ以外の場合:

       1. eventName を "backgroundfetchsuccess" に設定します。

       2. eventConstructor を BackgroundFetchUpdateUIEvent に設定します。

   13. swRegistration 上で eventConstructor を使用して eventName という名前の機能イベントを発火する。次のプロパティを指定します。

       registration

       イベントオブジェクトの関連するレルム内で bgFetch についてBackgroundFetchRegistration インスタンスを取得することの結果。

       次に、dispatchedEvent を用いて次の手順を並列に実行します。

       1. dispatchedEvent がアクティブでなくなるまで待機します。

          ServiceWorker/1348。

       2. bgFetch のレコード利用可能 フラグを未設定にします。

       3. bgFetch についてバックグラウンドフェッチ インスタンスを更新する。

1. responseData を record のレスポンスデータとします。

2. downloadTotal を、bgFetch のダウンロード総量が 0 でなければその値、そうでなければ 無限大とします。

3. bgFetch の一時停止フラグが未設定になるまで待機します。

4. request を record のリクエストのコピーとします。

   注: この時点では、リクエストがストリームとして開始された場合でも、リクエスト全体が ストレージに保持されています。

5. request のkeepalive フラグを設定します。

6. request のサービスワーカーモードを "none" に設定します。

7. rangeStart を responseData のバイトの長さとします。

8. rangeStart が 0 でない場合、rangeStart を指定して request にrange ヘッダーを追加します。

   注: rangeStart が 0 の場合、通常のリクエストが行われます。 これにより、range ヘッダーを持つリクエストには Accept-Encoding: identity が追加されるため、 最初のリクエストでコンテンツエンコーディングを利用できます。

9. fetchAttemptComplete を false とします。

10. lastTransmittedSize を 0 とします。

11. request をフェッチします。

    この手順の残りでは、 現在タスクをキューに入れる fetch の「コールバック」を使用します。これはここでは望ましくなく、実行もできないため、 タスクがキューに入れられないものと仮定します。（課題）

    request のリクエストボディを処理するには、次の手順を実行します。

    1. transmittedSize を request のボディの送信済み バイトとします。

    2. bgFetch のアップロード済みを、transmittedSize から lastTransmittedSize を引いた値だけ増加させます。

    3. lastTransmittedSize を transmittedSize に設定します。

    4. bgFetch についてバックグラウンドフェッチ インスタンスを更新する。

    response のレスポンスを処理するには、次の手順を実行します。

    1. response がネットワークエラーの場合:

       1. リソースが一時的に利用不可であり、 request のメソッドが `GET` の場合、 リソースが一時的に利用不可でなくなるまで待機し、 fetchAttemptComplete を true に設定してこれらの手順を中止します。

          注: request のメソッドが `GET` でない場合、 リクエストを再発行すると望ましくない副作用が生じる可能性があります。リクエストを再開する標準的な方法が 利用可能になれば、ここでも採用されます。

       2. response が中止されたネットワークエラーの場合、 responseData の結果を "aborted" に設定し、それ以外の場合は "fetch-error" に設定します。

       3. fetchAttemptComplete を true に設定し、これらの手順を中止します。

    2. response のステータスが 206 の場合:

       1. rangeStart、response、および responseData のレスポンスについて部分レスポンスを検証する結果が 無効を返す場合:

          1. responseData の結果を "fetch-error" に設定します。

          2. fetchAttemptComplete を true に設定します。

          3. 進行中のフェッチを終了し、これらの手順を中止します。

    3. それ以外の場合:

       1. responseData の結果を "redundant" に設定します。

       2. responseData を新しいバックグラウンドフェッチレスポンスに設定します。

       3. record のレスポンスデータを responseData に設定します。

          注: レコード オブジェクトを作成するアルゴリズムは、以前のバックグラウンドフェッチレスポンスへの参照を保持する場合があります。

       4. bgFetch についてバックグラウンドフェッチ インスタンスを更新する。

    4. rangeStart が 0、または response のステータスが 206 でない場合、 responseData のレスポンスを、 response のボディを除いたコピーに設定します。

    5. stream を response のボディのストリームとします。

    6. 1 バイト以上が stream から送信されるたびに、bytes を送信されたバイトとして次の手順を実行します。

       1. bgFetch の保存済みボディバイト 総量に bytes のサイズを加えた値が downloadTotal より大きい場合:

          1. stream をキャンセルします。

          2. responseData の結果を "download-total-exceeded" に、fetchAttemptComplete を true に設定し、これらの手順を中止します。

       2. bytes を responseData のバイトに追加します。

       3. 前の手順がクォータ制限の超過により失敗した場合、responseData の結果を "quota-exceeded" に、fetchAttemptComplete を true に設定し、 これらの手順を中止します。

       4. bgFetch についてバックグラウンドフェッチ インスタンスを更新する。

    7. いずれかの時点で stream のバイト送信が正常に完了した場合:

       1. response のステータスが 206 の場合:

          1. firstBytePos、lastBytePos、および completeLength を、response からcontent-range 値を抽出することの結果とします。

          2. completeLength が null でなく、かつ responseData のバイトの長さと等しい場合、 responseData の結果を "success" に設定します。

             注: リソース全体、またはリソースの残りを要求しても、 サーバーが残りを返さない場合があります。その場合は追加のリクエストを行う必要があります。

       2. それ以外で、response のステータスがok ステータスでない場合、responseData の結果を "bad-status" に設定します。

       3. それ以外の場合、responseData の結果を "success" に設定します。

       4. fetchAttemptComplete を true に設定します。

    8. いずれかの時点で stream がエラー状態になった場合:

       1. リソースが一時的に利用不可であり、 request のメソッドが `GET` の場合、 リソースが一時的に利用不可でなくなるまで待機し、 fetchAttemptComplete を true に設定します。

       2. それ以外の場合、responseData の結果を "fetch-error" に、fetchAttemptComplete を true に設定します。

12. result を空文字列とします。

13. 次の手順を実行しますが、bgFetch の一時停止 フラグまたはすべて中止フラグが設定された場合は中止します。

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

    2. result を responseData の結果に設定します。

14. 中止された場合:

    1. bgFetch の一時停止フラグが設定されている場合、 request のメソッドが `GET` であることを表明します。

    2. bgFetch のすべて中止フラグが設定されている場合、 responseData の結果を "aborted" に設定します。

    3. result を responseData の結果に設定します。

       注: フェッチを終了すると結果が変わる可能性があるため、ここで結果を保存します。

    4. 進行中のフェッチを終了します。

15. result が空文字列の場合、bgFetch と record についてレコードを完了する。

1. downloaded を bgFetch の保存済みボディバイト総量とします。

2. uploaded を bgFetch のアップロード済みとします。

3. result を bgFetch の結果とします。

4. failureReason を bgFetch の失敗理由とします。

5. bgFetch のレコード利用可能フラグが設定されている場合は recordsAvailable を true、それ以外の場合は false とします。

6. 環境設定オブジェクト env のうち、そのオリジンが bgFetch のサービスワーカー登録の スコープ URLのオリジンと等しいものそれぞれについて、env の担当イベントループ上でbgfetch タスクをキューに入れ、 次の手順を実行します。

   1. bgFetchRegistration を、バックグラウンドフェッチが bgFetch と等しい、関連するレルム内の BackgroundFetchRegistration インスタンスとし、存在しない場合は null とします。

      注: BackgroundFetchRegistration インスタンスを取得するアルゴリズムにより、環境ごとに最大 1 つしか存在しません。

   2. bgFetchRegistration が null の場合、これらの手順を中止します。

   3. recordsAvailable が false であり、bgFetchRegistration のレコード利用可能 フラグが設定されている場合、bgFetchRegistration のレコード利用可能 フラグを未設定にします。

   4. bgFetchRegistration の結果が空文字列でない場合、 これらの手順を中止します。

      注: これにより、バックグラウンドフェッチが確定した後に進行状況が報告されることを防ぎます。 操作が中止されたものの、一部のフェッチがまだ終了していない場合には、この状況が発生する可能性があります。

   5. 次のすべてが true の場合:

      • bgFetchRegistration のダウンロード済みが downloaded と等しい。

      • bgFetchRegistration のアップロード済みが uploaded と等しい。

      • bgFetchRegistration の結果が result と等しい。

      • bgFetchRegistration の失敗理由 が failureReason と等しい。

      その場合、これらの手順を中止します。

   6. bgFetchRegistration のダウンロード済みを downloaded に設定します。

   7. bgFetchRegistration のアップロード済みを uploaded に設定します。

   8. bgFetchRegistration の結果を result に設定します。

   9. bgFetchRegistration の失敗理由を failureReason に設定します。

   10. bgFetchRegistration に "progress" という名前のイベントを発火します。

   mouse move イベントがデバウンスされるのと同様に、これもデバウンスする必要があります。

registration

イベントオブジェクトの関連するレルム内で bgFetch についてBackgroundFetchRegistration インスタンスを取得することの結果。

1. instancesMap を、この realm 内にある唯一の BackgroundFetchManager インスタンスのBackgroundFetchRegistration インスタンスとします。

2. instancesMap[bgFetch] が存在する場合、 instancesMap[bgFetch] を返します。

3. instance を realm 内の新しい BackgroundFetchRegistration とし、そのバックグラウンドフェッチを bgFetch に設定します。

4. instancesMap[bgFetch] を instance に設定します。

5. instance を返します。

1. 表明: partialResponse のステータスは 206 である。

2. responseFirstBytePos、responseLastBytePos、および responseCompleteLength を、partialResponse からcontent-range 値を抽出することの結果とします。これが失敗した場合は、無効を返します。

3. responseFirstBytePos が expectedRangeStart と等しくない場合、 無効を返します。

4. previousResponse が null でない場合:

   1. « `ETag`, `Last-Modified` » の各 headerName について:

      1. previousResponse のヘッダーリストが headerName を含み、かつ previousResponse のヘッダーリスト内の headerName の結合された値が、 partialResponse のヘッダーリスト内の headerName の結合された値と等しくない場合、 無効を返します。

   2. previousResponse のステータスが 206 の場合:

      1. previousResponseFirstBytePos、 previousResponseLastBytePos、および previousResponseCompleteLength を、previousResponse からcontent-range 値を抽出することの結果とします。これが失敗した場合は、無効を返します。

      2. previousResponseCompleteLength が null でなく、 responseCompleteLength が previousResponseCompleteLength と等しくない場合、無効を返します。

5. 有効を返します。

1. response のヘッダーリストが `Content-Range` を含まない場合、失敗を返します。

2. contentRangeValue を、response のヘッダーリスト内で、その名前が `Content-Range` とバイト単位で大文字小文字を区別せず一致する最初のヘッダー の値とします。

3. contentRangeValue を単一バイト content-rangeに従って解析することに失敗した場合、失敗を返します。

4. firstBytePos を、contentRangeValue を単一バイト content-rangeとして解析したときに first-byte-pos と名付けられた部分を整数として解析したものとします。

5. lastBytePos を、contentRangeValue を単一バイト content-rangeとして解析したときに last-byte-pos と名付けられた部分を整数として解析したものとします。

6. completeLength を、contentRangeValue を単一バイト content-rangeとして解析したときに complete-length と名付けられた部分とします。

7. completeLength が "*" の場合、completeLength を null に設定し、 それ以外の場合は completeLength を整数として解析した値に設定します。

8. firstBytePos、lastBytePos、および completeLength を返します。

整数としての解析 infra/189。

すべてのプラットフォームオブジェクトは realm 内に作成しなければなりません。

1. recordObjects を新しいリストとします。

2. records の各 record についてそれぞれ:

   1. responseData を record のレスポンスデータとします。

   2. recordObject を新しい BackgroundFetchRecord とします。

   3. recordObject の responseReady を新しい promise に設定します。

   4. requestObject を、次を設定した新しい Request オブジェクトとします。

      リクエスト

      record のリクエストのコピー。ボディも含みます。

      ヘッダー

      この Request の リクエストのヘッダーリストに関連付けられた新しい Headers オブジェクト。

   5. recordObject の request を requestObject に設定します。

   6. transmittedBytes を 0 とします。

   7. stream を、新しい promise promise を返し、次の手順を並列に実行する pull アクションを持つ新しい読み取り可能ストリームとします。

      1. responseData のバイトの長さが transmittedBytes より大きくなるか、responseData の結果が空文字列でなくなるまで待機します。

      2. bytes を null とします。

      3. responseData のバイトの長さが transmittedBytes より大きく、かつ responseData を公開できる場合:

         1. bytes を、transmittedBytes のオフセットから始まる、 responseData のバイトの ユーザーエージェントが決定したスライスに設定します。

            注: これにより、ユーザーエージェントは適切な速度で ストレージからリソースをストリーミングできます。

         2. transmittedBytes を bytes の長さだけ増加させます。

      4. stream の関連する設定オブジェクトの担当イベントループ内で、ネットワークタスクソースを使用してタスクをキューに入れ、次の手順を実行します。

         1. bytes が null でない場合:

            1. array を、bytes の新しい ArrayBuffer をラップする新しい Uint8Array とします。

            2. array を stream にエンキューします。

         2. responseData を公開でき、 responseData の結果が空文字列ではなく、 かつ transmittedBytes が responseData のバイトの長さである場合、 stream を閉じます。

         3. それ以外で、responseData の結果が "aborted" の場合、stream を AbortError DOMException でエラー状態にします。

         4. それ以外で、responseData を公開できない場合、 stream を TypeError でエラー状態にします。

         5. promise を解決します。

   8. 次の手順を並列に実行します。

      1. responseData のレスポンスが null でなくなるまで待機します。

      2. responseData を公開できる場合:

         1. response を responseData のレスポンスのコピーとします。

         2. response のヘッダーリストから `Content-Range` を削除します。

         3. response のヘッダーリストから `Content-Length` を削除します。

         4. body を、ストリームが stream に設定された新しいボディとします。

         5. response のボディを body に設定します。

         6. recordObject の関連する設定 オブジェクトの担当イベントループ内で、ネットワークタスクソースを使用してタスクをキューに入れ、次の手順を実行します。

            1. responseObject を、次を設定した新しい Response オブジェクトとします。

               レスポンス

               response。

               ヘッダー

               この Response のレスポンスの ヘッダー リストに関連付けられた新しい Headers オブジェクト。

            2. recordObject の responseReady を responseObject で解決します。

      3. それ以外で、responseData の結果が "aborted" の場合、recordObject の responseReady を AbortError DOMException で拒否します。

      4. それ以外の場合、recordObject の responseReady を TypeError で拒否します。

   9. recordObject を recordObjects に追加します。

3. recordObjects を返します。

1. id を bgFetch のid とします。

2. map[id] が存在しない場合、 false を返します。

3. map[id] が bgFetch と等しくない場合、false を返します。

4. true を返します。

1. map が bgFetch というバックグラウンドフェッチを含む場合、 false を返します。

2. true を返します。

バックグラウンド フェッチクリック拡張コマンドは、ユーザーがバックグラウンドフェッチの表示をアクティブ化する動作をシミュレートします。リモートエンド手順は次のとおりです。

1. 現在のトップレベル閲覧コンテキスト がすでに開かれていない場合、WebDriver エラーコード no such window を持つWebDriver エラーを返します。

2. pageURL を、現在のトップレベル閲覧 コンテキストのアクティブな文書のURL とします。

3. swRegistration を pageURL に対する一致するサービスワーカー登録とします。

4. swRegistration が null の場合、ステータス 400 および JSON エラーコード "invalid service worker state" を持つWebDriver エラーを返します。

5. bgFetch を、URL 変数 id と同じid、および swRegistration と同じサービスワーカー登録 を持つ最新のバックグラウンドフェッチとし、存在しない場合は null とします。

6. bgFetch が null の場合、ステータス 404 および JSON エラーコード "background fetch not found" を持つWebDriver エラーを返します。

7. bgFetch についてバックグラウンドフェッチクリックイベントを発火する。

8. WebDriver 成功を返します。