サービスワーカー ナイトリー

W3C 候補勧告草案,

この文書の詳細
このバージョン:
https://www.w3.org/TR/2026/CRD-service-workers-20260812/
最新版公開バージョン:
https://www.w3.org/TR/service-workers/
編集者ドラフト:
https://w3c.github.io/ServiceWorker/
以前のバージョン:
履歴:
https://www.w3.org/standards/history/service-workers/
実装レポート:
https://wpt.fyi/results/service-workers
テストスイート:
https://github.com/web-platform-tests/wpt/tree/master/service-workers
フィードバック:
GitHub
仕様内インライン
編集者:
(Microsoft)
(Google)
前任編集者:
(Google)
(Google)
(Microsoft、2018年4月までSamsungを代表)
(Google)

概要

この仕様の核となるのは、イベントを受け取るために起動されるワーカーです。これは、他の宛先が不適切である場合や、他に宛先が存在しない場合に使用できるイベントの宛先を提供します。

例えば、ページの取得方法を開発者が決定できるようにするためには、そのオリジンの他の実行コンテキストが存在する前にイベントを配送する必要があります。また、プッシュメッセージへの対応や永続的なダウンロードの完了時には、元々関心を登録したコンテキストがすでに存在しない場合があります。これらの場合、サービスワーカーが理想的なイベントの宛先となります。

この仕様はさらに、fetchイベントや、HTTPキャッシュの設計に似たリクエストとレスポンスのストアも提供し、オフライン対応のWebアプリケーションの構築を容易にします。

この文書のステータス

このセクションは、本書が公開された時点でのステータスについて説明しています。現在のW3Cの公開文書一覧とこの技術報告書の最新版は、W3C標準およびドラフト一覧で確認できます。

この文書はWebアプリケーション作業グループによって 勧告候補ドラフトとして勧告プロセスに従い公開されました。 勧告候補として公開されたことは、W3Cおよびその会員による支持を意味するものではありません。 勧告候補ドラフトは、ワーキンググループが後続の勧告候補スナップショットに含める意図がある、以前の勧告候補からの変更を統合しています。

これはドラフト文書であり、今後いつでも更新、差替え、または他の文書によって廃止される可能性があります。 本文書を進行中の作業以外のものとして引用することは不適切です。

これはリビングドキュメントです。読者は、本仕様に未実装の機能や今後細部が変更される可能性があることに注意してください。Service Workers 1は、W3C勧告に向けて進んでいるバージョンです。

この文書は、W3C特許ポリシーの下で運営されるグループによって作成されました。W3Cは、グループの成果物に関連してなされた公開特許開示リストを管理しています。そのページには特許開示の手続きも記載されています。個人が「本質的クレーム」を含む特許を実際に知っている場合には、W3C特許ポリシーのセクション6に従ってその情報を開示する必要があります。

この文書は 2025年8月18日 W3Cプロセス文書に準拠しています。

1. 動機

このセクションは規範的ではありません。

Webアプリケーションは従来、ネットワークが到達可能であることを前提としています。この前提はプラットフォーム全体に浸透しています。HTML文書はHTTP経由で読み込まれ、従来はすべてのサブリソースも後続のHTTPリクエストで取得されます。このため、Webコンテンツは他の技術スタックと比べて不利な立場に置かれます。

サービスワーカーは、Web Workerコンテキストを提供することで、このバランスを是正するために設計されました。これは、ナビゲーションが発生する際にランタイムによって起動できるイベント駆動型ワーカーです。ワーカーは、オリジンとパス(またはパターン)に対して登録されるため、その場所へのナビゲーションが発生したときに参照されます。ネットワークリクエストに対応するイベントがワーカーに配送され、ワーカーが生成するレスポンスはデフォルトのネットワークスタックの動作を上書きする場合があります。これにより、サービスワーカーは概念的にネットワークとドキュメントレンダラーの間に位置し、オフライン時でもドキュメントにコンテンツを提供することができます。

以前のオフライン問題の解決策に慣れたWeb開発者からは、それらの解決策には柔軟性が欠如していると指摘されています。その結果、サービスワーカーは非常に手続き型となり、柔軟性を最大限に高める代わりに開発者により多くの複雑さをもたらします。この複雑さの一部は、サービスワーカーを単一スレッド実行モデルでも応答性を保つ必要から生じています。そのため、サービスワーカーが公開するAPIはほぼすべて非同期であり、他のJavaScriptコンテキストにも見られるパターンですが、ここではドキュメントやリソースの読み込みをブロックしない必要性から強調されています。

HTML5アプリケーションキャッシュを利用している開発者たちは、その設計のいくつかの属性が重大な問題を引き起こし、復旧不可能なエラーにつながると報告しています。Service Workerの主要な設計原則の一つは、エラーが常に回復可能であるべきだということです。Service Workerの更新処理の多くの詳細は、これらの問題を回避するために設計されています。

Service Workerはドキュメントではなくイベントとの関係によって起動および維持されます。この設計は、Shared WorkerChrome Background Pagesに関する開発者やベンダーの経験を大いに参考にしています。これらのシステムから得られた重要な教訓は、リソースの節約およびバックグラウンドコンテキストの損失や再起動を開発者が意識できるようにするため、バックグラウンド処理コンテキストの実行時間を制限する必要があるということです。そのため、Service WorkerChrome Event Pages(Background Pagesの後継)と非常によく似ています。Service Workerドキュメントが結びついていなくてもユーザーエージェントによって起動されることがあり、ほぼいつでもユーザーエージェントによって終了される可能性があります。概念的には、Service Workerは、ドキュメントからのメッセージを一度も処理せずに開始・イベント処理・終了することができるShared Workerと捉えることができます。開発者は、Service Workerが1秒間に何度も起動や終了される可能性があることを忘れないよう注意してください。

Service Workerは、オリジンで実行される汎用的かつイベント駆動で時間制限のあるスクリプトコンテキストです。これらの特徴により、特定のドキュメントのコンテキストを超えて動作する実行時サービス(例:プッシュ通知の処理、バックグラウンドデータ同期、他オリジンからのリソース要求への応答、高コストなデータの一元的な更新受信(例:位置情報やジャイロスコープ)など)の受け口として自然に活用できます。

2. モデル

2.1. サービスワーカー

サービスワーカーは、Web Workerの一種です。サービスワーカーは、登録元のサービスワークラクライアントオリジンで実行されます。

サービスワーカーは、"parsed"、"installing"、"installed"、"activating"、"activated"、"redundant"のいずれかの状態を持ちます。初期状態は"parsed"です。

サービスワーカーは、スクリプトURLURL)を持ちます。

サービスワーカーは、"classic"または"module"のいずれかのを持ちます。特に明記されていない限り、"classic"です。

サービスワーカーは、含有サービスワーカー登録サービスワーカー登録)を持ち、自身を含みます。

サービスワーカーは、グローバルオブジェクトServiceWorkerGlobalScopeオブジェクトまたはnull)を持ちます。

サービスワーカーは、スクリプトリソーススクリプト)を持ち、自身のスクリプトリソースを表します。初期値はnullです。

スクリプトリソースは、評価済みフラグを持ちます。初期状態は未設定です。

スクリプトリソースは、ポリシーコンテナポリシーコンテナ)を持ちます。初期値は新規ポリシーコンテナです。

サービスワーカーは、スクリプトリソースマップ順序付きマップ)を持ち、キーはURL、値はレスポンスです。

サービスワーカーは、使用済みスクリプト集合集合)を持ち、要素URLです。初期値は新規集合です。

注: 使用済みスクリプト集合は、新しいワーカーのインストール後に未使用リソースをマップから削除するためだけに利用され、アップデートチェック時に古いワーカーのマップを元に構築されます。

サービスワーカーは、skip waitingフラグを持ち、特に明記されていない限り未設定です。

サービスワーカーは、クラシックスクリプトインポート済みフラグを持ち、初期状態は未設定です。

サービスワーカーは、処理対象イベントタイプ集合集合)を持ち、要素イベントリスナーのイベントタイプです。初期値は新規集合です。

サービスワーカーは、拡張イベント集合集合)を持ち、要素ExtendableEventです。初期値は新規集合です。

サービスワーカーは、nullまたはCompletionとなる開始状態を持ちます。初期値はnullです。

サービスワーカーは、全fetchリスナー空フラグを持ちます。初期状態は未設定です。

サービスワーカーは、ルーター規則リストリストRouterRuleのリスト)を持ち、初期値は空リストです。

サービスワーカーは、実行中であると言い、これはイベントループが稼働している状態です。

サービスワーカーは、[[service worker queue]]並列キュー)を持ちます。

2.1.1. ライフタイム

サービスワーカーのライフタイムはイベントの実行時間に紐付いており、サービスワークラクライアントServiceWorkerオブジェクトを保持しているかどうかには依存しません。

ユーザーエージェントは、以下の場合いつでもサービスワーカーを終了することがあります

  • 処理するイベントが存在しない場合。

  • 異常な動作(例:イベント処理中の無限ループや課せられた時間制限(存在する場合)を超えるタスク)を検出した場合。

2.1.2. イベント

Service Workers仕様は、サービスワーカーイベント(すべてイベント)を定義しており、以下を含みます(一覧参照):

2.2. サービスワーカーのタイミング

サービスワーカーは、後に ナビゲーションタイミングAPIや リソースタイミングAPI によって公開される特定の時点を記録します。

サービスワーカータイミング情報は、構造体です。次の要素を持ちます:

開始時刻

DOMHighResTimeStamp、 初期値は0。

fetchイベント配送時刻

DOMHighResTimeStamp、 初期値は0。

ワーカーのルーター評価開始時刻

DOMHighResTimeStamp、 初期値は0。

ワーカーのキャッシュ検索開始時刻

DOMHighResTimeStamp、 初期値は0。

ワーカーの一致したルーターソース

DOMString、 初期値は空文字列。

ワーカーの最終ルーターソース

DOMString、 初期値は空文字列。

2.3. サービスワーカーの登録

サービスワーカー登録は、スコープURLストレージキー、およびサービスワーカーのセット、インストール中ワーカー待機ワーカーアクティブワーカーからなるタプルです。ユーザーエージェントは、スコープURLが異なる限り、1つのオリジンで複数のサービスワーカー登録を有効にすることができます。ユーザーエージェント内ですでに存在するスコープURLと同一のサービスワーカー登録が新たに作成された場合、既存のサービスワーカー登録は置き換えられます。

サービスワーカー登録には、関連付けられたストレージキーストレージキー)があります。

サービスワーカー登録には、関連付けられたスコープURLURL)があります。

サービスワーカー登録には、関連付けられたインストール中ワーカーサービスワーカーまたはnull)があり、その状態は"installing"です。初期値はnullです。

サービスワーカー登録には、関連付けられた待機ワーカーサービスワーカーまたはnull)があり、その状態は"installed"です。初期値はnullです。

サービスワーカー登録には、関連付けられたアクティブワーカーサービスワーカーまたはnull)があり、その状態は"activating"または"activated"です。初期値はnullです。

サービスワーカー登録には、関連付けられた最終更新確認時刻があります。初期値はnullです。

サービスワーカー登録は、登録の最終更新確認時刻がnullでなく、現在時刻から登録の最終更新確認時刻を引いた秒数が86400より大きい場合、古くなっているとされます。

サービスワーカー登録には、関連付けられたキャッシュ経由での更新モードがあり、"imports"、"all"、または"none"のいずれかです。初期値は"imports"です。

サービスワーカー登録には、1つ以上のタスクキューがあり、タスクアクティブワーカーイベントループに対応するタスクキューからバックアップします。(このバックアップ操作のターゲットタスクソースは、fetch処理タスクソースおよび機能イベント処理タスクソースです。)ユーザーエージェントは、アクティブワーカー終了されたとき、アクティブワーカータスクサービスワーカー登録タスクキューにダンプし、アクティブワーカーが再起動されたときにそれらのタスクを再度キューイングします。イベントループが所有するタスクキューとは異なり、サービスワーカー登録タスクキュー自体は、いかなるイベントループによっても処理されません。

サービスワーカー登録には、関連付けられたNavigationPreloadManagerオブジェクトがあります。

サービスワーカー登録には、関連付けられたナビゲーションプリロード有効フラグがあります。初期状態は未設定です。

サービスワーカー登録には、関連付けられたナビゲーションプリロードヘッダー値バイト列)があります。初期値はtrueです。

サービスワーカー登録は、登録マップ[このストレージキーシリアライズされたスコープURL]がこのサービスワーカー登録でない場合、登録解除済みとされます。

2.3.1. ライフタイム

ユーザーエージェントは、明示的に未登録されない限り、登録済みサービスワーカー登録のリストを永続的に保持しなければなりません。ユーザーエージェントは、サービスワーカー登録の(ストレージキー, 直列化された スコープURL)のタプルと、それに対応するサービスワーカー登録を格納するregistration mapを持ちます。サービスワーカー登録のライフタイムは、対応するサービスワークラクライアントのライフタイム内でそれを表すServiceWorkerRegistrationオブジェクトのライフタイムよりも長いです。

2.4. サービスワークラクライアント

サービスワークラクライアントは、環境です。

サービスワークラクライアントは、破棄フラグを持ちます。初期状態は未設定です。

サービスワークラクライアントは、以下の環境破棄手順を持ちます:

  1. client破棄フラグを設定する。

注: 実装は、破棄フラグが設定されたクライアントを破棄することができます。

サービスワークラクライアントは、originとして定義されるアルゴリズムを持ち、サービスワークラクライアント環境設定オブジェクトの場合は、そのoriginを返し、それ以外の場合はサービスワークラクライアント作成URLoriginを返します。

ウィンドウクライアントは、サービスワークラクライアントであり、そのグローバルオブジェクトWindowオブジェクトです。

専用ワークラクライアントは、サービスワークラクライアントであり、そのグローバルオブジェクトDedicatedWorkerGlobalScopeオブジェクトです。

共有ワークラクライアントは、サービスワークラクライアントであり、そのグローバルオブジェクトSharedWorkerGlobalScopeオブジェクトです。

ワークラクライアントは、専用ワークラクライアントまたは共有ワークラクライアントのいずれかです。

2.5. 制御と利用

サービスワークラクライアントは、自身の読み込みやサブリソースのためのアクティブサービスワーカーを持ちます。サービスワークラクライアントが非nullのアクティブサービスワーカーを持つ場合、そのクライアントはそのアクティブサービスワーカーによって制御されていると言います。また、サービスワークラクライアントサービスワーカー利用されている場合、そのクライアントは含有サービスワーカー登録を利用していると言います。 サービスワークラクライアントアクティブサービスワーカーは以下のサブセクションで説明する通りに決定されます。

このセクションの残り部分は規範的ではありません。

このセクションの挙動はまだ完全には規定されておらず、HTML標準で規定される予定です。作業はissueおよびpull requestで追跡されています。

2.5.1. ウィンドウクライアントの場合

ウィンドウクライアントは、作成されるとき、ブラウジングコンテキスト作成されたときや、ナビゲーション時に作成されます。

ウィンドウクライアント作成され、ブラウジングコンテキスト作成過程にある場合:

そのブラウジングコンテキストの初期アクティブドキュメントorigin不透明なoriginの場合、ウィンドウクライアントアクティブサービスワーカーはnullになります。 それ以外の場合は、作成元ドキュメントサービスワークラクライアントアクティブサービスワーカーに設定されます。

ウィンドウクライアント作成され、ブラウジングコンテキストナビゲーション過程にある場合:

fetchHTTP fetchを経由する場合、ウィンドウクライアントアクティブサービスワーカーサービスワーカー登録一致の結果になります。 それ以外の場合、新たに作成されたドキュメントorigin不透明なoriginであるか、作成元ドキュメントorigin同一でない場合、ウィンドウクライアントアクティブサービスワーカーはnullになります。 それ以外の場合は、作成元ドキュメントサービスワークラクライアントアクティブサービスワーカーに設定されます。

注: 初回置換ナビゲーションの場合、ウィンドウクライアント作成時にブラウジングコンテキスト作成されたものが再利用されますが、アクティブサービスワーカーの決定は上記と同じ動作に従います。

注: sandboxediframeでsandbox属性にallow-same-originおよびallow-scriptsが指定されていない場合は、アクティブサービスワーカー値がnullになります。これはorigin不透明なoriginとなるためです。

2.5.2. ワークラクライアントの場合

ワークラクライアントは、ユーザーエージェントが作成し、ワーカーを実行したときに作成されます。

ワークラクライアントが作成されたとき:

fetchHTTP fetchを経由する場合、ワークラクライアントアクティブサービスワーカーサービスワーカー登録一致の結果になります。 それ以外の場合、ワークラクライアントorigin不透明なoriginである場合や、リクエストURLblob URLで、そのワークラクライアントorigin同一でない場合、最後の項目ワークラクライアントグローバルオブジェクトowner setのoriginと一致しない場合、ワークラクライアントアクティブサービスワーカーはnullになります。 それ以外の場合は、最後の項目ワークラクライアントグローバルオブジェクトowner set環境設定オブジェクトアクティブサービスワーカーに設定されます。

注: ウィンドウクライアントワークラクライアントdata: URLを持つ場合、アクティブサービスワーカー値はnullとなります。これはoriginが不透明なoriginとなるためです。ウィンドウクライアントワークラクライアントblob URLを持つ場合は、作成元ドキュメントや所有者のアクティブサービスワーカーを継承できますが、リクエストoriginが、作成元ドキュメントや所有者のorigin同一でない場合、アクティブサービスワーカーはnullになります。

2.6. タスクソース

以下の追加のタスクソースサービスワーカーで利用されます。

fetch処理タスクソース

このタスクソースは、fetchイベントをサービスワーカーへ配送するために利用されます。

機能イベント処理タスクソース

このタスクソースは、他の機能イベント(例: pushイベント)をサービスワーカーへ配送する機能で利用されます。

注: ユーザーエージェントは、特定の機能イベントでヘッドオブラインブロッキング現象を避けるため、各機能イベントタイプごとに個別のタスクソースを利用する場合があります。

2.7. ユーザーエージェントのシャットダウン

ユーザーエージェントは、保存されたサービスワーカー登録の状態を再起動時にも維持しなければなりません。ただし、以下のルールに従います:

これを実現するため、ユーザーエージェントは終了時にユーザーエージェントのシャットダウン処理を呼び出す必要があります

3. クライアントコンテキスト

サービスワーカーによるブートストラップ:
// スコープはデフォルトでスクリプトが存在するパスになります
// この例では "/" です
navigator.serviceWorker.register("/serviceworker.js").then(registration => {
  console.log("success!");
  if (registration.installing) {
    registration.installing.postMessage("インストール中のページからこんにちは");
  }
}, err => {
  console.error("ワーカーのインストールに失敗しました!", err);
});

3.1. ServiceWorker

[SecureContext, Exposed=(Window,Worker)]
interface ServiceWorker : EventTarget {
  readonly attribute USVString scriptURL;
  readonly attribute ServiceWorkerState state;
  undefined postMessage(any message, sequence<object> transfer);
  undefined postMessage(any message, optional StructuredSerializeOptions options = {});

  // event
  attribute EventHandler onstatechange;
};
ServiceWorker includes AbstractWorker;

enum ServiceWorkerState {
  "parsed",
  "installing",
  "installed",
  "activating",
  "activated",
  "redundant"
};

ServiceWorker オブジェクトは サービスワーカーを表します。各 ServiceWorker オブジェクトは サービスワーカー に関連付けられます。複数のドキュメントやワーカーで ServiceWorker インターフェースを実装する個別のオブジェクトが、同じ サービスワーカー に同時に関連付けられることができます。

ServiceWorker オブジェクトは ServiceWorkerState オブジェクトを持ち、これは サービスワーカーstate に関連付けられています。

3.1.1. ServiceWorker インスタンスの取得

環境設定オブジェクトサービスワーカーオブジェクトマップマップ)を持ち、キーサービスワーカーServiceWorker オブジェクトです。

service worker オブジェクトの取得serviceWorkerサービスワーカー)を environment環境設定オブジェクト)で表す場合、以下の手順を実行する:
  1. objectMapenvironmentサービスワーカーオブジェクトマップとする。

  2. objectMap[serviceWorker] が 存在しない場合:

    1. serviceWorkerObjenvironmentRealm で新規作成した ServiceWorker とし、serviceWorker に関連付ける。

    2. serviceWorkerObjstateserviceWorkerstate に設定する。

    3. objectMap[serviceWorker] に serviceWorkerObj を設定する。

  3. objectMap[serviceWorker] を返す。

3.1.2. scriptURL

scriptURL ゲッター手順は、サービスワーカー直列化された script url を返す。

例:https://example.com/app.htmlへのナビゲーションで作成されたドキュメントが、次の登録呼び出しによって(事前に実行済み)マッチされた場合:
// ページ https://example.com/app.html 上のスクリプト
navigator.serviceWorker.register("/service_worker.js");

navigator.serviceWorker.controller.scriptURL の値は "https://example.com/service_worker.js" となります。

3.1.3. state

state 属性は、(ServiceWorkerState列挙)で最後に設定された値を返さなければなりません

3.1.4. postMessage(message, transfer)

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

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

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

3.1.5. postMessage(message, options)

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

  1. serviceWorkerサービスワーカーthisで表現される)とする。

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

  3. incumbentGlobalincumbentSettingsグローバルオブジェクトとする。

  4. serializeWithTransferResultStructuredSerializeWithTransfer(message, options["transfer"])の結果とする。 例外が発生した場合はそのまま投げる。

  5. Should Skip Eventアルゴリズムを"message"と serviceWorkerで実行し、その結果がtrueなら終了。

  6. 以下のサブステップを並列処理する:

    1. Run Service Workerアルゴリズムを serviceWorkerで実行し、結果がfailureなら終了。

    2. タスクをキューDOM操作タスクソース上で 以下を実行:

      1. sourceincumbentGlobal の型によって以下のように決定:

        ServiceWorkerGlobalScope
        incumbentGlobalservice worker関連設定オブジェクトserviceWorkerグローバルオブジェクトで表す)の サービスワーカーオブジェクト取得結果
        Window
        incumbentGlobal関連設定オブジェクト を表す新しい WindowClient オブジェクト
        その他
        incumbentGlobal の関連ワーカーを表す新しい Client オブジェクト
      2. originincumbentSettingsoriginとする。

      3. destinationserviceWorker に紐付いた ServiceWorkerGlobalScope オブジェクトとする。

      4. deserializeRecordStructuredDeserializeWithTransfer(serializeWithTransferResult, destinationRealm) の結果とする。

        例外なら eevent作成(名前: messageerrorExtendableMessageEvent 使用)として originoriginsource 属性を source で初期化したものとする。

      5. Else:

        1. messageClonedeserializeRecord.[[Deserialized]]とする。

        2. newPorts を 新しい 凍結配列 とし、deserializeRecord.[[TransferredValues]]内の全ての MessagePort オブジェクト(順序維持)を格納する。

        3. eevent作成(名前: messageExtendableMessageEvent 使用) として、 originoriginsource 属性を sourcedata 属性を messageCloneports 属性を newPorts で初期化したものとする。

      6. eをdestinationにディスパッチ する。

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

3.1.6. イベントハンドラー

以下は イベントハンドラー(および対応する イベントハンドラーイベントタイプ)であり、すべての ServiceWorker インターフェース実装オブジェクトで イベントハンドラーIDL属性としてサポートしなければなりません

event handler event handler event type
onstatechange statechange

3.2. ServiceWorkerRegistration

[SecureContext, Exposed=(Window,Worker)]
interface ServiceWorkerRegistration : EventTarget {
  readonly attribute ServiceWorker? installing;
  readonly attribute ServiceWorker? waiting;
  readonly attribute ServiceWorker? active;
  [SameObject] readonly attribute NavigationPreloadManager navigationPreload;

  readonly attribute USVString scope;
  readonly attribute ServiceWorkerUpdateViaCache updateViaCache;

  [NewObject] Promise<ServiceWorkerRegistration> update();
  [NewObject] Promise<boolean> unregister();

  // event
  attribute EventHandler onupdatefound;
};

enum ServiceWorkerUpdateViaCache {
  "imports",
  "all",
  "none"
};

ServiceWorkerRegistrationは、サービスワーカー登録サービスワーカー登録)を持ちます。

3.2.1. ServiceWorkerRegistrationインスタンスの取得

環境設定オブジェクトは、サービスワーカー登録オブジェクトマップを持ちます。これは、マップであり、キーサービスワーカー登録ServiceWorkerRegistrationオブジェクトです。

サービスワーカー登録オブジェクトの取得registrationサービスワーカー登録)をenvironment環境設定オブジェクト)で表す場合、以下の手順を実行する:
  1. objectMapenvironmentサービスワーカー登録オブジェクトマップとする。

  2. objectMap[registration]が存在しない場合:

    1. registrationObjectenvironmentRealmで新規作成したServiceWorkerRegistrationとする。

    2. registrationObjectサービスワーカー登録registrationに設定する。

    3. registrationObjectinstalling属性をnullに設定する。

    4. registrationObjectwaiting属性をnullに設定する。

    5. registrationObjectactive属性をnullに設定する。

    6. registrationinstalling workerがnullでない場合、registrationObjectinstalling属性をregistrationinstalling workerenvironmentで表すサービスワーカーオブジェクト取得の結果に設定する。

    7. registrationwaiting workerがnullでない場合、registrationObjectwaiting属性をregistrationwaiting workerenvironmentで表すサービスワーカーオブジェクト取得の結果に設定する。

    8. registrationactive workerがnullでない場合、registrationObjectactive属性をregistrationactive workerenvironmentで表すサービスワーカーオブジェクト取得の結果に設定する。

    9. objectMap[registration]にregistrationObjectを設定する。

  3. objectMap[registration]を返す。

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

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

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

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

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

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

3.2.5. navigationPreload

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

3.2.6. scope

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

§ 3.1.2 scriptURLの例では、registration.scope(例えばnavigator.serviceWorker.ready.then(registration => console.log(registration.scope))で取得)は"https://example.com/"となります。

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関連グローバルオブジェクトglobalObjectServiceWorkerGlobalScopeオブジェクトであり、globalObjectの関連サービスワーカーのstateが"installing"の場合、失敗したpromise("InvalidStateError"DOMException)を返して中断。

  5. promisepromiseとする。

  6. jobジョブ作成アルゴリズムで、update、registrationstorage keyregistrationscope urlnewestWorkerscript urlpromisethis関連設定オブジェクトを引数に実行した結果にする。

  7. jobworker typenewestWorkertypeに設定する。

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

  9. promiseを返す。

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

unregister()メソッド手順:

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

  2. promise新規promiseとする。

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

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

  5. promiseを返す。

3.2.10. イベントハンドラー

以下はイベントハンドラー(および対応するイベントハンドラーイベントタイプ)であり、すべてのServiceWorkerRegistrationインターフェース実装オブジェクトでイベントハンドラーIDL属性としてサポートしなければなりません

event handler event handler event type
onupdatefound updatefound
partial interface Navigator {
  [SecureContext, SameObject] readonly attribute ServiceWorkerContainer serviceWorker;
};

partial interface WorkerNavigator {
  [SecureContext, SameObject] readonly attribute ServiceWorkerContainer serviceWorker;
};

serviceWorker ゲッターの手順は、ServiceWorkerContainer オブジェクトをthisに関連付けて返すことです。

3.4. ServiceWorkerContainer

[SecureContext, Exposed=(Window,Worker)]
interface ServiceWorkerContainer : EventTarget {
  readonly attribute ServiceWorker? controller;
  readonly attribute Promise<ServiceWorkerRegistration> ready;

  [NewObject] Promise<ServiceWorkerRegistration> register((TrustedScriptURL or USVString) scriptURL, optional RegistrationOptions options = {});

  [NewObject] Promise<(ServiceWorkerRegistration or undefined)> getRegistration(optional USVString clientURL = "");
  [NewObject] Promise<FrozenArray<ServiceWorkerRegistration>> getRegistrations();

  undefined startMessages();


  // events
  attribute EventHandler oncontrollerchange;
  attribute EventHandler onmessage; // event.source of message events is ServiceWorker object
  attribute EventHandler onmessageerror;
};
dictionary RegistrationOptions {
  USVString scope;
  WorkerType type = "classic";
  ServiceWorkerUpdateViaCache updateViaCache = "imports";
};

ユーザーエージェントは、ServiceWorkerContainer オブジェクトをNavigator オブジェクトまたはWorkerNavigator オブジェクト作成時に生成し、それらのオブジェクトに関連付けなければなりません。

ServiceWorkerContainer は、サービスワーカー登録の登録・解除・更新の機能を提供し、サービスワーカー登録およびそれに関連するサービスワーカーの状態へのアクセスを提供します。

ServiceWorkerContainer は、関連するサービスワークラクライアントを持ちます。これは、サービスワークラクライアントであり、そのグローバルオブジェクトNavigator またはWorkerNavigator オブジェクトに関連付けられています。

ServiceWorkerContainer オブジェクトは、関連するready promisepromiseまたはnull)を持ちます。初期値はnullです。

ServiceWorkerContainer オブジェクトは、タスクソースとしてクライアントメッセージキュー(初期値は空)を持ちます。クライアントメッセージキューは有効・無効にでき、初期状態は無効です。ServiceWorkerContainer オブジェクトのクライアントメッセージキューが有効な場合、イベントループはそれをタスクソースの一つとして使用しなければなりませんServiceWorkerContainer オブジェクトの関連グローバルオブジェクトWindow オブジェクトの場合、すべてのタスクキューされる際、クライアントメッセージキューに関連付けられ、その関連設定オブジェクト関連ドキュメントに紐付けられます。

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

  1. clientthisサービスワークラクライアントとする。

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

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

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

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

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

  2. readyPromisethisready promiseとする。

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

    1. clientthisサービスワークラクライアントとする。

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

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

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

  4. readyPromiseを返す。

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

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

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

  1. pプロミスとする。

  2. scriptURLに、TrustedScriptURLthis関連グローバルオブジェクトscriptURL、"ServiceWorkerContainer register"、および"script"を引数に、Get Trusted Type compliant stringを呼び出した結果を設定する。

  3. clientに、thisservice workerクライアントを設定する。

  4. scriptURLに、this関連設定オブジェクトAPI基準URLscriptURL構文解析した結果を設定する。

  5. scopeURLをnullにする。

  6. もしoptions["scope"] が存在する場合、options["scope"] をthis関連設定オブジェクトAPI基準URL構文解析した結果をscopeURLに設定する。

  7. Start Registerを、 scopeURLscriptURLpclientclient作成URLoptions["type"], およびoptions["updateViaCache"] を引数として呼び出す。

  8. pを返す。

getRegistration(clientURL) メソッド手順:

  1. clientを、これサービスワーカークライアントとする。

  2. storage keyを、clientを与えてストレージキーを取得するを実行した結果とする。

  3. clientURLを、これ関連設定オブジェクトAPI基底URLを用いてclientURL構文解析した結果とする。

  4. clientURLが失敗である場合、TypeErrorで拒否されたプロミスを返す。

  5. clientURLフラグメントをnullに設定する。

  6. clientURLオリジンが、 clientオリジンでない場合、「SecurityErrorDOMExceptionで拒否されたpromiseを返す。

  7. promiseを新しいプロミスとする。

  8. 次の下位手順を並列に実行する:

    1. registrationを、storage keyおよびclientURLを与えてサービスワーカー登録を照合するを実行した結果とする。

    2. promise関連設定オブジェクト担当イベントループ上で、DOM操作タスクソースを使用して、次の手順を実行するタスクをキューに入れる

      1. registrationがnullである場合、promiseを undefinedで解決し、これらの手順を中止する。

      2. promiseを、promise関連設定オブジェクト内で registrationを表すサービスワーカー登録オブジェクトを取得する結果で解決する。

  9. promiseを返す。

getRegistrations() メソッド手順:

  1. clientを、これサービスワーカー クライアントとする。

  2. client storage keyを、clientを与えてストレージキーを取得するを実行した結果とする。

  3. promise新しい プロミスとする。

  4. 次の手順を並列に実行する:

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

    2. 登録マップの (storage key, scope) → registrationについて:

      1. storage keyclient storage key等しい場合、 registrationregistrations付加する

    3. promise関連設定オブジェクト担当イベントループ上で、DOM操作タスクソースを使用して、 次の手順を実行するタスクをキューに入れる

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

      2. registrationsの各registrationについて反復する

        1. registrationObjを、promise関連設定 オブジェクト内でregistrationを表すサービスワーカー登録オブジェクトを 取得する結果とする。

        2. registrationObjregistrationObjects付加する

      3. promiseを、promise関連レルム内の registrationObjects新しい固定配列で解決する。

  5. promiseを返す。

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

3.4.7. イベントハンドラー

以下はイベントハンドラー(および対応するイベントハンドラーイベントタイプ)であり、すべてのServiceWorkerContainer インターフェース実装オブジェクトでイベントハンドラーIDL属性としてサポートしなければなりません

event handler event handler event type
oncontrollerchange controllerchange
onmessage message
onmessageerror messageerror

初めてonmessage セッター手順が実行された時、thisクライアントメッセージキューを有効化します。

3.5. イベント

以下のイベントは ServiceWorker オブジェクト上で配送されます:

イベント名 インターフェース 配送タイミング
statechange Event state 属性が ServiceWorker オブジェクトで変更されたとき。

以下のイベントは ServiceWorkerRegistration オブジェクト上で配送されます:

イベント名 インターフェース 配送タイミング
updatefound Event サービスワーカー登録installing worker が変更されたとき(Installアルゴリズムのステップ8参照)。

以下のイベントは ServiceWorkerContainer オブジェクト上で配送されます:

イベント名 インターフェース 配送タイミング
controllerchange Event サービスワークラクライアントアクティブサービスワーカーが変更されたとき(Activateアルゴリズムのステップ9.2参照。skip waitingフラグ付きのサービスワーカーactivationサービスワーカー登録サービスワークラクライアント利用されている間に発生させ、navigator.serviceWorker.controller は即座に active worker を、そのサービスワーカー制御するサービスワークラクライアントとして即座に反映します。)
message MessageEvent サービスワークラクライアントサービスワーカーからメッセージを受信したとき。postMessage(message, options)参照。
messageerror MessageEvent サービスワークラクライアントサービスワーカーからデシリアライズできないメッセージを受信したとき。postMessage(message, options)参照。
[SecureContext, Exposed=(Window,Worker)]
interface NavigationPreloadManager {
  Promise<undefined> enable();
  Promise<undefined> disable();
  Promise<undefined> setHeaderValue(ByteString value);
  Promise<NavigationPreloadState> getState();
};

dictionary NavigationPreloadState {
  boolean enabled = false;
  ByteString headerValue;
};

enable() メソッドの手順:

  1. promise新しい プロミスとする。

  2. 次の手順を並列に実行する:

    1. registrationthis に 関連付けられたサービスワーカー登録とする。

    2. registrationアクティブワーカーが null の場合、promiseタスクをキューに入れる。これは promise関連する設定オブジェクト担当イベントループ上で、DOM 操作タスクソースを使用し、 promise を "InvalidStateError" DOMException拒否するためのものであり、 これらの手順を中止する。

    3. registrationナビゲーション プリロード有効フラグを設定する。

    4. promiseタスクをキューに入れる。これは promise関連する設定オブジェクト担当イベントループ上で、DOM 操作タスクソースを使用し、 promise を undefined で解決するためのものである。

  3. promise を返す。

disable() メソッドの手順:

  1. promise新しい promise とする。

  2. 次の手順を 並列に 実行する:

    1. registrationthis に関連付けられた service worker registration とする。

    2. registrationactive worker が null なら、promiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して、reject するための task をキューに入れpromise を "InvalidStateError" の DOMException で reject し、 これらの手順を中止する。

    3. registrationnavigation preload enabled flag を解除する。

    4. promiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して、 promise を undefined で resolve するための task をキューに入れる

  3. promise を返す。

setHeaderValue(value) メソッドの手順:

  1. value正規化 した結果を value とする。

  2. valueheader value でない場合、TypeErrorreject された promise を返す。

  3. promise新しい promise とする。

  4. 次の手順を 並列に 実行する:

    1. registrationthis に関連付けられた service worker registration とする。

    2. registrationactive worker が null なら、promiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して、reject するための task をキューに入れpromise を "InvalidStateError" の DOMException で reject し、 これらの手順を中止する。

    3. registrationnavigation preload header valuevalue に設定する。

    4. promiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して、 promise を undefined で resolve するための task をキューに入れる

  5. promise を返す。

getState() メソッドの手順:

  1. promise新しい promise とする。

  2. 次の手順を 並列に 実行する:

    1. registrationthis に関連付けられた service worker registration とする。

    2. state を新しい NavigationPreloadState 辞書とする。

    3. registrationnavigation preload enabled flag が設定されている場合、state["enabled"] を true に設定する。

    4. state["headerValue"] を registrationnavigation preload header value に設定する。

    5. promiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して promisestate で resolve するための task をキューに入れる

  3. promise を返す。

4. 実行コンテキスト

キャッシュされたリソースの提供:
// caching.js
self.addEventListener("install", event => {
  event.waitUntil(
    // リソースのキャッシュを開く。
    caches.open("shell-v1").then(cache => {
      // それらの取得処理を開始する。全てのリソースが保存された場合のみ成功。
      // 一つでも失敗すると、全体の操作は失敗となる。
      return cache.addAll([
        "/app.html",
        "/assets/v1/base.css",
        "/assets/v1/app.js",
        "/assets/v1/logo.png",
        "/assets/v1/intro_video.webm"
      ]);
    })
  );
});

self.addEventListener("fetch", event => {
  // Service Workerが正常にインストール・アクティベートされるまで、"fetch"イベントはディスパッチされない。

  // キャッシュ操作は全て非同期で行われるため、URL照合を含めPromiseを多用する。e.respondWith()もPromiseを受け付ける:
  event.respondWith(
    caches.match(e.request).then(response => {
      return response || fetch(e.request);
    }).catch(() => {
      return caches.match("/fallback.html");
    })
  );
});

4.1. ServiceWorkerGlobalScope

[Global=(Worker,ServiceWorker), Exposed=ServiceWorker, SecureContext]
interface ServiceWorkerGlobalScope : WorkerGlobalScope {
  [SameObject] readonly attribute Clients clients;
  [SameObject] readonly attribute ServiceWorkerRegistration registration;
  [SameObject] readonly attribute ServiceWorker serviceWorker;

  [NewObject] Promise<undefined> skipWaiting();

  attribute EventHandler oninstall;
  attribute EventHandler onactivate;
  attribute EventHandler onfetch;

  attribute EventHandler onmessage;
  attribute EventHandler onmessageerror;
};

ServiceWorkerGlobalScope オブジェクトは、Service Worker のグローバルな実行コンテキストを表します。

ServiceWorkerGlobalScope オブジェクトは、関連付けられた service workerService Worker)を持ちます。

ServiceWorkerGlobalScope オブジェクトには、import scripts用キャッシュ強制バイパスフラグ が関連付けられています。初期状態では未設定です。

ServiceWorkerGlobalScope オブジェクトには、race response map が関連付けられています。これは 順序付きマップ であり、キーリクエスト で、 race response です。

race response は、構造体 であり、"race-network-and-fetch-handler" が実行された際のネットワークレスポンスを保持するために使われます。これは valueresponse、"pending" または null)を持ちます。

注: ServiceWorkerGlobalScope オブジェクトは、オリジンで実行される汎用的なイベント駆動型・時間制限付きスクリプトの実行コンテキストを提供します。 正常に 登録 されると、 Service Worker が起動し、 イベントとの関係によって存続・終了されます。 Service Workerクライアント との直接的な関係では存続しません。 Service Worker内で同期リクエストは開始しないでください。

4.1.1. clients

clients のgetterは、 Clients オブジェクト(this に関連するもの)を返します。

4.1.2. registration

registration のgetterは、 サービスワーカー登録オブジェクトの取得 の結果を返します。 これは thisservice worker含まれるService Worker登録該当設定オブジェクト内で表します。

4.1.3. serviceWorker

serviceWorker のgetterは、 Service Workerオブジェクトの取得 の結果を返します。 これは thisservice worker を、 該当設定オブジェクト内で表します。

4.1.4. skipWaiting()

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

skipWaiting() メソッドの手順:

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

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

    1. service workerskip waitingフラグ を設定する。

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

    3. タスクをキューに追加するサービスワーカー担当イベントループ上で、promise を undefined で解決する。

  3. promise を返す。

4.1.5. イベントハンドラ

以下は、イベントハンドラ (対応する イベント型)であり、 ServiceWorkerGlobalScope インターフェースを実装する全てのオブジェクトで 必ず サポートされるべき イベントハンドラIDL属性 です:

イベントハンドラ イベント型
oninstall install
onactivate activate
onfetch fetch
onmessage message
onmessageerror messageerror

4.2. Client

[Exposed=ServiceWorker]
interface Client {
  readonly attribute USVString url;
  readonly attribute FrameType frameType;
  readonly attribute DOMString id;
  readonly attribute ClientType type;
  undefined postMessage(any message, sequence<object> transfer);
  undefined postMessage(any message, optional StructuredSerializeOptions options = {});
};

[Exposed=ServiceWorker]
interface WindowClient : Client {
  readonly attribute VisibilityState visibilityState;
  readonly attribute boolean focused;
  [SameObject] readonly attribute FrozenArray<USVString> ancestorOrigins;
  [NewObject] Promise<WindowClient> focus();
  [NewObject] Promise<WindowClient?> navigate(USVString url);
};

enum FrameType {
  "auxiliary",
  "top-level",
  "nested",
  "none"
};

Client オブジェクトには、関連付けられた service worker clientservice worker client)があります。

Client オブジェクトには、関連付けられた frame type(フレームタイプ)があり、"auxiliary"、"top-level"、"nested"、"none" のいずれかです。特に記載がなければ "none" となります。

WindowClient オブジェクトには、関連付けられた 閲覧コンテキスト(browsing context)があり、これはその service worker clientグローバルオブジェクト閲覧コンテキストです。

WindowClient オブジェクトは、visibility state(可視性状態)を持ちます。これはvisibilityState 属性値のいずれかです。

WindowClient オブジェクトには、関連付けられた フォーカス状態(focus state)があり、true または false(初期値は false)です。

WindowClient オブジェクトには、関連付けられた 先祖オリジン配列(ancestor origins array)があります。

4.2.1. url

url のgetter手順は、this に関連付けられた service worker client直列化された 作成URL を返します。

4.2.2. frameType

frameType のgetter手順は、thisframe type を返します。

4.2.3. id

id のgetter手順は、this に関連付けられた service worker clientid を返します。

4.2.4. type

type のgetter手順:

  1. clientthisservice worker client とする。

  2. clientenvironment settings object なら:

    1. clientwindow client なら "window" を返す。

    2. そうでなく、clientdedicated worker client なら "worker" を返す。

    3. さらにそうでなく、clientshared worker client なら "sharedworker" を返す。

  3. それ以外の場合:

    1. "window" を返す。

4.2.5. postMessage(message, transfer)

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

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

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

4.2.6. postMessage(message, options)

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

  1. contextObjectthis とする。

  2. sourceSettingscontextObjectrelevant settings object とする。

  3. serializeWithTransferResultStructuredSerializeWithTransfer(message, options["transfer"]) とする。 例外はあれば再スローする。

  4. 次の手順を 並列に 実行する:

    1. targetClient を null とする。

    2. service worker client client について:

      1. clientcontextObjectservice worker client である場合、targetClientclient に設定し、 そして break する。

    3. targetClient が null の場合、return する。

    4. destination を、関連付けられた service worker clienttargetClient である ServiceWorkerContainer オブジェクトとする。

    5. 次の手順を実行する task を、destinationclient message queue に追加する:

      1. originsourceSettingsorigin とする。

      2. source を、contextObjectrelevant global objectservice workertargetClient 内で表す service worker object の取得 の結果とする。

      3. deserializeRecordStructuredDeserializeWithTransfer(serializeWithTransferResult, destinationrelevant Realm) とする。

        これが例外を投げた場合、それを捕捉し、destinationmessageerror という名前の event を発火 する。MessageEvent を使用し、 その originorigin で初期化し、source 属性を source で初期化し、その後これらの手順を中止する。

      4. messageClonedeserializeRecord.[[Deserialized]] とする。

      5. newPorts を、deserializeRecord.[[TransferredValues]] 内の すべての MessagePort オブジェクト(存在する場合)から成る新しい frozen array とする。

      6. destinationmessage という名前の event をディスパッチ する。MessageEvent を使用し、 その originorigin で初期化し、source 属性を source で初期化し、data 属性を messageClone で初期化し、ports 属性を newPorts で初期化する。

4.2.7. visibilityState

visibilityState のgetter手順は、this可視状態 を返します。

4.2.8. focused

focused のgetter手順は、thisフォーカス状態 を返します。

4.2.9. ancestorOrigins

ancestorOrigins のgetter手順は、this に関連付けられた 先祖オリジン配列 を返します。

4.2.10. focus()

focus() メソッド手順:

  1. この origin 内のいずれの Windowtransient activation を持たない場合、"InvalidAccessError" の DOMException で reject された promise を返す。

  2. serviceWorkerEventLoop を、surrounding agentevent loop とする。

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

  4. task をキューに入れthis に関連付けられた service worker clientresponsible event loop 上で、user interaction task source を使用して次の手順を実行する:

    1. focusing stepsthisbrowsing context で実行する。

    2. frameType を、Get Frame Typethisbrowsing context で実行した結果とする。

    3. visibilityStatethisbrowsing contextactive documentvisibilityState 属性値とする。

    4. focusState を、has focus stepsthisbrowsing contextactive document で実行した結果とする。

    5. ancestorOriginsListthisbrowsing contextactive documentancestor origins list の関連付けられたリストとする。

    6. task をキューに入れDOM manipulation task source を使用して serviceWorkerEventLoop 上で次の手順を実行する:

      1. windowClient を、Create Window Clientthis に関連付けられた service worker clientframeTypevisibilityStatefocusState、および ancestorOriginsList で実行した結果とする。

      2. windowClientfocus state が true の場合、promisewindowClient で resolve する。

      3. それ以外の場合、promiseTypeError で reject する。

  5. promise を返す。

4.2.11. navigate(url)

navigate(url) メソッド手順:

  1. url を、parsingurlthisrelevant settings objectAPI base URL で実行した結果とする。

  2. url が failure の場合、TypeError で reject された promise を返す。

  3. urlabout:blank の場合、TypeError で reject された promise を返す。

  4. this に関連付けられた service worker clientactive service workerthisrelevant global objectservice worker でない場合、promiseTypeError で reject して返す。

  5. serviceWorkerEventLoop を、current global objectevent loop とする。

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

  7. task をキューに入れthis に関連付けられた service worker clientresponsible event loop 上で、user interaction task source を使用して次の手順を実行する:

    1. browsingContextthisbrowsing context とする。

    2. browsingContextassociated documentfully active でない場合、task をキューに入れpromiseTypeError で reject する。serviceWorkerEventLoop 上で DOM manipulation task source を使用し、これらの手順を中止する。

    3. HandleNavigate: NavigatebrowsingContext から url へ、browsingContextassociated document を用いて、exceptionsEnabled を true として実行する。

    4. HandleNavigate とラベル付けされた手順で呼び出されたアルゴリズムの手順が throws した場合、task をキューに入れpromise を その例外で reject する。serviceWorkerEventLoop 上で DOM manipulation task source を使用し、これらの手順を中止する。

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

    6. visibilityStatebrowsingContextactive documentvisibilityState 属性値とする。

    7. focusState を、has focus stepsbrowsingContextactive document で実行した結果とする。

    8. ancestorOriginsListbrowsingContextactive documentancestor origins list の関連付けられたリストとする。

    9. task をキューに入れDOM manipulation task source を使用して serviceWorkerEventLoop 上で次の手順を実行する:

      1. browsingContextWindow オブジェクトの environment settings objectcreation URLorigin が、sameservice workerorigin と一致しない場合、 promise を null で resolve し、これらの手順を中止する。

      2. windowClient を、Create Window Clientthisservice worker clientframeTypevisibilityStatefocusState、および ancestorOriginsList で実行した結果とする。

      3. promisewindowClient で resolve する。

  8. promise を返す。

4.3. Clients

[Exposed=ServiceWorker]
interface Clients {
  // The objects returned will be new instances every time
  [NewObject] Promise<(Client or undefined)> get(DOMString id);
  [NewObject] Promise<FrozenArray<Client>> matchAll(optional ClientQueryOptions options = {});
  [NewObject] Promise<WindowClient?> openWindow(USVString url);
  [NewObject] Promise<undefined> claim();
};
dictionary ClientQueryOptions {
  boolean includeUncontrolled = false;
  ClientType type = "window";
};
enum ClientType {
  "window",
  "worker",
  "sharedworker",
  "all"
};

ユーザーエージェントは ServiceWorkerGlobalScope オブジェクトが作成されるとき、必ず Clients オブジェクトを作成し、そのオブジェクトに関連付けなければならない。

4.3.1. get(id)

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

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

  2. これらのサブステップを 並列に 実行する:

    1. 与えられた client に対して obtain a storage key を実行した結果が、関連付けられた service workercontaining service worker registrationstorage keyequals である各 service worker client client について:

      1. clientidid でない場合、continue する。

      2. clientexecution ready flag が設定されるか、または clientdiscarded flag が設定されるまで待機する。

      3. clientexecution ready flag が設定されている場合、promiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して、次の手順を実行するための task をキューに入れる

        1. Resolve Get Client Promiseclientpromise で呼び出す。

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

    2. promiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して promise を undefined で resolve するための task をキューに入れる

  3. promise を返す。

4.3.2. matchAll(options)

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

  1. promise新しい プロミスとする。

  2. 次の手順を並列に実行する。

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

    2. client を与えてストレージキーを取得するを実行した結果が、 関連付けられたサービスワーカー包含サービス ワーカー登録ストレージキー等しい、各サービスワーカークライアント client について、次を実行する。

      1. client実行 準備完了フラグが設定されていないか、client破棄済み フラグが設定されている場合、続行する

      2. clientセキュアコンテキストでない場合、続行する

      3. options["includeUncontrolled"] が false であり、かつ clientアクティブな サービスワーカーが、関連付けられたサービス ワーカーでない場合、続行する

      4. clienttargetClients に追加する。

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

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

    5. targetClients 内の各サービスワーカークライアント client について、次を実行する。

      1. options["type"] が "window" または "all" であり、かつ client環境設定 オブジェクトでないか、またはウィンドウクライアントである場合、次を実行する。

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

        2. browsingContext を null とする。

        3. isClientEnumerable を true とする。

        4. client環境 設定オブジェクトである場合、browsingContextclientグローバル オブジェクト閲覧コンテキストに設定する。

        5. そうでない場合、browsingContextclient対象 閲覧コンテキストに設定する。

        6. タスクをキューに追加するtask が、ユーザーインタラクション タスクソースを使用して、browsingContextイベントループ上で次の副手順を実行する。

          1. browsingContext破棄されている場合、 isClientEnumerable を false に設定し、これらの 手順を中止する。

          2. client がウィンドウクライアントであり、 client関連付けられた 文書browsingContextアクティブな文書でない場合、 isClientEnumerable を false に設定し、これらの 手順を中止する。

          3. windowData["frameType"] を、 browsingContext を用いてフレーム型を取得するを実行した 結果に設定する。

          4. windowData["visibilityState"] を、browsingContextアクティブな文書visibilityState 属性値に設定する。

          5. windowData["focusState"] を、 browsingContextアクティブな文書を引数として、 フォーカスを持つかの手順 を実行した結果に設定する。

          6. clientウィンドウクライアント である場合、 windowData["ancestorOriginsList"] を browsingContextアクティブな文書祖先 オリジンリストに関連付けられたリストに設定する。

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

          注記: 待機は ブロッキング待機であるが、実装者は状態が壊れない限り、反復を並列に 実行してもよい。

        8. isClientEnumerable が true である場合、次を実行する。

          1. windowDatamatchedWindowData に追加する。

      2. そうでなく、options["type"] が "worker" または "all" であり、かつ client専用ワーカー クライアントであるか、または options["type"] が "sharedworker" または "all" であり、かつ client共有ワーカークライアント である場合、次を実行する。

        1. clientmatchedClients に追加する。

    6. task をキューに入れ、次の手順を promiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して実行する:

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

      2. matchedWindowData 内の各 windowData について、次を実行する

        1. windowClient を、 windowData["client"]、 windowData["frameType"]、 windowData["visibilityState"]、 windowData["focusState"]、および windowData["ancestorOriginsList"] を 引数としてウィンドウクライアントを作成する アルゴリズムを実行した結果とする。

        2. windowClientclientObjects付加する

      3. matchedClients 内の各 client について、次を実行する

        1. clientObject を、client を引数としてクライアントを作成するアルゴリズムを実行した 結果とする。

        2. clientObjectclientObjects付加する

      4. clientObjects を次のように並べ替える。

        注記: ウィンドウクライアントは常に ワーカークライアントより前に 配置される。

      5. promise関連 Realmにおいて、 clientObjects新しい固定配列promise を解決する。

  3. promise を返す。

4.3.3. openWindow(url)

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

  1. url を、parsingurlthisrelevant settings objectAPI base URL で実行した結果とする。

  2. url が failure の場合、TypeError で reject された promise を返す。

  3. urlabout:blank の場合、TypeError で reject された promise を返す。

  4. この origin 内のいずれの Windowtransient activation を持たない場合、"InvalidAccessError" の DOMException で reject された promise を返す。

  5. serviceWorkerEventLoop を、current global objectevent loop とする。

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

  7. これらのサブステップを 並列に 実行する:

    1. newContext を新しい top-level browsing context とする。

    2. task をキューに入れ、次の手順を newContextWindow オブジェクトの environment settings objectresponsible event loop 上で、user interaction task source を使用して実行する:

      1. HandleNavigate: NavigatenewContext から url へ、exceptionsEnabled を true、 かつ historyHandling を "replace" として実行する。

      2. HandleNavigate とラベル付けされた手順で呼び出されたアルゴリズムの手順が throws した場合、task をキューに入れpromise をその例外で reject する。 serviceWorkerEventLoop 上で DOM manipulation task source を使用し、これらの手順を中止する。

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

      4. visibilityStatenewContextactive documentvisibilityState 属性値とする。

      5. focusState を、has focus stepsnewContextactive document を引数として実行した結果とする。

      6. ancestorOriginsListnewContextactive documentancestor origins list の関連付けられたリストとする。

      7. task をキューに入れ、次の手順を serviceWorkerEventLoop 上で DOM manipulation task source を使用して実行する:

        1. obtain a storage keynewContextWindow オブジェクトの environment settings object で実行した結果が、equalservice workercontaining service worker registrationstorage key と一致しない場合、promise を null で resolve し、 これらの手順を中止する。

        2. client を、Create Window ClientnewContextWindow オブジェクトの environment settings objectframeTypevisibilityStatefocusState、および ancestorOriginsList を引数として実行した結果とする。

        3. promiseclient で resolve する。

  8. promise を返す。

4.3.4. claim()

claim() メソッドの手順:

  1. サービスワーカーアクティブワーカーでない場合、"InvalidStateError" DOMException で却下されたプロミスを返す。

  2. promise を新しいプロミスとする。

  3. 次の副手順を並列に実行する。

    1. client を与えてストレージキーを取得するを実行した結果が、サービスワーカー包含サービス ワーカー登録ストレージキー等しい、各サービスワーカークライアント client について、次を実行する。

      1. client実行 準備完了フラグが設定されていないか、client破棄済み フラグが設定されている場合、続行する

      2. clientセキュアコンテキストでない場合、続行する

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

      4. registration を、storage key および client作成 URLを与えてサービスワーカー 登録を照合するを実行した結果とする。

      5. registrationサービス ワーカー包含 サービスワーカー登録でない場合、続行する

        注記: サービス ワーカー包含 サービスワーカー登録登録解除済み である場合、registration は null になる。

      6. clientアクティブな サービスワーカーサービス ワーカーでない場合、次を実行する。

        1. client を引数としてサービス ワーカークライアントのアンロードを処理するを呼び出す。

        2. clientアクティブな サービスワーカーサービス ワーカーに設定する。

        3. client を引数としてコントローラーの変更を 通知するアルゴリズムを呼び出す。

    2. task をキューに入れpromiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して promise を undefined で resolve する。

  4. promise を返す。

4.4. ExtendableEvent

[Exposed=ServiceWorker]
interface ExtendableEvent : Event {
  constructor(DOMString type, optional ExtendableEventInit eventInitDict = {});
  undefined waitUntil(Promise<any> f);
};
dictionary ExtendableEventInit : EventInit {
  // Defined for the forward compatibility across the derived events
};

ExtendableEvent オブジェクトは、関連付けられた extend lifetime promises(存続期間拡張promise群)promiseの配列)を持ちます。初期値は空配列です。

ExtendableEvent オブジェクトは、関連付けられた pending promises count(保留中promise数)extend lifetime promisesの中で保留中のpromise数)を持ちます。初期値は0です。

ExtendableEvent オブジェクトは、関連付けられた timed out flag(タイムアウトフラグ) を持ちます。これは初期状態では未設定であり、pending promises count が0より大きい場合、ユーザーエージェントが任意で遅延をかけた後に設定されます。

ExtendableEvent オブジェクトは、timed out flag が未設定であり、かつpending promises count が0より大きい、またはdispatch flag が設定されている場合、active(有効)であると言います。

Service Worker には2つのライフサイクルイベントinstallactivate)があります。 Service Worker は、ExtendableEvent インターフェースを install および activate イベントで利用します。

Service Worker拡張イベントハンドラを定義するものも、ExtendableEvent インターフェースを利用または拡張することができます

4.4.1. event.waitUntil(f)

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

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

lifetime promiseの追加 promisepromise)を eventExtendableEvent)に対して行う手順:
  1. eventisTrusted 属性がfalseの場合、"InvalidStateError" DOMExceptionthrowする。

  2. eventactive でない場合、"InvalidStateError" DOMExceptionthrowする。

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

  3. promiseeventextend lifetime promises に追加する。

  4. eventpending promises count を1増加させる。

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

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

    1. eventpending promises count を1減らす。

    2. eventpending promises count が0なら:

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

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

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

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

Service Workerや、拡張イベントハンドラを定義するものは、独自の挙動を定義してもよいです。これにより、extend lifetime promisesによって処理時間を示唆したり、extend lifetime promises内のいずれかのPromiseがrejected状態であれば処理失敗を示唆できます。

注: Service Workerは、installing workerを「installed」として扱うのを、installイベントのextend lifetime promises内のすべてのPromiseが正常に解決されるまで遅延します。(該当のInstallアルゴリズム手順を参照。)Promiseのいずれかがrejectされた場合、インストールは失敗します。これは主に、Service Workerが依存するコアキャッシュがすべて準備されるまで「installed」と見なされないようにするために使われます。同様に、Service Workerは、active workerを「activated」として扱うのを、activateイベントのextend lifetime promises内のすべてのPromiseが決着(resolveまたはreject)するまで遅延します。(該当のActivateアルゴリズム手順を参照。)これは主に、ファンクショナルイベントService Workerへ送信される前に、データベーススキーマのアップグレードや古いキャッシュエントリの削除が完了することを保証するために利用されます。

4.5. InstallEvent

[Exposed=ServiceWorker]
interface InstallEvent : ExtendableEvent {
  constructor(DOMString type, optional ExtendableEventInit eventInitDict = {});
  Promise<undefined> addRoutes((RouterRule or sequence<RouterRule>) rules);
};

dictionary RouterRule {
  required RouterCondition condition;
  required RouterSource source;
};

dictionary RouterCondition {
  URLPatternCompatible urlPattern;
  ByteString requestMethod;
  RequestMode requestMode;
  RequestDestination requestDestination;
  RunningStatus runningStatus;

  sequence<RouterCondition> _or;
  RouterCondition not;
};

typedef (RouterSourceDict or RouterSourceEnum) RouterSource;

dictionary RouterSourceDict {
  DOMString cacheName;
};

enum RunningStatus { "running", "not-running" };
enum RouterSourceEnum {
  "cache",
  "fetch-event",
  "network",
  "race-network-and-fetch-handler"
};

count router condition result(ルーター条件結果のカウント)は、次からなる構造体です:

  • condition count(条件数)(数値)。

  • quota exceeded(クォータ超過)(真偽値)。

4.5.1. event.addRoutes(rules)

注: addRoutes(rules) は、このサービスワーカーでfetchイベントハンドラが通常行う単純なタスクを分担するためのルールを登録します。

addRoutes(rules) メソッドの手順:

  1. rulesRouterRule 辞書である場合、rules を « rules » に設定する。

  2. serviceWorkercurrent global object に関連付けられた service worker とする。

  3. rules の各 rule について:

    1. Verify Router Condition アルゴリズムを rule["condition"] および serviceWorker で実行した結果が false を返す場合、a promise rejected with a TypeError を返す。

    2. rule["source"] が "fetch-event" または "race-network-and-fetch-handler" のいずれかであり、かつ serviceWorkerset of event types to handlefetchcontain しない場合、a promise rejected with a TypeError を返す。

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

  5. Add lifetime promise lifetimePromisethis に追加する。

    Note: event.addRoutes(rules) は、event.waitUntil(promise) が呼び出された場合と同様に、デフォルトでイベントの存続期間を延長する。

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

  7. promisefulfillment または rejection したら、lifetimePromise を undefined で resolve する。

    Note: このステップは、install イベントの失敗を避けるために lifetimePromise を常に fulfilled にするためのものである。

  8. serviceWorkerEventLoopcurrent global objectevent loop とする。

  9. 次の手順を [[service worker queue]]Enqueue する:

    1. allRulesserviceWorkerlist of router rules のコピーとする。

    2. rules の各 rule について:

      1. ruleallRules に追加する。

    3. Check Router Registration LimitallRules で実行した結果が false を返す場合、次を実行する:

      1. task をキューに入れ、次の手順を serviceWorkerEventLoop 上で DOM manipulation task source を使用して実行する:

        1. promiseTypeError で reject する。

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

    4. serviceWorkerlist of router rulesallRules に設定する。

    5. task をキューに入れ、次の手順を serviceWorkerEventLoop 上で DOM manipulation task source を使用して実行する:

      1. promise を undefined で resolve する。

  10. promise を返す。

4.6. FetchEvent

[Exposed=ServiceWorker]
interface FetchEvent : ExtendableEvent {
  constructor(DOMString type, FetchEventInit eventInitDict);
  [SameObject] readonly attribute Request request;
  readonly attribute Promise<any> preloadResponse;
  readonly attribute DOMString clientId;
  readonly attribute DOMString resultingClientId;
  readonly attribute DOMString replacesClientId;
  readonly attribute Promise<undefined> handled;

  undefined respondWith(Promise<Response> r);
};
dictionary FetchEventInit : ExtendableEventInit {
  required Request request;
  Promise<any> preloadResponse;
  DOMString clientId = "";
  DOMString resultingClientId = "";
  DOMString replacesClientId = "";
  Promise<undefined> handled;
};

ServiceWorker には重要な機能的イベント fetch があります。 fetch イベントでは、ServiceWorkerFetchEvent インターフェースを利用し、これは ExtendableEvent インターフェースを拡張します。

FetchEvent インターフェースを使用する各イベントには、関連付けられた potential response(潜在的レスポンス)response)があり、初期値はnullです。また、初期状態で未設定の以下のフラグを持ちます:

  • wait to respond flag(応答待ちフラグ)

  • respond-with entered flag(respondWith実行済みフラグ)

  • respond-with error flag(respondWithエラーフラグ)

4.6.1. event.request

request 属性は、初期化時に設定された値を返すべきです。

4.6.2. event.preloadResponse

preloadResponse 属性は、初期化時に設定された値を返すべきです。イベントが作成されたとき、この属性は undefinedで解決されたpromise に初期化すべきです。

4.6.3. event.clientId

clientId 属性は、初期化時に設定された値を返すべきです。イベントが作成されたとき、この属性は空文字列に初期化すべきです。

注記: clientId は、リクエストに開始元となるサービスワーカー クライアントがある場合は、requestクライアントIDであり、それ以外の場合は空文字列である(例えば、開始元のない トップレベルのナビゲーションリクエスト)。ナビゲーションリクエストの結果として生じる文書に関連付けられた環境については、resultingClientId を参照すること。

4.6.4. event.resultingClientId

resultingClientId 属性は、初期化時に設定された値を返すべきです。イベントが作成されたとき、この属性は空文字列に初期化すべきです。

注記: resultingClientId は、request予約済みクライアントIDである。サブリソースリクエストの場合、リクエストの宛先"report" である場合、およびrequest予約済みクライアントがnullである場合は、空文字列となる。

4.6.5. event.replacesClientId

replacesClientId 属性は、初期化時に設定された値を返すべきです。イベントが作成されたとき、この属性は空文字列に初期化すべきです。

4.6.6. event.handled

handled 属性は、初期化時に設定された値を返すべきです。イベントが作成されたとき、この属性はpendingな promise で初期化すべきです。

4.6.7. event.respondWith(r)

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

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

  1. eventthis とする。

  2. eventdispatch flag が未設定なら、"InvalidStateError" DOMExceptionthrowする。

  3. eventrespond-with entered flag が 設定済みなら、"InvalidStateError" DOMExceptionthrowする。

  4. lifetime promiseの追加 revent に対して行う。

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

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

  6. eventrespond-with entered flag を設定する。

  7. eventwait to respond flag を設定する。

  8. targetRealmeventrelevant Realm とする。

  9. rのrejection時:

    1. eventrespond-with error flag を設定する。

    2. eventwait to respond flag を解除する。

  10. rのfulfillment時response で:

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

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

    2. それ以外の場合:

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

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

      3. done をfalseとする。

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

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

        1. readerreader取得responsebodystream で実行した結果とする。

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

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

            chunk stepschunkを受け取る)
            1. アサート:chunkUint8Array である。

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

            3. potentialResponsebody infoencoded sizebytesbyte length だけ増加させる。

            4. potentialResponsebody infodecoded sizebytesbyte length だけ増加させる。

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

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

            error steps
            1. error newStreamTypeError を与える。

          2. read a chunkreaderreadRequest を与えて実行する。

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

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

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

        6. newStream を新しい ReadableStream とし、set uppullAlgorithm pullAlgorithmcancelAlgorithm cancelAlgorithmhighWaterMark highWaterMarksizeAlgorithm sizeAlgorithmtargetRealm でセットアップする。

        7. potentialResponsebody を新しい body とし、その streamnewStream にする。

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

          1. newStreamerrored なら、done をtrueにする。

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

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

            1. chunkbytes の先頭からの部分列とする。

            2. chunkbytes から除去する。

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

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

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

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

      6. eventpotential responsepotentialResponse に設定する。

    3. eventwait to respond flag を解除する。

4.7. ExtendableMessageEvent

[Exposed=ServiceWorker]
interface ExtendableMessageEvent : ExtendableEvent {
  constructor(DOMString type, optional ExtendableMessageEventInit eventInitDict = {});
  readonly attribute any data;
  readonly attribute USVString origin;
  readonly attribute DOMString lastEventId;
  [SameObject] readonly attribute (Client or ServiceWorker or MessagePort)? source;
  readonly attribute FrozenArray<MessagePort> ports;
};
dictionary ExtendableMessageEventInit : ExtendableEventInit {
  any data = null;
  USVString origin = "";
  DOMString lastEventId = "";
  (Client or ServiceWorker or MessagePort)? source = null;
  sequence<MessagePort> ports = [];
};

ExtendableMessageEventoriginorigin、文字列、または null)を持つ。初期値は null。

Service workerextendable message イベントを定義し、イベントの存続期間を拡張可能にする。message イベントでは、service workerExtendableMessageEvent インターフェースを使用し、これは ExtendableEvent インターフェースを拡張している。

4.7.1. event.data

data 属性は、初期化時に設定された値を返すべきです。オブジェクト生成時にはこの属性はnullで初期化すべきです。送信されるメッセージを表します。

4.7.2. event.origin

origin属性は、メッセージを送信したサービスワーカー クライアントオリジンを表す。

origin のゲッター手順:

  1. thisoriginorigin型なら、 そのoriginのシリアル化を返す。

  2. thisorigin が null なら空文字列を返す。

  3. thisorigin を返す。

origin 属性が "初期化" されるとき(例えば ExtendableMessageEvent のコンストラクタ内など)、 初期化値はオブジェクトの origin に格納されます。

4.7.3. event.lastEventId

lastEventId 属性は、 初期化された値を返さなければならない (must)。オブジェクト生成時、この属性は 空文字列で初期化されなければならない (must)。

ExtendableMessageEvent インターフェースを実装するオブジェクトの extract an origin の手順は、 thisoriginorigin 型であればその値を返し、そうでなければ null を返す。

4.7.4. event.source

source 属性は、初期化時に設定された値を返すべきです。オブジェクト生成時にはこの属性はnullで初期化すべきです。これはメッセージを送信した Client オブジェクトを表します。

4.7.5. event.ports

ports 属性は、初期化時に設定された値を返すべきです。オブジェクト生成時にはこの属性は空配列で初期化すべきです。これは送信される MessagePort 配列を表します。

4.8. イベント

以下のイベントは ServiceWorkerイベント と呼ばれ、ServiceWorkerGlobalScope オブジェクト上でdispatchされます:

イベント名 インターフェイス カテゴリ 配送される場合…
install InstallEvent ライフサイクル サービスワーカー包含サービスワーカー 登録インストール中のワーカーが変更される。(インストール アルゴリズムの手順 11.2 を参照。)
activate ExtendableEvent ライフサイクル サービスワーカー包含サービスワーカー 登録アクティブワーカーが変更される。(アクティベート アルゴリズムの手順 12.2 を参照。)
fetch FetchEvent 機能 HTTP フェッチrequest を用いてフェッチを処理するを 呼び出す。フェッチを処理するを実行した結果、サービスワーカーHTTP フェッチレスポンスを返す。Response オブジェクトで表されるレスポンスは、Cache オブジェクトから取得するか、self.fetch(input, init) メソッドを使用してネットワークから直接取得できる。(カスタムの Response オブジェクトも別の選択肢となり得る。)
push PushEvent 機能 push イベントを発火するを参照。)
notificationclick NotificationEvent 機能 通知を アクティベートする。を参照。)
notificationclose NotificationEvent 機能 通知を 閉じる。を参照。)
sync SyncEvent 機能 sync イベントを発火するを参照。)
canmakepayment CanMakePaymentEvent 機能 CanMakePaymentEvent を処理するを参照。)
paymentrequest PaymentRequestEvent 機能 PaymentRequestEvent を処理するを参照。)
message ExtendableMessageEvent レガシー メッセージを受信した場合。
messageerror ExtendableMessageEvent レガシー 逆シリアル化できないメッセージが送信された場合。

5. キャッシュ

著者がオフライン利用のためにコンテンツキャッシュを完全に管理できるよう、Window および WorkerGlobalScope は、Cache オブジェクトを開いて操作できる非同期キャッシュメソッドを提供します。オリジンごとに複数の名前付き Cache オブジェクトを持つことができ、その内容は完全にスクリプトで制御できます。キャッシュは オリジン間で共有されず、ブラウザのHTTPキャッシュとも完全に分離されています。

5.1. 構成要素

リクエスト レスポンスリストは、リクエスト(リクエスト)およびレスポンス(レスポンス)からなるタプルリストである。

関連リクエストレスポンスリストは、これが表すインスタンスである。

名前からキャッシュへの マップは、そのエントリーが、キーリクエストレスポンスリストの名前を表す文字列)およびリクエストレスポンスリスト)からなる順序付きマップである。

CacheStorage オブジェクトの関連する名前からキャッシュへのマップは、そのオブジェクトの関連設定オブジェクトおよび「caches」を用いてローカルストレージボトルマップを取得するを実行した結果に関連付けられた名前からキャッシュへのマップである。

5.2. キャッシュの寿命の理解

Cache インスタンスはブラウザのHTTPキャッシュとは無関係です。Cache オブジェクトは著者が自ら管理するものです。Cache オブジェクトは、著者が明示的に更新を要求しない限り更新されません。Cache オブジェクトは、著者がエントリーを削除しない限り期限切れになりません。Cache オブジェクトは、ServiceWorkerスクリプトが更新されても消えません。つまり、キャッシュは自動で更新されません。更新は手動で管理する必要があります。したがって、著者はキャッシュ名でバージョン管理し、ServiceWorkerの安全に操作できるバージョンのキャッシュのみ利用するようにしてください。

5.3. self.caches

partial interface mixin WindowOrWorkerGlobalScope {
  [SecureContext, SameObject] readonly attribute CacheStorage caches;
};

5.3.1. caches

caches のgetter手順は、thisの関連付けられたCacheStorageオブジェクトを返します。

5.4. Cache

[SecureContext, Exposed=(Window,Worker)]
interface Cache {
  [NewObject] Promise<(Response or undefined)> match(RequestInfo request, optional CacheQueryOptions options = {});
  [NewObject] Promise<FrozenArray<Response>> matchAll(optional RequestInfo request, optional CacheQueryOptions options = {});
  [NewObject] Promise<undefined> add(RequestInfo request);
  [NewObject] Promise<undefined> addAll(sequence<RequestInfo> requests);
  [NewObject] Promise<undefined> put(RequestInfo request, Response response);
  [NewObject] Promise<boolean> delete(RequestInfo request, optional CacheQueryOptions options = {});
  [NewObject] Promise<FrozenArray<Request>> keys(optional RequestInfo request, optional CacheQueryOptions options = {});
};
dictionary CacheQueryOptions {
  boolean ignoreSearch = false;
  boolean ignoreMethod = false;
  boolean ignoreVary = false;
};

Cache オブジェクトは、リクエスト・レスポンスリストを表します。複数のドキュメントやワーカー間で Cache インターフェースを実装する別々のオブジェクトが、同じ リクエスト・レスポンスリスト に関連付けられる場合もあります。

キャッシュバッチ操作は、構造体であり、次の要素からなります:

5.4.1. match(request, options)

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

  1. promise新しいpromise とする。

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

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

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

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

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

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

      1. responses が空配列の場合:

        1. promise をundefinedでresolveする。

      2. それ以外の場合:

        1. promiseresponsesの最初の要素でresolveする。

  3. promise を返す。

5.4.2. matchAll(request, options)

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

  1. r を null とする。

  2. 省略可能な引数 request が省略されていない場合:

    1. requestRequest オブジェクトである場合:

      1. rrequestリクエストに設定する。

      2. rメソッドが `GET` ではなく、かつ options.ignoreMethod が false である場合、空の配列で 解決された promiseを 返す。

    2. それ以外で、request が文字列である場合:

      1. request を引数として Request の初期値をコンストラクターとして呼び出した結果に関連付けられた リクエストr に設定する。これが例外を スローする場合、その例外を伴う 拒否された promiseを 返す。

  3. realmthis関連するレルムとする。

  4. promise新しい promiseとする。

  5. 次のサブステップを 並行に実行する:

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

    2. 省略可能な引数 request が省略されている場合:

      1. requestResponse関連するリクエスト レスポンスリスト内)について:

        1. requestResponse の response のコピーを responses に追加する。

    3. それ以外の場合:

      1. r および options を用いて Query Cache を実行した結果を requestResponses とする。

      2. requestResponses requestResponse について:

        1. requestResponse の response のコピーを responses に追加する。

    4. responsesresponse について:

      1. responsetype が "opaque" であり、promiserelevant settings objectoriginpromiserelevant settings object、""、および responseinternal response を用いた cross-origin resource policy checkblocked を返す場合、promiseTypeError で reject し、これらの手順を中止する。

    5. task をキューに入れpromiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して、次の手順を実行する:

      1. responseListlist とする。

      2. responsesresponse について:

        1. response に関連付けられた新しい Response オブジェクトと、guard が "immutable" である新しい Headers オブジェクトを responseList に追加する。

      3. realm 内で、responseList から created された frozen arraypromise を resolve する。

  6. promise を返す。

5.4.3. add(request)

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

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

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

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

5.4.4. addAll(requests)

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

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

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

  3. requests 内の型が Request である各 request について:

    1. rrequestリクエストとする。

    2. rURLスキームが "http" および "https" のいずれでもない場合、または rメソッドが `GET` でない場合、 TypeError を伴う 拒否された promiseを 返す。

  4. fetchControllersフェッチコントローラーリストとする。

  5. requests 内の各 request について:

    1. request を引数として Request の初期値をコンストラクターとして呼び出した結果に関連付けられた リクエストr とする。これが例外を スローする場合、その例外を伴う 拒否された promiseを 返す。

    2. rURLスキームが "http" および "https" のいずれでもない場合:

      1. fetchControllers の各 fetchControllerついてfetchController中止する

      2. TypeError を伴う 拒否された promiseを 返す。

    3. rクライアントグローバルオブジェクトServiceWorkerGlobalScope オブジェクトである場合、requestservice-workers モードを "none" に設定する。

    4. rrequestList に追加する。

    5. responsePromise新しい promiseとする。

    6. 次のサブステップを 並行に実行する:

      • rフェッチした結果を 付加する

      • response に対して processResponse を行うには、 次のサブステップを実行する:

        1. responseが "error" である場合、または responseステータスok ステータスでないか、206 である場合、 responsePromiseTypeError で拒否する。

        2. それ以外で、responseヘッダーリストが、 名前が `Vary` である ヘッダーを含む場合:

          1. fieldValues を、Vary ヘッダーの フィールド値に対応する要素を含む リストとする。

          2. fieldValues の各 fieldValueついて:

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

              1. responsePromiseTypeError で拒否する。

              2. fetchControllers の各 fetchControllerついてfetchController中止する

              3. これらのステップを中止する。

      • response に対して processResponseEndOfBody を行うには、次のサブステップを実行する:

        1. response中止済みフラグが 設定されている場合、responsePromise を "AbortError" DOMException で拒否し、これらのステップを中止する。

        2. responsePromiseresponse で解決する。

        注: キャッシュへの コミットは、レスポンスの本体を完全に受信したときに許可される。

    7. responsePromiseresponsePromises に追加する。

  6. p を、responsePromises のすべてを 待機する promise を取得した結果と する。

  7. p に対して、引数 responses で呼び出されたときに 次のサブステップを実行する履行ハンドラーを使用して 反応した結果を返す:

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

    2. index をゼロとする。

    3. responses 内の各 response について:

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

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

      3. operationリクエストrequestList[index] に設定する。

      4. operationレスポンスresponse に設定する。

      5. operationoperations付加する

      6. index を 1 増加させる。

    4. realmthis関連するレルムとする。

    5. cacheJobPromise新しい promiseとする。

    6. 次のサブステップを 並行に実行する:

      1. errorData を null とする。

      2. Batch Cache Operationsoperations で呼び出す。これが throws で例外を投げる場合、 errorData をその例外に設定する。

      3. task をキューに入れcacheJobPromiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して、次のサブステップを実行する:

        1. errorData が null の場合、 cacheJobPromise を undefined で resolve する。

        2. それ以外の場合、realm 内で errorData を使った new exceptioncacheJobPromise を reject する。

    7. cacheJobPromise を返す。

5.4.5. put(request, response)

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

  1. innerRequest を null とする。

  2. requestRequest オブジェクトである場合、innerRequestrequestリクエストに設定する。

  3. それ以外の場合:

    1. request を引数として Request の コンストラクターを呼び出した結果を requestObj とする。これが exceptionスローする場合、exception拒否された promiseを返す。

    2. innerRequestrequestObjリクエストに設定する。

  4. innerRequestURLスキームが "http" および "https" のいずれでもない場合、または innerRequestメソッドが `GET` でない場合、TypeError で拒否された promiseを 返す。

  5. innerResponseresponseレスポンスとする。

  6. innerResponseステータス206 である場合、TypeError で拒否された promiseを 返す。

  7. innerResponseヘッダーリストが、ヘッダーのうち、名前が `Vary` であるものを含む場合:

    1. fieldValues を、Vary ヘッダーの フィールド値に対応する 項目を含む リスト とする。

    2. fieldValues 内の各 fieldValueついて:

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

  8. innerResponse本体攪乱されているか、または ロックされている場合、TypeError で拒否された promiseを 返す。

  9. clonedResponseinnerResponseクローンとする。

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

  11. innerResponse本体が null でない場合、次のサブステップを実行する:

    1. streaminnerResponse本体ストリームとする。

    2. readerstreamリーダーを取得した結果と する。

    3. bodyReadPromise を、reader から すべての バイトを読み取った結果に設定する。

    注: これにより、 innerResponse本体ロックされ、本体の完全にバッファリングされたコピーが clonedResponse に保持されることが保証される。実装は、メモリーではなく ディスクへ直接ストリーミングすることで最適化できる。

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

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

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

  15. operationリクエストinnerRequest に設定する。

  16. operationレスポンスclonedResponse に設定する。

  17. operationoperations付加する

  18. realmthis関連するレルムとする。

  19. bodyReadPromise履行時に、次の結果を返す:

    1. cacheJobPromise新しい promiseとする。

    2. cacheJobPromise を返し、次のステップを 並行に実行する:

      1. errorData を null とする。

      2. Batch Cache Operationsoperations で呼び出す。これが throws で例外を投げる場合、 errorData をその例外に設定する。

      3. task をキューに入れcacheJobPromiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して、次のサブステップを実行する:

        1. errorData が null の場合、 cacheJobPromise を undefined で resolve する。

        2. それ以外の場合、realm 内で errorData を使った new exceptioncacheJobPromise を reject する。

5.4.6. delete(request, options)

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

  1. r を null とする。

  2. requestRequest オブジェクトである場合:

    1. rrequestリクエストに設定する。

    2. rメソッドが `GET` ではなく、かつ options.ignoreMethod が false である場合、false で 解決された promiseを返す。

  3. それ以外で、request が文字列である場合:

    1. request を引数として Request の初期値をコンストラクターとして呼び出した結果に関連付けられた リクエストr に設定する。これが例外を スローする場合、その例外を伴う 拒否された promiseを 返す。

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

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

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

  7. operationリクエストr に設定する。

  8. operationオプションoptions に設定する。

  9. operationoperations付加する

  10. realmthis関連するレルムとする。

  11. cacheJobPromise新しい promiseとする。

  12. 次のサブステップを 並行に実行する:

    1. errorData を null とする。

    2. operations を用いて キャッシュ 操作を一括処理を実行した結果を requestResponses とする。これが例外を スローする場合、errorData をその例外に設定する。

    3. task をキューに入れcacheJobPromiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して、次のサブステップを実行する:

      1. errorData が null である場合:

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

        2. それ以外の場合、cacheJobPromise を false で解決する。

      2. それ以外の場合、realm 内で、errorData を伴う 新しい 例外によって cacheJobPromise を拒否する。

  13. cacheJobPromise を返す。

5.4.7. keys(request, options)

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

  1. r を null とする。

  2. 省略可能な引数 request が省略されていない場合:

    1. requestRequest オブジェクトである場合:

      1. rrequestリクエストに設定する。

      2. rメソッドが `GET` ではなく、かつ options.ignoreMethod が false である場合、空の配列で 解決された promiseを 返す。

    2. それ以外で、request が文字列である場合:

      1. request を引数として Request の初期値をコンストラクターとして呼び出した結果に関連付けられた リクエストr に設定する。これが例外を スローする場合、その例外を伴う 拒否された promiseを 返す。

  3. realmthis関連するレルムとする。

  4. promise新しい promiseとする。

  5. 次のサブステップを 並行に実行する:

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

    2. 省略可能な引数 request が省略されている場合:

      1. requestResponse関連するリクエスト レスポンスリスト内)について:

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

    3. それ以外の場合:

      1. r および options を用いて Query Cache を実行した結果を requestResponses とする。

      2. requestResponses requestResponse について:

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

    4. task をキューに入れpromiserelevant settings objectresponsible event loop 上で、DOM manipulation task source を使用して、次の手順を実行する:

      1. requestListリストとする。

      2. requests request について:

        1. request および、ガードが "immutable" である新しい関連付けられた Headers オブジェクトに関連付けられた新しい Request オブジェクトを requestList に追加する。

      3. realm 内で、requestList から 作成された 凍結配列を用いて promise を解決する。

  6. promise を返す。

5.5. CacheStorage

[SecureContext, Exposed=(Window,Worker)]
interface CacheStorage {
  [NewObject] Promise<(Response or undefined)> match(RequestInfo request, optional MultiCacheQueryOptions options = {});
  [NewObject] Promise<boolean> has(DOMString cacheName);
  [NewObject] Promise<Cache> open(DOMString cacheName);
  [NewObject] Promise<boolean> delete(DOMString cacheName);
  [NewObject] Promise<sequence<DOMString>> keys();
};

dictionary MultiCacheQueryOptions : CacheQueryOptions {
  DOMString cacheName;
};

注: CacheStorage インターフェースは主にECMAScript 6のMapオブジェクトに準拠するよう設計されていますが、すべて非同期であり、さらに便利なメソッドも備えています。clearforEachentriesvaluesの各メソッドは、TC39による非同期イテレーションについての議論が継続中であるため、初版の範囲からは意図的に除外されています。

ユーザーエージェントは、CacheStorage オブジェクトをWindow オブジェクトまたはWorkerGlobalScope オブジェクトが作成された際に必ず作成しなければなりません。

CacheStorage オブジェクトは、そのname to cache mapを、自身の関連設定オブジェクトと"caches"を使ってローカルストレージボトルマップを取得した結果に紐付けて表現します。ドキュメントやワーカーをまたいでCacheStorage インターフェースの複数の独立したオブジェクトが、同じname to cache mapに同時に紐付くことができます。

5.5.1. match(request, options)

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

  1. もしoptions["cacheName"] が存在する場合、次を実行:

    1. 新しいPromise promise を返し、以下のサブステップを並列で実行する:

      1. cacheNamecache について、relevant name to cache map を反復する:

        1. もしoptions["cacheName"] と cacheName が一致する場合:

          1. promise を、Cache インターフェースの match(request, options) メソッド(thisArgumentに cache を与えて \[[Call]] 内部メソッドを呼び出し)をrequestoptionsで実行した結果でresolveする。

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

      2. promiseをundefinedでresolveする。

  2. それ以外の場合:

    1. promiseundefinedでresolveされたpromise を設定する。

    2. cacheNamecache について、relevant name to cache map を反復する:

      1. promise自身の決着に反応する形で、 fulfillment handlerとして以下のサブステップを実行する形に設定する。引数はresponseとする:

        1. もしresponseがundefinedでなければ、そのresponseを返す。

        2. Cache インターフェースの match(request, options) メソッド(thisArgumentに cache を与えて \[[Call]] 内部メソッドを呼び出し)をrequestoptionsで実行した結果を返す。

    3. promiseを返す。

5.5.2. has(cacheName)

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

  1. promise新しいPromiseとする。

  2. 次のサブステップを並列で実行する:

    1. keyvalue について、relevant name to cache map を反復する:

      1. もしcacheNamekeyと一致したら、promiseをtrueで解決し、これらの手順を中止する。

    2. promiseをfalseで解決する。

  3. promiseを返す。

5.5.3. open(cacheName)

open(cacheName)メソッドの手順は次の通り:

  1. promise新しいPromiseとする。

  2. 次のサブステップを並列で実行する:

    1. keyvalueについて、relevant name to cache mapを反復する:

      1. もしcacheNamekeyと一致するなら:

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

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

    2. cacheを新しいrequest response listとする。

    3. Setを使い、relevant name to cache map[cacheName]にcacheを設定する。このキャッシュ書き込み操作が割り当てられたクォータ制限超過で失敗した場合、promiseQuotaExceededErrorでrejectし、これらの手順を中止する。

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

  3. promiseを返す。

5.5.4. delete(cacheName)

delete(cacheName)メソッドの手順は次の通り:

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

  2. promiseの決着に反応する形で、 fulfillment handlerを以下の通り実行した結果を返す。引数はcacheExistsとする:

    1. もしcacheExistsがfalseなら:

      1. falseを返す。

    2. cacheJobPromise新しいPromiseとする。

    3. 次のサブステップを並列で実行する:

      1. Removeを使い、relevant name to cache map[cacheName]を削除する。

      2. cacheJobPromiseをtrueでresolveする。

      注: このステップの後でも、既存のDOMオブジェクト(つまり参照されているCache、Request、Responseオブジェクト)は引き続き有効であるべきです。

    4. cacheJobPromiseを返す。

5.5.5. keys()

keys()メソッドの手順は次の通り:

  1. promise新しいPromiseとする。

  2. 次のサブステップを並列で実行する:

    1. cacheKeysrelevant name to cache mapのキー取得の結果とする。

      注: 結果の順序付き集合内の各項目は、name to cache mapに追加された順序となる。

    2. promisecacheKeysでresolveする。

  3. promiseを返す。

6. セキュリティに関する考慮事項

6.1. セキュアコンテキスト

サービス ワーカーは、セキュアコンテキストで実行されなければならないサービスワーカー クライアントも、サービス ワーカー登録を登録し、サービス ワーカー登録およびサービスワーカーにアクセスし、サービス ワーカーとメッセージを交換し、さらにサービスワーカーによって操作されるためには、セキュアコンテキストなければならない

注記: これは実質的に、サービス ワーカーおよびそのサービスワーカークライアントをHTTPS経由でホストする必要があることを 意味する。ユーザーエージェントは、開発目的でlocalhost要件を参照)、 127.0.0.0/8、および::1/128を許可できる。この制限の主な理由は、 安全でないコンテキストに 関連するリスクからユーザーを保護することである。

6.2. Content Security Policy(CSP)

ユーザーエージェントが Run Service Worker アルゴリズムを ServiceWorker serviceWorker で呼び出す際:

  • serviceWorkerスクリプトリソースContent-Security-Policy HTTPヘッダー値 policy で配信された場合、ユーザーエージェントは 必ず policyを強制 しなければなりません。

  • serviceWorkerスクリプトリソースContent-Security-Policy-Report-Only HTTPヘッダー値 policy で配信された場合、ユーザーエージェントは 必ず policyを監視 しなければなりません。

この制限の主な理由は、クロスサイトスクリプティング(XSS)などの幅広いコンテンツ注入脆弱性を緩和するためです。

6.3. オリジン依存性

6.3.1. オリジン制限

この節は規範的ではありません。

ServiceWorker は登録した ServiceWorkerクライアントオリジン で実行されます。大規模なアプリケーションで課題となるのはCDNからのホスト可否ですが、CDNは定義上他の場所や他の オリジン です。したがって、ServiceWorkerはCDNでホストできません。ただし importScripts() 経由でリソースを含めることは可能です。この制限理由は、ServiceWorkerが悪意ある者によって永続的な被害をもたらす可能性があるためです。

6.3.2. importScripts(urls)

importScripts(urls) メソッドが ServiceWorkerGlobalScope オブジェクトで呼ばれると、ユーザーエージェントは 必ず workerグローバルスコープへスクリプトをimportします(この ServiceWorkerGlobalScope オブジェクトと urls を渡す)。さらに fetchフック手順(リクエスト request に対し)を以下の通り実行します:

  1. serviceWorkerを、requestクライアントグローバルオブジェクトサービスワーカーとする。

  2. mapserviceWorkerスクリプトリソースマップ とする。

  3. urlrequesturl とする。

  4. serviceWorkerstate が "parsed" または "installing" でない場合:

    1. map[url] が存在すればそれを返し、そうでなければ ネットワークエラー を返す。

  5. map[url] が存在する場合:

    1. urlを serviceWorker使用済みスクリプト集合 に追加する。

    2. map[url] を返す。

  6. registrationserviceWorkerServiceWorker登録 とする。

  7. requestservice-workers mode を "none" に設定する。

  8. 次のいずれかに該当する場合 requestcache mode を "no-cache" に設定する:

  9. responserequestのfetch結果とする。

  10. responsecache state が "local" でない場合、registrationlast update check time を現在時刻に設定する。

  11. responseunsafe responsebad import script response なら ネットワークエラー を返す。

  12. map[url] に response を設定する。

  13. urlを serviceWorker使用済みスクリプト集合 に追加する。

  14. serviceWorkerクラシックスクリプトimport済みフラグ を設定する。

  15. response を返す。

6.4. クロスオリジンリソースとCORS

この節は規範的ではありません。

アプリケーションは、CDNなどのオリジンから来るアイテムをキャッシュする傾向があります。これらの多くを<script><img><video><link>要素で直接リクエストすることが可能です。このようなランタイムでの協調処理がオフライン時に壊れてしまうのは大きな制約となります。同様に、適切なCORSヘッダーが設定されていれば、多くの種類のオフオリジンリソースもfetchできます。 Service Workerは、Cachesがオフオリジンのアイテムをフェッチしてキャッシュできるようにすることで、これを実現します。ただし、いくつかの制約があります。まず、Cache内で管理される同一オリジンリソースと異なり、対応するレスポンスbasic filtered responseであるResponseオブジェクトとは違い、保存されるオブジェクトは、対応するレスポンスCORSフィルタされたレスポンスまたはopaque filtered responseとなるResponseオブジェクトです。これらは、対応するレスポンスbasic filtered responseとなるResponseオブジェクトと同じ方法でevent.respondWith(r) メソッドに渡すことができますが、プログラム的に意味のある方法で生成することはできません。これらの制限はプラットフォームのセキュリティ不変条件を維持するために必要です。Caches がこれらを保存可能なことにより、多くの場合アプリケーション側での大きな設計変更を避けることができます。

6.5. パス制限

この節は規範的ではありません。

オリジン制限に加え、ServiceWorkerはスクリプトの パス でも制限されます。例えば https://www.example.com/~bob/sw.js の ServiceWorkerは scope url https://www.example.com/~bob/ では登録できますが、https://www.example.com/https://www.example.com/~alice/ ではできません。これは同一オリジンでユーザーごとに分離されるディレクトリ構成のサイトの保護に役立ちます。ただしパス制限は厳密なセキュリティ境界ではなく、オリジンのみが厳密な境界です。サイトは必要に応じて異なるオリジンを用いて安全な分離を推奨します。

サーバーは ServiceWorker スクリプトに Service-Worker-Allowed ヘッダーを設定することでパス制限を解除できます。

6.6. ServiceWorkerスクリプトリクエスト

この節は規範的ではありません。

悪意あるServiceWorker登録への対策として、本仕様は以下を要求します:

6.7. 実装者向け注意事項

この節は規範的ではありません。

実装者は以下に留意してください:

  • プラグインは ServiceWorker 経由ではロードすべきではありません。プラグインは自身のURLからセキュリティオリジンを取得する場合があり、埋め込んだ ServiceWorker では扱えません。このため Handle Fetch アルゴリズムは <embed> および <object> リクエストを fetch イベントdispatchせず即座にネットワークへフォールバックします。

  • レガシーネットワークスタックの一部コードは ServiceWorker との相互作用の影響を理解するため、慎重な監査が必要な場合があります。

6.8. プライバシー

Service Workerは、新しい永続ストレージ機能を導入します。これには、registration mapService Workerの登録やそのService Worker用)、request response listname to cache map(キャッシュ用)、そしてscript resource map(スクリプトリソース用)が含まれます。ユーザーを許可されていないトラッキングの脅威から守るため、これらの永続ストレージは、ユーザーが消去しようと意図したとき消去されるべきであり、また、既存のユーザーコントロール(例:全ての永続ストレージの消去)と整合し、相互運用すべきです。

7. 拡張性

Service Workers仕様は他の仕様から拡張可能です。

7.1. ServiceWorkerRegistrationに結びつけたAPI定義

仕様は、Service Worker 登録に紐付いたAPIを、partial interface定義を用いてServiceWorkerRegistrationインターフェイスに属性やメソッドを仕様ごとに定義してもよい

partial interface ServiceWorkerRegistration {
  // 例: API名前空間の定義
  readonly attribute APISpaceType APISpace;
  // 例: メソッドの定義
  Promise<T> methodName(/* 引数リスト */);
};

7.2. 機能的イベントの定義

仕様は、ExtendableEvent インターフェースを拡張して機能的イベント定義してもよいです:

// 例えば FunctionalEvent インターフェイスの定義
interface FunctionalEvent : ExtendableEvent {
  // 機能イベント独自の属性やメソッドを追加
};

7.3. イベントハンドラの定義

仕様は、対応する機能的イベントのイベントハンドラ属性を、ServiceWorkerGlobalScope インターフェースへの partial interface 定義で定義してもよいです:

partial interface ServiceWorkerGlobalScope {
  attribute EventHandler onfunctionalevent;
};

7.4. 機能的イベントの発火

機能的イベントServiceWorker登録active workerにdispatch要求するには、 仕様はFire Functional Event呼び出すべきです。

付録A:アルゴリズム

以下の定義は、現行標準仕様全体で使われるユーザーエージェントの内部データ構造です。

登録マップは、(順序付きマップ)であり、キーは(ストレージキーシリアライズされたscope url)、値はServiceWorker登録です。

ジョブは、ServiceWorker登録に対するregister、update、unregisterリクエストの抽象化です。

ジョブジョブタイプregisterupdateunregisterのいずれか)を持ちます。

ジョブストレージキーストレージキー)を持ちます。

ジョブscope urlURL)を持ちます。

ジョブスクリプトurlURL)を持ちます。

ジョブワーカータイプ("classic" または "module")を持ちます。

ジョブupdate via cache mode("imports"、"all"、"none")を持ちます。

ジョブclientServiceWorkerクライアント)を持ちます。初期値はnullです。

ジョブreferrerURLまたはnull)を持ちます。

ジョブジョブpromisepromise)。初期値はnullです。

ジョブ所属ジョブキュージョブキューまたはnull)。初期値はnullです。

ジョブ等価ジョブリストジョブのリスト)。初期値は空リストです。

ジョブforce bypass cache flagを持ちます。初期値は未設定です。

2つのジョブ等価とは、ジョブタイプが同じで、以下がすべて同じ場合です:

ジョブキューは、同時実行されるジョブ群を同期させるためのスレッドセーフなキューです。ジョブキュージョブitemとして含みます。ジョブキューの初期値は空です。

scope→ジョブキュー マップは、順序付きマップで、キーはシリアライズされたscope url、値はジョブキューです。

bad import script responseは、responseで、以下のいずれかの条件を満たすものです:

race resultは、タプルであり、routed responseused routeから構成されます。

race resultは、関連付けられたrouted responseresponse)を持ちます。

race resultは、関連付けられたused routeRouterSourceEnum)を持ちます。

ジョブの作成

入力

jobTypeジョブタイプ

storage keyストレージキー

scopeURLURL

scriptURLURL

promisepromise

clientServiceWorkerクライアント

出力

jobジョブ

  1. job を新規 ジョブとする。

  2. jobジョブタイプjobType に設定する。

  3. jobストレージキーstorage key に設定する。

  4. jobscope urlscopeURL に設定する。

  5. jobscript urlscriptURL に設定する。

  6. jobジョブpromisepromise に設定する。

  7. jobclientclient に設定する。

  8. client が null でなければ、jobreferrerclient作成URL に設定する。

  9. job を返す。

ジョブのスケジュール

入力

jobジョブ

出力

なし

  1. jobQueue を null とする。

  2. jobScopejobscope urlシリアライズ済み)とする。

  3. scope→ジョブキューマップ[jobScope] が 存在しない場合、scope→ジョブキューマップ[jobScope] を新しい ジョブキュー に設定する。

  4. jobQueuescope→ジョブキューマップ[jobScope] に設定する。

  5. jobQueue が空なら:

    1. job所属ジョブキューjobQueue に設定し、jobQueuejob をenqueueする。

    2. ジョブの実行jobQueue)を呼び出す。

  6. そうでない場合:

    1. lastJobjobQueue の末尾要素とする。

    2. joblastJobと等価 かつ lastJobジョブpromise がsettleしていなければ、joblastJob等価ジョブリストに追加する。

    3. それ以外なら、job所属ジョブキューjobQueue に設定し、jobQueuejob をenqueueする。

ジョブの実行

入力

jobQueue:ジョブキュー

出力

なし

  1. アサート:jobQueue空ではない

  2. タスクをキューに入れる。以下の手順を実行:

    1. jobjobQueue の最初の item とする。

    2. jobジョブタイプregister なら、登録job)を 並行して実行する。

    3. そうでなく jobジョブタイプupdate なら、更新job)を 並行して実行する。

      注: registerジョブとupdateジョブの場合、ユーザーエージェントは、そのジョブを開始するタスクキュー投入を、ジョブを開始したドキュメントで DOMContentLoaded イベントdispatch後まで遅延します。

    4. そうでなく jobジョブタイプunregister なら、登録解除job)を 並行して実行する。

ジョブの完了

入力

jobジョブ

出力

なし

  1. jobQueuejob所属ジョブキュー に設定する。

  2. アサート:jobQueue の最初の itemjob である。

  3. dequeuejobQueue から実行する。

  4. jobQueue空でない場合は、ジョブの実行jobQueue)を呼び出す。

ジョブpromiseの解決

入力

jobジョブ

value:任意

出力

なし

  1. jobclient が null でない場合、task をキューに入れjobclientresponsible event loop 上で、DOM manipulation task source を使用して、次の サブステップを実行する:

    1. convertedValue を null とする。

    2. jobjob typeregister または update のいずれかである場合、convertedValue を、valuejobclient で表す service worker registration object の取得 の結果に設定する。

    3. それ以外の場合、convertedValuevalue に、jobclientRealm 内で設定する。

    4. jobjob promiseconvertedValue で resolve する。

  2. joblist of equivalent jobs 内の各 equivalentJob について:

    1. equivalentJobclient が null の場合、ループの次の反復に continue する。

    2. task をキューに入れequivalentJobclientresponsible event loop 上で、DOM manipulation task source を使用して、 次のサブステップを実行する:

      1. convertedValue を null とする。

      2. equivalentJobjob typeregister または update のいずれかである場合、convertedValue を、valueequivalentJobclient で表す service worker registration object の取得 の結果に設定する。

      3. それ以外の場合、convertedValuevalue に、 equivalentJobclientRealm 内で設定する。

      4. equivalentJobjob promiseconvertedValue で resolve する。

ジョブpromiseの拒否

入力

jobジョブ

errorData例外生成に必要な情報

出力

なし

  1. jobクライアントが null でない場合、jobクライアント担当イベントループ上で、DOM 操作タスクソースを使用して、タスクをキューに入れjobジョブプロミスを、jobクライアントRealm内で、errorData を持つ新しい例外で拒否する。

  2. job同等のジョブのリスト内の各 equivalentJob について:

    1. equivalentJobクライアントが null の場合、続行する

    2. equivalentJobクライアント担当イベントループ上で、DOM 操作タスクソースを使用して、タスクをキューに入れequivalentJobジョブプロミスを、equivalentJobクライアントRealm内で、 errorData を持つ新しい例外で拒否する。

登録開始

入力

scopeURLURL/失敗/null

scriptURLURL/失敗

promisepromise

clientServiceWorkerクライアント

referrerURL

workerTypeワーカータイプ

updateViaCacheupdate via cache mode

出力

なし

  1. scriptURL が失敗なら、promiseTypeError でrejectし、これらの手順を中止する。

  2. scriptURLfragment を null に設定する。

    注: ユーザーエージェントはスクリプトurlの fragment を保存しません。つまりfragmentはServiceWorkerの識別には影響しません。

  3. scriptURLscheme が "http"/"https" 以外なら、promiseTypeError でrejectし、これらの手順を中止する。

  4. scriptURLpath 内のいずれかに ASCII大文字小文字無視 "%2f" または ASCII大文字小文字無視 "%5c" が含まれるなら、promiseTypeError でrejectし、これらの手順を中止する。

  5. scopeURL が null なら、scopeURL"./"scriptURL でパースした結果に設定する。

    注: 登録のscope urlはデフォルトでServiceWorkerスクリプトの場所になります。

  6. scopeURL が失敗なら、promiseTypeError でrejectし、これらの手順を中止する。

  7. scopeURLfragment を null に設定する。

    注: ユーザーエージェントはscope urlの fragment を保存しません。つまりfragmentはServiceWorker登録の識別には影響しません。

  8. scopeURLscheme が "http"/"https" 以外なら、promiseTypeError でrejectし、これらの手順を中止する。

  9. scopeURLpath 内のいずれかに ASCII大文字小文字無視 "%2f" または ASCII大文字小文字無視 "%5c" が含まれるなら、promiseTypeError でrejectし、これらの手順を中止する。

  10. storage keyclientからストレージキー取得 の結果とする。

  11. jobCreate Job(register、storage keyscopeURLscriptURLpromiseclient)の結果とする。

  12. jobworker typeworkerType に設定する。

  13. jobupdate via cache modeupdateViaCache に設定する。

  14. jobreferrerreferrer に設定する。

  15. ジョブのスケジュールjob)を呼び出す。

登録

入力

jobジョブ

出力

なし

  1. potentially trustworthy originjobscript urlのorigin)の結果が Not Trusted なら:

    1. ジョブpromiseの拒否job、"SecurityError" DOMException)を呼び出す。

    2. ジョブの完了job)を呼び出し、これらの手順を中止する。

  2. jobscript urloriginjobreferrerorigin同一オリジンでなければ:

    1. ジョブpromiseの拒否job、"SecurityError" DOMException)を呼び出す。

    2. ジョブの完了job)を呼び出し、これらの手順を中止する。

  3. jobscope urloriginjobreferrerorigin同一オリジンでなければ:

    1. ジョブpromiseの拒否job、"SecurityError" DOMException)を呼び出す。

    2. ジョブの完了job)を呼び出し、これらの手順を中止する。

  4. registrationGet Registrationjobストレージキーjobscope url)の結果とする。

  5. registration が null でなければ:

    1. newestWorkerGet Newest Workerregistration)の結果とする。

    2. newestWorker が null でなく、jobscript urlnewestWorkerのscript urlと一致jobworker type が newestWorkerのtypeと一致、jobupdate via cache mode が registrationのupdate via cache modeと一致するなら:

      1. ジョブpromiseの解決jobregistration)を呼び出す。

      2. ジョブの完了job)を呼び出し、これらの手順を中止する。

  6. それ以外:

    1. Set Registrationjobストレージキーjobscope urljobupdate via cache mode)アルゴリズムを呼び出す。

  7. Updatejob)アルゴリズムを呼び出す。

更新

入力

jobジョブ

出力

なし

  1. registrationGet Registrationjobストレージキーjobscope url)の結果とする。

  2. registration が null なら:

    1. ジョブpromiseの拒否jobTypeError)を呼び出す。

    2. ジョブの完了job)を呼び出し、これらの手順を中止する。

  3. newestWorkerGet Newest Workerregistration)の結果とする。

  4. jobジョブタイプupdate かつ newestWorker が null でなく、かつ newestWorkerscript urljobのscript urlと一致しないなら:

    1. ジョブpromiseの拒否jobTypeError)を呼び出す。

    2. ジョブの完了job)を呼び出し、これらの手順を中止する。

  5. hasUpdatedResources を false とする。

  6. updatedResourceMap順序付きマップ(キー:URL、値:response)とする。

  7. jobworker type に応じて以下のオプションでサブステップを実行:

    "classic"

    クラシックワーカースクリプトのfetchjobシリアライズ済み script urljobclient、"serviceworker"、このServiceWorker用の生成予定environment settings object)を呼び出す。

    "module"

    モジュールワーカースクリプトグラフのfetchjobシリアライズ済み script urljobclient、"serviceworker"、"same-origin"、このServiceWorker用の生成予定environment settings object)を呼び出す。

    具体的な環境設定オブジェクトではなく、生成予定の環境設定オブジェクトを利用しています。これは、Service Workerが他のWeb Workerと比べて独自の処理モデルを持つためです。HTML標準で他のWeb Worker向けに設計されたスクリプト取得アルゴリズムでは、実行環境の環境設定オブジェクトが必要ですが、Service Workerでは、Updateアルゴリズムでスクリプトを個別に取得し、その後Run Service Workerアルゴリズムを通じてスクリプトが複数回実行される前処理が行われます。

    HTMLのクラシック/モジュールワーカースクリプトfetchアルゴリズムはjobclientを引数に取るが、jobclientはSoft Updateアルゴリズムから呼ぶときnull。

    fetchフックrequest)の実行手順:

    1. `Service-Worker`/`script` を requestヘッダーリストに追加する。

      注: Service-Workerヘッダーの定義は付録B: 拡張HTTPヘッダーを参照。

    2. 下記のいずれかが真であれば、requestcache mode を "no-cache" に設定する:

      注: cache mode が "no-cache" でなくても、ユーザーエージェントはネットワーク層でCache-Controlヘッダーのmax-age値に従い、ブラウザキャッシュをバイパスすべきかを判断する。

    3. requestservice-workers mode を "none" に設定する。

    4. もし isTopLevel フラグが未設定なら、fetchrequest を取得した結果を返す。

    5. requestredirect mode を "error" に設定する。

    6. Fetchrequest を取得し、fetch の processResponse の一部として、残りのステップを非同期に待つ。responseresponse

    7. responseヘッダーリスト から MIME type を抽出。このMIMEタイプ(パラメータを無視)が JavaScript MIME type でなければ:

      1. Reject Job Promisejob と "SecurityError" DOMException で呼び出す。

      2. 非同期でこれらのステップをnetwork errorとして完了する。

    8. serviceWorkerAllowed を、responseヘッダーリストから取得する `Service-Worker-Allowed` の結果とする。ヘッダーリスト

      注: Service-Worker-Allowed ヘッダーの定義は、 付録 B: 拡張 HTTP ヘッダーを参照。

    9. serviceWorkerAllowed が null でない場合、 serviceWorkerAllowed同型デコード の結果に設定する。 serviceWorkerAllowed

    10. policyContainer を、response を指定して実行した fetch レスポンスから ポリシーコンテナーを作成する結果に設定する。

    11. scopeURLregistrationスコープ URL とする。

    12. maxScopeString を null とする。

    13. serviceWorkerAllowed が null の場合:

      1. resolvedScope を、jobスクリプト URLベース URL として "./" を 解析する結果とする。

      2. maxScopeString を "/" に設定し、その後に resolvedScopeパス 内の文字列(空文字列を含む)を "/" で区切って続ける。

        注: resolvedScopeパス の最後の項目は常に空文字列になるため、 maxScopeString には末尾の "/" が付く。

    14. それ以外の場合:

      1. maxScope を、jobスクリプト URLベース URL として serviceWorkerAllowed解析する結果とする。

      2. maxScope が失敗の場合:

        1. これらの手順を ネットワークエラーで非同期に完了する。

      3. maxScopeオリジン が、jobスクリプト URLオリジン である場合:

        1. maxScopeString を "/" に設定し、その後に maxScopeパス 内の文字列(空文字列を含む)を "/" で区切って続ける。

    15. scopeString を "/" とし、その後に scopeURLパス 内の文字列(空文字列を含む)を "/" で区切って続ける。

    16. maxScopeString が null、または scopeStringmaxScopeString で始まらない場合:

      1. job と "SecurityError" DOMException を指定して Reject Job Promise を呼び出す。

      2. これらの手順を ネットワークエラーで非同期に完了する。

    17. urlrequestURL とする。

    18. updatedResourceMap[url] を response に設定する。

    19. responseキャッシュ状態 が "local" でない場合、registration最終 更新確認時刻 を現在時刻に設定する。

    20. 次のいずれかが true の場合、hasUpdatedResources を true に設定する:

    21. hasUpdatedResources が false であり、かつ newestWorkerクラシックスクリプトインポート済み フラグ が設定されている場合:

      注: 以下では、 メインスクリプトが変更されていないため、インポートされたスクリプトが更新されたかを確認する。

      1. newestWorkerスクリプトリソースマップ の 各 importUrlstoredResponse について 反復する:

        1. importUrlurl である場合、続行する。

        2. importRequestを、リクエストであって、そのURLimportUrlクライアントjobクライアント宛先が 「script」、パーサーメタデータが 「not parser-inserted」であり、そのURL資格情報使用 フラグが設定された、新しいリクエストとする。

        3. 次のいずれかが true の場合、importRequestキャッシュモード を "no-cache" に設定する:

        4. fetchedResponse を、importRequestfetch する結果とする。

        5. updatedResourceMap[importRequestURL] を fetchedResponse に設定する。

        6. fetchedResponsefetchedResponse安全でないレスポンス に設定する。

        7. fetchedResponseキャッシュ状態 が "local" でない場合、registration最終更新確認 時刻 を現在時刻に設定する。

        8. fetchedResponse不正なインポートスクリプト レスポンス である場合、続行する。

          注: importScripts() に対する不正な レスポンスは、バイト単位のチェックの目的では無視される。現在のワーカーに対する良好な レスポンスと、潜在的な更新ワーカーに対する良好なレスポンスのみが考慮される。根拠については issue #1374 を参照。

        9. fetchedResponse本文 が、 storedResponse安全でないレスポンス本文 とバイト単位で同一でない場合、 hasUpdatedResources を true に設定する。

          注: キャッシュにデータを投入するため、すべてのインポートされたスクリプトについて続行するので、 このステップでは制御はループを中断しない。

    22. 非同期でこれらのステップを response で完了する。

    アルゴリズムが非同期完了したら、残りの手順をscript(非同期完了値)で続行。

  8. もし script が null または Is Async Modulescriptrecordscriptbase URL、および « » を与えて実行した結果が true なら:

    1. Reject Job PromisejobTypeError で呼び出す。

      注: すでに Reject Job Promise が "SecurityError DOMException" で呼び出されていた場合、ここでは何もしない。

    2. もし newestWorker が null なら、registration map[(registrationstorage keyserialized scopeURL)] を削除する。

    3. Finish Jobjob で呼び出し、これらの手順を中止する。

  9. もし hasUpdatedResources が false なら:

    1. registrationupdate via cache modejobupdate via cache mode を設定する。

    2. Resolve Job Promisejobregistration で呼び出す。

    3. Finish Jobjob で呼び出し、これらの手順を中止する。

  10. worker を新しい service worker とする。

  11. workerscript urljobscript urlworkerscript resourcescriptworkertypejobworker type、および workerscript resource mapupdatedResourceMap を設定する。

  12. urlworkerset of used scripts に追加する。

  13. workerscript resourcepolicy containerpolicyContainer を設定する。

  14. forceBypassCache に、jobforce bypass cache flag がセットされていれば true、そうでなければ false を設定する。

  15. runResultRun Service Worker アルゴリズムに workerforceBypassCache を与えて実行した結果とする。

  16. もし runResultfailure または abrupt completion なら:

    1. Reject Job PromisejobTypeError で呼び出す。

    2. もし newestWorker が null なら、registration map[(registrationstorage keyserialized scopeURL)] を削除する。

    3. Finish Jobjob で呼び出す。

  17. それ以外の場合は、Install アルゴリズムを jobworkerregistration で実行する。

ソフトアップデート

ユーザーエージェントは好きな頻度で呼び出してアップデートを確認してもよい

入力

registrationServiceWorker登録

forceBypassCache:オプションのboolean。デフォルトはfalse。

注: 実装者はforceBypassCacheをデバッグ用途(開発者ツールなど)や、ServiceWorker拡張仕様で任意に利用してもよい

出力

なし

  1. newestWorkerGet Newest Workerregistration)の結果とする。

  2. newestWorker が null なら、これらの手順を中止する。

  3. jobCreate Job(update、registrationストレージキーregistrationscope urlnewestWorkerscript url、null、null)で生成。

  4. jobworker typenewestWorkertype に設定する。

  5. forceBypassCache が true なら jobforce bypass cache flag を設定する。

  6. ジョブのスケジュールjob)を呼び出す。

インストール

入力

jobジョブ

workerServiceWorker

registrationServiceWorker登録

出力

なし

  1. installFailed を false とする。

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

  3. registrationキャッシュ経由更新モードjobキャッシュ経由更新モードに設定する。

  4. registration、"installing"、worker を引数として渡して、登録状態を更新アルゴリズムを 実行する。

  5. registrationインストール中のワーカーと "installing" を引数として渡して、ワーカー状態を更新アルゴリズムを実行する。

  6. 表明:jobジョブプロミスは null ではない。

  7. jobregistration を指定してジョブプロミスを解決を呼び出す。

  8. settingsObjects を、そのオリジンregistrationスコープ URLオリジンである、すべての環境設定オブジェクトとする。

  9. settingsObjects の各 settingsObject について、settingsObject担当イベントループ上で、DOM 操作タスクソースにおいて、次の 手順を実行するタスクをキューに入れる

    1. registrationObjects を、settingsObjectRealm内にあるすべての ServiceWorkerRegistration オブジェクトのうち、そのサービス ワーカー登録registration であるものとする。

    2. registrationObjects の各 registrationObject について、 registrationObject 上で updatefound という名前のイベントを発火する

  10. installingWorkerregistrationインストール中のワーカーとする。

  11. installingWorker と "install" を指定してイベントをスキップすべきかアルゴリズムを実行した結果が false の場合、次を行う:

    1. forceBypassCache を、jobキャッシュを強制的にバイパスするフラグが 設定されている場合は true、それ以外の場合は false とする。

    2. installingWorkerforceBypassCache を指定してサービスワーカーを実行アルゴリズムを実行した結果が失敗の場合、 次を行う:

      1. installFailed を true に設定する。

    3. それ以外の場合:

      1. installingWorkerイベントループ上で、DOM 操作タスク ソースを使用して、次の手順を実行するタスク task をキューに入れる:

        1. e を、InstallEvent を用いてイベントを作成した結果とする。

        2. etype 属性を install に初期化する。

        3. installingWorkerグローバル オブジェクトe配送する

        4. 非同期拡張を待機:次の副手順を並列に実行する:

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

          2. eタイムアウト フラグが設定されている場合、installFailed を true に設定する。

          3. p を、eライフタイムを 延長するプロミスのすべてを待機するためのプロミスを取得した結果とする。

          4. p拒否されたときinstallFailed を true に設定する。

        task が破棄された場合、installFailed を true に設定する。

      2. task が実行されるか、破棄されるまで待機する。

      3. 非同期拡張を待機とラベル付けされた手順が完了するまで待機する。

  12. installFailed が true の場合、次を行う:

    1. registrationインストール中のワーカーと "redundant" を引数として渡して、ワーカー状態を更新アルゴリズムを実行する。

    2. registration、"installing"、null を 引数として渡して、登録状態を更新アルゴリズムを実行する。

    3. newestWorker が null の場合、登録 マップ[(registrationストレージキー, 直列化された registrationスコープ URL)] を削除する

    4. job を指定してジョブを 完了を呼び出し、これらの手順を中止する。

  13. mapregistrationインストール中の ワーカースクリプトリソースマップとする。

  14. usedSetregistrationインストール中の ワーカー使用済みスクリプトの集合とする。

  15. map の各 url について:

    1. usedSeturl含まない場合、map[url] を削除する

  16. registration待機中のワーカーが null でない場合、次を行う:

    1. registration待機中のワーカー終了する

    2. registration待機中のワーカーと "redundant" を引数として渡して、ワーカー状態を更新アルゴリズムを実行する。

  17. registration、"waiting"、registrationインストール中のワーカーを引数として渡して、登録状態を更新アルゴリズムを実行する。

  18. registration、"installing"、null を引数として渡して、登録状態を更新アルゴリズムを実行する。

  19. registration待機中のワーカーと "installed" を 引数として渡して、ワーカー状態を更新アルゴリズムを実行する。

  20. job を指定してジョブを完了を 呼び出す。

  21. このアルゴリズム内で呼び出されたワーカー状態を更新によってキューに入れられたすべてのタスクが実行されるまで待機する。

  22. registration を指定してアクティブ化を 試行を呼び出す。

    注:ここでアクティブ化を試行アクティブ化をトリガーしない場合、既存のアクティブワーカーによって制御される最後のクライアントがアンロードされるとき、skipWaiting() が非同期に呼び出されたとき、または既存のアクティブワーカーライフタイムを延長するプロミスが 決着したときに、アクティブ化が再度試行される。

アクティベート

入力

registrationServiceWorker登録

出力

なし

  1. registration待機中のワーカーが null の場合、これらの手順を中止する。

  2. registrationアクティブワーカーが null でない場合、次を行う:

    1. registration終了する アクティブワーカー

    2. registrationアクティブワーカーと "redundant" を引数として渡して、ワーカー状態を更新アルゴリズムを実行する。

  3. registration、"active"、および registration待機中のワーカーを引数として渡して、登録状態を更新アルゴリズムを実行する。

  4. registration、"waiting"、および null を引数として渡して、登録状態を更新アルゴリズムを実行する。

  5. registrationアクティブワーカーと "activating" を 引数として渡して、ワーカー状態を更新アルゴリズムを実行する。

    注:アクティブワーカーが アクティブ化中になると、実行時のスクリプトエラーも、アクティブワーカーの強制終了も、 アクティブワーカーがアクティブ化されることを妨げない。

    注:アクティブ化 ハンドラーは、必須ではない作業(クリーンアップなど)を行うように設計すること。これは、特にアクティブ化中にブラウザーが終了した場合、 アクティブ化ハンドラーのすべてが完了まで実行されるとは限らないためである。 Service Worker は、アクティブ化ハンドラーが すべて正常に完了しなかった場合でも、適切に機能するように設計すべきである。

  6. matchedClients を、その作成 URLregistrationストレージキーおよび registrationスコープ URL一致するサービスワーカークライアントリストとする。

  7. matchedClients client について、 client担当イベントループ上で、DOM 操作タスクソースを使用して、次の 副手順を実行するタスクをキューに入れる

    1. readyPromiseclientグローバルオブジェクトServiceWorkerContainer オブジェクトのready プロミスとする。

    2. readyPromise が null の場合、続行する

    3. readyPromise が保留中の場合、 readyPromise関連する設定オブジェクトにおいて registration を表すサービスワーカー 登録オブジェクトを取得した結果で readyPromise を解決する

  8. registration使用しているサービスワーカークライアント client について:

    1. clientアクティブワーカーregistrationアクティブワーカーに設定する。

    2. client を引数としてコントローラー変更を通知アルゴリズムを 呼び出す。

  9. activeWorkerregistrationアクティブワーカーとする。

  10. activeWorker と "activate" を指定してイベントをスキップすべきかアルゴリズムを実行した結果が false の場合、次を行う:

    1. activeWorker を指定してサービスワーカーを実行アルゴリズムを実行した結果が 失敗でない場合、次を行う:

      1. activeWorkerイベントループ上で、DOM 操作タスク ソースを使用して、次の手順を実行するタスク task をキューに入れる:

        1. e を、ExtendableEvent を用いてイベントを作成した結果とする。

        2. etype 属性を activate に初期化する。

        3. activeWorkerグローバル オブジェクトe配送する

        4. 非同期拡張を待機eアクティブでなくなるまで、並列に待機する。

      2. task が実行されるか、破棄されるまで待機する。

      3. 非同期拡張を待機とラベル付けされた手順が完了するまで待機する。

  11. registrationアクティブワーカーと "activated" を 引数として渡して、ワーカー状態を更新アルゴリズムを実行する。

アクティベート試行

入力

registrationServiceWorker登録

出力

なし

  1. registrationwaiting worker が null なら return。

  2. registrationactive worker が null でなく、かつ registrationactive workerstate が "activating" なら return。

    注: 既存active workerがまだactivating状態なら、waiting workerのアクティベートは遅延される。

  3. 以下のいずれかが真なら Activateregistration)を呼び出す:

ServiceWorkerGlobalScopeのセットアップ

入力

serviceWorkerServiceWorker

出力

ServiceWorkerGlobalScope オブジェクトまたはnull

注: このアルゴリズムはCSPチェック等で使えるServiceWorkerGlobalScope またはnullを返す。serviceWorkerがactiveなServiceWorkerGlobalScopeを持つ場合はそれを返し、そうでなければ新規生成。

このアルゴリズムは、CSPやCOEPのようなセキュリティチェックに使えるService Workerを作成するために必要最小限のセットアップのみを行います。この仕様は、こうしたチェックが実行される前に、このアルゴリズムが呼ばれることを保証します。

仕様において、そのようなセキュリティチェックには、ServiceWorkerGlobalScope関連設定オブジェクトrealmagent の作成が必要です。実装では、必要な作業量はこれより少ない可能性があります。したがって、実装はこのアルゴリズムに相当する処理でより少ない作業を行い、必要ならRun Service Workerでより多くの作業を実施しても構いません。ただし、その結果が観察可能な範囲で等価であること(特に、すべてのセキュリティチェックが同じ結果となること)が前提です。

  1. unsafeCreationTimeunsafe shared current time とする。

  2. もし serviceWorker実行中 であれば、serviceWorkerglobal object を返す。

  3. もし serviceWorkerstate が "redundant" であれば、null を返す。

  4. もし serviceWorkerglobal object が null でなければ、serviceWorkerglobal object を返す。

  5. アサート: serviceWorkerstart status は null である。

  6. setupFailed を false にする。

  7. globalObject を null にする。

  8. agentService Worker エージェントを取得した結果とし、そのコンテキストで次を実行する:

    1. realmExecutionContext新しいrealmの生成agentおよび次のカスタマイズ指定)で得る:

      • グローバルオブジェクトとして、新しい ServiceWorkerGlobalScope オブジェクトを作成し、workerGlobalScopeとする。

    2. settingsObject を、次のアルゴリズムで定義される 環境設定オブジェクト の新しいインスタンスとする:

      レルム実行コンテキスト

      realmExecutionContextを返す。

      モジュールマップ

      workerGlobalScopeモジュールマップを返す。

      API基底URL

      serviceWorkerスクリプトURLを返す。

      オリジン

      それを登録したサービスワーカークライアントオリジンを返す。

      サイト間の 祖先を持つか

      それを登録したサービスワーカークライアントサイト間の 祖先を持つかを返す。

      ポリシーコンテナー

      workerGlobalScopeポリシー コンテナーを返す。

      時刻起点

      workerGlobalScopeオリジン間 分離機能を与えてunsafeCreationTime粗粒度化した結果を返す。

    3. settingsObjectIDを新しい一意な不透明文字列に、作成URLserviceWorkerスクリプトURLに、トップレベル作成 URLをnullに、トップレベルオリジン実装定義の値に、対象閲覧 コンテキストをnullに、またアクティブなサービス ワーカーをnullに設定する。

    4. workerGlobalScopeurlserviceWorkerscript url を設定する。

    5. workerGlobalScopepolicy containerserviceWorkerscript resourcepolicy container を設定する。

    6. workerGlobalScopetypeserviceWorkertype を設定する。

    7. 新しい WorkerLocation オブジェクトを作成し、workerGlobalScope に関連付ける。

    8. もし グローバルオブジェクトのCSP初期化 アルゴリズムを workerGlobalScope で実行した結果が "Blocked" であれば、setupFailed を true にし、これらの手順を中止する。

    9. globalObjectworkerGlobalScope を設定する。

  9. globalObject が null でなくなるか、setupFailed が true になるまで待つ。

  10. もし setupFailed が true であれば、null を返す。

  11. globalObject を返す。

ServiceWorkerの実行

入力

serviceWorkerServiceWorker

forceBypassCache:オプションのboolean。デフォルトはfalse

出力

Completionまたは失敗

注: このアルゴリズムはServiceWorkerがrunning状態になるか起動失敗するまでブロックする。

  1. serviceWorker実行中である場合、serviceWorker開始状態を返す。

  2. serviceWorker状態が「redundant」である場合、 失敗を返す。

  3. 表明:serviceWorker開始 状態はnullである。

  4. scriptを、serviceWorkerスクリプトリソースとする。

  5. 表明:scriptはnullでない。

  6. startFailedをfalseとする。

  7. workerGlobalScopeを、serviceWorkerグローバルオブジェクトとする。

  8. workerGlobalScopeがnullである場合:

    1. workerGlobalScopeを、serviceWorkerを用いてServiceWorkerGlobalScopeを設定する アルゴリズムを実行した結果に設定する。

    2. workerGlobalScopeがnullである場合、失敗を返す。

    3. serviceWorkerグローバルオブジェクトworkerGlobalScopeに設定する。

  9. workerGlobalScopeレルム実行コンテキストのエージェントを取得し、その コンテキスト内で次の手順を実行する:

    1. forceBypassCacheがtrueである場合、workerGlobalScopeインポート スクリプト用キャッシュ強制迂回フラグを設定する。

    2. serviceWorkerアクティブなワーカーであり、 serviceWorker包含するサービス ワーカー登録タスクキュー内に キューに入れられたタスクがある場合、それらを元のタスクソースを使用して、同じ順序で serviceWorkerイベントループタスクキューキューに入れる

    3. evaluationStatusをnullとする。

    4. scriptクラシックスクリプトである場合:

      1. evaluationStatusを、scriptクラシックスクリプトとして実行した結果に 設定する。

      2. evaluationStatus.[[Value]]が空である場合、これはスクリプトが 評価されなかったことを意味する。startFailedをtrueに設定し、これらの手順を 中止する。

    5. そうでなく、scriptモジュールスクリプトである場合:

      1. evaluationPromiseを、エラーの報告をfalseに設定して scriptモジュールスクリプトとして実行した結果とする。

      2. 表明:evaluationPromise.[[PromiseState]]は 「pending」でない。

      3. evaluationPromise.[[PromiseState]]が「rejected」である場合:

        1. evaluationStatusThrowCompletion(evaluationPromise.[[PromiseResult]])に 設定する。

      4. そうでない場合:

        1. evaluationStatusNormalCompletion(undefined)に 設定する。

    6. スクリプトがサービスワーカーを終了するアルゴリズムによって 中止された場合、startFailedをtrueに設定し、これらの手順を中止する。

    7. serviceWorker開始状態evaluationStatusに設定する。

    8. script一度でも評価されたことがあるフラグが 設定されていない場合:

      1. settingsObjectグローバルオブジェクトに 関連付けられたイベントリスナーのリストにある イベント型の各eventTypeについて:

        1. eventTypeを、workerGlobalScopeに関連付けられたサービス ワーカー処理するイベント型の 集合付加する

        注記: この時点で グローバルオブジェクトに関連付けられたイベントリスナーのリストにイベントリスナーが 追加されていない場合、サービスワーカーの処理するイベント型の 集合は空集合のままとなる。

      2. script一度でも評価されたことがある フラグを設定する。

      3. serviceWorkerすべてのフェッチ リスナーが空であるフラグを設定解除する。

      4. ユーザーエージェントは、workerGlobalScopeを用いたすべてのフェッチリスナーが空であるか アルゴリズムがtrueを返す場合、serviceWorkerすべての フェッチリスナーが空であるフラグを設定してもよい。

    9. settingsObjectによって指定された担当イベントループを、それが破棄されるまで 実行する。

    10. workerGlobalScopeアクティブなタイマーのマップ消去する

  10. serviceWorker実行中になるか、 startFailedがtrueになるまで待機する。

  11. startFailedがtrueである場合、失敗を返す。

  12. serviceWorker開始状態を返す。

fetchリスナーが全て空である

入力

workerGlobalScopeglobal object

出力

boolean

  1. workerGlobalScopeset of event types to handlefetch を含まなければ true を返す。

  2. eventHandlerworkerGlobalScopeevent handler map["onfetch"]の値に設定。

  3. eventListenerCallbackslegacy-obtain service worker fetch event listener callbacksworkerGlobalScope)の結果に設定。

  4. eventListenerCallback について eventListenerCallbacks内で:

    1. callback を null とする。

    2. もし eventHandler が null でなく、eventListenerCallbackeventHandlerlistenercallback と等しい場合、callbackECMAScript値へ変換した eventHandlervalue の結果を設定する。

    3. そうでなければ、callbackECMAScript値へ変換した eventListenerCallback の結果を設定する。

    4. もし IsCallable(callback) が false なら、false を返す。

      注: Callback オブジェクトが handleEvent(event) を使っている場合、非空と見なされます。これは、handleEvent(event) のgetterを呼び出すことで、このチェック中にイベントリスナーが変更される可能性を避けるためです。

    5. もし callback関数本体 が空でない(すなわち または 宣言 が存在する)なら、false を返す。

    注: () => {} のようなfetchリスナーを検出。一部サイトはPWA認定目的で空bodyのfetchリスナーを持つ。

  5. true を返す。

注: ユーザーエージェントは空fetchリスナーが不要で性能低下の可能性ある旨警告表示を推奨。

ServiceWorkerの終了

入力

serviceWorkerServiceWorker

出力

なし

  1. serviceWorkerのメインループと並列に、次の手順を実行する:

    1. serviceWorkerGlobalScopeを、serviceWorkerグローバルオブジェクトとする。

    2. serviceWorkerGlobalScopeclosingフラグをtrueに設定する。

    3. serviceWorker延長されたイベントの集合から、すべての項目削除する

    4. serviceWorkerGlobalScopeイベントループタスクキュー内にキューに入れられた、タスクソースフェッチ処理タスクソースまたは機能イベント処理 タスクソースのいずれかであるタスクがある場合、それらを元のタスクソースを使用して同じ順序で、 serviceWorker包含するサービス ワーカー登録の対応するタスクキューキューに入れserviceWorkerGlobalScopeイベントループタスクキューから、すべてのタスクタスクソースフェッチ処理タスクソースでも機能イベント処理 タスクソースでもないタスクを含む)を処理せずに破棄する。

      注記: これは実質的に、 フェッチイベントおよびプッシュイベントなどのその他の機能イベントが登録のタスクキューに 退避される一方で、メッセージイベントを含むその他のタスクは破棄されることを意味する。

    5. serviceWorker内で現在実行中のスクリプトを中止する

    6. serviceWorker開始状態をnullに設定する。

Fetch処理

Fetch処理アルゴリズムはfetch処理をServiceWorkerコンテキストへ委譲するエントリポイントです。

入力

requestリクエスト

fetchControllerフェッチコントローラー

useHighResPerformanceTimers、ブール値

出力

レスポンスまたはサービス ワーカータイミング情報

  1. registrationをnullとする。

  2. clientを、requestクライアントとする。

  3. reservedClientを、request予約済みクライアントとする。

  4. preloadResponseを新しいプロミスとする。

  5. workerRealmをnullとする。

  6. timingInfoを新しいサービスワーカータイミング情報とする。

  7. 表明:request宛先は 「serviceworker」でない。

  8. request宛先が「embed」 または「object」のいずれかである場合:

    1. nullを返す。

  9. そうでなく、request非サブリソースリクエストである場合:

    1. reservedClientがnullでなく、かつ環境設定オブジェクトである場合:

      1. reservedClientセキュアコンテキストでない場合、nullを返す。

    2. そうでない場合:

      1. requestURL潜在的に信頼できる URLでない場合、nullを返す。

    3. requestナビゲーションリクエストであり、それを引き起こしたナビゲーションがshift+reloadまたは同等の操作によって開始された場合、 nullを返す。

    4. reservedClientがnullでないことを表明する

    5. storage keyを、reservedClientを与えてストレージキーを取得するを実行した結果とする。

    6. registrationを、storage keyおよびrequestURLを与えてサービスワーカー登録を照合するを 実行した結果に設定する。

    7. registrationがnullであるか、registrationアクティブなワーカーがnullである場合、nullを返す。

    8. request宛先"report"でない場合、 reservedClientアクティブなサービス ワーカーregistrationアクティブなワーカーに 設定する。

    注記: この時点から、サービスワーカークライアントは、そのアクティブなサービスワーカー包含するサービスワーカー登録使用を開始する。

  10. そうでなく、requestサブリソースリクエストである場合:

    1. clientアクティブなサービス ワーカーがnullでない場合、registrationを、clientアクティブなサービス ワーカー包含するサービス ワーカー登録に設定する。

    2. そうでない場合、nullを返す。

  11. activeWorkerを、registrationアクティブなワーカーとする。

  12. shouldSoftUpdateを、次のいずれかがtrueである場合はtrue、それ以外の場合はfalseとする:

  13. activeWorkerルータールールのリスト空でない場合:

    1. timingInfoワーカー ルーター評価開始時刻を、useHighResPerformanceTimersを与えた粗粒度化された共有現在時刻に 設定する。

    2. sourceを、registrationアクティブなワーカーおよび requestを用いてルーターソースを取得する アルゴリズムを実行した結果とする。

    3. sourceがnullでない場合:

      1. timingInfoワーカー 一致ルーターソースsourceに設定し、ワーカー 最終ルーターソース"network"に 設定する。

      2. source"network"である場合:

        1. shouldSoftUpdateがtrueである場合、 registrationを用いてソフト更新アルゴリズムを並列に実行する。

        2. timingInfoを返す。

      3. そうでなく、source"cache"であるか、 source["cacheName"]が存在する場合:

        1. shouldSoftUpdateがtrueである場合、 registrationを用いてソフト更新アルゴリズムを並列に実行する。

        2. timingInfoワーカー キャッシュ検索開始時刻を、useHighResPerformanceTimersを 与えた粗粒度化された共有 現在時刻に設定する。

        3. environmentをnullとする。

        4. request非サブリソース リクエストである場合:

          1. environmentreservedClientに設定する。

        5. そうでない場合:

          1. environmentclientに設定する。

        6. cachesを、environmentおよび 「caches」を用いてローカル ストレージボトルマップを取得するを実行した結果とする。

        7. cachesの各cacheNamecacheについて反復する

          1. source["cacheName"]が存在し、かつ source["cacheName"]が cacheNameない場合、継続する

          2. requestResponsesを、request、新しいCacheQueryOptions、 およびcacheを用いてキャッシュを照会するを 実行した結果とする。

          3. requestResponsesが空のリストである場合、 timingInfoを返す。

          4. そうでない場合:

            1. requestResponseを、 requestResponsesの最初の要素とする。

            2. responseを、 requestResponseのレスポンスとする。

            3. globalObjectを、 activeWorkerグローバル オブジェクトとする。

            4. globalObjectがnullである場合:

              1. globalObjectを、 activeWorkerを用いてServiceWorkerGlobalScopeを 設定するを実行した結果に設定する。

            5. globalObjectがnullである場合、 timingInfoを返す。

              注記: これはCORSチェックに 必要であるためにのみServiceWorkerGlobalScopeを作成する。 実装がここで実際にServiceWorkerGlobalScopeを作成することは 想定されていない。

            6. response種別が 「opaque」であり、 globalObjectオリジンglobalObject、""、および response内部 レスポンスを用いたオリジン間 リソースポリシーチェックblockedを返す場合、 timingInfoを返す。

            7. timingInfoワーカー 最終ルーターソース"cache"に 設定する。

            8. resultサービス ワーカータイミング情報timingInfoに設定する。

            9. responseを返す。

        8. timingInfoを返す。

      4. そうでなく、source"race-network-and-fetch-handler"であり、 requestメソッドが`GET` である場合:

        1. shouldSoftUpdateがtrueである場合、 registrationを用いてソフト更新アルゴリズムを並列に実行する。

        2. queueを、競合 結果の空のキューとする。

        3. raceFetchControllerをnullとする。

        4. raceResponseを、そのが 「pending」である競合レスポンスとする。

        5. 次の下位手順を並列に実行する:

          1. fetchController状態が 「terminated」または 「aborted」である場合、 raceResponseを、そのがnullである競合レスポンスに設定し、 これらの手順を中止する。

          2. raceFetchControllerを、requestを与えてフェッチを呼び出した結果に 設定する。その際、processResponseを、 レスポンス raceNetworkRequestResponseを与えた次の手順に設定する:

            1. 次の手順を実行するが、fetchController状態が 「terminated」または 「aborted」になったとき中止する

              1. raceResponseraceNetworkRequestResponseに 設定する。

              2. raceNetworkRequestResponseステータス成功ステータスで ある場合:

                1. raceNetworkResultを、そのルーティングされた レスポンスraceNetworkRequestResponseで、 使用された ルート"network"で ある競合 結果とする。

                2. raceNetworkResultqueueエンキューする

            2. 中止された場合で、 raceFetchControllerがnullでない場合:

              1. raceFetchController中止する

              2. raceResponseを、そのが nullである競合 レスポンスに設定する。

        6. preloadResponseをundefinedで解決する。

        7. 次の下位手順を並列に実行する:

          1. fetchHandlerResponseを、requestregistrationuseHighResPerformanceTimerstimingInfoworkerRealmreservedClientpreloadResponse、 およびraceResponseを用いてフェッチ イベントを作成して配送するを実行した結果とする。

          2. fetchHandlerResponseがnullでもネットワークエラーでも なく、かつraceFetchControllerがnullでない場合、 raceFetchController中止する

          3. raceFetchHandlerResultを、そのルーティングされた レスポンスfetchHandlerResponseであり、使用されたルート"fetch-event"で ある競合結果とする。

          4. raceFetchHandlerResultqueueエンキューする

        8. queueが空でなくなるまで待機する。

        9. resultを、queueデキューした結果とする。

        10. routedResponseを、resultルーティングされた レスポンスとする。

        11. routedResponseがnullである場合:

          1. timingInfoを返す。

        12. result使用されたルート"network"で ある場合:

          1. routedResponseサービスワーカー タイミング情報timingInfoに設定する。

        13. routedResponseサービスワーカータイミング 情報ワーカー 最終ルーターソースを、result使用されたルートに設定する。

        14. routedResponseを返す。

      5. 表明:sourceは「fetch-event」である。

  14. responseForAutoPreloadをnullとする。

  15. requestナビゲーションリクエストであり、requestメソッドが`GET`であり、 registrationアクティブなワーカー処理するイベント型の集合fetch含み、かつregistrationアクティブなワーカーすべてのフェッチリスナーが 空であるフラグが設定されていない場合:

    1. registrationナビゲーション プリロード有効フラグが設定されている場合:

      注記: 上記の条件のうち、 registrationアクティブなワーカー処理するイベント型の集合fetchを含まないことを除いてすべてtrueである場合、開発者の意図が明確でないため、 ユーザーエージェントはコンソール警告を表示してもよい。

      1. preloadRequestを、リクエストrequest複製した結果とする。

      2. preloadRequestHeadersを、preloadRequestヘッダーリストとする。

      3. preloadResponseObjectを、ガードが 「immutable」である新しいHeaders オブジェクトに関連付けられた新しいResponse オブジェクトとする。

      4. preloadRequestHeadersに、名前が `Service-Worker-Navigation-Preload`で、registrationナビゲーション プリロードヘッダー値である新しいヘッダー付加する

      5. preloadRequestサービスワーカーモードを 「none」に設定する。

      6. preloadFetchControllerをnullとする。

      7. 次の下位手順を並列に実行するが、 fetchController状態が 「terminated」または「aborted」になったとき中止する

        1. preloadFetchControllerを、 preloadRequestフェッチした結果に設定する。

          navigationPreloadResponseprocessResponseとして、 次の下位手順を実行する:

          1. navigationPreloadResponse種別が 「error」である場合、 preloadResponseTypeErrorで拒否し、 これらの下位手順を終了する。

          2. preloadResponseObjectnavigationPreloadResponseに関連付ける。

          3. preloadResponsepreloadResponseObjectで解決する。

      8. 中止された場合

        1. deserializedErrorを、nullおよび workerRealmを与えて直列化された 中止理由を逆直列化するを実行した結果とする。

        2. preloadFetchControllerdeserializedError中止する

    2. そうでなく、timingInfoワーカー 一致ルーターソースが「fetch-event」で ない場合、ユーザーエージェントは次の下位手順を実行してもよい:

      注記: ユーザーエージェントは、 起動コストを最小限に抑えるため、フェッチイベントの作成と並列にネットワークリクエストを 投機的に配送してもよい。

      1. 表明:timingInfoワーカー 一致ルーターソースはnullである。

      2. autoPreloadFetchControllerをnullとする。

      3. responseForAutoPreloadを、そのが 「pending」である競合 レスポンスに設定する。

      4. 次の下位手順を並列に実行するが、 fetchController状態が 「terminated」または「aborted」になったとき中止する

        1. autoPreloadFetchControllerを、 requestを与えてフェッチを呼び出した結果に設定する。 その際、processResponseを、レスポンス autoPreloadRequestResponseを与えた次の手順に設定する:

          1. responseForAutoPreloadautoPreloadRequestResponseに設定する。

      5. 中止された場合で、 autoPreloadFetchControllerがnullでない場合:

        1. autoPreloadFetchController中止する

        2. responseForAutoPreloadを、そのがnullである競合レスポンスに設定する。

      6. preloadResponseをundefinedで解決する。

  16. そうでない場合、preloadResponseをundefinedで解決する。

  17. fetchResultを、requestregistrationuseHighResPerformanceTimerstimingInfoworkerRealmreservedClientpreloadResponse、および responseForAutoPreloadを用いてフェッチイベントを作成して配送するを 実行した結果とする。

  18. timingInfoワーカー最終ルーター ソースが空文字列でない場合:

    1. timingInfoワーカー最終 ルーターソース"network"で あることを表明する。

    2. fetchResultがnullである場合、timingInfoを返す。

    3. そうでない場合:

      1. fetchResultサービスワーカータイミング 情報ワーカー 最終ルーターソース"network"で あることを表明する。

      2. fetchResultサービスワーカータイミング 情報ワーカー 最終ルーターソース"fetch-event"に 設定する。

  19. fetchResultを返す。

Fetchイベント生成・dispatch

入力

requestリクエスト

registrationサービスワーカー登録

useHighResPerformanceTimers、ブール値

timingInfoサービスワーカータイミング情報

workerRealm関連レルムであり、グローバルオブジェクトのもの

reservedClient予約済みクライアント

preloadResponseプロミス

raceResponse競合レスポンスまたはnull

出力

レスポンスまたはnull

  1. responseをnullとする。

  2. eventCanceledをfalseとする。

  3. clientを、requestクライアントとする。

  4. activeWorkerを、registrationアクティブなワーカーとする。

  5. eventHandledをnullとする。

  6. handleFetchFailedをfalseとする。

  7. respondWithEnteredをfalseとする。

  8. networkErrorネットワークエラーとする。

  9. raceResponseがnullでない場合:

    1. networkErrorサービスワーカータイミング情報timingInfoに設定する。

  10. shouldSoftUpdateを、次のいずれかがtrueである場合はtrue、それ以外の場合は falseとする:

  11. 「fetch」およびactiveWorkerを用いてイベントをスキップすべきかアルゴリズムを実行した結果が trueである場合:

    1. shouldSoftUpdateがtrueである場合、registrationを用いてソフト更新アルゴリズムを並列に実行する。

    2. nullを返す。

  12. activeWorkerすべてのフェッチリスナーが 空であるフラグが設定されている場合:

    1. 並列に

      1. activeWorker状態が「activating」である場合、 activeWorker状態が「activated」になるまで待機する。

      2. activeWorkerを用いてサービスワーカーを実行するアルゴリズムを 実行する。

      3. shouldSoftUpdateがtrueである場合、 registrationを用いてソフト更新アルゴリズムを 実行する。

    2. nullを返す。

  13. useHighResPerformanceTimersがtrueである場合、 useHighResPerformanceTimersactiveWorkerグローバルオブジェクトオリジン間 分離機能に設定する。

  14. timingInfo開始時刻を、 useHighResPerformanceTimersを与えた粗粒度化された共有現在時刻とする。

  15. activeWorker状態が「activating」である場合、 activeWorker状態が「activated」になるまで待機する。

  16. activeWorkerを用いてサービスワーカーを実行するアルゴリズムを実行した結果が 失敗である場合、handleFetchFailedをtrueに設定する。

  17. そうでない場合:

    1. workerRealmを、activeWorkerグローバルオブジェクト関連レルムに設定する。

    2. eventHandledを、workerRealm内の新しいプロミスに設定する。

    3. raceResponseがnullでない場合、activeWorkerグローバルオブジェクト競合レスポンス マップ[request]をraceResponse設定する

    4. 次の下位手順を実行するタスクtaskキューに入れる

      1. eを、FetchEventを用いてイベントを作成した結果とする。

      2. abortControllerを、workerRealmを用いた新しい AbortController オブジェクトとする。

      3. requestObjectを、requestガードが 「immutable」である新しいHeaders オブジェクト、abortControllerシグナル、および workerRealmを与えてRequest オブジェクトを作成した結果とする。

      4. etype 属性をfetchに 初期化する。

      5. ecancelable 属性をtrueに初期化する。

      6. erequest 属性をrequestObjectに初期化する。

      7. epreloadResponsepreloadResponseに初期化する。

      8. clientがnullでない場合、eclientId 属性をclientIDに初期化する。

      9. request非サブリソースリクエストであり、 request宛先"report"でなく、 かつreservedClientがnullでない場合、eresultingClientId 属性をreservedClientIDに初期化する。

      10. requestナビゲーションリクエストである場合、 ereplacesClientId 属性をrequest置換対象クライアントIDに 初期化する。

      11. ehandledeventHandledに初期化する。

      12. timingInfoフェッチ イベント配送時刻を、useHighResPerformanceTimersを与えた粗粒度化された共有現在 時刻とする。

      13. activeWorkerグローバルオブジェクトe配送する

      14. activeWorkerおよびeを用いてサービスワーカーの 延長イベント集合を更新するを呼び出す。

      15. erespond-with入力済み フラグが設定されている場合、respondWithEnteredをtrueに設定する。

      16. e応答待機フラグが 設定されている場合:

        1. e応答待機 フラグが設定解除されるまで待機する。

        2. erespond-with エラーフラグが設定されている場合、 handleFetchFailedをtrueに設定する。

        3. そうでない場合、responsee潜在的な レスポンスに設定する。

      17. responseがnullであり、request本体がnullでなく、かつ request本体ソースがnullである場合:

        1. request本体使用不能である場合、 handleFetchFailedをtrueに設定する。

        2. そうでない場合、request本体をundefinedでキャンセルする

      18. responseがnullでない場合、responseサービスワーカータイミング 情報timingInfoに設定する。

      19. eキャンセル済みフラグが設定されている場合、 eventCanceledをtrueに設定する。

      20. fetchController状態が 「terminated」または「aborted」である場合:

        1. deserializedErrorを、 fetchController直列化された 中止理由およびworkerRealmを与えて直列化された 中止理由を逆直列化するを実行した結果とする。

        2. abortController上で deserializedErrorを用いて中止を通知するタスクをキューに入れる

      taskが破棄された場合、handleFetchFailedをtrueに設定する。

      taskは、activeWorkerイベントループおよびフェッチ処理タスクソースを使用しなければ ならない

  18. taskが実行されるか、handleFetchFailedがtrueになるまで待機する。

  19. shouldSoftUpdateがtrueである場合、registrationを用いてソフト更新アルゴリズムを並列に実行する。

  20. activeWorkerグローバルオブジェクト競合レスポンス マップ[request]が存在する場合、activeWorkerグローバルオブジェクト競合レスポンス マップ[request]を削除する

  21. respondWithEnteredがfalseである場合:

    1. eventCanceledがtrueである場合:

      1. eventHandledがnullでない場合、 workerRealm内でeventHandledを「NetworkErrorDOMException拒否する

      2. networkErrorを返す。

    2. eventHandledがnullでない場合、eventHandled解決する

    3. raceResponseがnullでなく、かつraceResponseがnullでない場合:

      1. raceResponseが 「pending」でなくなるまで待機する。

      2. raceResponseレスポンスである場合、 raceResponseを返す。

    4. nullを返す。

  22. handleFetchFailedがtrueである場合:

    1. eventHandledがnullでない場合、workerRealm内で eventHandledを「NetworkErrorDOMException拒否する

    2. networkErrorを返す。

  23. eventHandledがnullでない場合、eventHandled解決する

  24. responseを返す。

URLパターンの解析

入力

rawPatternURLPatternCompatible

serviceWorkerサービスワーカー

出力

URLパターン

  1. baseURLserviceWorkerスクリプトURLとする。

  2. rawPatternおよびbaseURLを与えて、Web IDL値からURLパターンを構築する結果を返す。

ルーター条件の検証

入力

conditionRouterCondition

serviceWorkerサービスワーカー

出力

真偽値

  1. hasConditionをfalseにする。

  2. condition["urlPattern"] が存在する場合:

    1. rawPatterncondition["urlPattern"]とする。

    2. rawPatternserviceWorkerを渡してURLパターンの解析アルゴリズムを実行した結果をpatternとする。これが例外を投げた場合はcatchし、falseを返す。

    3. pattern正規表現グループを持つ場合、falseを返す。

      注:ユーザー定義正規表現の実行はセキュリティ上の懸念があるため、禁止されている。

    4. hasConditionをtrueにする。

  3. condition["requestMethod"] が存在する場合:

    1. methodcondition["requestMethod"]とする。

    2. methodメソッドでなければ、falseを返す。

    3. method禁止メソッドならば、falseを返す。

    4. hasConditionをtrueにする。

  4. condition["requestMode"] が存在する場合、hasConditionをtrueにする。

  5. condition["requestDestination"] が存在する場合、hasConditionをtrueにする。

  6. condition["runningStatus"] が存在する場合、hasConditionをtrueにする。

  7. condition["_or"] が存在する場合:

    1. hasConditionがtrueなら、falseを返す。

      注:ルーター規則の理解を容易にするため、"or"条件は他の条件と相互排他である。

    2. orConditionscondition["_or"]とする。

    3. orConditionsの各orConditionについて:

      1. orConditionserviceWorkerを使ってルーター条件の検証アルゴリズムを実行し、falseならfalseを返す。

    4. hasConditionをtrueにする。

  8. condition["not"] が存在する場合:

    1. hasConditionがtrueなら、falseを返す。

      注:ルーター規則の理解を容易にするため、"not"条件は他の条件と相互排他である。

    2. condition["not"]とserviceWorkerを使ってルーター条件の検証アルゴリズムを実行し、falseならfalseを返す。

    3. hasConditionをtrueにする。

  9. hasConditionを返す。

ルーター条件のマッチング

入力

conditionRouterCondition

serviceWorkerサービスワーカー

requestリクエスト

出力

真偽値

注:複数の条件(例:urlPatternrunningStatusrequestMethodが設定されている場合)は、すべての条件が一致した場合にtrueが返される。

  1. condition["or"] が存在する場合:

    1. orConditionscondition["or"]とする。

    2. orConditionsの各orConditionについて:

      1. orConditionserviceWorkerrequestを使ってルーター条件のマッチングアルゴリズムを実行し、trueが返った場合はtrueを返す。

    3. falseを返す。

  2. condition["not"] が存在する場合:

    1. condition["not"]、serviceWorkerrequestを使ってルーター条件のマッチングアルゴリズムを実行し、trueが返った場合はfalseを返す。

    2. trueを返す。

  3. それ以外:

    注:ルーター条件の検証アルゴリズムは、ornotと他の条件が排他されていることを保証する。

    1. condition["urlPattern"] が存在する場合:

      1. rawPatterncondition["urlPattern"]とする。

      2. rawPatternserviceWorkerを渡してURLパターンの解析アルゴリズムを実行した結果をpatternとする。

      3. patternrequestURLマッチングを実行し、結果がnullならfalseを返す。

    2. condition["requestMethod"] が存在する場合:

      1. methodcondition["requestMethod"]とする。

      2. method正規化する。

      3. requestメソッドmethodでなければ、falseを返す。

    3. condition["requestMode"] が存在する場合:

      1. modecondition["requestMode"]とする。

      2. requestモードmodeでなければ、falseを返す。

    4. condition["requestDestination"] が存在する場合:

      1. destinationcondition["requestDestination"]とする。

      2. request宛先destinationでなければ、falseを返す。

    5. condition["runningStatus"] が存在する場合:

      1. runningStatuscondition["runningStatus"]とする。

      2. runningStatus"running"であり、serviceWorker稼働中でなければ、falseを返す。

      3. runningStatus"not-running"であり、serviceWorker稼働中ならば、falseを返す。

    6. trueを返す。

ルーター登録制限の確認

入力

routerRulesルーター規則のリスト

出力

真偽値

注: ルーター条件は_ornotを用いて複雑かつネスト可能です。過度な処理を防ぐため、このアルゴリズムでは2つの制限を設けます。第一に、すべてのネストされた条件を含む合計条件数は1024を超えてはなりません。第二に、ネストの深さは10レベルまでに制限され、指数的計算を回避します。

  1. resultルーター条件カウント結果とする。

  2. result条件数を1024に設定する。

  3. resultクォータ超過をfalseに設定する。

  4. rulerouterRulesから取り出して:

    1. resultを、Count Router Inner Conditionsアルゴリズムの rule["condition"], result、10を渡した結果で更新する。

    2. resultクォータ超過がtrueなら、falseを返す。

  5. trueを返す。

ルーター内条件数のカウント

入力

conditionRouterCondition

resultルーター条件カウント結果

depth、数値

出力

resultルーター条件カウント結果

  1. result条件数を1減らす。

  2. result条件数が0、またはdepthが0なら:

    1. resultクォータ超過をtrueに設定する。

    2. resultを返す。

  3. condition["_or"] が存在する場合:

    1. depthを1減らす。

    2. condition["_or"]の各orConditionについて:

      1. resultを、ルーター内条件数のカウントorConditionresultdepthで実行した結果で更新する。

      2. resultクォータ超過がtrueなら、resultを返す。

  4. それ以外でcondition["not"] が存在する場合:

    1. depthを1減らす。

    2. resultを、ルーター内条件数のカウントcondition["not"]、resultdepthで実行した結果で更新する。

    3. resultクォータ超過がtrueなら、resultを返す。

  5. resultを返す。

ルーターソースの取得

入力

serviceWorkerサービスワーカー

requestリクエスト

出力

RouterSource またはnull

  1. ruleserviceWorkerルーター規則のリストから取り出して:

    1. rule["condition"]、serviceWorkerrequestを使ってルーター条件のマッチングアルゴリズムを実行し、trueなら rule["source"]を返す。

  2. nullを返す。

イベントをスキップすべきか

入力

eventName、文字列

serviceWorkerサービスワーカー

出力

真偽値

注: 不要な遅延を避けるため、この仕様ではサービスワーカーのグローバルにイベントリスナーが初回スクリプト実行時に決定的に追加されていない場合、イベントのdispatchをスキップすることを許可します。

  1. serviceWorker処理するイベント型の集合eventName含まない場合、ユーザーエージェントはスキップ可能としてtrueを返すことができる。

  2. falseを返す。

ファンクショナルイベントを発火

入力

eventName、文字列

eventConstructorExtendableEvent を拡張するイベントコンストラクタ

registrationservice worker registration

initialization、任意。eventeventConstructor から構築される)のプロパティ初期化

postDispatchSteps、任意。active worker のイベントループ上で実行するステップ群。ここで dispatchedEventeventConstructor のインスタンスで、dispatch されたものとする。

出力

なし

  1. 断言: registrationactive worker は null でない。

  2. activeWorkerregistrationactive worker とする。

  3. もし eventNameactiveWorker を使って Should Skip Event を実行した結果が true なら、次を行う:

    1. もし registrationstale なら、並列で Soft Update アルゴリズムを registration で実行する。

    2. 返す。

  4. もし activeWorkerstate が "activating" なら、activeWorkerstate が "activated" になるのを待つ。

  5. もし Run Service Worker アルゴリズムを activeWorker で実行した結果が failure なら、次を行う:

    1. もし registrationstale なら、並列で Soft Update アルゴリズムを registration で実行する。

    2. 返す。

  6. タスクをキューし、次のサブステップを実行する task を登録する:

    1. event を、eventConstructoractiveWorkerrelevant realmactiveWorkerglobal object)を用いて イベントを作成した結果とする。

    2. もし initialization が null でなければ、initialization を使って event を初期化する。

    3. DispatchactiveWorkerglobal object 上で行い、event を送出する。

    4. Update Service Worker Extended Events SetactiveWorkerevent で呼び出す。

    5. もし postDispatchSteps が null でなければ、postDispatchSteps を実行し、引数として eventdispatchedEvent に渡す。

    この taskactiveWorkerイベントループhandle functional event task source を使用しなければならない。

  7. task が実行されるか破棄されるのを待つ。

  8. もし registrationstale なら、並列で Soft Update アルゴリズムを registration で実行する。

特定の serviceWorkerRegistration 上で "amazingthing" イベント(型は AmazingThingEvent)を発火し、イベントオブジェクトのプロパティを初期化する例の説明は次のようになる:
  1. Fire Functional Event "amazingthing" を AmazingThingEvent を使って serviceWorkerRegistration 上で実行し、次のプロパティで初期化する:

    propertyName

    value

    anotherPropertyName

    anotherValue

    その後、dispatchedEvent を使って次のステップを実行する:

    1. サービスワーカーのイベントループ上で dispatchedEvent を使って必要な処理を行う。

初期化ステップとポストディスパッチステップは省略可能である。必要ない場合の記述は次のようになる:

  1. Fire Functional Event "whatever" を ExtendableEvent を使って serviceWorkerRegistration 上で実行する。

Service Worker クライアントのアンロード処理

ユーザーエージェントは、サービスワーカー クライアント文書のアンロード時クリーンアップ手順または終了によってアンロードされる際の一部として、これらの手順を実行し なければならない

入力

clientサービスワーカークライアント

出力

なし

  1. 次の手順を不可分に実行する。

  2. registrationを、client使用しているサービスワーカー登録とする。

  3. registrationがnullである場合、これらの手順を中止する。

  4. 他のいずれかのサービスワーカークライアントregistration使用している場合、これらの手順を中止する。

  5. registration登録解除済みである場合、 registrationを用いて登録の消去を試行するを呼び出す。

  6. registrationを用いてアクティブ化を試行するを呼び出す。

ユーザーエージェントのシャットダウン処理

入力

なし

出力

なし

  1. registrationregistration mapvalues から反復する:

    1. もし registrationinstalling worker が null でなければ:

      1. もし registrationwaiting worker が null で、かつ registrationactive worker が null なら、Clear Registrationregistration で呼び出し、ループの次の反復に進む。

      2. それ以外なら、registrationinstalling worker を null に設定する。

    2. もし registrationwaiting worker が null でなければ、並列で 次を行う:

      1. Activateregistration で呼び出す。

Service Worker の拡張イベント集合を更新

入力

workerサービスワーカー

eventExtendableEvent

出力

なし

  1. 断言: eventdispatch flag はセットされていない。

  2. item について、workerset of extended events を走査する:

    1. もし itemactive でなければ、remove して workerset of extended events から取り除く。

  3. もし eventactive なら、append して workerset of extended events に追加する。

登録解除 (Unregister)

入力

jobjob

出力

なし

  1. registration を、jobストレージキーjobスコープURL を指定して Get Registrationを実行した結果とする。

  2. registration が null なら:

    1. Resolve Job Promisejob と false で呼び出す。

    2. Finish Jobjob とともに呼び出し、これらのステップを中止する。

  3. Remove registration map[(registrationストレージキー, jobスコープURL)] を削除する。

  4. Resolve Job Promisejob と true で呼び出す。

  5. Try Clear Registrationregistration で呼び出す。

    Note: ここでTry Clear RegistrationClear Registrationをトリガーしない場合は、 最後のクライアントがregistrationを使用しなくなるか、 または登録されたサービスワーカーのextend lifetime promisesが解決されたときに、 Clear Registrationが再度試行される。

  6. Finish Jobjob で呼び出す。

登録を設定 (Set Registration)

入力

storage keystorage key

scopeURL

updateViaCacheupdate via cache mode

出力

registrationservice worker registration

  1. 次のステップを原子的に実行する。

  2. scopeString を、serialize した scopeexclude fragment flag を設定)とする。

  3. registration を新しい service worker registration とし、その storage keystorage keyscope urlscope、および update via cache modeupdateViaCache に設定する。

  4. Set registration map[(storage key, scopeString)] を registration に設定する。

  5. 返す registration

登録をクリア (Clear Registration)

入力

registrationservice worker registration

出力

なし

  1. 次のステップを原子的に実行する。

  2. もし registrationinstalling worker が null でなければ、次を行う:

    1. Terminateregistrationinstalling worker に対して実行する。

    2. Update Worker State を呼び出し、registrationinstalling worker と "redundant" を引数として渡す。

    3. Update Registration State を呼び出し、registration、"installing"、および null を引数として渡す。

  3. もし registrationwaiting worker が null でなければ、次を行う:

    1. Terminateregistrationwaiting worker に対して実行する。

    2. Update Worker State を呼び出し、registrationwaiting worker と "redundant" を引数として渡す。

    3. Update Registration State を呼び出し、registration、"waiting"、および null を引数として渡す。

  4. もし registrationactive worker が null でなければ、次を行う:

    1. Terminateregistrationactive worker に対して実行する。

    2. Update Worker State を呼び出し、registrationactive worker と "redundant" を引数として渡す。

    3. Update Registration State を呼び出し、registration、"active"、および null を引数として渡す。

Try Clear Registration

入力

registrationservice worker registration

出力

なし

  1. もしどの service worker client使用しておらず、かつ次のすべての条件が真であれば、Clear Registrationregistration で呼び出す:

登録状態を更新 (Update Registration State)

入力

registrationservice worker registration

target、文字列("installing"、"waiting"、"active" のいずれか)

sourceservice worker または null

出力

なし

  1. registrationObjects を、registration に関連付けられたすべての ServiceWorkerRegistration オブジェクトを含む配列とする。

  2. target が "installing" である場合:

    1. registrationインストール中の Workersource に設定する。

    2. registrationObjects 内の各 registrationObject について:

      1. registrationインストール中の Workerが null である場合は registrationObjectinstalling 属性を null に設定し、それ以外の場合は registrationObject関連する設定オブジェクト内で registrationインストール中の Workerを表す service worker オブジェクトを取得した結果に設定する タスクをキューに追加する

  3. それ以外で target が "waiting" の場合、次を行う:

    1. registration待機中のワーカーsource に設定する。

    2. registrationObjects 内の各 registrationObject について:

      1. タスクをキューに入れる。そのタスクは、 registration待機中のワーカーが null の場合は registrationObjectwaiting 属性を null に設定し、それ以外の場合は、 registrationObject関連する設定オブジェクト内で registration待機中のワーカーを表すサービスワーカー オブジェクトを取得した結果に設定する。

  4. それ以外で target が "active" の場合、次を行う:

    1. registrationアクティブワーカーsource に設定する。

    2. registrationObjects 内の各 registrationObject について:

      1. タスクをキューに入れる。そのタスクは、 registrationアクティブワーカーが null の場合は registrationObjectactive 属性を null に設定し、それ以外の場合は、 registrationObject関連する設定オブジェクト内で registrationアクティブワーカーを表すサービスワーカー オブジェクトを取得した結果に設定する。

    タスクは、registrationObject関連する設定オブジェクト担当イベントループおよびDOM 操作タスクソースを使用しなければならない

ワーカー状態を更新 (Update Worker State)

入力

workerservice worker

state、サービスワーカーの state

出力

なし

  1. 表明:state は "parsed" ではない。

    注: "parsed" は 初期状態である。サービスワーカーがこの状態に更新されることはない。

  2. worker状態state に設定する。

  3. settingsObjects を、そのオリジンworkerスクリプト URLオリジンである、すべての環境設定オブジェクトとする。

  4. settingsObjects の各 settingsObject について、settingsObject担当イベントループ上で、DOM 操作タスクソースにおいて、次の 手順を実行するタスクをキューに入れる

    1. objectMapsettingsObjectサービス ワーカーオブジェクトマップとする。

    2. objectMap[worker] が存在しない場合、これらの手順を中止する。

    3. workerObjobjectMap[worker] とする。

    4. workerObjstatestate に設定する。

    5. workerObjstatechange という名前のイベントを発火する

コントローラ変更の通知 (Notify Controller Change)

入力

clientサービスワーカークライアント

出力

なし

  1. 表明:client は null ではない。

  2. client環境設定オブジェクトである場合、client関連付けられている ServiceWorkerContainer オブジェクトで controllerchange という名前のイベントを発火するためのタスクをキューに入れる

タスクは、client担当イベントループおよびDOM 操作タスクソースを使用しなければならない

サービスワーカー登録を照合 (Match Service Worker Registration)

入力

storage keystorage key

clientURLURL

出力

service worker registration または null

  1. 次のステップを原子的に実行する。

  2. clientURLStringclientURLserialize 結果とする。

  3. matchingScopeString を空文字列にする。

  4. scopeStringSet を空のリストにする。

  5. (entry storage key, entry scope) を registration mapkeys から反復する:

    1. もし storage keyentry storage key等しい なら、append して entry scopescopeStringSet の末尾に追加する。

  6. matchingScopeString を、scopeStringSet の中で clientURLString が先頭に持つ最長の値に設定する(存在する場合)。

    注意: このステップの URL 文字列の照合はパス構造ベースではなくプレフィックスベースである。例えばクライアント URL 文字列 "https://example.com/prefix-of/resource.html" はスコープ "https://example.com/prefix" に一致する。HTTP(S) の URL は常に起点部分に末尾スラッシュが付いてシリアライズされるため、同一オリジンの安全性が保たれる。

  7. matchingScope を null にする。

  8. もし matchingScopeString が空文字列でないなら:

    1. matchingScopematchingScopeStringparse した結果に設定する。

    2. 断言: matchingScopeoriginclientURLorigin同一オリジン である。

  9. Get Registrationstorage keymatchingScope で実行した結果を返す。

登録を取得 (Get Registration)

入力

storage keystorage key

scopeURL

出力

service worker registration または null

  1. 次のステップを原子的に実行する。

  2. scopeString を空文字列にする。

  3. もし scope が null でなければ、scopeStringscopeserializeexclude fragment flag を設定)した結果に設定する。

  4. (entry storage key, entry scope) → registrationregistration map から反復する:

    1. もし storage keyentry storage key等しく、かつ scopeStringentry scope と一致するなら、registration を返す。

  5. null を返す。

最新のワーカーを取得 (Get Newest Worker)

入力

registrationservice worker registration

出力

newestWorkerservice worker または null

  1. 次のステップを原子的に実行する。

  2. newestWorker を null にする。

  3. もし registrationinstalling worker が null でなければ、registrationinstalling workernewestWorker に設定する。

  4. そうでなくてもし registrationwaiting worker が null でなければ、registrationwaiting workernewestWorker に設定する。

  5. さらにそうでなくてもし registrationactive worker が null でなければ、registrationactive workernewestWorker に設定する。

  6. newestWorker を返す。

サービスワーカーに保留中イベントがないか (Service Worker Has No Pending Events)

入力

workerservice worker

出力

真または偽、ブール値

  1. workerset of extended events の各 event について:

    1. もし eventactive なら、false を返す。

  2. true を返す。

クライアントを作成 (Create Client)

入力

clientservice worker client

出力

clientObjectClient オブジェクト

  1. clientObject を新しい Client オブジェクトとする。

  2. clientObjectservice worker clientclient に設定する。

  3. clientObject を返す。

Window Client を作成 (Create Window Client)

入力

clientservice worker client

frameType、文字列

visibilityState、文字列

focusState、ブール値

ancestorOriginsList、リスト

出力

windowClientWindowClient オブジェクト

  1. windowClient を新しい WindowClient オブジェクトとする。

  2. windowClientservice worker clientclient に設定する。

  3. windowClientframe typeframeType に設定する。

  4. windowClientvisibility statevisibilityState に設定する。

  5. windowClientfocus statefocusState に設定する。

  6. windowClientancestor origins array を、ancestorOriginsList から作成した frozen array に設定する。

  7. windowClient を返す。

フレームタイプを取得 (Get Frame Type)

入力

navigablenavigable

出力

frameType、文字列

  1. もし navigableparent が null でなければ、"nested" を返す。

  2. もし navigableactive browsing contextauxiliary browsing context なら、"auxiliary" を返す。

  3. "top-level" を返す。

Get Client Promise を解決 (Resolve Get Client Promise)

入力

clientservice worker client

promisepromise

出力

なし

  1. client環境設定オブジェクトである場合、次を行う:

    1. clientセキュアコンテキストでない場合、promise関連する設定オブジェクト担当イベントループ上で、DOM 操作タスクソースを使用して、 promise を "SecurityError" DOMException で拒否するタスクをキューに入れ、 これらの手順を中止する。

  2. それ以外の場合:

    1. client作成 URL潜在的に信頼できる URLでない場合、promise関連する設定オブジェクト担当イベントループ上で、DOM 操作タスクソースを使用して、 promise を "SecurityError" DOMException で拒否するタスクをキューに入れ、 これらの手順を中止する。

  3. client環境設定オブジェクトであり、かつウィンドウ クライアントでない場合、次を行う:

    1. clientObject を、client を引数としてクライアントを作成アルゴリズムを 実行した結果とする。

    2. promise関連する設定オブジェクト担当イベントループ上で、DOM 操作タスクソースを使用して、 promiseclientObject で解決するタスクをキューに入れ、 これらの手順を中止する。

  4. それ以外の場合:

    1. browsingContext を null とする。

    2. client環境設定オブジェクトである場合、 browsingContextclientグローバルオブジェクト閲覧コンテキストに設定する。

    3. それ以外の場合、browsingContextclientターゲット閲覧 コンテキストに設定する。

    4. navigable を、browsingContextアクティブ閲覧コンテキストとするナビゲーション可能とする。

    5. browsingContextイベントループ上で、ユーザー操作タスクソースを使用して、 次の手順を実行するタスクをキューに入れる

      1. frameType を、navigable を指定してフレームタイプを取得 を実行した結果とする。

      2. visibilityStatebrowsingContextアクティブドキュメントvisibilityState 属性値とする。

      3. focusState を、browsingContextアクティブドキュメントを引数としてフォーカスを持つ手順を実行した結果とする。

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

      5. clientウィンドウクライアントである場合、 ancestorOriginsListbrowsingContextアクティブドキュメント祖先オリジン リストに関連付けられたリストに設定する。

      6. promise関連する設定オブジェクト担当イベントループ上で、DOM 操作タスク ソースを使用して、次の手順を実行するタスクをキューに入れる

        1. client破棄済み フラグが設定されている場合、promise を undefined で解決し、 これらの手順を中止する。

        2. windowClient を、clientframeTypevisibilityStatefocusState、および ancestorOriginsList を指定してウィンドウクライアントを作成を実行した結果とする。

        3. promisewindowClient で解決する。

キャッシュを照会 (Query Cache)

入力

requestQueryrequest

optionsCacheQueryOptions オブジェクト、任意

targetStoragerequest response list、任意

出力

resultListrequest response list

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

  2. storage を null にする。

  3. もし オプション引数 targetStorage が省略されていれば、storagerelevant request response list に設定する。

  4. そうでなければ、storagetargetStorage に設定する。

  5. requestResponsestorage から反復する:

    1. cachedRequestrequestResponse の request にする。

    2. cachedResponserequestResponse の response にする。

    3. もし Request Matches Cached ItemrequestQuerycachedRequestcachedResponseoptions で実行した結果が true なら:

      1. requestCopycachedRequest のコピーとする。

      2. responseCopycachedResponse のコピーとする。

      3. requestCopy/responseCopyresultList に追加する。

  6. resultList を返す。

リクエストがキャッシュ項目に一致するか (Request Matches Cached Item)

入力

requestQueryリクエスト

requestリクエスト

responseレスポンスまたはnull、省略可能、既定値はnull

optionsCacheQueryOptions オブジェクト、省略可能

出力

ブール値

  1. もし options["ignoreMethod"] が false で、かつ requestmethod が `GET` でなければ、false を返す。

  2. queryURLrequestQueryurl とする。

  3. cachedURLrequesturl とする。

  4. もし options["ignoreSearch"] が true なら:

    1. cachedURLquery を空文字列に設定する。

    2. queryURLquery を空文字列に設定する。

  5. もし queryURLcachedURLexclude fragment flag を設定して 等しく なければ、false を返す。

  6. もし response が null、または options["ignoreVary"] が true、または responseheader list が `Vary` を含まないなら、true を返す。

  7. fieldValues を、リスト として、Vary ヘッダーのフィールド値に対応する要素で構成する。

  8. fieldValue について:

    1. もし fieldValue が "*" とマッチするか、または fieldValue に対する requestheader list と組み合わせた combined value が、同じ fieldValue に対する requestQuery のヘッダーと組み合わせた値に一致しない場合、false を返す。

  9. true を返す。

バッチキャッシュ操作 (Batch Cache Operations)

入力

operationsリスト。各要素は cache batch operation オブジェクト。

出力

resultListrequest response list

  1. cacherelevant request response list とする。

  2. backupCachecache のコピーである新しい request response list とする。

  3. addedItems を空の リスト とする。

  4. 次のサブステップを原子的に実行してみる:

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

    2. operationoperations から反復する:

      1. もし operationtype が "delete" でも "put" でもなければ、throwTypeError を投げる。

      2. もし operationtype が "delete" で、かつ operationresponse が null でなければ、throwTypeError を投げる。

      3. もし Query Cacheoperationrequestoperationoptions、および addedItems で実行した結果が空でなければ、throw で "InvalidStateError" DOMException を投げる。

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

      5. もし operationtype が "delete" なら:

        1. requestResponsesQuery Cacheoperationrequestoperationoptions で実行した結果に設定する。

        2. requestResponserequestResponses から反復する:

          1. Remove して、cache から requestResponse に一致するアイテムを削除する。

      6. それ以外で、もし operationtype が "put" なら:

        1. もし operationresponse が null なら、throwTypeError を投げる。

        2. roperationrequest の関連付けられた request とする。

        3. もし rurlscheme が "http" または "https" のいずれでもなければ、throwTypeError を投げる。

        4. もし rmethod が `GET` でなければ、throwTypeError を投げる。

        5. もし operationoptions が null でなければ、throwTypeError を投げる。

        6. requestResponsesQuery Cacheoperationrequest で実行した結果に設定する。

        7. requestResponserequestResponses から反復する:

          1. Remove して、cache から requestResponse に一致するアイテムを削除する。

        8. append して operationrequest/operationresponsecache に追加する。

        9. もし 前の 2 ステップ のキャッシュ書き込みが許可されたクォータを超えて失敗した場合、throwQuotaExceededError を投げる。

        10. append して operationrequest/operationresponseaddedItems に追加する。

      7. append して operationrequest/operationresponseresultList に追加する。

    3. resultList を返す。

  5. もし例外が 投げられた 場合、次を行う:

    1. Remove して、items をすべて relevant request response list から取り除く。

    2. requestResponsebackupCache から反復する:

      1. append して requestResponserelevant request response list に戻す。

    3. throw してその例外を再度投げる。

    注意: 例外が 投げられた 場合、実装はバッチ操作ジョブ中に行われたキャッシュストレージへの変更を元に戻す(ロールバックする)。

非同期モジュールか (Is Async Module)

入力

recordModule Record

moduleMapmodule map

baseURL

seensetURLs の)

出力

ブール値

  1. もし recordCyclic Module Record でなければ、false を返す。

  2. もし record.[[Async]] が true なら、true を返す。

  3. 文字列 requestedrecord.[[RequestedModules]] から反復する:

    1. urlresolve a module specifierbaserequested で行った結果とする。

    2. 断言: url は失敗にならない。なぜならこの二つの引数でのモジュールスペシファイア解決は以前に成功しているはずだからである。

    3. もし seenurl を含まないなら:

      1. append して urlseen に追加する。

      2. もし moduleMap[url] がレコードを持たないなら、false を返す。

      3. もし Is Async ModulemoduleMap[url] のレコード、moduleMapbase、および seen で実行した結果が true なら、true を返す。

  4. false を返す。

レースレスポンスを検索

入力

requestリクエスト

出力

レスポンス または null

  1. registrationをnullとする。

  2. request非サブリソースリクエストである場合:

    1. request予約済みクライアントがnullである場合、 nullを返す。

    2. storage keyを、request予約済みクライアントを与えてストレージキーを取得するを実行した結果とする。

    3. registrationを、storage keyおよびrequestURLを与えてサービスワーカー登録を照合するを 実行した結果に設定する。

  3. そうでなく、requestサブリソースリクエストである場合:

    1. clientを、requestクライアントとする。

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

    3. registrationを、clientアクティブなサービス ワーカー包含するサービス ワーカー登録に設定する。

  4. それ以外の場合、nullを返す。

  5. activeWorkerを、registrationアクティブなワーカーとする。

  6. mapを、activeWorkerグローバルオブジェクト競合レスポンスマップとする。

  7. map[request]が存在する 場合:

    1. entrymap[request]とする。

    2. entryが「pending」でなくなるまで 待機する。

    3. entryレスポンスである場合、 entry複製した結果を返す。

  8. nullを返す。

付録B: 拡張HTTPヘッダー

サービスワーカーのスクリプトリクエスト

fetchによるサービスワーカースクリプトリソースのHTTPリクエストには、次のヘッダーが含まれる:

`Service-Worker`

このリクエストがサービスワーカースクリプトリソースリクエストであることを示す。

注: このヘッダーは管理者がリクエスト記録や脅威検知を行う際に役立つ。

サービスワーカーのスクリプトレスポンス

サービスワーカースクリプトリソースリクエストへのHTTPレスポンスには、次のヘッダーを含めることができる:

`Service-Worker-Allowed`

ユーザーエージェントがパス制限(スクリプトが制御できる最大のスコープURLを制限)の上限を、指定された値に上書きすることを示す。

注: 値はURLである。相対URLが指定された場合は、スクリプトのURLを基準にパースされる。

デフォルトのスコープ:
// 許容される最大スコープのデフォルトはスクリプトのパス(この例では "/js/")
// "/js/" の場合
navigator.serviceWorker.register("/js/sw.js").then(() => {
  console.log("デフォルトスコープ'/js/'でインストールに成功しました。");
});
Service-Worker-Allowedヘッダーなしで上位パス指定:
// スクリプトより上位パスへスコープを指定
// レスポンスにService-Worker-Allowedヘッダーなし
navigator.serviceWorker.register("/js/sw.js", { scope: "/" }).catch(() => {
  console.error("パス制限違反でインストールに失敗しました。");
});
Service-Worker-Allowedヘッダー付きで上位パス指定:
// スクリプトより上位パスへスコープを指定
// レスポンスに "Service-Worker-Allowed : /" を含む
navigator.serviceWorker.register("/js/sw.js", { scope: "/" }).then(() => {
  console.log("最大許容スコープが'/'に上書きされ、インストールに成功しました。");
});
Service-Worker-Allowedヘッダーがあってもパス制限違反:
// スクリプトより上位パスへスコープを指定
// レスポンスに "Service-Worker-Allowed : /foo" を含む
navigator.serviceWorker.register("/foo/bar/sw.js", { scope: "/" }).catch(() => {
  console.error("スコープが上書き最大許容範囲外のため、インストールに失敗しました。");
});

構文

ABNFによる、サービスワーカースクリプトリソースリクエストとレスポンスで使われるヘッダー値の構文定義:

Service-Worker = %x73.63.72.69.70.74 ; "script", case-sensitive

注: Service-Worker-Allowedヘッダー値の検証はABNFではなくURLパースアルゴリズム(Updateアルゴリズム)で行われる。

8. 謝辞

Andrew Betts氏には、Jake Archibald氏、Jackson Gabbard氏、Tobie Langel氏、Robin Berjon氏、Patrick Lauke氏、Christian Heilmann氏など志を同じくする方々を集めて小さなワークショップを主催してくれたことに深く感謝します。その日の議論の明快さと、そこで示されたユースケースから多くの可能性が生まれました。さらに、オフライン問題への意識向上にも感謝します。彼のEdgeConfの運営と、オフラインを継続的なテーマにしたことで、この作業が前進する多くの機会とつながりが生まれました。

Anne van Kesteren氏には、Webプラットフォームの専門知識と標準化経験を惜しみなく提供いただき、サービスワーカーの開発を通じて助けていただきました。彼のURL、HTTP Fetch、Promises、DOMの実際の挙動についての先行研究がなければ、この仕様は不完全だったでしょう。同様に、Ian Hickson氏のWeb Worker仕様の厳密さにも多大な感謝を捧げます。

順不同ですが、設計指針や議論に深く感謝する方々:Jungkee Song氏、Alec Flett氏、David Barrett-Kahn氏、Aaron Boodman氏、Michael Nordman氏、Tom Ashworth氏、Kinuko Yasuda氏、Darin Fisher氏、Jonas Sicking氏、Jesús Leganés Combarro氏、Mark Christian氏、Dave Hermann氏、Yehuda Katz氏、François Remy氏、Ilya Grigorik氏、Will Chan氏、Domenic Denicola氏、Nikhil Marathe氏、Yves Lafon氏、Adam Barth氏、Greg Simon氏、Devdatta Akhawe氏、Dominic Cooney氏、Jeffrey Yasskin氏、Joshua Bell氏、Boris Zbarsky氏、Matt Falkenhagen氏、Tobie Langel氏、Gavin Peters氏、Ben Kelly氏、Hiroki Nakagawa氏、Jake Archibald氏、Josh Soref氏、Jinho Bang氏、Yutaka Hirano氏、Michael(tm) Smith氏、isonmad氏、Ali Alabbas氏、Philip Jägenstedt氏、Mike Pennisi氏、Eric Willigers氏。

Jason Weber氏、Chris Wilson氏、Paul Kinlan氏、Ehsan Akhgari氏、Daniel Austin氏にも、要件や標準化プロセスに関して貴重かつ的確なフィードバックをいただきました。

著者らは、Dimitri Glazkov氏にも感謝します。彼のスクリプトやフォーマットツールは、この仕様書の作成に不可欠でした。また、彼の多大なガイダンスにも感謝します。

Vivian Cromwell氏、Greg Simon氏、Alex Komoroske氏、Wonsuk Lee氏、Seojin Kim氏にも、その専門的な支援に感謝します。

適合性

文書の規約

適合性要件は、記述的なアサーションとRFC 2119の用語を組み合わせて表現されています。 現行標準の定義部分では、「MUST」「MUST NOT」「REQUIRED」「SHALL」「SHALL NOT」「SHOULD」「SHOULD NOT」「RECOMMENDED」「MAY」「OPTIONAL」といったキーワードは、RFC 2119で定義されている通りに解釈されます。 ただし、可読性のため、本仕様書ではこれらの単語は全て大文字では記載されていません。

本仕様書のすべての本文は現行標準ですが、明示的に非現行標準と示された節、例、および注記は除きます。[RFC2119]

本仕様書における例は、「例えば」で始まるか、class="example"で現行標準の本文から区別されています。例えば:

これは情報提供的な例です。

情報提供的な注記は「注」と始まり、class="note"で現行標準の本文から区別されています。例えば:

注:これは情報提供的な注記です。

適合性のあるアルゴリズム

アルゴリズムの一部として命令形で記述された要件(「先頭の空白文字を削除する」や「falseを返し、これらの手順を中止する」など)は、アルゴリズムの導入部で用いられているキーワード("must"、"should"、"may"など)の意味で解釈されます。

アルゴリズムや具体的な手順として記述された適合性要件は、最終的な結果が同等である限り、どのような方法で実装しても構いません。 とりわけ、本仕様書で定義されるアルゴリズムは理解しやすいことを目的としており、性能のためのものではありません。 実装者は最適化することが推奨されます。

索引

この仕様で定義される用語

参照によって定義される用語

参考文献

現行標準の参考文献

[CSP-NEXT]
スクリプティングポリシー. 編集者草案. URL: https://wicg.github.io/csp-next/scripting-policy.html
[CSP3]
Mike West; Antonio Sartori. コンテンツセキュリティポリシー レベル 3. 2026年7月29日. WD. URL: https://www.w3.org/TR/CSP3/
[DOM]
Anne van Kesteren. DOM 標準. リビングスタンダード. URL: https://dom.spec.whatwg.org/
[ECMASCRIPT]
ECMAScript 言語仕様. URL: https://tc39.es/ecma262/multipage/
[FETCH]
Anne van Kesteren. Fetch 標準. リビング スタンダード. URL: https://fetch.spec.whatwg.org/
[FileAPI]
Marijn Kruisselbrink. File API. 2026年6月4日. WD. URL: https://www.w3.org/TR/FileAPI/
[HR-TIME-3]
Yoav Weiss. 高分解能時間. 2026年3月24日. WD. URL: https://www.w3.org/TR/hr-time-3/
[HTML]
Anne van Kesteren; et al. HTML 標準. リビングスタンダード. URL: https://html.spec.whatwg.org/multipage/
[INFRA]
Anne van Kesteren; Domenic Denicola. Infra 標準. リビングスタンダード. URL: https://infra.spec.whatwg.org/
[MIMESNIFF]
Gordon P. Hemsley. MIME スニッフィング標準. リビングスタンダード. URL: https://mimesniff.spec.whatwg.org/
[NAVIGATION-TIMING-2]
Yoav Weiss; Noam Rosenthal. Navigation Timing レベル 2. 2026年2月25日. WD. URL: https://www.w3.org/TR/navigation-timing-2/
[PAGE-LIFECYCLE]
Page Lifecycle. コミュニティグループ草案 レポート. URL: https://wicg.github.io/page-lifecycle/
[RESOURCE-TIMING]
Yoav Weiss; Noam Rosenthal. Resource Timing. 2026年4月20日. CRD. URL: https://www.w3.org/TR/resource-timing/
[RFC2119]
S. Bradner. RFC において要件レベルを 示すために用いるキーワード. 1997年3月. 現行最良実践. URL: https://datatracker.ietf.org/doc/html/rfc2119
[RFC5234]
D. Crocker, Ed.; P. Overell. 構文仕様のための 拡張 BNF: ABNF. 2008年1月. インターネット標準. URL: https://www.rfc-editor.org/info/rfc5234/
[RFC7230]
R. Fielding, Ed.; J. Reschke, Ed.. Hypertext Transfer Protocol (HTTP/1.1): メッセージ構文とルーティング. 2014年6月. 標準化提案. URL: https://httpwg.org/specs/rfc7230.html
[RFC7231]
R. Fielding, Ed.; J. Reschke, Ed.. Hypertext Transfer Protocol (HTTP/1.1): セマンティクスと内容. 2014年6月. 標準化提案. URL: https://httpwg.org/specs/rfc7231.html
[SCREEN-CAPTURE]
Jan-Ivar Bruaroey; Elad Alon. 画面 キャプチャ. 2026年7月23日. WD. URL: https://www.w3.org/TR/screen-capture/
[SECURE-CONTEXTS]
Mike West. セキュアコンテキスト. 2023年11月10日. CRD. URL: https://www.w3.org/TR/secure-contexts/
[STORAGE]
Anne van Kesteren. Storage 標準. リビング スタンダード. URL: https://storage.spec.whatwg.org/
[STREAMS]
Adam Rice; et al. Streams 標準. リビング スタンダード. URL: https://streams.spec.whatwg.org/
[TRUSTED-TYPES]
Krzysztof Kotowicz. Trusted Types. 2026年6月23日. WD. URL: https://www.w3.org/TR/trusted-types/
[URL]
Anne van Kesteren. URL 標準. リビングスタンダード. URL: https://url.spec.whatwg.org/
[URLPATTERN]
Ben Kelly; Jeremy Roman; 宍戸俊哉 (Shunya Shishido). URL Pattern 標準. リビングスタンダード. URL: https://urlpattern.spec.whatwg.org/
[WEBIDL]
Edgar Chen; Timothy Gu. Web IDL 標準. リビング スタンダード. URL: https://webidl.spec.whatwg.org/

参考情報

[UNSANCTIONED-TRACKING]
Unsanctioned Web Tracking. 2015年7月17日. W3C TAGのファインディング. URL: https://www.w3.org/2001/tag/doc/unsanctioned-tracking/

IDL索引

[SecureContext, Exposed=(Window,Worker)]
interface ServiceWorker : EventTarget {
  readonly attribute USVString scriptURL;
  readonly attribute ServiceWorkerState state;
  undefined postMessage(any message, sequence<object> transfer);
  undefined postMessage(any message, optional StructuredSerializeOptions options = {});

  // event
  attribute EventHandler onstatechange;
};
ServiceWorker includes AbstractWorker;

enum ServiceWorkerState {
  "parsed",
  "installing",
  "installed",
  "activating",
  "activated",
  "redundant"
};

[SecureContext, Exposed=(Window,Worker)]
interface ServiceWorkerRegistration : EventTarget {
  readonly attribute ServiceWorker? installing;
  readonly attribute ServiceWorker? waiting;
  readonly attribute ServiceWorker? active;
  [SameObject] readonly attribute NavigationPreloadManager navigationPreload;

  readonly attribute USVString scope;
  readonly attribute ServiceWorkerUpdateViaCache updateViaCache;

  [NewObject] Promise<ServiceWorkerRegistration> update();
  [NewObject] Promise<boolean> unregister();

  // event
  attribute EventHandler onupdatefound;
};

enum ServiceWorkerUpdateViaCache {
  "imports",
  "all",
  "none"
};

partial interface Navigator {
  [SecureContext, SameObject] readonly attribute ServiceWorkerContainer serviceWorker;
};

partial interface WorkerNavigator {
  [SecureContext, SameObject] readonly attribute ServiceWorkerContainer serviceWorker;
};

[SecureContext, Exposed=(Window,Worker)]
interface ServiceWorkerContainer : EventTarget {
  readonly attribute ServiceWorker? controller;
  readonly attribute Promise<ServiceWorkerRegistration> ready;

  [NewObject] Promise<ServiceWorkerRegistration> register((TrustedScriptURL or USVString) scriptURL, optional RegistrationOptions options = {});

  [NewObject] Promise<(ServiceWorkerRegistration or undefined)> getRegistration(optional USVString clientURL = "");
  [NewObject] Promise<FrozenArray<ServiceWorkerRegistration>> getRegistrations();

  undefined startMessages();


  // events
  attribute EventHandler oncontrollerchange;
  attribute EventHandler onmessage; // event.source of message events is ServiceWorker object
  attribute EventHandler onmessageerror;
};

dictionary RegistrationOptions {
  USVString scope;
  WorkerType type = "classic";
  ServiceWorkerUpdateViaCache updateViaCache = "imports";
};

[SecureContext, Exposed=(Window,Worker)]
interface NavigationPreloadManager {
  Promise<undefined> enable();
  Promise<undefined> disable();
  Promise<undefined> setHeaderValue(ByteString value);
  Promise<NavigationPreloadState> getState();
};

dictionary NavigationPreloadState {
  boolean enabled = false;
  ByteString headerValue;
};

[Global=(Worker,ServiceWorker), Exposed=ServiceWorker, SecureContext]
interface ServiceWorkerGlobalScope : WorkerGlobalScope {
  [SameObject] readonly attribute Clients clients;
  [SameObject] readonly attribute ServiceWorkerRegistration registration;
  [SameObject] readonly attribute ServiceWorker serviceWorker;

  [NewObject] Promise<undefined> skipWaiting();

  attribute EventHandler oninstall;
  attribute EventHandler onactivate;
  attribute EventHandler onfetch;

  attribute EventHandler onmessage;
  attribute EventHandler onmessageerror;
};

[Exposed=ServiceWorker]
interface Client {
  readonly attribute USVString url;
  readonly attribute FrameType frameType;
  readonly attribute DOMString id;
  readonly attribute ClientType type;
  undefined postMessage(any message, sequence<object> transfer);
  undefined postMessage(any message, optional StructuredSerializeOptions options = {});
};

[Exposed=ServiceWorker]
interface WindowClient : Client {
  readonly attribute VisibilityState visibilityState;
  readonly attribute boolean focused;
  [SameObject] readonly attribute FrozenArray<USVString> ancestorOrigins;
  [NewObject] Promise<WindowClient> focus();
  [NewObject] Promise<WindowClient?> navigate(USVString url);
};

enum FrameType {
  "auxiliary",
  "top-level",
  "nested",
  "none"
};

[Exposed=ServiceWorker]
interface Clients {
  // The objects returned will be new instances every time
  [NewObject] Promise<(Client or undefined)> get(DOMString id);
  [NewObject] Promise<FrozenArray<Client>> matchAll(optional ClientQueryOptions options = {});
  [NewObject] Promise<WindowClient?> openWindow(USVString url);
  [NewObject] Promise<undefined> claim();
};

dictionary ClientQueryOptions {
  boolean includeUncontrolled = false;
  ClientType type = "window";
};

enum ClientType {
  "window",
  "worker",
  "sharedworker",
  "all"
};

[Exposed=ServiceWorker]
interface ExtendableEvent : Event {
  constructor(DOMString type, optional ExtendableEventInit eventInitDict = {});
  undefined waitUntil(Promise<any> f);
};

dictionary ExtendableEventInit : EventInit {
  // Defined for the forward compatibility across the derived events
};

[Exposed=ServiceWorker]
interface InstallEvent : ExtendableEvent {
  constructor(DOMString type, optional ExtendableEventInit eventInitDict = {});
  Promise<undefined> addRoutes((RouterRule or sequence<RouterRule>) rules);
};

dictionary RouterRule {
  required RouterCondition condition;
  required RouterSource source;
};

dictionary RouterCondition {
  URLPatternCompatible urlPattern;
  ByteString requestMethod;
  RequestMode requestMode;
  RequestDestination requestDestination;
  RunningStatus runningStatus;

  sequence<RouterCondition> _or;
  RouterCondition not;
};

typedef (RouterSourceDict or RouterSourceEnum) RouterSource;

dictionary RouterSourceDict {
  DOMString cacheName;
};

enum RunningStatus { "running", "not-running" };
enum RouterSourceEnum {
  "cache",
  "fetch-event",
  "network",
  "race-network-and-fetch-handler"
};

[Exposed=ServiceWorker]
interface FetchEvent : ExtendableEvent {
  constructor(DOMString type, FetchEventInit eventInitDict);
  [SameObject] readonly attribute Request request;
  readonly attribute Promise<any> preloadResponse;
  readonly attribute DOMString clientId;
  readonly attribute DOMString resultingClientId;
  readonly attribute DOMString replacesClientId;
  readonly attribute Promise<undefined> handled;

  undefined respondWith(Promise<Response> r);
};

dictionary FetchEventInit : ExtendableEventInit {
  required Request request;
  Promise<any> preloadResponse;
  DOMString clientId = "";
  DOMString resultingClientId = "";
  DOMString replacesClientId = "";
  Promise<undefined> handled;
};

[Exposed=ServiceWorker]
interface ExtendableMessageEvent : ExtendableEvent {
  constructor(DOMString type, optional ExtendableMessageEventInit eventInitDict = {});
  readonly attribute any data;
  readonly attribute USVString origin;
  readonly attribute DOMString lastEventId;
  [SameObject] readonly attribute (Client or ServiceWorker or MessagePort)? source;
  readonly attribute FrozenArray<MessagePort> ports;
};

dictionary ExtendableMessageEventInit : ExtendableEventInit {
  any data = null;
  USVString origin = "";
  DOMString lastEventId = "";
  (Client or ServiceWorker or MessagePort)? source = null;
  sequence<MessagePort> ports = [];
};

partial interface mixin WindowOrWorkerGlobalScope {
  [SecureContext, SameObject] readonly attribute CacheStorage caches;
};

[SecureContext, Exposed=(Window,Worker)]
interface Cache {
  [NewObject] Promise<(Response or undefined)> match(RequestInfo request, optional CacheQueryOptions options = {});
  [NewObject] Promise<FrozenArray<Response>> matchAll(optional RequestInfo request, optional CacheQueryOptions options = {});
  [NewObject] Promise<undefined> add(RequestInfo request);
  [NewObject] Promise<undefined> addAll(sequence<RequestInfo> requests);
  [NewObject] Promise<undefined> put(RequestInfo request, Response response);
  [NewObject] Promise<boolean> delete(RequestInfo request, optional CacheQueryOptions options = {});
  [NewObject] Promise<FrozenArray<Request>> keys(optional RequestInfo request, optional CacheQueryOptions options = {});
};

dictionary CacheQueryOptions {
  boolean ignoreSearch = false;
  boolean ignoreMethod = false;
  boolean ignoreVary = false;
};

[SecureContext, Exposed=(Window,Worker)]
interface CacheStorage {
  [NewObject] Promise<(Response or undefined)> match(RequestInfo request, optional MultiCacheQueryOptions options = {});
  [NewObject] Promise<boolean> has(DOMString cacheName);
  [NewObject] Promise<Cache> open(DOMString cacheName);
  [NewObject] Promise<boolean> delete(DOMString cacheName);
  [NewObject] Promise<sequence<DOMString>> keys();
};

dictionary MultiCacheQueryOptions : CacheQueryOptions {
  DOMString cacheName;
};

課題索引

このセクションの挙動はまだ完全に仕様化されておらず、HTML標準で仕様化される予定です。作業はissueおよびpull requestで追跡されています。
作成される予定の環境設定オブジェクトを使用し、具体的な環境設定オブジェクトは使用しません。これはサービスワーカーの独自の処理モデルによるもので、他のWebワーカーの処理モデルとは異なります。HTML標準のスクリプト取得アルゴリズムは本来他のWebワーカー向けに設計されており、実行環境の環境設定オブジェクトを必要としますが、サービスワーカーはスクリプトを更新アルゴリズムで個別に取得し、その後サービスワーカー実行アルゴリズムを通して複数回スクリプトが実行されます。
HTMLのクラシックワーカースクリプト取得アルゴリズム及びモジュールワーカースクリプトグラフ取得アルゴリズムはjobclientを引数に取ります。jobclientソフト更新アルゴリズムから渡される際にnullとなっています。
MDN

Cache/add

In all current engines.

Firefox41+Safari11.1+Chrome44+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet4.0+Opera Mobile?
MDN

Cache/addAll

In all current engines.

Firefox41+Safari11.1+Chrome46+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Cache/delete

In all current engines.

Firefox41+Safari11.1+Chrome43+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Cache/keys

In all current engines.

Firefox41+Safari11.1+Chrome43+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Cache/match

In all current engines.

Firefox41+Safari11.1+Chrome43+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Cache/matchAll

In all current engines.

Firefox41+Safari11.1+Chrome47+
Opera34+Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Cache/put

In all current engines.

Firefox41+Safari11.1+Chrome43+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet4.0+Opera Mobile?
MDN

Cache

In all current engines.

Firefox41+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet4.0+Opera Mobile?
MDN

CacheStorage/delete

In all current engines.

Firefox41+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

CacheStorage/has

In all current engines.

Firefox41+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

CacheStorage/keys

In all current engines.

Firefox41+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

CacheStorage/match

In all current engines.

Firefox41+Safari11.1+Chrome54+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

CacheStorage/open

In all current engines.

Firefox41+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

CacheStorage

In all current engines.

Firefox41+Safari11.1+Chrome43+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Client/frameType

In all current engines.

Firefox44+Safari11.1+Chrome43+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Client/id

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Client/postMessage

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Client/type

In all current engines.

Firefox54+Safari11.1+Chrome60+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Client/url

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Client

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Clients/claim

In all current engines.

Firefox44+Safari11.1+Chrome42+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Clients/get

In all current engines.

Firefox45+Safari11.1+Chrome51+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Clients/matchAll

In all current engines.

Firefox54+Safari11.1+Chrome42+
Opera29+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile29+
MDN

Clients/openWindow

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera38+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile41+
MDN

Clients

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ExtendableEvent/ExtendableEvent

In all current engines.

Firefox44+Safari11.1+Chrome41+
Opera24+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile24+
MDN

ExtendableEvent/waitUntil

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera24+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile24+
MDN

ExtendableEvent

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera24+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile24+
MDN

ExtendableMessageEvent/ExtendableMessageEvent

In all current engines.

Firefox44+Safari11.1+Chrome51+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ExtendableMessageEvent/data

In all current engines.

Firefox44+Safari11.1+Chrome51+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ExtendableMessageEvent/lastEventId

In all current engines.

Firefox44+Safari11.1+Chrome51+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ExtendableMessageEvent/origin

In all current engines.

Firefox44+Safari11.1+Chrome51+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ExtendableMessageEvent/ports

In all current engines.

Firefox44+Safari11.1+Chrome51+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ExtendableMessageEvent/source

In all current engines.

Firefox44+Safari11.1+Chrome51+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ExtendableMessageEvent

In all current engines.

Firefox44+Safari11.1+Chrome51+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

FetchEvent/FetchEvent

In all current engines.

Firefox44+Safari11.1+Chrome44+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

FetchEvent/clientId

In all current engines.

Firefox45+Safari11.1+Chrome49+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

FetchEvent/handled

In all current engines.

Firefox84+Safari16+Chrome86+
Opera?Edge86+
Edge (Legacy)?IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

FetchEvent/preloadResponse

In all current engines.

Firefox99+Safari15.4+Chrome59+
Opera?Edge79+
Edge (Legacy)18IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

FetchEvent/replacesClientId

In no current engines.

FirefoxNoneSafariNoneChromeNone
Opera?EdgeNone
Edge (Legacy)?IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

FetchEvent/request

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

FetchEvent/respondWith

In all current engines.

Firefox44+Safari11.1+Chrome42+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

FetchEvent/resultingClientId

In all current engines.

Firefox65+Safari16+Chrome72+
Opera?Edge79+
Edge (Legacy)?IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile50+
MDN

FetchEvent

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

NavigationPreloadManager/disable

In all current engines.

Firefox99+Safari15.4+Chrome59+
Opera?Edge79+
Edge (Legacy)18IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

NavigationPreloadManager/enable

In all current engines.

Firefox99+Safari15.4+Chrome59+
Opera?Edge79+
Edge (Legacy)18IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

NavigationPreloadManager/getState

In all current engines.

Firefox99+Safari15.4+Chrome59+
Opera?Edge79+
Edge (Legacy)18IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

NavigationPreloadManager/setHeaderValue

In all current engines.

Firefox99+Safari15.4+Chrome59+
Opera?Edge79+
Edge (Legacy)18IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

NavigationPreloadManager

In all current engines.

Firefox99+Safari15.4+Chrome59+
Opera?Edge79+
Edge (Legacy)18IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Navigator/serviceWorker

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorker/postMessage

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorker/postMessage

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorker/scriptURL

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorker/state

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorker/statechange_event

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorker

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerContainer/controller

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerContainer/controllerchange_event

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerContainer/getRegistration

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerContainer/getRegistrations

In all current engines.

Firefox44+Safari11.1+Chrome45+
Opera27+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView40+Samsung Internet4.0+Opera Mobile27+
MDN

ServiceWorkerContainer/message_event

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerContainer/ready

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerContainer/register

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerContainer/startMessages

In all current engines.

Firefox64+Safari11.1+Chrome74+
Opera?Edge79+
Edge (Legacy)?IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile50+
MDN

ServiceWorkerContainer

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerGlobalScope/activate_event

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera24+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile24+
MDN

ServiceWorkerGlobalScope/activate_event

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera24+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile24+
MDN

ServiceWorkerGlobalScope/clients

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera24+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile24+
MDN

ServiceWorkerGlobalScope/fetch_event

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera24+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile24+
MDN

ServiceWorkerGlobalScope/install_event

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera24+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile24+
MDN

ServiceWorkerGlobalScope/message_event

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera24+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile24+
MDN

ServiceWorkerGlobalScope/message_event

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera24+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile24+
MDN

ServiceWorkerGlobalScope/registration

In all current engines.

Firefox44+Safari11.1+Chrome42+
Opera26+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile26+
MDN

ServiceWorkerGlobalScope/skipWaiting

In all current engines.

Firefox44+Safari11.1+Chrome41+
Opera25+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile25+
MDN

ServiceWorkerGlobalScope

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera24+Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile24+
MDN

ServiceWorkerRegistration/active

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerRegistration/installing

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerRegistration/navigationPreload

In all current engines.

Firefox99+Safari15.4+Chrome59+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet4.0+Opera Mobile?
MDN

ServiceWorkerRegistration/scope

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerRegistration/unregister

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerRegistration/update

In all current engines.

Firefox44+Safari11.1+Chrome45+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet4.0+Opera Mobile?
MDN

ServiceWorkerRegistration/updatefound_event

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerRegistration/updateViaCache

In all current engines.

Firefox57+Safari11.1+Chrome68+
Opera?Edge79+
Edge (Legacy)18IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerRegistration/waiting

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

ServiceWorkerRegistration

In all current engines.

Firefox44+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

WindowClient/focus

In all current engines.

Firefox44+Safari11.1+Chrome42+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

WindowClient/focused

In all current engines.

Firefox44+Safari11.1+Chrome42+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

WindowClient/navigate

In all current engines.

Firefox50+Safari16+Chrome49+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView42+Samsung Internet4.0+Opera Mobile?
MDN

WindowClient/visibilityState

In all current engines.

Firefox44+Safari11.1+Chrome42+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

WindowClient

In all current engines.

Firefox44+Safari11.1+Chrome42+
Opera?Edge79+
Edge (Legacy)17+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

caches

In all current engines.

Firefox41+Safari11.1+Chrome40+
Opera?Edge79+
Edge (Legacy)16+IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?
MDN

Headers/Service-Worker-Navigation-Preload

In all current engines.

Firefoxpreview+Safari15.4+Chrome59+
Opera?Edge79+
Edge (Legacy)18IENone
Firefox for Android?iOS Safari?Chrome for Android?Android WebView?Samsung Internet?Opera Mobile?