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
.
Синтаксис
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
Спецификации
Specification |
---|
Background Fetch # background-fetch-registration-match-all |
Совместимость с браузерами
BCD tables only load in the browser