BackgroundFetchRegistration: matchAll() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Note: This feature is available in Web Workers.

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

Syntax

js
matchAll()
matchAll(request)
matchAll(request,options)

Parameters

request Optional

The Request for which you are attempting to find records. This can be a Request object or a URL. If this parameter is omitted, all records are included in the result.

options Optional

An object that sets options for the match operation. The available options are:

ignoreSearch Optional

A boolean value 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 Optional

A boolean value. When true, prevents matching operations from validating the Request http method. If false (the default) only GET and HEAD are allowed.

ignoreVary Optional

A boolean value. 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 DOMException

Returned if the recordsAvailable flag is false, indicating that there is no fetch in progress.

Examples

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

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

Specifications

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

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
matchAll
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.