サービスワーカー (Web)

仕様書

意味

[34] サービスワーカー (service worker) は、ワーカーの一種です。サービスワーカーは、登録したサービスワーカークライアントの起源において実行されます。 >>33

状態

状態: サービスワーカーの状態。
スクリプトURL: URL。
型: classic または module。初期値は classic。
containing service worker registration
ID (id): 不透明な文字列。containing service worker registrationの寿命内において固有に当サービスワーカーを識別するものです。 >>33
大域オブジェクト: ServiceWorkerGlobalScope または null。
スクリプト資源: スクリプトまたは null。
スクリプト資源写像
skip waiting flag
imported scripts updated flag
set of event types to handle
set of extended events
list of foreign fetch scopes
list of foreign fetch origins

[38] サービスワーカーは、状態 (state) を持ち、その値は構文解析済み (parsed) , インストール中 (installing) , インストール済み (installed) , 活性化中 (activating) , 活性化済み (activated) , 冗長 (redundant) のいずれかです。初期状態は構文解析済みです。 >>33

handle fetch は、状態が活性化中から活性化済みになった時に次の動作を実行します。

[68] サービスワーカーは、走っている (running) か否か (not) のいずれかです。

「走っている」の意味はなぜか定義されていません。サービスワーカーを走らせる処理やサービスワーカーの終端の処理で参照されます。

[39] サービスワーカーは、サービスワーカー登録に関連付けられています。

[40] サービスワーカー登録はインストール中ワーカー (installing worker) を持ち、値はインストール中のサービスワーカーまたは null です。初期値は null です。 >>37

[41] サービスワーカー登録は待機中ワーカー (waiting worker) を持ち、値はインストール済みのサービスワーカーまたは null です。初期値は null です。 >>37

[42] サービスワーカー登録は活性ワーカー (active worker) を持ち、値は活性化中または活性化済みのサービスワーカーまたは null です。初期値は null です。 >>37

[70] 活性ワーカーの変化時、ready

[73] サービスワーカーは、スクリプトURL (script url) を持ちます >>33。値は URL です。サービスワーカーの作成に使った JavaScript ファイルの URL を表しています。

[74] ジョブは、スクリプトURL (script url) を持ちます >>72。値は URL です。

サービスワーカーエージェント

[103] サービスワーカーエージェント (service worker agent) は、 ServiceWorkerGlobalScope を1つ含むエージェントです。 >>104

提供される場面

[23] Service Workers は、保安文脈でしか提供されません。つまり、 HTTPS でない HTTP の文書では原則として使えません。

[27] アプリ内ブラウザーでは提供されないことがあります。 (提供されない可能性が高いかもしれません。)

[102] しばしば Cloudflare Workers がサービスワーカーである、 Service Worker API を提供する、と紹介されることがあります。実際には Cloudflare Workers はサービスワーカー風 API のうちの一部を、独自に拡張したものを提供しているのですが、 Cloudflare Workers は Web でいうサービスワーカーではありませんし、サービスワーカーの動作モデルとは違うものです。

[105] なのでそのような解説は Cloudflare 寄りのマーケティング記事か、無知な著者の記事だと思って構いません。

API

サービスワーカーを扱う API

[71]

サービスワーカーに晒されている API

[22] Sercice Workers のスクリプト (サービスワーカー環境) に晒されている API は、文書環境とは若干異なります。

文書木関係の API は提供されません。
- Node を継承する Document, Element などはありません。
XHR は提供されません。

処理

実行

[43] サービスワーカーを走らせる (Run Service Worker) 処理は、サービスワーカーワーカーと force bypass cache for importscripts flag について、次にようにします >>44。

[46] ワーカーが走っているなら、
1. [47] 成功を返し、ここで停止します。
[45] スクリプトを、ワーカーのスクリプト資源に設定します。
[48] 独立した並列に動作する実行環境を作成し、以後この環境で実行します。
[50] ワーカー大域オブジェクトを、新しい ServiceWorkerGlobalScope に設定します。
[49] Realm実行文脈を、 InitializeHostDefinedRealm を実行した結果に設定します。
大域オブジェクト
ワーカー大域オブジェクト
[51] ワーカーの大域オブジェクトを、ワーカー大域オブジェクトに設定します。
[52] 設定群を、新しい環境設定群オブジェクトを作成した結果に設定します。
Realm実行文脈
Realm実行文脈
大域文脈
ワーカー大域オブジェクト
ワーカー
ワーカー
クライアント
registering service worker client
[53] ワーカー大域オブジェクトを、次の通り設定します。
URL
ワーカーのスクリプトURL
HTTPS状態
ワーカーのスクリプト資源のHTTPS状態
参照元ポリシー
ワーカーのスクリプト資源の参照元ポリシー
型
ワーカーの型
force bypass cache for importscripts flag
force bypass cache for importscripts flag
[54] 新しい WorkerLocation を作成します。
[55] WorkerLocation
大域オブジェクト
ワーカー大域オブジェクト
[56] ワーカーが活性ワーカーで、 ワーカーの containing service worker registration のタスクキュー群の各キューについて、
1. [57] キューの各タスクについて順に、
  1. [58] タスクをキューに追加します。
    タスクキュー
    ワーカーのイベントループのタスクキュー群のキューに相当するタスクキュー
    処理
    タスクの処理
    タスク源
    タスクのタスク源
[59] スクリプトの種別により、
古典スクリプト
スクリプトについて古典スクリプトの実行をします。
モジュールスクリプト
スクリプトについてモジュールスクリプトの実行をします。
[60] スクリプトの has ever been evaluated flag が偽の場合、
1. [61] 設定群の大域オブジェクトのイベントリスナー群の各リスナーについて、
  1. [62] リスナーのイベント型を、ワーカーの set of event types to handle の末尾に追加します。
2. [63] ワーカーの set of event types to handle が空なら、
  1. [64] 開発者コンソールに警告を出すべき (encouraged) です。
3. [65] スクリプトの has ever been evaluated flag を、真に設定します。
[66] 設定群の有責イベントループを実行します。
[67] ワーカー大域オブジェクトの活性タイマー群のリストを、空にします。
[76] 以上で実行時スクリプトエラーが捕獲されていなければ失敗を、そうでなければ成功を返します。 >>77