BackgroundFetchRegistration: matchAll() 方法

语法

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（默认值），则只允许 GET 和 HEAD。

ignoreVary 可选

一个布尔值。当设置为 true 时，表示应忽略 Vary 头部。默认值为 false。

返回值

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

异常

InvalidStateError DOMException

如果 recordsAvailable 标志为 false，则返回此值，表示没有进行中的获取操作。

示例

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

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

规范

浏览器兼容性