Cache: 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.
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 matchAll() Methode des Cache
Interfaces gibt ein Promise zurück, das zu einem Array aller übereinstimmenden
Antworten im Cache Objekt aufgelöst wird.
Syntax
matchAll()
matchAll(request)
matchAll(request, options)
Parameter
requestOptional-
Das
RequestObjekt, für das Sie versuchen, Antworten imCachezu finden. Dies kann einRequestObjekt oder eine URL sein. Wenn dieses Argument weggelassen wird, erhalten Sie eine Kopie aller Antworten in diesem Cache. optionsOptional-
Ein Optionsobjekt, das es Ihnen ermöglicht, spezifische Steuerungsoptionen für das durchgeführte Matching festzulegen. Die verfügbaren Optionen sind:
ignoreSearch-
Ein Boolean-Wert, der angibt, ob der Abgleichsprozess die Query-String in der URL ignorieren soll. Wenn auf
truegesetzt, wird der Teil?value=barvonhttp://foo.com/?value=barbei der Durchführung eines Abgleichs ignoriert. Es ist standardmäßig auffalsegesetzt. ignoreMethod-
Ein Boolean-Wert, der, wenn auf
truegesetzt, verhindert, dass die Abgleichsoperationen diehttpMethode desRequestvalidieren (normalerweise sind nurGETundHEADerlaubt.) Standardmäßig ist es auffalsegesetzt. ignoreVary-
Ein Boolean-Wert, der, wenn auf
truegesetzt, der Matching-Operation sagt, dass keinVARYHeader-Abgleich durchgeführt wird — d.h. wenn die URL übereinstimmt, erhalten Sie eine Übereinstimmung unabhängig davon, ob dasResponseObjekt einenVARYHeader hat oder nicht. Standardmäßig ist es auffalsegesetzt.
Rückgabewert
Ein Promise, das zu einem Array aller übereinstimmenden Antworten im
Cache Objekt aufgelöst wird.
Hinweis:>Cache.match() ist im Wesentlichen identisch mit
Cache.matchAll(), außer dass es mit nur der ersten übereinstimmenden Antwort aufgelöst wird (d.h.
response[0]).
Beispiele
Das folgende Beispiel ruft alle Antworten im v1 Cache ab, die mit der URL / übereinstimmen, einschließlich potenzieller Abfrageparameter. Indem { ignoreSearch: true } verwendet wird, würde matchAll sowohl / als auch /?value=bar abrufen.
Es werden dann die Anzahl der übereinstimmenden Antworten protokolliert.
caches
.open("v1")
.then((cache) => cache.matchAll("/", { ignoreSearch: true }))
.then((responses) => {
console.log(`Found ${responses.length} matching responses`);
});
Spezifikationen
| Specification |
|---|
| Service Workers # cache-matchall |
Browser-Kompatibilität
Loading…