BackgroundFetchRegistration:matchAll() 方法

可用性有限

此功能不是基线,因为它在一些最常用的浏览器中无法正常运行。

实验性: 这是一个 实验性技术
在生产环境中使用之前,请仔细查看 浏览器兼容性表

注意: 此功能在 Web Workers 中可用。

BackgroundFetchRegistration 接口的 matchAll() 方法返回一个包含匹配的 BackgroundFetchRecord 对象的数组。

语法

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

参数

request 可选

您尝试查找记录的 Request。这可以是 Request 对象或 URL。如果省略此参数,则结果中将包含所有记录。

options 可选

一个用于设置 match 操作选项的对象。可用的选项是

ignoreSearch 可选

一个布尔值,用于指定是否忽略 URL 中的查询字符串。例如,如果设置为 true,则在执行匹配时将忽略 http://foo.com/?value=bar 中的 ?value=bar 部分。默认值为 false

ignoreMethod 可选

一个布尔值。当为 true 时,将阻止匹配操作验证 Request http 方法。如果为 false(默认值),则仅允许 GETHEAD

ignoreVary 可选

一个布尔值。当为 true 时,表示应忽略 Vary 标头。默认值为 false

返回值

一个 Promise,它解析为包含所有匹配的 BackgroundFetchRecord 对象的数组。

异常

InvalidStateError DOMException

如果 recordsAvailable 标志为 false,表示没有正在进行的获取,则返回此错误。

示例

使用不带任何参数的 matchAll() 来返回后台获取中的所有记录。

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

规范

规范
后台获取
# background-fetch-registration-match-all

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。