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
.
Syntax
cache.delete(request, {options}).then(function(found) { // your cache entry has been deleted if found });
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
: ABoolean
that specifies whether the matching process should ignore the query string in the url. If set totrue
, the?value=bar
part ofhttp://foo.com/?value=bar
would be ignored when performing a match. It defaults tofalse
.ignoreMethod
: ABoolean
that, when set totrue
, prevents matching operations from validating theRequest
HTTP
method (normally onlyGET
andHEAD
are allowed.) It defaults tofalse
.ignoreVary
: ABoolean
that, when set totrue,
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
: ADOMString
that represents a specific cache to search within. Note that this option is ignored byCache.delete()
.
Return value
a Promise
that resolves to true
if the cache entry is deleted, or false
otherwise.
Examples
caches.open('v1').then(function(cache) { cache.delete('/images/image.png').then(function(response) { someUIUpdateFunction(); }); })
Specifications
Specification | Status | Comment |
---|---|---|
Service Workers The definition of 'Cache: delete' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
delete | Chrome Full support 43 | Edge Full support 16 | Firefox
Full support
39
| IE No support No | Opera Full support 30 | Safari Full support 11 | WebView Android Full support 43 | Chrome Android Full support 43 | Firefox Android Full support 39 | Opera Android Full support 30 | Safari iOS Full support 11 | Samsung Internet Android Full support 4.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- See implementation notes.