백그라운드 가져오기

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가 백그라운드 가져오기 포함 bgFetch를 포함하고 있다면, activeBgFetches[id]를 제거합니다.

   4. 그렇지 않으면, failureReason을 "aborted"로 설정합니다.

      참고: 이것은 abort()가 성공적으로 호출되었지만 동시에 가져오기가 실패한 경우의 경쟁 조건을 처리합니다. 만약 우리가 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에서 다음 속성과 함께 실행합니다:

       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이 아니면 범위 헤더를 추가한다. 대상은 request이며 rangeStart를 사용한다.

   참고: rangeStart가 0이면 일반 요청이 이루어진다. 범위 헤더가 있는 요청에는 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. 하나 이상의 바이트가 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를 content-range 값 추출 결과로 한다. 추출 대상은 response이다.

          2. completeLength가 null이 아니며 다음 길이, 즉 responseData의 바이트 길이와 같으면 responseData의 결과를 "success"로 설정한다.

             참고: 전체 리소스 또는 리소스의 나머지 부분을 요청하더라도 서버가 나머지 부분을 반환하지 않았을 수 있으며, 이 경우 추가 요청을 해야 한다.

       2. 그렇지 않고 response의 상태가 정상 상태가 아니면 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. recordsAvailable을 bgFetch의 레코드 사용 가능 플래그가 설정되어 있으면 true로, 그렇지 않으면 false로 한다.

6. 각 환경 설정 객체 env 중 그 출처가 bgFetch의 서비스 워커 등록의 범위 URL의 출처와 같은 것에 대해, bgfetch 태스크를 큐에 넣는다. 대상은 env의 담당 이벤트 루프이며 다음 단계를 실행한다:

   1. bgFetchRegistration을 BackgroundFetchRegistration 인스턴스로 한다. 이 인스턴스는 관련 Realm 안에 있고, 그 백그라운드 페치가 bgFetch와 같아야 한다. 존재하지 않으면 null로 한다.

      참고: 다음 BackgroundFetchRegistration 인스턴스 가져오기 알고리즘으로 인해 환경마다 최대 하나만 존재한다.

   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. 이벤트를 발생시킨다. 이름은 "progress"이고 대상은 bgFetchRegistration이다.

   마우스 이동 이벤트를 디바운스하는 방식과 유사하게 이것도 디바운스해야 한다.

registration

이벤트 객체의 관련 영역에서 bgFetch에 대해 BackgroundFetchRegistration 인스턴스를 가져오는 결과.

1. instancesMap을 다음 BackgroundFetchRegistration 인스턴스로 한다. 이는 유일한 BackgroundFetchManager 인스턴스가 이 realm 안에서 갖는 값이다.

2. instancesMap[bgFetch]가 존재하면, instancesMap[bgFetch]를 반환한다.

3. instance를 새 BackgroundFetchRegistration으로 한다. 이는 realm에 있으며, 그 백그라운드 페치를 bgFetch로 설정한다.

4. instancesMap[bgFetch]을 instance로 설정한다.

5. instance를 반환한다.

1. 단언: partialResponse의 상태는 206입니다.

2. responseFirstBytePos, responseLastBytePos, 그리고 responseCompleteLength를 partialResponse에서 콘텐츠 범위 값 추출의 결과로 설정합니다. 이 작업이 실패하면, 유효하지 않음을 반환합니다.

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에서 콘텐츠 범위 값 추출의 결과로 설정합니다. 이 작업이 실패하면, 유효하지 않음을 반환합니다.

      2. 만약 previousResponseCompleteLength가 null이 아니고, responseCompleteLength가 previousResponseCompleteLength와 같지 않다면, 유효하지 않음을 반환합니다.

5. 유효함을 반환합니다.

1. 만약 response의 헤더 목록이 `Content-Range`를 포함하지 않는다면, 실패를 반환합니다.

2. contentRangeValue를 response의 헤더 목록에서 헤더의 값으로 설정합니다. 이때 이름은 `Content-Range`와 바이트 대소문자 무시 일치여야 합니다.

3. 만약 contentRangeValue를 단일 바이트 콘텐츠 범위로 구문 분석하는 데 실패하면, 실패를 반환합니다.

4. firstBytePos를 contentRangeValue에서 단일 바이트 콘텐츠 범위로 분석된 값 중 first-byte-pos에 해당하는 부분으로 설정하고, 정수로 구문 분석합니다.

5. lastBytePos를 contentRangeValue에서 단일 바이트 콘텐츠 범위로 분석된 값 중 last-byte-pos에 해당하는 부분으로 설정하고, 정수로 구문 분석합니다.

6. completeLength를 contentRangeValue에서 단일 바이트 콘텐츠 범위로 분석된 값 중 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를 새 프로미스로 설정한다.

   4. requestObject를 다음과 같이 설정된 새 Request 객체로 한다:

      요청

      record의 요청 사본. 해당 본문도 포함한다.

      헤더

      이 새 Headers 객체는 이 Request의 요청에 속한 헤더 리스트와 연결된다.

   5. recordObject의 request를 requestObject로 설정한다.

   6. transmittedBytes를 0으로 한다.

   7. stream을 새 읽기 가능 스트림으로 한다. 이 스트림에는 pull 동작이 있으며, 이 동작은 새 프로미스 promise를 반환하고 다음 단계를 병렬로 실행한다:

      1. 다음 길이, 즉 responseData의 바이트 길이가 transmittedBytes보다 커지거나 responseData의 결과가 빈 문자열이 아니게 될 때까지 기다린다.

      2. bytes를 null로 한다.

      3. 다음 길이, 즉 responseData의 바이트 길이가 transmittedBytes보다 크고 responseData가 노출될 수 있으면:

         1. bytes를 사용자 에이전트가 결정한 슬라이스로 설정한다. 이 슬라이스는 responseData의 바이트에서 추출하며 transmittedBytes 오프셋부터 시작한다.

            참고: 이를 통해 사용자 에이전트는 저장소에서 적절한 속도로 리소스를 스트리밍할 수 있다.

         2. transmittedBytes를 bytes의 길이만큼 증가시킨다.

      4. 태스크를 큐에 넣는다. 대상은 stream의 관련 설정 객체의 담당 이벤트 루프이며, 네트워킹 태스크 소스를 사용해 다음 단계를 실행한다:

         1. bytes가 null이 아니면:

            1. array를 새 Uint8Array로 한다. 이 객체는 새 ArrayBuffer를 래핑하며, 이 버퍼는 bytes로 구성된다.

            2. 다음을 큐에 넣는다: array를 stream에.

         2. responseData가 노출될 수 있고, responseData의 결과가 빈 문자열이 아니며 transmittedBytes가 길이, 즉 responseData의 바이트 길이이면 닫을 대상은 stream이다.

         3. 그렇지 않고 responseData의 결과가 "aborted"이면 오류를 발생시킬 대상은 stream이며 AbortError DOMException을 사용한다.

         4. 그렇지 않고 responseData가 노출될 수 없으면, 오류를 발생시킬 대상은 stream이며 TypeError를 사용한다.

         5. 이행할 대상은 promise이다.

   8. 다음 단계를 병렬로 실행한다:

      1. responseData의 응답이 not-null이 아니게 될 때까지 기다린다.

      2. responseData가 노출될 수 있으면:

         1. response을 responseData의 응답 사본으로 한다.

         2. 다음을 삭제한다: `Content-Range`를 response의 헤더 리스트에서.

         3. 다음을 삭제한다: `Content-Length`를 response의 헤더 리스트에서.

         4. body를 새 본문으로 한다. 이 본문의 스트림을 stream으로 설정한다.

         5. response의 본문을 body로 설정한다.

         6. 태스크를 큐에 넣는다. 대상은 recordObject의 관련 설정 객체의 담당 이벤트 루프이며 네트워킹 태스크 소스를 사용해 다음 단계를 실행한다:

            1. responseObject를 다음과 같이 설정된 새 Response 객체로 한다:

               응답

               response.

               헤더

               이 새 Headers 객체는 이 Response의 응답에 속한 헤더 리스트와 연결된다.

            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 오류를 WebDriver 오류 코드 해당 창 없음과 함께 반환합니다.

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. 백그라운드 패치 클릭 이벤트를 발생시킵니다. bgFetch에 대해.

8. WebDriver 성공을 반환합니다.