WindowClient: focus() method
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
InvalidAccessError
DOMException
-
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 # client-focus |
Browser compatibility
BCD tables only load in the browser