WindowClient

Baseline 広く利用可能 *

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2018年4月以降、すべてのブラウザーで利用可能です。

* この機能の一部は、対応レベルが異なる場合があります。

もっと詳しく
完全な互換性情報を見る

WindowClient はサービスワーカー API のインターフェイスで、アクティブなワーカーによって制御される閲覧コンテキスト内のドキュメントである、サービスワーカークライアントのスコープを表します。サービスワーカークライアントは、それ自身の読み込みとサブリソースに対してサービスワーカーを個別に選択して使用します。

インスタンスメソッド

WindowClient には、親インターフェイスである Client から継承したメソッドがあります。

WindowClient.focus(): 現在のクライアントにユーザー入力フォーカスを与えます。
WindowClient.navigate(): 指定された URL を制御されたクライアントのページに読み込みます。

インスタンスプロパティ

WindowClient には、親インターフェイスである Client から継承したプロパティがあります。

WindowClient.focused 読取専用: 論理値で、現在のクライアントにフォーカスがあるかどうかを示します。
WindowClient.visibilityState 読取専用: 現在のクライアントの可視性を示します。この値は、"hidden"、"visible"、"prerender" のいずれかです。

例

self.addEventListener("notificationclick", (event) => {
 console.log("On notification click: ", event.notification.tag);
 event.notification.close();
 // これは、クライアントが既に開いているかどうかを確認し、
 // 開いている場合にフォーカスを合わせます
 event.waitUntil(
 clients
 .matchAll({
 type: "window",
 })
 .then((clientList) => {
 for (const client of clientList) {
 if (client.url === "/" && "focus" in client) {
 client.focus();
 break;
 }
 }
 if (clients.openWindow) return clients.openWindow("/");
 }),
 );
});