WindowClient: focus()-Methode
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.
Hinweis: Diese Funktion ist nur in Service Workers verfügbar.
Die focus()
-Methode des WindowClient
-Interfaces gibt dem aktuellen Client den Benutzereingabefokus und gibt ein Promise
zurück, das auf den bestehenden WindowClient
aufgelöst wird.
Syntax
js
focus()
Parameter
Keine.
Rückgabewert
Ein Promise
, das auf den bestehenden WindowClient
aufgelöst wird.
Ausnahmen
InvalidAccessError
DOMException
-
Das Versprechen wird mit dieser Ausnahme zurückgewiesen, wenn keines der Fenster im Ursprung der App eine vorübergehende Aktivierung aufweist.
Sicherheitsanforderungen
- Mindestens ein Fenster im Ursprung der App muss eine vorübergehende Aktivierung aufweisen.
Beispiele
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("/");
}),
);
});
Spezifikationen
Specification |
---|
Service Workers # client-focus |
Browser-Kompatibilität
BCD tables only load in the browser