BackgroundFetchRegistration:matchAll() 方法
注意: 此功能在 Web Workers 中可用。
BackgroundFetchRegistration
接口的 matchAll()
方法返回一个包含匹配的 BackgroundFetchRecord
对象的数组。
语法
js
matchAll()
matchAll(request)
matchAll(request,options)
参数
request
可选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()
来返回后台获取中的所有记录。
js
const records = await bgFetch.matchAll();
console.log(records); // an array of BackgroundFetchRecord objects
规范
规范 |
---|
后台获取 # background-fetch-registration-match-all |
浏览器兼容性
BCD 表格仅在启用了 JavaScript 的浏览器中加载。