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: Dieses Feature ist verfügbar in Web Workers.

Die delete() Methode der Cache Schnittstelle findet den Cache-Eintrag, dessen Schlüssel die Anfrage ist, und löscht den Cache-Eintrag, falls er gefunden wird. Sie gibt ein Promise zurück, das sich auf true auflöst. Falls kein Cache-Eintrag gefunden wird, löst sie sich auf false auf.

Syntax

js
delete(request)
delete(request, options)

Parameter

request

Das Request, das gelöscht werden soll. Dies kann ein Request-Objekt oder eine URL sein.

options Optional

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

ignoreSearch

Ein boolescher Wert, der angibt, ob der Abgleichsvorgang den Abfrage-String in der URL ignorieren soll. Wenn auf true gesetzt, wird der ?value=bar-Teil von http://foo.com/?value=bar beim Abgleich ignoriert. Standardmäßig ist er auf false gesetzt.

ignoreMethod

Ein boolescher Wert, der, wenn er auf true gesetzt ist, Verhinderung der Überprüfung des HTTP-Methods von Request beim Abgleich erlaubt (normalerweise sind nur GET und HEAD erlaubt). Standardmäßig ist er auf false gesetzt.

ignoreVary

Ein boolescher Wert, der, wenn auf true gesetzt, angibt, dass der Abgleichsvorgang keine Prüfung der VARY Header durchführen soll. Anders gesagt, wenn die URL übereinstimmt, erhalten Sie eine Übereinstimmung, unabhängig davon, ob das Response-Objekt einen VARY-Header hat. Standardmäßig ist er auf false gesetzt.

cacheName

Ein String, der einen spezifischen Cache repräsentiert, in dem gesucht werden soll. Beachten Sie, dass diese Option von Cache.delete() ignoriert wird.

Rückgabewert

Ein Promise, das sich auf true auflöst, wenn der Cache-Eintrag gelöscht wird, oder auf false andernfalls.

Beispiele

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

Spezifikationen

Specification
Service Workers
# cache-delete

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch