Cache.matchAll

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.

Parameters

request

The Request you are attempting to find in the Cache.

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: A Boolean that specifies whether the matching process should ignore the query string in the url. If set to true, the ?value=bar part of http://foo.com/?value=bar would be ignored when performing a match. It defaults to false.
• ignoreMethod: A Boolean that, when set to true, prevents matching operations from validating the Request http method (normally only GET and HEAD are allowed.) It defaults to false.
• ignoreVary: A Boolean that when set to true tells the matching operation not to perform VARY header matching — i.e. if the URL matches you will get a match regardless of the Response object having a VARY header or not. It defaults to false.
• cacheName: A DOMString that represents a specific cache to search within. Cache.matchAll()

Examples

caches.open('v1').then(function(cache) {
  cache.matchAll('/images/').then(function(response) {
    response.forEach(function(element, index, array) {
      cache.delete(element);
    });
  });
})

Specifications

Browser compatibility

[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.)

See also

• Using Service Workers
• Cache
• WorkerGlobalScope.caches