The matchAll()
method of the Cache
interface returns a Promise
that resolves to an array of all matching responses in the Cache
object.
Syntax
cache.matchAll(request, {options}).then(function(response) { // do something with the response array });
Parameters
- request Optional
- The
Request
for which you are attempting to find responses in theCache
. This can be aRequest
object or a URL. If this argument is omitted, you will get a copy of all responses in this cache. - options Optional
- An options object allowing you to set specific control options for the matching performed. 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
.
Return value
A Promise
that resolves to an array of all matching responses in the Cache
object.
Note: Cache.match()
is basically identical to Cache.matchAll()
, except that rather than resolving with an array of all matching responses, it resolves with the first matching response only (that is, response[0]
).
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: matchAll' 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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
matchAll | Chrome Full support 47 | Edge Full support 16 | Firefox
Full support
39
| IE No support No | Opera
Full support
34
| Safari Full support 11 | WebView Android Full support 47 | Chrome Android Full support 47 | Firefox Android Full support 39 | Opera Android Full support 34 | Safari iOS Full support 11 | Samsung Internet Android Full support 5.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.