Clients
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: Dieses Feature ist nur verfügbar in Service Workers.
Das Clients
-Interface bietet Zugriff auf Client
-Objekte. Sie können darauf über [
self](/de/docs/Web/API/ServiceWorkerGlobalScope).clients
in einem Service Worker zugreifen.
Instanzmethoden
Clients.get()
-
Gibt ein
Promise
für einenClient
zurück, der einer gegebenenid
entspricht. Clients.matchAll()
-
Gibt ein
Promise
für ein Array vonClient
-Objekten zurück. Ein Optionsargument ermöglicht es Ihnen, die zurückgegebenen Client-Typen zu kontrollieren. Clients.openWindow()
-
Öffnet ein neues Browserfenster für eine gegebene URL und gibt ein
Promise
für den neuenWindowClient
zurück. Clients.claim()
-
Ermöglicht einem aktiven Service Worker, sich als
controller
für alle Clients innerhalb seinesscope
zu setzen.
Beispiele
Das folgende Beispiel zeigt ein bestehendes Chatfenster oder erstellt ein neues, wenn der Benutzer auf eine Benachrichtigung klickt.
addEventListener("notificationclick", (event) => {
event.waitUntil(
(async () => {
const allClients = await clients.matchAll({
includeUncontrolled: true,
});
let chatClient;
// Let's see if we already have a chat window open:
for (const client of allClients) {
const url = new URL(client.url);
if (url.pathname === "/chat/") {
// Excellent, let's use it!
client.focus();
chatClient = client;
break;
}
}
// If we didn't find an existing chat window,
// open a new one:
if (!chatClient) {
chatClient = await clients.openWindow("/chat/");
}
// Message the client:
chatClient.postMessage("New chat messages!");
})(),
);
});
Spezifikationen
Specification |
---|
Service Workers # clients-interface |
Browser-Kompatibilität
BCD tables only load in the browser