BackgroundFetchRegistration.matchAll()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

Метод matchAll() интерфейса BackgroundFetchRegistration возвращает массив всех совпавших объектов BackgroundFetchRecord.

Синтаксис

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

Параметры

request

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

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

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

ignoreSearch

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

ignoreMethod

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

ignoreVary

Булево значение. Когда true сигнализирует, что заголовок VARY должен быть проигнорирован. Значение по умолчанию - false.

Возвращаемое значение

Promise результатом обработки которого будет массив всех совпавших объектов BackgroundFetchRecord.

Exceptions

InvalidStateError DOMException (en-US)

Возвращается, если флаг recordsAvailable установлен как false, указывает на то, что запрос не выполняется.

Примеры

Используйте matchAll() без параметров, чтобы вернуть все записи в фоновом запросе.

js
const records = await bgFetch.matchAll();
console.log(records); // массив объектов BackgroundFetchRecord

Спецификации

Specification
Background Fetch
# background-fetch-registration-match-all

Совместимость с браузерами

BCD tables only load in the browser