BackgroundFetchRegistration: метод match()

Метод match() интерфейса BackgroundFetchRegistration возвращает первый соответствующий BackgroundFetchRecord.

request

Запрос Request, для которого вы пытаетесь найти записи. Это может быть объект Request или URL.

options Необязательно

Объект, устанавливающий параметры для операции match. Доступные параметры:

ignoreSearch Необязательно

Логическое значение, указывающее, нужно ли игнорировать строку запроса в URL. Например, если установлено значение true, часть ?value=bar в http://foo.com/?value=bar будет проигнорирована при выполнении сопоставления. По умолчанию false.

ignoreMethod Необязательно

Логическое значение. Если true, операции сопоставления не будут проверять метод Request http. Если false (по умолчанию), разрешены только GET и HEAD.

ignoreVary Необязательно

Логическое значение. Если true, указывает, что заголовок Vary должен быть проигнорирован. По умолчанию false.

Promise, который разрешается первым BackgroundFetchRecord, соответствующим запросу, или undefined, если соответствий нет.

InvalidStateError DOMException

Возвращается, если вы вызываете 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);
});