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

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

2. settledFetchesを0に設定します。

3. immediateFailureをfalseに設定します。

4. failureReasonを空文字列に設定します。

5. 各 recordについて、bgFetchのレコードに対して、以下の手順を並列で実行します:

   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がバックグラウンドフェッチを含むなら、activeBgFetches[id]を削除します。

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

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

   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. 機能イベントを発火するをeventNameを名前としてeventConstructorを使用し、swRegistrationで以下のプロパティを持つイベントを実行します:

       登録

       イベントオブジェクトの関連するレルムにおいて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でない場合は、Range ヘッダーを追加してrequestにrangeStartを設定します。

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

9. fetchAttemptCompleteを false とします。

10. lastTransmittedSizeを 0 とします。

11. Fetch requestを実行します。

    このステップの残りの部分では、Fetch "callbacks" を使用していますが、現在タスクをキューに入れています。これは望ましくも可能でもないため、タスクがキューに入っていないと仮定します。(issue)

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

    1. transmittedSizeをrequestのbodyの送信済みバイト数とします。

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

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

    4. バックグラウンドフェッチインスタンスを更新 します。

    レスポンスを処理するには、responseに対して以下の手順を実行します：

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

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

          注: requestのmethodが `GET`でない場合、リクエストを再発行することで意図しない副作用が 発生する可能性があります。リクエストを再開する標準的な方法が利用可能になった場合、 それがここで採用されます。

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

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

    2. responseのstatusが206の場合：

       1. もし部分レスポンスを検証するがrangeStart、response、およびresponseDataのレスポンスに対して無効を返す場合、次を実行します:

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

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

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

    3. それ以外の場合：

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

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

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

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

       4. バックグラウンドフェッチインスタンスを更新 します。

    4. rangeStartが0であるか、responseのstatusが206でない場合、 responseDataのresponseをresponse のコピーに設定します。ただしbodyを除きます。

    5. streamをresponseのbodyのstreamとします。

    6. streamから1バイト以上が送信された場合は、bytesを送信されたバイト数 として以下の手順を実行します：

       1. bgFetchの保存されたボディ バイト合計にbytesのサイズを加算した値が downloadTotalを超える場合：

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

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

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

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

       4. バックグラウンドフェッチインスタンスを更新 します。

    7. 任意の時点でstreamのバイト送信が正常に完了した場合：

       1. responseのstatusが206である場合：

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

          2. completeLengthがnullでなく、かつresponseDataのbytesの 長さに等しい場合、 responseDataのresultを "success" に設定します。

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

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

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

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

    8. 任意の時点でstreamがエラー状態になった場合：

       1. リソースが一時的に利用できない状態であり、 requestのmethodが `GET`の場合、リソースが一時的に利用できない状態でなくなるまで 待機し、fetchAttemptCompleteをtrueに設定します。

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

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

13. 以下の手順を実行しますが、中止条件としてbgFetchのpaused flagまたはabort all flagが設定された場合：

    1. fetchAttemptCompleteがtrueになるのを待ちます。

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

14. 中止された場合：

    1. bgFetchのpaused flagが設定されている場合、 requestのmethodが`GET`であることを確認します。

    2. bgFetchのabort all flagが設定されている場合、 responseDataのresultを "aborted"に設定します。

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

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

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

15. resultが空文字列の場合、レコードを完了するをbgFetchおよび recordに対して実行します。

1. downloadedをbgFetchの保存されたボディバイト合計とします。

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

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

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

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

6. 環境設定オブジェクトのうち、そのオリジンがbgFetchのサービスワーカーレジストレーションの スコープURLのオリジンと等しいものをそれぞれ取り出し、envの責任あるイベントループにバックグラウンドフェッチタスクをキューイングして以下の手順を実行します：

   1. bgFetchRegistrationを、BackgroundFetchRegistrationのうち、バックグラウンドフェッチが bgFetchと等しいものとします。該当するインスタンスが存在しない場合はnullとします。

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

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

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

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

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

   5. 以下のすべてが真である場合：

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

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

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

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

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

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

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

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

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

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

   マウス移動イベントのデバウンスに似た方法でデバウンスを実装する必要があります。

registration

イベントオブジェクトの関連するRealmで、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値を抽出する結果とします。これが失敗した場合、invalidを返します。

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

4. もしpreviousResponseがnullでない場合：

   1. 《`ETag`、`Last-Modified`》のheaderNameそれぞれに対して：

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

   2. もしpreviousResponseのステータスが206の場合：

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

      2. もしpreviousResponseCompleteLengthがnullでない場合、かつ responseCompleteLengthが previousResponseCompleteLengthと等しくない場合、invalidを返します。

5. validを返します。

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. 各 recordをrecordsから以下のように処理する：

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

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

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

   4. requestObjectを以下の設定を持つ新しいRequest オブジェクトとします：

      リクエスト

      recordのリクエストのコピーを設定します。その中にはボディも含みます。

      ヘッダー

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

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

   6. transmittedBytesを0とします。

   7. streamを新しいReadable Streamとし、以下の手順を並行して実行するプルアクションを持たせる：

      1. responseDataの長さがtransmittedBytesを超えるか、またはresponseDataの結果が空文字列でなくなるのを待つ。

      2. bytesをnullとします。

      3. もしresponseDataの長さがtransmittedBytesを超え、かつresponseDataが公開可能である場合：

         1. bytesをresponseDataのバイトのうち、transmittedBytesオフセットから始まるエージェントが決定するスライスとする。

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

         2. transmittedBytesにbytesの長さを加算する。

      4. タスクをキューに追加し、以下を実行する：

         1. もしbytesがnullでない場合：

            1. arrayを新しいUint8Arrayオブジェクトとし、ArrayBufferをラップする。

            2. arrayをstreamにキューに追加する。

         2. もしresponseDataが公開可能であり、responseDataの結果が空文字列でなく、かつtransmittedBytesがresponseDataの長さと等しい場合、streamを閉じる。

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

         4. Promiseを解決する。

   8. 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エラーをWebDriverエラーコード no such windowと共に返します。

2. pageURLを現在のトップレベルブラウジングコンテキストのアクティブドキュメントのURLとします。

3. swRegistrationをpageURLに対する一致するサービスワーカーレジストレーションとします。

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

5. bgFetchを、バックグラウンドフェッチの中で、idがurl変数 idで、サービスワーカーレジストレーションがswRegistrationの最新のものとし、それが存在しない場合はnullとします。

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

7. バックグラウンドフェッチクリックイベントを発火 します。

8. WebDriver成功を返します。