サービスワーカー

3.1.4. postMessage(message, transfer)

postMessage(message, transfer) メソッド手順：

1. options を «[ "transfer" → transfer ]» とする。

2. message と options を引数に postMessage(message, options) を呼び出す。

3.1.5. postMessage(message, options)

postMessage(message, options) メソッド手順：

1. serviceWorker を サービスワーカー（thisで表される）とする。

2. incumbentSettings を 現職設定オブジェクトとする。

3. incumbentGlobal を incumbentSettings の グローバルオブジェクトとする。

4. serializeWithTransferResult を StructuredSerializeWithTransfer(message, options["transfer"]) の結果とする。例外は再スローする。

5. "message" と serviceWorkerで イベントスキップ判定アルゴリズムの結果が true なら return。

6. 以下のサブステップを 並列で実行：

   1. serviceWorker で サービスワーカーの実行アルゴリズムの結果が failure なら return。

   2. DOM操作タスクソースで以下を実行：

      1. incumbentGlobal の型に応じて source を決定：

         ServiceWorkerGlobalScope

         incumbentGlobal の service worker を serviceWorker の 関連設定オブジェクトで表すサービスワーカーオブジェクト取得の結果

         Window

         incumbentGlobal の 関連設定オブジェクトを表す新しい WindowClient オブジェクト

         その他

         incumbentGlobal の関連ワーカーを表す新しい Client オブジェクト

      2. origin を incumbentSettings の origin の ASCII直列化結果とする。

      3. destination を serviceWorker に関連付けられた ServiceWorkerGlobalScope オブジェクトとする。

      4. deserializeRecord を StructuredDeserializeWithTransfer(serializeWithTransferResult, destination の Realm) とする。

         例外が発生した場合は、originを初期化した messageerror イベントを ExtendableMessageEvent を使い作成し、source を初期化する。

      5. それ以外：

         1. messageClone を deserializeRecord.[[Deserialized]] とする。

         2. newPorts を deserializeRecord.[[TransferredValues]] 内のすべての MessagePort オブジェクトから作成した新しい frozen array（順序維持）とする。

         3. e を origin、source、messageClone、newPortsを初期化した message イベントとして ExtendableMessageEvent を使い作成する。

      6. Dispatch e を destination で実行。

      7. サービスワーカー拡張イベントセットの更新 を serviceWorker と e で呼び出す。

3.2.2. installing

installing属性は、最後に設定された値を返さなければなりません。

注: Realm内では、関連付けられたサービスワーカーごとに1つのServiceWorkerオブジェクトのみ存在します。

3.2.3. waiting

waiting属性は、最後に設定された値を返さなければなりません。

注: Realm内では、関連付けられたサービスワーカーごとに1つのServiceWorkerオブジェクトのみ存在します。

3.2.4. active

active属性は、最後に設定された値を返さなければなりません。

注: Realm内では、関連付けられたサービスワーカーごとに1つのServiceWorkerオブジェクトのみ存在します。

3.2.5. navigationPreload

navigationPreloadゲッター手順は、サービスワーカー登録のNavigationPreloadManagerオブジェクトを返すこと。

3.2.6. scope

scopeゲッター手順は、サービスワーカー登録の直列化されたscope urlを返すこと。

3.2.7. updateViaCache

updateViaCacheゲッター手順は、サービスワーカー登録のupdate via cacheモードを返すこと。

3.2.8. update()

update()メソッド手順：

1. registrationをサービスワーカー登録とする。

2. newestWorkerを最新ワーカー取得アルゴリズムでregistrationを引数に実行した結果にする。

3. newestWorkerがnullの場合、失敗したpromise（"InvalidStateError"DOMException）を返して中断。

4. thisの関連グローバルオブジェクトglobalObjectがServiceWorkerGlobalScopeオブジェクトであり、globalObjectの関連サービスワーカーのstateが"installing"の場合、失敗したpromise（"InvalidStateError"DOMException）を返して中断。

5. promiseをpromiseとする。

6. jobをジョブ作成アルゴリズムで、update、registrationのstorage key、registrationのscope url、newestWorkerのscript url、promise、thisの関連設定オブジェクトを引数に実行した結果にする。

7. jobのworker typeをnewestWorkerのtypeに設定する。

8. ジョブスケジュールをjobで呼び出す。

9. promiseを返す。

3.2.9. unregister()

注: unregister()メソッドはサービスワーカー登録を解除します。現在制御されているサービスワークラクライアントのアクティブサービスワーカーの含有サービスワーカー登録は、そのサービスワーカー登録を利用するすべてのサービスワークラクライアント（自身を含む）がアンロードされるまで有効です。つまり、unregister()メソッドは、以降のナビゲーションにのみ影響します。

unregister()メソッド手順：

1. registrationをサービスワーカー登録とする。

2. promiseを新規promiseとする。

3. jobをジョブ作成アルゴリズムで、unregister、registrationのstorage key、registrationのscope url、null、promise、thisの関連設定オブジェクトを引数に実行した結果にする。

4. ジョブスケジュールをjobで呼び出す。

5. promiseを返す。

3.4.1. controller

controller 属性の手順は以下の通り実行しなければなりません：

1. clientをthisのサービスワークラクライアントとする。

2. clientのアクティブサービスワーカー がnullの場合、nullを返す。

3. clientのアクティブサービスワーカーをサービスワーカーオブジェクト取得で、thisの関連設定オブジェクトで表現した結果を返す。

注: navigator.serviceWorker.controller はリクエストが強制リフレッシュ（shift+refresh）の場合、nullを返します。

3.4.2. ready

ready属性は以下の手順で実行しなければなりません：

1. thisのready promiseがnullの場合、thisのready promiseに新規promiseを設定する。

2. readyPromiseをthisのready promiseとする。

3. readyPromiseがpendingの場合、以下のサブステップを並列で実行：

   1. clientをthisの サービスワークラクライアントとする。

   2. storage keyをストレージキー取得でclientを引数に実行した結果とする。

   3. registrationをサービスワーカー登録一致でstorage keyとclientの作成URLを引数に実行した結果とする。

   4. registrationがnullでなく、registrationのactive workerがnullでない場合、DOM操作タスクソースでreadyPromiseの関連設定オブジェクトの責任イベントループにタスクをキューし、readyPromiseをregistrationを表すサービスワーカー登録オブジェクト取得の結果で解決する。

4. readyPromiseを返す。

注: 返されるready promiseはrejectされません。このアルゴリズムでresolveされない場合でも、該当するサービスワーカー登録が登録され、active workerが設定されると必ずresolveされます。（該当するActivateアルゴリズム参照）

3.4.3. register(scriptURL, options)

注: register(scriptURL, options) メソッドは、指定されたscope urlのサービスワーカー登録を新規作成または更新します。成功すると、提供されたscriptURLがscope urlに関連付けられ、以後ナビゲーションマッチング（navigation matching）で使用されます。

register(scriptURL, options) メソッド手順：

1. pをpromiseとする。

2. scriptURLをTrustedScriptURL、 thisの関連グローバルオブジェクト、 scriptURL、"ServiceWorkerContainer register"、"script"でGet Trusted Type compliant stringを呼び出した結果にする。

3. clientをthisのサービスワークラクライアントとする。

4. scriptURLをURLパーサーでthisの関連設定オブジェクトのAPI base URLで解析した結果にする。

5. scopeURLをnullとする。

6. options["scope"] が存在する場合、scopeURLをURLパーサーでoptions["scope"]をthisの関連設定オブジェクトのAPI base URLで解析した結果に設定する。

7. Start RegisterをscopeURL、scriptURL、p、client、clientの作成URL、options["type"]、options["updateViaCache"]で呼び出す。

8. pを返す。

3.4.4. getRegistration(clientURL)

getRegistration(clientURL) メソッド手順：

1. clientをthisのサービスワークラクライアントとする。

2. storage keyをストレージキー取得でclientを引数に実行した結果とする。

3. clientURLをURLパーサーでclientURLをthisの関連設定オブジェクトのAPI base URLで解析した結果にする。

4. clientURLが失敗の場合、promiseをTypeErrorでrejectして返す。

5. clientURLのfragmentをnullに設定する。

6. clientURLのoriginがclientのoriginでない場合、promiseをSecurityErrorのDOMExceptionでrejectして返す。

7. promiseを新規promiseとする。

8. 以下の手順を並列で実行：

   1. registrationをサービスワーカー登録一致でstorage keyとclientURLを引数に実行した結果とする。

   2. registrationがnullの場合、promiseをundefinedでresolveして手順終了。

   3. promiseをregistrationを表すサービスワーカー登録オブジェクト取得の結果でresolveする。

9. promiseを返す。

3.4.5. getRegistrations()

getRegistrations() メソッド手順：

1. clientをthisのサービスワークラクライアントとする。

2. client storage keyをストレージキー取得でclientを引数に実行した結果とする。

3. promiseを新規promiseとする。

4. 以下の手順を並列で実行：

   1. registrationsを新規リストとする。

   2. 各 (storage key, scope) → registration をregistration mapから反復：

      1. storage keyがclient storage keyと等しい場合、append registrationをregistrationsへ追加。

   3. DOM操作タスクソースでpromiseの関連設定オブジェクトの責任イベントループにタスクをキューして、以下を実行：

      1. registrationObjectsを新規リストとする。

      2. 各 registrationをregistrationsで反復：

         1. registrationObjをregistrationを表すサービスワーカー登録オブジェクト取得の結果とする。

         2. append registrationObjをregistrationObjectsに追加。

      3. promiseを新規frozen arrayでregistrationObjectsをpromiseの関連Realmで解決する。

5. promiseを返す。

3.4.6. startMessages()

startMessages()メソッドの手順は、thisのクライアントメッセージキューが有効でなければ有効化すること。

4.1.4. skipWaiting()

注: skipWaiting() メソッドは、この Service Worker を、 登録 の waiting 状態から active 状態へと進めることができます。 Service Workerクライアント がその 登録 を 利用している最中でも実行可能です。

skipWaiting() メソッドの手順:

1. promise を新しい Promise とする。

2. 以下のサブステップを 並行して実行する:

   1. service worker の skip waitingフラグ を設定する。

   2. Try Activate を service worker の 含まれるService Worker登録 に対して呼び出す。

   3. promise を undefined で解決する。

3. promise を返す。

4.2.5. postMessage(message, transfer)

postMessage(message, transfer) メソッドの手順:

1. options を «[ "transfer" → transfer ]» とする。

2. postMessage(message, options) を message と options を引数として呼び出す。

4.2.6. postMessage(message, options)

postMessage(message, options) メソッドの手順:

1. contextObject を this とする。

2. sourceSettings を contextObject の 該当設定オブジェクト とする。

3. serializeWithTransferResult を StructuredSerializeWithTransfer(message, options["transfer"]) とする。例外は再スローする。

4. 以下の手順を 並行して実行する:

   1. targetClient を null とする。

   2. 各 service worker client client について:

      1. client が contextObject の service worker client であれば、targetClient に client を設定し、break する。

   3. targetClient が null なら return。

   4. destination を、関連する service worker client が targetClient である ServiceWorkerContainer オブジェクトとする。

   5. destination の client message queue に、次の手順を実行するタスクを追加する:

      1. origin を sourceSettings の origin の 直列化とする。

      2. source を、service workerオブジェクトの取得の結果とし、これは contextObject の 該当グローバルオブジェクト の service worker を targetClient で表す。

      3. deserializeRecord を StructuredDeserializeWithTransfer(serializeWithTransferResult, destination の 該当Realm) とする。

         例外が発生した場合、それをキャッチし、messageerror イベントを destination で MessageEvent を使って発火し、origin 属性を origin で、source 属性を source で初期化し、その後これらの手順を中止する。

      4. messageClone を deserializeRecord.[[Deserialized]] とする。

      5. newPorts を、deserializeRecord.[[TransferredValues]] 内の全ての MessagePort オブジェクトからなる新しい frozen array とする（もしあれば）。

      6. message イベントを destination で MessageEvent を使って発火し、origin 属性を origin で、source 属性を source で、data 属性を messageClone で、ports 属性を newPorts で初期化する。

4.2.10. focus()

focus() メソッド手順:

1. この オリジン に Window が一つも 一時的なアクティベーション を持たない場合、"InvalidAccessError" DOMException で拒否された promise を返す。

2. serviceWorkerEventLoop を 周囲のエージェント の イベントループ とする。

3. promise を新しい promise とする。

4. タスクをキューに入れる。次の手順を this に関連付けられた service worker client の 責任イベントループ上で ユーザー操作タスクソース を使って実行する:

   1. フォーカス手順 を this の 閲覧コンテキスト に対して実行する。

   2. frameType を Get Frame Type を this の 閲覧コンテキスト で実行した結果とする。

   3. visibilityState を this の 閲覧コンテキスト の アクティブドキュメント の visibilityState 属性値とする。

   4. focusState を has focus手順 を this の 閲覧コンテキスト の アクティブドキュメント に対して実行した結果とする。

   5. ancestorOriginsList を this の 閲覧コンテキスト の アクティブドキュメント の 該当グローバルオブジェクト の Location オブジェクトの 先祖オリジンリスト の関連リストとする。

   6. タスクをキューに入れる。次の手順を serviceWorkerEventLoop 上で DOM操作タスクソース を使って実行する:

      1. windowClient を Create Window Client に this に関連付けられた service worker client、frameType、visibilityState、focusState、ancestorOriginsList を渡して実行した結果とする。

      2. windowClient の フォーカス状態 が true なら、promise を windowClient で解決する。

      3. そうでなければ、promise を TypeError で拒否する。

5. promise を返す。

4.2.11. navigate(url)

navigate(url) メソッド手順:

1. url を パース した結果とし、this の 該当設定オブジェクト の APIベースURL を使う。

2. url が失敗の場合、TypeError で拒否された promise を返す。

3. url が about:blank の場合、TypeError で拒否された promise を返す。

4. this に関連付けられた service worker client の active service worker が this の 該当グローバルオブジェクト の service worker でない場合、TypeError で拒否された promise を返す。

5. serviceWorkerEventLoop を 現在のグローバルオブジェクト の イベントループ とする。

6. promise を新しい promise とする。

7. タスクをキューに入れる。次の手順を this に関連付けられた service worker client の 責任イベントループ上で ユーザー操作タスクソース を使って実行する:

   1. browsingContext を this の 閲覧コンテキスト とする。

   2. browsingContext の 関連ドキュメント が 完全アクティブ でない場合、タスクをキューに入れる。promise を TypeError で serviceWorkerEventLoop 上の DOM操作タスクソース で拒否し、これらの手順を中止する。

   3. HandleNavigate: ナビゲート browsingContext を url へ、browsingContext の 関連ドキュメント を使い、例外有効 を true とする。

   4. HandleNavigate ラベル付きのアルゴリズム手順が 例外 を投げた場合、タスクをキューに入れる。promise を例外で serviceWorkerEventLoop 上の DOM操作タスクソース で拒否し、これらの手順を中止する。

   5. frameType を Get Frame Type を browsingContext で実行した結果とする。

   6. visibilityState を browsingContext の アクティブドキュメント の visibilityState 属性値とする。

   7. focusState を has focus手順 を browsingContext の アクティブドキュメント に対して実行した結果とする。

   8. ancestorOriginsList を browsingContext の アクティブドキュメント の 該当グローバルオブジェクト の Location オブジェクトの 先祖オリジンリスト の関連リストとする。

   9. タスクをキューに入れる。次の手順を serviceWorkerEventLoop 上で DOM操作タスクソース を使って実行する:

      1. browsingContext の Window オブジェクトの environment settings object の 作成URL の origin が 同一 でない場合、service worker の origin と、promise を null で解決し、これらの手順を中止する。

      2. windowClient を Create Window Client に this の service worker client、frameType、visibilityState、focusState、ancestorOriginsList を渡して実行した結果とする。

      3. promise を windowClient で解決する。

8. promise を返す。

4.3.1. get(id)

get(id) メソッドの手順:

1. promise を新しい promise とする。

2. 以下のサブステップを 並行して実行する:

   1. 各 service worker client client について、ストレージキーの取得 の結果が、関連する service worker の 含まれるService Worker登録 の ストレージキー と等しい場合:

      1. client の id が id でない場合、continue。

      2. client の 実行準備フラグ が設定されるか、client の 破棄フラグ が設定されるまで待つ。

      3. client の 実行準備フラグ が設定されたら、Get Client Promiseの解決 を client と promise で呼び出し、これらの手順を中止する。

   2. promise を undefined で解決する。

3. promise を返す。

4.3.2. matchAll(options)

matchAll(options) メソッドの手順:

1. promise を 新しいpromise とする。

2. 以下の手順を 並行して実行する:

   1. targetClients を新しい リスト とする。

   2. 各 service worker client client について、ストレージキーの取得 の結果が、関連する service worker の 含まれるService Worker登録 の ストレージキー と等しい場合:

      1. client の 実行準備フラグ が未設定、または client の 破棄フラグ が設定されている場合、continue。

      2. client が セキュアコンテキスト でない場合、continue。

      3. options["includeUncontrolled"] が false であり、かつ client の active service worker が関連 service worker でない場合、continue。

      4. client を targetClients に追加する。

   3. matchedWindowData を新しい リスト とする。

   4. matchedClients を新しい リスト とする。

   5. targetClients 内の各 service worker client client について:

      1. options["type"] が "window" または "all" であり、 client が environment settings object でない、または window client である場合:

         1. windowData を «[ "client" → client, "ancestorOriginsList" → 新しい リスト ]» とする。

         2. browsingContext を null とする。

         3. isClientEnumerable を true とする。

         4. client が environment settings object なら、browsingContext を client の グローバルオブジェクト の 閲覧コンテキスト とする。

         5. そうでなければ、browsingContext を client の ターゲット閲覧コンテキスト とする。

         6. タスクをキューに入れる。以下のサブステップを browsingContext の イベントループ で ユーザー操作タスクソース を使って実行する:

            1. browsingContext が 破棄済み なら、isClientEnumerable を false にしてこれらの手順を中止する。

            2. client がwindow clientかつ client の 関連ドキュメント が browsingContext の アクティブドキュメント でない場合、isClientEnumerable を false にしてこれらの手順を中止する。

            3. windowData["frameType"] に Get Frame Type を browsingContext で実行した結果を設定する。

            4. windowData["visibilityState"] に browsingContext の アクティブドキュメント の visibilityState 属性値を設定する。

            5. windowData["focusState"] に has focus手順 を browsingContext の アクティブドキュメント に対して実行した結果を設定する。

            6. client が window client なら、 windowData["ancestorOriginsList"] に browsingContext の アクティブドキュメント の 該当グローバルオブジェクト の Location オブジェクトの 先祖オリジンリスト の関連リストを設定する。

         7. task が実行されるまで待つ。

            注: 待機はブロッキングだが、実装者は状態が壊れない限り並行して反復処理できる。

         8. isClientEnumerable が true なら:

            1. windowData を matchedWindowData に追加する。

      2. そうでなく options["type"] が "worker" または "all" かつ client が dedicated worker client の場合、あるいは options["type"] が "sharedworker" または "all" かつ client が shared worker client の場合:

         1. client を matchedClients に追加する。

   6. タスクをキューに入れる。以下の手順を promise の 該当設定オブジェクト の 責任イベントループ で DOM操作タスクソース を使って実行する:

      1. clientObjects を新しい リスト とする。

      2. 各 windowData について、matchedWindowData 内で:

         1. windowClient を Create Window Client アルゴリズムを windowData["client"], windowData["frameType"], windowData["visibilityState"], windowData["focusState"], windowData["ancestorOriginsList"] で実行した結果とする。

         2. windowClient を clientObjects に追加する。

      3. 各 client について、matchedClients 内で:

         1. clientObject を Create Client アルゴリズムを client で実行した結果とする。

         2. clientObject を clientObjects に追加する。

      4. clientObjects を以下のようにソートする:

         • WindowClient オブジェクトでその 閲覧コンテキスト が フォーカスされたものは先頭に、最新の フォーカス順で並ぶ。

         • WindowClient オブジェクトでその 閲覧コンテキスト が一度も フォーカスされていないものは次に、service worker client の生成順で並ぶ。

         • Client オブジェクトで関連する service worker client が worker client のものはその後、service worker client の生成順で並ぶ。

         注: window client は常に worker client より先に配置される。

      5. promise を clientObjectsの新しいFrozenArray で promise の 該当Realm で解決する。

3. promise を返す。

4.3.3. openWindow(url)

openWindow(url) メソッドの手順:

1. url を パースした結果とし、this の 該当設定オブジェクト の APIベースURL を使う。

2. url が失敗の場合、TypeError で拒否された promise を返す。

3. url が about:blank の場合、TypeError で拒否された promise を返す。

4. この オリジン に Window が一つも 一時的なアクティベーション を持たない場合、"InvalidAccessError" DOMException で拒否された promise を返す。

5. serviceWorkerEventLoop を 現在のグローバルオブジェクト の イベントループ とする。

6. promise を新しい promise とする。

7. 以下のサブステップを 並行して実行する:

   1. newContext を新しい トップレベル閲覧コンテキスト とする。

   2. タスクをキューに入れる。以下の手順を newContext の Window オブジェクトの environment settings object の 責任イベントループ で ユーザー操作タスクソース を使って実行する:

      1. HandleNavigate: ナビゲート newContext を url へ、例外有効 を true、historyHandling を "replace" とする。

      2. HandleNavigate ラベル付きのアルゴリズム手順が 例外 を投げた場合、タスクをキューに入れる。promise を例外で serviceWorkerEventLoop 上の DOM操作タスクソース で拒否し、これらの手順を中止する。

      3. frameType を Get Frame Type を newContext で実行した結果とする。

      4. visibilityState を newContext の アクティブドキュメント の visibilityState 属性値とする。

      5. focusState を has focus手順 を newContext の アクティブドキュメント に対して実行した結果とする。

      6. ancestorOriginsList を newContext の アクティブドキュメント の 該当グローバルオブジェクト の Location オブジェクトの 先祖オリジンリスト の関連リストとする。

      7. タスクをキューに入れる。以下の手順を serviceWorkerEventLoop 上で DOM操作タスクソース を使って実行する:

         1. newContext の Window オブジェクトの environment settings object の ストレージキーの取得 の結果が、equal でない場合、service worker の 含まれるService Worker登録 の ストレージキー と、promise を null で解決し、これらの手順を中止する。

         2. client を Create Window Client に newContext の Window オブジェクトの environment settings object、frameType、visibilityState、focusState、ancestorOriginsList を渡して実行した結果とする。

         3. promise を client で解決する。

8. promise を返す。

4.3.4. claim()

claim() メソッドの手順:

1. service worker が アクティブワーカー でない場合、"InvalidStateError" DOMException で拒否された promise を返す。

2. promise を新しい promise とする。

3. 以下のサブステップを 並行して実行する:

   1. 各 service worker client client について、ストレージキーの取得 の結果が、equal である場合、service worker の 含まれるService Worker登録 の ストレージキー と等しい場合:

      1. client の 実行準備フラグ が未設定、または client の 破棄フラグ が設定されている場合、continue。

      2. client が セキュアコンテキスト でない場合、continue。

      3. storage key を ストレージキーの取得 を client で実行した結果とする。

      4. registration を Match Service Worker Registration を storage key と client の 作成URL で実行した結果とする。

      5. registration が service worker の 含まれるService Worker登録 でない場合、continue。

         注: registration は、service worker の 含まれるService Worker登録 が 登録解除済み の場合、null になる。

      6. client の active service worker が service worker でない場合、以下を実行する:

         1. Handle Service Worker Client Unload を client で呼び出す。

         2. client の active service worker を service worker に設定する。

         3. Notify Controller Change アルゴリズムを client で呼び出す。

   2. promise を undefined で解決する。

4. promise を返す。

4.4.1. event.waitUntil(f)

注: waitUntil() メソッドはイベントの存続期間を延長します。

waitUntil(f) メソッドの手順は、lifetime promiseの追加 f を this に対して行うことです。

1. event の isTrusted 属性がfalseの場合、"InvalidStateError" DOMException をthrowする。

2. event が active でない場合、"InvalidStateError" DOMException をthrowする。

   注: イベントハンドラを呼び出したタスク内でlifetime extension promiseが追加されていない場合、後続の非同期タスクで waitUntil() を呼ぶと例外となります。

3. promise を event の extend lifetime promises に追加する。

4. event の pending promises count を1増加させる。

   注: 渡されたpromiseが既に解決済みでもpending promises countは加算されます。減算はpromiseのreactionでマイクロタスクがキューされる際に行われます。

5. fulfillment または rejection が発生したら、マイクロタスクをキューして以下のサブステップを実行する:

   1. event の pending promises count を1減らす。

   2. event の pending promises count が0なら:

      1. registration を 現在のグローバルオブジェクト の関連 service worker の 含まれるService Worker登録 とする。

      2. registration が 登録解除済み なら、Try Clear Registration を registration で呼ぶ。

      3. registration が null でない場合、Try Activate を registration で呼ぶ。

ユーザーエージェントは、Service Worker Has No Pending Events がその service worker に対してfalseを返す場合、service workerの終了 をすべきではないです。

4.6.7. event.respondWith(r)

注: 開発者は引数 r に promise（Response オブジェクトで解決される）または Response オブジェクト（自動的にpromiseへ変換）を指定できます。それ以外の場合は ネットワークエラー が Fetch に返されます。 レンダラー側のクロスオリジンコンテンツの汚染に関するセキュリティチェックは、filtered response の型に依存します。

respondWith(r) メソッドの手順：

1. event を this とする。

2. event の dispatch flag が未設定なら、"InvalidStateError" DOMException をthrowする。

3. event の respond-with entered flag が 設定済みなら、"InvalidStateError" DOMException をthrowする。

4. lifetime promiseの追加 r を event に対して行う。

   注: event.respondWith(r) は event.waitUntil(r) を呼ぶのと同様に、デフォルトでイベントの存続期間を延長します。

5. event の stop propagation flag および stop immediate propagation flag を設定する。

6. event の respond-with entered flag を設定する。

7. event の wait to respond flag を設定する。

8. targetRealm を event の relevant Realm とする。

9. rのrejection時:

   1. event の respond-with error flag を設定する。

   2. event の wait to respond flag を解除する。

10. rのfulfillment時、response で：

    1. response が Response オブジェクトでない場合、respond-with error flag を設定する。

       注: respond-with error flag が設定された場合、 ネットワークエラー が Fetch の Handle Fetch アルゴリズムを通じて返されます（ステップ21.1参照）。そうでなければ、値 response が Fetch の Handle Fetch アルゴリズムを通じて返されます（ステップ22.1参照）。

    2. それ以外の場合：

       1. bytes を空のバイト列とする。

       2. end-of-body をfalseとする。

       3. done をfalseとする。

       4. potentialResponse を response の関連付けられた response のコピーとし、body を除く。

       5. response の body がnullでない場合、以下のサブステップを実行：

          1. reader を reader取得 を response の body の stream で実行した結果とする。

          2. pullAlgorithm を以下を行うactionとする：

             1. readRequest を新しい read request とし、以下の item を持つ：

                chunk steps（chunkを受け取る）

                1. アサート：chunk は Uint8Array である。

                2. chunk で表されるバイトを bytes に追加する。

                3. potentialResponse の body info の encoded size を bytes の byte length だけ増加させる。

                4. potentialResponse の body info の decoded size を bytes の byte length だけ増加させる。

                5. ! DetachArrayBuffer(chunk.[[ViewedArrayBuffer]]) を実行する。

                close steps

                1. end-of-body をtrueにする。

                error steps

                1. error newStream に TypeError を与える。

             2. read a chunk を reader に readRequest を与えて実行する。

          3. cancelAlgorithm を readerのキャンセルアクションとする。

          4. highWaterMark を非負・非NaNな数値（ユーザーエージェントが決定）とする。

          5. sizeAlgorithm を chunk オブジェクトを受け取り、非負・非NaN・無限大でない値を返すアルゴリズム（ユーザーエージェントが決定）とする。

          6. newStream を新しい ReadableStream とし、set up で pullAlgorithm pullAlgorithm、cancelAlgorithm cancelAlgorithm、highWaterMark highWaterMark、sizeAlgorithm sizeAlgorithm を targetRealm でセットアップする。

          7. potentialResponse の body を新しい body とし、その stream を newStream にする。

          8. 以下を 並行して done がfalseの間繰り返す：

             1. newStream が errored なら、done をtrueにする。

             2. それ以外で bytes が空かつ end-of-body がtrueなら、close newStream、done をtrueにする。

             3. それ以外で bytes が空でない場合、以下のサブサブサブステップを実行：

                1. chunk を bytes の先頭からの部分列とする。

                2. chunk を bytes から除去する。

                3. buffer を targetRealm で作られた ArrayBuffer オブジェクトで、chunk を含むものとする。

                4. enqueue を targetRealm で作られた Uint8Array オブジェクトで buffer をラップし、newStream に追加する。

          注: これらのサブステップは response の body の stream を potentialResponse に「パイプ」する観測可能な同等物を生成するためのものです。

          注: ServiceWorkerがチャンクで書き込んだデータは、受け取ったクライアントが必ずしも同じチャンクで読むとは限りません。つまり、クライアントは同じ内容を読むが、ブラウザによってチャンク分割方法が異なる場合があります。

       6. event の potential response を potentialResponse に設定する。

    3. event の wait to respond flag を解除する。

5.4.1. match(request, options)

match(request, options) メソッドの手順：

1. promise を 新しいpromise とする。

2. 以下のサブステップを 並行して実行する：

   1. p を matchAll(request, options) メソッド（requestとoptionsを渡す）で実行したアルゴリズムの結果とする。

   2. p がsettleするまで待つ。

   3. p が例外でrejectされたら：

      1. promise をその例外でrejectする。

   4. p が配列responsesでresolveされた場合：

      1. responses が空配列の場合：

         1. promise をundefinedでresolveする。

      2. それ以外の場合：

         1. promise をresponsesの最初の要素でresolveする。

3. promise を返す。

5.4.2. matchAll(request, options)

matchAll(request, options) メソッドの手順：

1. r をnullとする。

2. オプション引数requestが省略されていない場合：

   1. request が Request オブジェクトなら：

      1. r を request の request とする。

      2. r の method が `GET` でなく、かつ options.ignoreMethod がfalseなら、空配列でresolveされたpromise を返す。

   2. そうでなくrequestが文字列なら：

      1. r を request を引数として Request のコンストラクタを呼び出した結果の関連 request とする。例外が発生したら その例外でrejectされたpromise を返す。

3. realm を this の 関連Realm とする。

4. promise を 新しいpromise とする。

5. 以下のサブステップを 並行して実行する：

   1. responses を空の リスト とする。

   2. オプション引数requestが省略されている場合：

      1. 各 requestResponse について、関連リクエスト・レスポンスリスト内で：

         1. requestResponse のレスポンスのコピーを responses に追加する。

   3. そうでない場合：

      1. requestResponses を Query Cache を r と options で実行した結果とする。

      2. 各 requestResponse について、requestResponses内で：

         1. requestResponse のレスポンスのコピーを responses に追加する。

   4. 各 response について、responses内で：

      1. response の type が "opaque" かつ cross-origin resource policy check（promise の 関連設定オブジェクト の origin、promise の 関連設定オブジェクト、空文字列、response の internal response で実行）がblockedを返した場合、promise を TypeError でrejectし、これらの手順を中止する。

   5. タスクをキューに入れる。promise の 関連設定オブジェクト の 責任イベントループ で DOM操作タスクソース を使い、以下の手順を実行する：

      1. responseList を リストとする。

      2. 各 response について、responses内で：

         1. 新しい Response オブジェクト（responseに関連付け、Headers オブジェクト（guard が "immutable"）付き）を responseList に追加する。

      3. promise を frozen array（responseListから生成、realmで）でresolveする。

6. promise を返す。

5.4.3. add(request)

add(request) メソッドの手順：

1. requests を request だけを含む配列とする。

2. responseArrayPromise を addAll(requests) のアルゴリズム（requestsを引数に）で実行した結果とする。

3. responseArrayPromise のsettle後にundefinedを返すfulfillmentハンドラで reactする結果を返す。

5.4.4. addAll(requests)

addAll(requests) メソッドの手順：

1. responsePromises を空の リストとする。

2. requestList を空の リストとする。

3. requests 内の Request 型の各 request について：

   1. r を request の request とする。

   2. r の url の scheme が "http" または "https" 以外の場合、もしくは r の method が `GET` でない場合、TypeErrorでrejectされたpromise を返す。

4. fetchControllers を リスト（fetch controller）とする。

5. requests の各 request について：

   1. r を request を引数に Request のコンストラクタを呼び出した結果の関連 request とする。例外が発生したら 例外でrejectされたpromise を返す。

   2. r の url の scheme が "http" または "https" 以外の場合：

      1. 各 fetchController について、fetchControllers内で、abortする。

      2. TypeErrorでrejectされたpromise を返す。

   3. r の client の global object が ServiceWorkerGlobalScope オブジェクトなら、request の service-workers mode を "none" に設定する。

   4. r の initiator を "fetch"、destination を "subresource" に設定する。

   5. requestList に r を追加する。

   6. responsePromise を 新しいpromiseとする。

   7. 以下のサブステップを 並行して実行する：

      • fetching r の結果を追加する。

      • processResponse を response に対して実行：

        1. response の type が "error"、または response の status が ok status 以外、または 206 の場合、responsePromise を TypeError でrejectする。

        2. それ以外で response の header list に header Vary が含まれる場合：

           1. fieldValues を list（field-values を Vary headerで抽出）とする。

           2. 各 fieldValue について、fieldValues内で：

              1. fieldValue が "*" と一致する場合：

                 1. responsePromise を TypeError でrejectする。

                 2. 各 fetchController について、fetchControllers内で、abortする。

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

      • processResponseEndOfBody を response に対して実行：

        1. response の aborted flag が設定されている場合、"AbortError" DOMException で responsePromise をrejectし、これらの手順を中止する。

        2. responsePromise を response でresolveする。

        注: レスポンスのbodyが完全に受信されたときにキャッシュコミットが許可されます。

   8. responsePromise を responsePromises に追加する。

6. p を responsePromises全部がsettleするpromiseの結果とする。

7. p のsettle後、引数 responses を受け取るfulfillmentハンドラで reactし、以下のサブステップを実行：

   1. operations を空の リストとする。

   2. index をゼロとする。

   3. responses の各 response について：

      1. operation を キャッシュバッチ操作とする。

      2. operation の type を "put" に設定する。

      3. operation の request を requestList[index] に設定する。

      4. operation の response を response に設定する。

      5. operation を operations に追加する。

      6. index を1増やす。

   4. realm を this の 関連Realmとする。

   5. cacheJobPromise を 新しいpromiseとする。

   6. 以下のサブステップを 並行して実行する：

      1. errorData をnullとする。

      2. Batch Cache Operations を operations で呼び出す。例外が発生したら errorData にその例外を設定する。

      3. タスクをキューに入れる。cacheJobPromise の 関連設定オブジェクト の 責任イベントループ で DOM操作タスクソース を使い、以下のサブステップを実行：

         1. errorData がnullなら cacheJobPromise をundefinedでresolveする。

         2. それ以外なら cacheJobPromise を 新規例外（exception、errorData、realm）でrejectする。

   7. cacheJobPromise を返す。

5.4.5. put(request, response)

put(request, response) メソッドの手順：

1. innerRequest を null とする。

2. request が Request オブジェクトの場合、innerRequest を request の request に設定する。

3. それ以外の場合：

   1. requestObj を Request のコンストラクタに request を渡して呼び出した結果とする。例外が発生した場合は その例外でrejectされたpromise を返す。

   2. innerRequest を requestObj の request に設定する。

4. innerRequest の url の scheme が "http" または "https" 以外の場合、または innerRequest の method が `GET` でない場合、TypeErrorでrejectされたpromise を返す。

5. innerResponse を response の response に設定する。

6. innerResponse の status が 206 の場合、TypeErrorでrejectされたpromise を返す。

7. innerResponse の header list に header Vary が含まれる場合：

   1. fieldValues を list（Vary header の field-values）とする。

   2. 各 fieldValue について、fieldValues内で：

      1. fieldValue が "*" と一致する場合、TypeErrorでrejectされたpromise を返す。

8. innerResponse の body が disturbed または locked の場合、TypeErrorでrejectされたpromise を返す。

9. clonedResponse を innerResponseのclone とする。

10. bodyReadPromise を undefinedでresolveされたpromise とする。

11. innerResponse の body が null でない場合、以下のサブステップを実行：

    1. stream を innerResponse の body の stream に設定する。

    2. reader を streamのreader取得の結果とする。

    3. bodyReadPromise を 全バイト読み取りを reader で実行した結果とする。

    注: これは innerResponse の body が locked になり、clonedResponse に完全なバッファ済みコピーを保持することを保証します。実装ではメモリではなく直接ディスクにストリームする最適化も可能です。

12. operations を空の リストとする。

13. operation を キャッシュバッチ操作とする。

14. operation の type を "put" に設定する。

15. operation の request を innerRequest に設定する。

16. operation の response を clonedResponse に設定する。

17. operation を operations に追加する。

18. realm を this の 関連Realmとする。

19. bodyReadPromise の fulfillment時に以下を実行：

    1. cacheJobPromise を 新しいpromiseとする。

    2. cacheJobPromise を返し、以下のサブステップを 並行して実行：

       1. errorData を null とする。

       2. Batch Cache Operations を operations で呼び出す。例外が発生したら errorData にその例外を設定する。

       3. タスクをキューに入れる。cacheJobPromise の 関連設定オブジェクト の 責任イベントループ で DOM操作タスクソース を使い、以下のサブステップを実行：

          1. errorData が null なら cacheJobPromise を undefined でresolveする。

          2. それ以外なら cacheJobPromise を 新規例外（exception、errorData、realm）でrejectする。

5.4.6. delete(request, options)

delete(request, options) メソッドの手順：

1. r を null とする。

2. request が Request オブジェクトの場合：

   1. r を request の request に設定する。

   2. r の method が `GET` でなく、かつ options.ignoreMethod が false なら falseでresolveされたpromise を返す。

3. そうでなくrequestが文字列の場合：

   1. r を request を引数として Request のコンストラクタを呼び出した結果の関連 request とする。例外が発生した場合は その例外でrejectされたpromise を返す。

4. operations を空の リストとする。

5. operation を キャッシュバッチ操作とする。

6. operation の type を "delete" に設定する。

7. operation の request を r に設定する。

8. operation の options を options に設定する。

9. operation を operations に追加する。

10. realm を this の 関連Realmとする。

11. cacheJobPromise を 新しいpromiseとする。

12. 以下のサブステップを 並行して実行：

    1. errorData を null とする。

    2. requestResponses を Batch Cache Operations を operations で呼び出した結果とする。例外が発生したら errorData にその例外を設定する。

    3. タスクをキューに入れる。cacheJobPromise の 関連設定オブジェクト の 責任イベントループ で DOM操作タスクソース を使い、以下のサブステップを実行：

       1. errorData が null なら：

          1. requestResponses が 空でない場合、cacheJobPromise を true でresolveする。

          2. それ以外なら cacheJobPromise を false でresolveする。

       2. それ以外なら cacheJobPromise を 新規例外（exception、errorData、realm）でrejectする。

13. cacheJobPromise を返す。

5.4.7. keys(request, options)

keys(request, options) メソッドの手順：

1. r を null とする。

2. オプション引数requestが省略されていない場合：

   1. request が Request オブジェクトの場合：

      1. r を request の request に設定する。

      2. r の method が `GET` でなく、かつ options.ignoreMethod がfalseなら、空配列でresolveされたpromise を返す。

   2. そうでなくrequestが文字列の場合：

      1. r を request を引数に Request のコンストラクタを呼び出した結果の関連 request とする。例外が発生した場合は その例外でrejectされたpromise を返す。

3. realm を this の 関連Realmとする。

4. promise を 新しいpromiseとする。

5. 以下のサブステップを 並行して実行：

   1. requests を空の リストとする。

   2. オプション引数requestが省略されている場合：

      1. 各 requestResponse について、関連リクエスト・レスポンスリスト内で：

         1. requestResponse のリクエストを requests に追加する。

   3. そうでない場合：

      1. requestResponses を Query Cache を r と options で実行した結果とする。

      2. 各 requestResponse について、requestResponses内で：

         1. requestResponse のリクエストを requests に追加する。

   4. タスクをキューに入れる。promise の 関連設定オブジェクト の 責任イベントループ で DOM操作タスクソース を使い、以下の手順を実行：

      1. requestList を リストとする。

      2. 各 request について、requests内で：

         1. 新しい Request オブジェクト（requestに関連付け、Headers オブジェクト（guard が "immutable"）付き）を requestList に追加する。

      3. promise を frozen array（requestListから生成、realmで）でresolveする。

6. promise を返す。

5.5.1. match(request, options)

match(request, options) メソッドの手順：

1. options["cacheName"] が存在する場合：

   1. 新しいpromise promise を返し、以下のサブステップを 並行して実行：

      1. 各 cacheName → cache について、関連名前 → キャッシュマップ内で：

         1. options["cacheName"] が cacheName と一致する場合：

            1. match(request, options) メソッド（requestとoptionsを渡す）を Cache インターフェースで実行し、その結果で promise をresolveする（thisArgumentとしてcacheを渡す）。

            2. これらの手順を中止する。

      2. promise をundefinedでresolveする。

2. それ以外の場合：

   1. promise を undefinedでresolveされたpromise とする。

   2. 各 cacheName → cache について、関連名前 → キャッシュマップ内で：

      1. promise を自身の settle後にreactするように設定し、引数 response を受け取るfulfillmentハンドラで以下を実行：

         1. response がundefinedでなければ response を返す。

         2. match(request, options) メソッド（requestとoptionsを渡す）を Cache インターフェースで実行し、その結果を返す（thisArgumentとしてcacheを渡す）。

   3. promise を返す。

5.5.2. has(cacheName)

has(cacheName) メソッドの手順：

1. promise を 新しいpromise とする。

2. 以下のサブステップを 並行して実行：

   1. 各 key → value について、関連名前 → キャッシュマップ内で：

      1. cacheName が key と一致すれば promise を true でresolveし、これらの手順を中止する。

   2. promise を false でresolveする。

3. promise を返す。

5.5.3. open(cacheName)

open(cacheName) メソッドの手順：

1. promise を 新しいpromise とする。

2. 以下のサブステップを 並行して実行：

   1. 各 key → value について、関連名前 → キャッシュマップ内で：

      1. cacheName が key と一致する場合：

         1. value を表す新しい Cache オブジェクトで promise をresolveする。

         2. これらの手順を中止する。

   2. cache を新しい リクエスト・レスポンスリスト とする。

   3. 関連名前 → キャッシュマップ[cacheName] に cache を設定する。このキャッシュ書き込み操作がクォータ制限超過で失敗した場合、promise を "QuotaExceededError" DOMException でrejectし、これらの手順を中止する。

   4. cache を表す新しい Cache オブジェクトで promise をresolveする。

3. promise を返す。

5.5.4. delete(cacheName)

delete(cacheName) メソッドの手順：

1. promise を has(cacheName) メソッドで cacheName を渡して実行したアルゴリズムの結果とする。

2. promise のsettle後、引数 cacheExists を受け取るfulfillmentハンドラで reactし、以下のサブステップを実行：

   1. cacheExists がfalseの場合：

      1. false を返す。

   2. cacheJobPromise を 新しいpromiseとする。

   3. 以下のサブステップを 並行して実行：

      1. 関連名前 → キャッシュマップ[cacheName] を削除する。

      2. cacheJobPromise を true でresolveする。

      注: このステップ後、既存のDOMオブジェクト（参照中のCache、Request、Responseオブジェクト）は機能を維持します。

   4. cacheJobPromise を返す。

5.5.5. keys()

keys() メソッドの手順：

1. promise を 新しいpromiseとする。

2. 以下のサブステップを 並行して実行：

   1. cacheKeys を 関連名前 → キャッシュマップ のキー取得結果とする。

      注: 結果の item（順序付き集合）は 名前 → キャッシュマップ に追加された順序です。

   2. promise を cacheKeys でresolveする。

3. promise を返す。