WindowClient
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Hinweis: Diese Funktion ist nur in Service Workers verfügbar.
Das WindowClient-Interface der ServiceWorker-API repräsentiert den Gültigkeitsbereich eines Service-Worker-Clients, der ein Dokument in einem Browsing-Kontext ist, das von einem aktiven Worker gesteuert wird. Der Service-Worker-Client wählt und verwendet unabhängig einen Service Worker für sein eigenes Laden und seine Unterressourcen.
Instanzmethoden
WindowClient erbt Methoden von seinem Eltern-Interface, Client.
WindowClient.focus()-
Gibt dem aktuellen Client den Benutzereingabefokus.
-
Lädt eine angegebene URL in eine kontrollierte Client-Seite.
Instanzeigenschaften
WindowClient erbt Eigenschaften von seinem Eltern-Interface, Client.
WindowClient.ancestorOriginsSchreibgeschützt Experimentell-
Ein Array von Zeichenfolgen, das die Vorfahrenursprünge des vom
WindowClientdargestellten Browsing-Kontexts in umgekehrter Reihenfolge angibt. WindowClient.focusedSchreibgeschützt-
Ein Boolean, der angibt, ob der aktuelle Client den Fokus hat.
WindowClient.visibilityStateSchreibgeschützt-
Gibt die Sichtbarkeit des aktuellen Clients an. Dieser Wert kann
"hidden"oder"visible"sein.
Beispiel
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("/");
}),
);
});
Spezifikationen
| Spezifikation |
|---|
| Service Workers Nightly> # windowclient> |