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: Diese Funktion ist nur in Service Workers verfügbar.
Das Clients-Interface bietet Zugriff auf Client-Objekte. Greifen Sie darauf mit [self](/de/docs/Web/API/ServiceWorkerGlobalScope).clients innerhalb eines Service Workers zu.
Instanzmethoden
Clients.get()-
Gibt ein
Promisefür einenClientzurück, der mit einer gegebenenidübereinstimmt. Clients.matchAll()-
Gibt ein
Promisefür ein Array vonClient-Objekten zurück. Ein Optionsargument ermöglicht es Ihnen, die Typen der zurückgegebenen Clients zu steuern. Clients.openWindow()-
Öffnet ein neues Browserfenster für eine gegebene URL und gibt ein
Promisefür den neuenWindowClientzurück. Clients.claim()-
Ermöglicht einem aktiven Service Worker, sich selbst als
controllerfür alle Clients innerhalb seinesscopezu setzen.
Beispiele
Das folgende Beispiel zeigt ein vorhandenes Chat-Fenster 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: chatClient ??= await clients.openWindow("/chat/"); // Message the client: chatClient.postMessage("New chat messages!"); })(), ); }); Spezifikationen
| Specification |
|---|
| Service Workers # clients-interface |
Browser-Kompatibilität
Loading…