WindowClient

The WindowClient interface of the ServiceWorker API represents the scope of a service worker client that is a document in a browsing context, controlled by an active worker. The service worker client independently selects and uses a service worker for its own loading and sub-resources.

Instance methods

WindowClient inherits methods from its parent interface, Client.

WindowClient.focus(): Gives user input focus to the current client.
WindowClient.navigate(): Loads a specified URL into a controlled client page.

Instance properties

WindowClient inherits properties from its parent interface, Client.

WindowClient.ancestorOrigins Read only: An array of strings that indicates the ancestor origins of the browsing context represented by this WindowClient in reverse order.
WindowClient.focused Read only: A boolean that indicates whether the current client has focus.
WindowClient.visibilityState Read only: Indicates the visibility of the current client. This value can be one of "hidden", "visible", or "prerender".

Example

self.addEventListener("notificationclick", (event) => {
  console.log("On notification click: ", event.notification.tag);
  event.notification.close();

  // This looks to see if the current is already open and
  // focuses if it is
  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("/");
      }),
  );
});

Specifications

Specification
Service Workers # windowclient

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`WindowClient`	42	17	44	No	29	11.1	42	42	44	29	11.3	4.0
`ancestorOrigins`	No	No	No	No	No	16	No	No	No	No	No	No
`focus`	42	17	44	No	29	11.1	42	42	44	29	11.3	4.0
`focused`	42	17	44	No	29	11.1	42	42	44	29	11.3	4.0
`navigate`	49	17	50	No	36	16 11.1–16 This method exists, but always throws `NotSupportedError`.	42	49	50	36	16 11.3–16 This method exists, but always throws `NotSupportedError`.	4.0
`visibilityState`	42	17	44	No	29	11.1	42	42	44	29	11.3	4.0

Docs

Docs4dev

Title here