BackgroundFetchRegistration.matchAll()

The matchAll() method of the BackgroundFetchRegistration interface returns an array of matching BackgroundFetchRecord objects.

Syntax

let records = BackgroundFetchRegistration.matchAll(request,options);

Parameters

request
The Request for which you are attempting to find records. This can be a Request object or a URL.
options Optional
An object that sets options for the match operation. The available options are:
ignoreSearch
A Boolean that specifies whether to ignore the query string in the URL. For example, 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. When true, prevents matching operations from validating the Request http method. If false (the default) only GET and HEAD are allowed.
ignoreVary
A Boolean. When true indicates that the VARY header should be ignored. It defaults to false.

Return value

A Promise that resolves with an array of all matching BackgroundFetchRecord objects.

Exceptions

InvalidStateError
If the recordsAvailable flag is false, indicating that there is not a fetch in progress, return a promise that resolves with an InvalidStateError DOMException.

Examples

Use matchAll() with no parameters to return all of the records in a background fetch.

const records = await bgFetch.matchAll();
console.log(records); // an array of BackgroundFetchRecord objects

Specifications

Specification
Background Fetch
# background-fetch-registration-match-all

Browser compatibility

BCD tables only load in the browser