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 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

js
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 ein Request 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 von http://foo.com/?value=bar beim Abgleichen ignoriert werden. Standardmäßig auf false.

ignoreMethod

Ein boolescher Wert, der, wenn auf true gesetzt, verhindert, dass Matching-Operationen die Request HTTP Methode validieren (normalerweise sind nur GET und HEAD erlaubt). Standardmäßig auf false.

ignoreVary

Ein boolescher Wert, der, wenn auf true gesetzt, der Matching-Operation mitteilt, kein VARY Header-Matching durchzuführen. Mit anderen Worten, wenn die URL übereinstimmt, erhalten Sie eine Übereinstimmung, unabhängig davon, ob das Response Objekt einen VARY Header hat. Standardmäßig auf false.

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

Ein Promise, das sich zu einem Array von Request Objekten auflöst.

Beispiele

js
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

Siehe auch