This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The matchAll()
method of the Cache
interface returns a Promise
that resolves to an array of all matching requests in the Cache
object.
Syntax
cache.matchAll(request,{options}).then(function(response) { //do something with the response array });
Returns
a Promise
that resolves to an array of all matching requests in the Cache
object.
Note: Cache.match()
is basically identical to Cache.matchAll()
, except it resolves with response[0]
(i.e. the first matching response) instead of response
(all matching response in an array).
Parameters
- request
- The
Request
you are attempting to find in theCache
. - options Optional
- An options object allowing you to set specific control options for the matching done in the
match
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 — i.e. if the URL matches you will get a match regardless of theResponse
object having aVARY
header or not. It defaults tofalse
.cacheName
: ADOMString
that represents a specific cache to search within. Note that this option is ignored byCache.matchAll()
.
Examples
caches.open('v1').then(function(cache) { cache.matchAll('/images/').then(function(response) { response.forEach(function(element, index, array) { cache.delete(element); }); }); })
Specifications
Specification | Status | Comment |
---|---|---|
Service Workers The definition of 'Cache' in that specification. |
Editor's Draft | Initial definition. |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support | 47.0 [1] | (Yes) | 44 (44)[2] | No support | 34 | No support |
All options supported | 54.0 | 41 |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support | No support | No support | (Yes) | ? | No support | (Yes) | No support | 47.0[1] |
All options supported | No support | No support | 41 | 54.0 |
[1] The options parameter only supports ignoreSearch
, and cacheName
.
[2] Service workers (and Push) have been disabled in the Firefox 45 & 52 Extended Support Releases (ESR.)