The matchAll()
method of the BackgroundFetchRegistration
interface returns an array of matching BackgroundFetchRecord
objects.
The matchAll()
method of the BackgroundFetchRegistration
interface returns an array of matching BackgroundFetchRecord
objects.
matchAll(request) matchAll(request,options)
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 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
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
A boolean value. When true
indicates that the VARY
header should be ignored. It defaults to false
.
A Promise
that resolves with an array of all matching BackgroundFetchRecord
objects.
InvalidStateError
DOMException
Returned if the recordsAvailable
flag is false
, indicating that there is no fetch in progress.
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
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
matchAll |
74 |
79 |
No |
No |
62 |
No |
No |
74 |
No |
53 |
No |
11.0 |
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BackgroundFetchRegistration/matchAll