WindowClient: focus() method
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.
Note: This feature is only available in Service Workers.
The focus() method of the WindowClient
interface gives user input focus to the current client and returns a
Promise that resolves to the existing
WindowClient.
Syntax
js
focus()
Parameters
None.
Return value
A Promise that resolves to the existing WindowClient.
Exceptions
InvalidAccessErrorDOMException-
The promise is rejected with this exception if none of the windows in the app's origin have transient activation.
Security requirements
- At least one window in the app's origin must have transient activation.
Examples
js
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) return client.focus();
}
if (clients.openWindow) return clients.openWindow("/");
}),
);
});
Specifications
| Specification |
|---|
| Service Workers Nightly # client-focus |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
focus
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support