The keys()
method of the Cache
interface returns a Promise
that resolves to an array of Cache
keys.
The requests are returned in the same order that they were inserted.
Note: Requests with duplicate URLs but different headers can be returned if their responses have the VARY
header set on them.
Syntax
cache.keys(request, {options}).then(function(keys) { // do something with your array of requests });
Parameters
- request Optional
- The
Request
want to return, if a specific key is desired. This can be aRequest
object or a URL. - options Optional
- An object whose properties control how matching is done in the
keys
operation. The available options are:
ignoreSearch
- A
Boolean
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.keys()
.
- A
Return value
A Promise
that resolves to an array of Cache
keys.
Examples
caches.open('v1').then(function(cache) {
cache.keys().then(function(keys) {
keys.forEach(function(request, index, array) {
cache.delete(request);
});
});
})
Specifications
Specification | Status | Comment |
Service WorkersThe definition of 'Cache: keys' 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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
Full support 43 |
Edge
Full support 16 |
Firefox Full support 39 Full support 39 Notes' Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API. |
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.
See also
Cache.keys() by Mozilla Contributors is licensed under CC-BY-SA 2.5.