Cache: keys() 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.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die keys() Methode des Cache Schnittstelle gibt ein
Promise zurück, der in ein Array von Request Objekten
aufgelöst wird, die die Schlüssel des Cache darstellen.
Die Anfragen werden in der Reihenfolge zurückgegeben, in der sie eingefügt wurden.
Hinweis:
Anfragen mit doppelten URLs, jedoch unterschiedlichen Headern können zurückgegeben werden, wenn ihre Antworten den VARY Header gesetzt haben.
Syntax
keys()
keys(request)
keys(request, options)
Parameter
requestOptional-
Das
Request, das zurückgegeben werden soll, wenn ein bestimmter Schlüssel gewünscht ist. Dies kann einRequestObjekt oder eine URL sein. optionsOptional-
Ein Objekt, dessen Eigenschaften steuern, wie das Matching in der
keysOperation durchgeführt wird. Die verfügbaren Optionen sind:ignoreSearch-
Ein boolescher Wert, der angibt, ob der Abgleichsprozess die Query-String in der URL ignorieren soll. Wenn auf
truegesetzt, würde der?value=barTeil vonhttps://example.com/?value=barignoriert, wenn eine Übereinstimmung durchgeführt wird. Standardmäßig ist esfalse. ignoreMethod-
Ein boolescher Wert, der, wenn auf
truegesetzt, Abgleichsoperationen daran hindert, dieHTTPMethode desRequestzu validieren (normalerweise sind nurGETundHEADerlaubt.) Standardmäßig ist esfalse. ignoreVary-
Ein boolescher Wert, der, wenn auf
truegesetzt, die Abgleichsoperation anweist, keineVARYHeader-Übereinstimmung durchzuführen. Mit anderen Worten, wenn die URL übereinstimmt, erhalten Sie eine Übereinstimmung, unabhängig davon, ob dasResponseObjekt einenVARYHeader hat. Standardmäßig ist esfalse. cacheName-
Ein String, der einen bestimmten Cache darstellt, in dem gesucht werden soll. Beachten Sie, dass diese Option von
Cache.keys()ignoriert wird.
Rückgabewert
Ein Promise, der in ein Array von Request Objekten aufgelöst wird.
Beispiele
caches
.open("v1")
.then((cache) => cache.keys())
.then((keys) => {
keys.forEach((request, index, array) => {
cache.delete(request);
});
});
Spezifikationen
| Specification |
|---|
| Service Workers Nightly # cache-keys |