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

Возвращается, если флаг 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