The delete()
method of the Cache
interface finds the Cache
entry whose key is the request, and if found, deletes the Cache
entry and returns a Promise
that resolves to true
. If no Cache
entry is found, it resolves to false
.
On this page
Cache: delete() method
Syntax
js
delete(request)
delete(request, options)
Parameters
-
request
-
The
Request
you are looking to delete. This can be aRequest
object or a URL. options
Optional-
An object whose properties control how matching is done in the
delete
operation. The available options are:-
ignoreSearch
-
A boolean value that specifies whether the matching process should ignore the query string in the URL. If set to
true
, the?value=bar
part ofhttp://foo.com/?value=bar
would be ignored when performing a match. It defaults tofalse
. -
ignoreMethod
-
A boolean value that, when set to
true
, prevents matching operations from validating theRequest
HTTP
method (normally onlyGET
andHEAD
are allowed.) It defaults tofalse
. -
ignoreVary
-
A boolean value that, when set to
true,
tells the matching operation not to performVARY
header matching. In other words, if the URL matches you will get a match regardless of whether theResponse
object has aVARY
header. It defaults tofalse
. -
cacheName
-
A string that represents a specific cache to search within. Note that this option is ignored by
Cache.delete()
.
-
Return value
a Promise
that resolves to true
if the cache entry is deleted, or false
otherwise.
Examples
js
caches.open("v1").then((cache) => {
cache.delete("/images/image.png").then((response) => {
someUIUpdateFunction();
});
});
Specifications
Specification |
---|
Service Workers # cache-delete |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
delete |
43 | 16 | 41 | No | 30 | 11.1 | 43 | 43 | 41 | 30 | 11.3 | 4.0 |
See also
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Cache/delete