Cache: delete() 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 delete() Methode des Cache-Interfaces findet den Eintrag im Cache, dessen Schlüssel die Anfrage ist, und löscht, falls gefunden, den Cache-Eintrag. Sie gibt ein Promise zurück, das zu true aufgelöst wird. Wenn kein Cache-Eintrag gefunden wird, wird es zu false aufgelöst.

Syntax

delete(request)
delete(request, options)

Parameter

request

Der Request, den Sie löschen möchten. Dies kann ein Request-Objekt oder eine URL sein.

options Optional

Ein Objekt, dessen Eigenschaften steuern, wie das Matching in der delete-Operation durchgeführt wird. Die verfügbaren Optionen sind:

ignoreSearch: Ein boolescher Wert, der angibt, ob der Abgleichprozess den Abfrage-String in der URL ignorieren soll. Wenn auf true gesetzt, wird der Teil ?value=bar von http://foo.com/?value=bar ignoriert, wenn ein Abgleich durchgeführt wird. Standardmäßig ist dieser Wert false.
ignoreMethod: Ein boolescher Wert, der, wenn auf true gesetzt, verhindert, dass Abgleichoperationen die HTTP-Methode des Request validieren (normalerweise sind nur GET und HEAD erlaubt). Standardmäßig ist dieser Wert false.
ignoreVary: Ein boolescher Wert, der, wenn auf true gesetzt, den Abgleichprozess anweist, 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 ist dieser Wert false.
cacheName: Ein String, der einen bestimmten Cache repräsentiert, in dem gesucht werden soll. Beachten Sie, dass diese Option von Cache.delete() ignoriert wird.

Rückgabewert

Ein Promise, das zu true aufgelöst wird, wenn der Cache-Eintrag gelöscht wurde, oder zu false andernfalls.

Beispiele

caches
  .open("v1")
  .then((cache) => cache.delete("/images/image.png"))
  .then((response) => {
    someUIUpdateFunction();
  });

Spezifikationen

Specification
Service Workers # cache-delete