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

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
matchAll
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.