BackgroundFetchRegistration.matchAll()

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

Синтаксис

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() без параметров, чтобы вернуть все записи в фоновом запросе.

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

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

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