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.
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.
Properties
WindowClient
inherits properties from its parent interface, Client
.
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', function(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(function(clientList) { for (var i = 0; i < clientList.length; i++) { var client = clientList[i]; if (client.url == '/' && 'focus' in client) { client.focus(); break; } } if (clients.openWindow) return clients.openWindow('/'); })); });
Specifications
Specification | Status | Comment |
---|---|---|
Service Workers The definition of 'WindowClient' in that specification. |
Working Draft | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
WindowClient | Chrome Full support 42 | Edge Full support ≤18 | Firefox
Full support
44
| IE No support No | Opera ? | Safari No support No | WebView Android No support No | Chrome Android Full support 42 | Firefox Android Full support 44 | Opera Android ? | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
ancestorOrigins | Chrome ? | Edge ? | Firefox ? | IE No support No | Opera ? | Safari No support No | WebView Android No support No | Chrome Android ? | Firefox Android ? | Opera Android ? | Safari iOS No support No | Samsung Internet Android ? |
focus | Chrome Full support 42 | Edge Full support ≤18 | Firefox
Full support
44
| IE No support No | Opera ? | Safari No support No | WebView Android No support No | Chrome Android Full support 42 | Firefox Android Full support 44 | Opera Android ? | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
focused | Chrome Full support 42 | Edge Full support ≤18 | Firefox
Full support
44
| IE No support No | Opera ? | Safari No support No | WebView Android No support No | Chrome Android Full support 42 | Firefox Android Full support 44 | Opera Android ? | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
navigate | Chrome Full support 49 | Edge Full support ≤18 | Firefox
Full support
44
| IE No support No | Opera ? | Safari No support No | WebView Android No support No | Chrome Android Full support 49 | Firefox Android Full support 44 | Opera Android ? | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
visibilityState | Chrome Full support 42 | Edge Full support ≤18 | Firefox
Full support
44
| IE No support No | Opera ? | Safari No support No | WebView Android No support No | Chrome Android Full support 42 | Firefox Android Full support 44 | Opera Android ? | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- See implementation notes.