ServiceWorker.state
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.
state
は ServiceWorker
インターフェイスの読み取り専用プロパティで、サービスワーカーの現在の状態を表す文字列を返します。読み込みプロパティである は service worker の現在の状態を表す文字列を返します。これは、parsed
、installing
、installed
、activating
、activated
、redundant
の何れかです。
値
文字列で、以下の値のうちのいずれかを取ります。
"parsed"
-
サービスワーカーがダウンロードされ、実行可能であることが確認された後の初期状態です。 サービスワーカーがこの状態に更新されることはないので、
ServiceWorker.statechange_event
の値になることはありません。 "installing"
-
この状態のサービスワーカーは、インストール中のワーカーとみなされます。この状態の間、
ExtendableEvent.waitUntil()
はinstall
イベントハンドラーの中で呼び出され、渡されたプロミスが正常に解決されるまでインストール中のワーカーを延長することができます。これは主に、コアキャッシュがすべて投入されるまでサービスワーカーがアクティブにならないようにするために使用します。 "installed"
-
この状態のサービスワーカーは、待機中のワーカーとみなされます。
"activating"
-
この状態のサービスワーカーは、アクティブワーカーとみなされます。この状態の間、
ExtendableEvent.waitUntil()
はonactivate
イベントハンドラーの中で呼び出され、渡されたプロミスが正常に解決されるまでアクティブワーカーを延長させることができます。状態がアクティブになるまで、機能イベントは配信されません。 "activated"
-
この状態のサービスワーカーは、機能イベントを処理する準備が整ったアクティブワーカーとみなされます。
"redundant"
-
新しいサービスワーカーが現在のサービスワーカーに置き換わるか、または現在のサービスワーカーがインストールに失敗して破棄される場合です。
例
このコードスニペットは、サービスワーカーの登録イベントサンプル(ライブデモ)に掲載されています。このコードは、ServiceWorker.state
の変化を待ち受け、その値を返しています。
let serviceWorker;
if (registration.installing) {
serviceWorker = registration.installing;
document.querySelector("#kind").textContent = "installing";
} else if (registration.waiting) {
serviceWorker = registration.waiting;
document.querySelector("#kind").textContent = "waiting";
} else if (registration.active) {
serviceWorker = registration.active;
document.querySelector("#kind").textContent = "active";
}
if (serviceWorker) {
logState(serviceWorker.state);
serviceWorker.addEventListener("statechange", (e) => {
logState(e.target.state);
});
}
仕様書
Specification |
---|
Service Workers # service-worker-state |
ブラウザーの互換性
BCD tables only load in the browser