Cache.delete()
This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
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 returns false
.
Syntax
cache.delete(request,{options}).then(function(true) { //your cache entry has been deleted });
Returns
a Promise
that resolves to true if the cache entry is deleted, or false otherwise.
Parameters
- request
- The
Request
you are looking to delete. - 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()
.
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' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 40.0[1] | 39 (39)[2] | No support | 24 | No support |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support | No support | No support | 39.0 (39) | ? | No support | ? | No support | 40.0[1] |
[1] The options parameter only supports ignoreSearch
, and cacheName
.
[2] Service workers (and Push) have been disabled in the Firefox 45 Extended Support Release (ESR.)
See also
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/cache/delete