Clients: matchAll() 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: Dieses Feature ist nur verfügbar in Service Workers.
Die matchAll()
Methode der Clients
Schnittstelle gibt ein Promise
für eine Liste von Service Worker
Client
Objekten zurück. Schließen Sie den options
-Parameter ein, um alle Service Worker-Clients zurückzugeben, deren Herkunft mit der des zugehörigen Service Workers identisch ist. Wenn keine Optionen einbezogen werden, gibt die Methode nur die vom Service Worker gesteuerten Service Worker-Clients zurück.
Syntax
matchAll()
matchAll(options)
Parameter
options
Optional-
Ein Optionsobjekt, mit dem Sie Optionen für den Matching-Vorgang festlegen können. Verfügbare Optionen sind:
includeUncontrolled
-
Ein boolescher Wert — wenn er auf
true
gesetzt ist, gibt der Matching-Vorgang alle Service Worker-Clients zurück, die denselben Ursprung wie der aktuelle Service Worker haben. Andernfalls gibt er nur die vom aktuellen Service Worker gesteuerten Service Worker-Clients zurück. Der Standardwert istfalse
. type
-
Legt den Typ der Clients fest, die Sie abgleichen möchten. Verfügbare Werte sind
"window"
,"worker"
,"sharedworker"
und"all"
. Der Standardwert ist"window"
.
Rückgabewert
Beispiele
clients.matchAll(options).then((clientList) => {
for (const client of clientList) {
if (client.url === "index.html") {
clients.openWindow(client);
// or do something else involving the matching client
}
}
});
Spezifikationen
Specification |
---|
Service Workers # clients-matchall |
Browser-Kompatibilität
BCD tables only load in the browser