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("/");
      }),
  );
});