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: Dieses Feature ist verfügbar in Web Workers.
Die keys()
Methode der Cache
Schnittstelle gibt ein
Promise
zurück, welches ein Array von Request
Objekten auflöst,
die die Schlüssel des Cache
repräsentieren.
Die Anfragen werden in der Reihenfolge zurückgegeben, in der sie eingefügt wurden.
Hinweis: Anfragen mit doppelten URLs, aber unterschiedlichen Headers können
zurückgegeben werden, wenn ihre Antworten den VARY
Header gesetzt haben.
Syntax
keys()
keys(request)
keys(request, options)
Parameter
request
Optional-
Die
Request
, die zurückgegeben werden soll, wenn ein bestimmter Schlüssel gewünscht ist. Dies kann einRequest
Objekt oder eine URL sein. options
Optional-
Ein Objekt, dessen Eigenschaften steuern, wie das Matching bei der
keys
Operation durchgeführt wird. Die verfügbaren Optionen sind:ignoreSearch
-
Ein boolescher Wert, der angibt, ob der Matching-Prozess den Abfrage-String in der URL ignorieren soll. Wenn auf
true
gesetzt, würde der?value=bar
Teil vonhttp://foo.com/?value=bar
beim Abgleichen ignoriert werden. Standardmäßig auffalse
. ignoreMethod
-
Ein boolescher Wert, der, wenn auf
true
gesetzt, verhindert, dass Matching-Operationen dieRequest
HTTP
Methode validieren (normalerweise sind nurGET
undHEAD
erlaubt). Standardmäßig auffalse
. ignoreVary
-
Ein boolescher Wert, der, wenn auf
true
gesetzt, der Matching-Operation mitteilt, keinVARY
Header-Matching durchzuführen. Mit anderen Worten, wenn die URL übereinstimmt, erhalten Sie eine Übereinstimmung, unabhängig davon, ob dasResponse
Objekt einenVARY
Header hat. Standardmäßig auffalse
. cacheName
-
Ein String, der einen bestimmten Cache repräsentiert, in dem gesucht werden soll. Beachten Sie, dass diese Option von
Cache.keys()
ignoriert wird.
Rückgabewert
Beispiele
caches.open("v1").then((cache) => {
cache.keys().then((keys) => {
keys.forEach((request, index, array) => {
cache.delete(request);
});
});
});
Spezifikationen
Specification |
---|
Service Workers # cache-keys |
Browser-Kompatibilität
BCD tables only load in the browser