BackgroundFetchRegistration: match() 方法

语法

match(request)
match(request, options)

参数

请求

您尝试查找记录的 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，如果未找到匹配项，则解析为 undefined。

异常

InvalidStateError DOMException

当您在没有正在进行的 fetch 时调用 match() 时返回此值。此状态将反映在 BackgroundFetchRegistration.recordsAvailable 设置为 false。

示例

在此示例中，我们查找 URL 为“/ep-5.mp3”的记录。如果找到 BackgroundFetchRecord，我们就可以返回有关它的信息。

bgFetch.match("/ep-5.mp3").then(async (record) => {
  if (!record) {
    console.log("No record found");
    return;
  }

  console.log(`Here's the request`, record.request);
  const response = await record.responseReady;
  console.log(`And here's the response`, response);
});

规范

浏览器兼容性